Ciclo di vita di un deployment del marketplace

Questo documento spiega come installare, eseguire l'upgrade e disinstallare i pacchetti software del Marketplace di Google Distributed Cloud (GDC) con air gap utilizzando la console GDC. Puoi anche installare pacchetti software utilizzando l'interfaccia a riga di comando gdcloud marketplace o l'API Marketplace.

Questo documento è rivolto ai segmenti di pubblico del gruppo di operatori di applicazioni che gestiscono il ciclo di vita dei deployment del Marketplace all'interno dei progetti GDC. Per saperne di più, consulta la documentazione sui segmenti di pubblico per GDC con air gap.

Prima di iniziare

Prima di poter installare, eseguire l'upgrade o disinstallare i pacchetti software del Marketplace, devi disporre delle autorizzazioni necessarie e preparare l'ambiente.

Richiedi ruoli IAM

Contatta l'amministratore dell'organizzazione IAM o l'amministratore del progetto IAM per richiedere i seguenti ruoli in base alle attività che devi eseguire all'interno del progetto:

• Marketplace Editor (marketplace-editor): installa, esegue l'upgrade e disinstalla i pacchetti software di Marketplace.
• Visualizzatore progetto (project-viewer): visualizza un progetto esistente e le relative risorse.

L'amministratore dell'organizzazione IAM può concedere questi ruoli per qualsiasi progetto all'interno dell'organizzazione. L'amministratore del progetto IAM può concedere questi ruoli nell'ambito del proprio progetto specifico.

prepara l'ambiente

Le attività in questa pagina utilizzano principalmente la console GDC. Se prevedi di utilizzare le alternative della riga di comando, completa i seguenti passaggi:

• Scarica e installa l'interfaccia a riga di comando gdcloud, se non l'hai ancora fatto.
• Per utilizzare l'API con kubectl, è necessaria una configurazione aggiuntiva:
  • Installa l'interfaccia a riga di comando kubectl.
  • Genera un file kubeconfig.

Installa un pacchetto software del marketplace di Distributed Cloud

Per installare un pacchetto software dal marketplace di Distributed Cloud, completa i seguenti passaggi:

Console

1. Nel selettore dei progetti della console GDC, seleziona il progetto in cui vuoi installare il pacchetto software.
2. Nel marketplace di Distributed Cloud, visita la pagina della scheda del prodotto che vuoi installare. Da questa pagina puoi esaminare i dettagli del prodotto e seguire i link alla relativa documentazione, ai prezzi e ai Termini di servizio.
3. Se è la prima volta che installi questo prodotto, fai clic su Installa. In caso contrario, vai alla scheda Gestione e fai clic su Nuova istanza.
4. Nella finestra di dialogo, seleziona il cluster utente in cui vuoi installare il pacchetto software. Se vuoi personalizzare la configurazione, fai clic su Avanti. Se vuoi utilizzare la configurazione predefinita, fai clic su Installa.
5. Se hai fatto clic su Avanti, ora puoi esaminare la configurazione predefinita. Fai clic su Configurazione personalizzata per inserire i tuoi parametri, seguendo la documentazione del fornitore. Al termine, fai clic su Install (Installa) per procedere con l'installazione. Per i pacchetti software Kubernetes, i parametri configurati qui sostituiscono i valori predefiniti forniti dal fornitore nel file dei valori Helm.

6. Attendi qualche minuto affinché la nuova istanza venga contrassegnata come Pronta nella scheda Gestione della pagina.

   

7. Consulta la documentazione del fornitore di software pertinente per scoprire come utilizzare la sua soluzione una volta installata.

gdcloud

1. Seleziona il progetto in cui vuoi installare il pacchetto software:

   gdcloud config set project PROJECT_NAME
   

   Sostituisci PROJECT_NAME con il nome del progetto in cui vuoi installare il pacchetto software.

2. Elenca le applicazioni del Marketplace disponibili:

   gdcloud marketplace services list
   

3. Installa l'applicazione selezionata dall'elenco, specificando il cluster di destinazione:

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME
   

   Per fornire override della configurazione personalizzata durante l'installazione, utilizza il flag --parameters-file:

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME \
     --parameters-file=PATH_TO_PARAMETERS_FILE
   

   Sostituisci quanto segue:

   • SERVICE_NAME: il nome del servizio Marketplace da installare (ad esempio dataproc)
   • CLUSTER_NAME: il nome del cluster utente di destinazione in cui vuoi installare l'applicazione
   • PATH_TO_PARAMETERS_FILE: il percorso di un file YAML contenente i parametri di override della configurazione per l'istanza di servizio

4. Verifica l'installazione:

   gdcloud marketplace services list
   

   Verifica che l'applicazione appena installata venga visualizzata nell'elenco con lo stato READY o INSTALLED.

API

1. Elenca le risorse ServiceVersion disponibili per trovare il servizio e la versione specifici che vuoi installare:

   kubectl get serviceversions -n mkt-system
   

2. Crea un manifest YAML per una risorsa ServiceInstance (ad esempio service-instance.yaml):

   apiVersion: marketplace.gdc.goog/v1
   kind: ServiceInstance
   metadata:
     name: INSTANCE_NAME
   spec:
     clusterRef:
       name: CLUSTER_NAME
       namespace: CLUSTER_NAMESPACE
     serviceVersionRef:
       name: SERVICE_VERSION_NAME
       namespace: mkt-system
     parameters:
       KEY: VALUE
   

   Sostituisci quanto segue:

   • INSTANCE_NAME: un nome per la nuova istanza dell'applicazione
   • CLUSTER_NAME: il nome del cluster utente di destinazione in cui vuoi installare l'applicazione
   • CLUSTER_NAMESPACE: lo spazio dei nomi del cluster (ad esempio production-cluster)
   • SERVICE_VERSION_NAME: il nome di ServiceVersion da installare (ad esempio, dataproc-1.0.0)
   • KEY: il nome del parametro di override della configurazione, che segue lo schema dei valori Helm del fornitore
   • VALUE: il valore del parametro di override della configurazione

   Per saperne di più e per un manifest di esempio, consulta la panoramica dell'API Marketplace.

3. Applica il manifest al progetto:

   kubectl apply -f service-instance.yaml -n PROJECT_NAME
   

   Sostituisci PROJECT_NAME con il nome del progetto in cui vuoi installare il pacchetto software.

4. Verifica l'installazione controllando lo stato dell'oggetto ServiceInstance:

   kubectl get serviceinstance INSTANCE_NAME -n PROJECT_NAME -o yaml
   

   Verifica che status.conditions contenga una condizione di tipo Ready con stato "True" e che status.installedVersion mostri la versione installata.

Nota: se hai bisogno di sapere quale immagine container è disponibile in GDC, consulta l'elenco delle immagini del Marketplace incluse nella tua versione di GDC. Le immagini incluse nelle versioni precedenti di GDC rimangono disponibili per l'uso, anche dopo un upgrade di GDC.

Riconfigura un'istanza di un pacchetto software del marketplace di Distributed Cloud

Avviso: anche se puoi riconfigurare un'istanza in esecuzione di un pacchetto software del marketplace di Distributed Cloud, il processo di riconfigurazione viene implementato dal fornitore che ha pubblicato il prodotto. La procedura di riconfigurazione varia quindi da un pacchetto software all'altro. Ti consigliamo di esaminare attentamente la documentazione del fornitore pertinente prima di procedere con una riconfigurazione. A seconda di come il fornitore ha implementato il processo di riconfigurazione, potresti riscontrare tempi di inattività nel servizio fornito.

Alcuni pacchetti software del marketplace di Distributed Cloud possono essere riconfigurati quando sono già in esecuzione. Per i servizi basati su Kubernetes, questo equivale ad applicare nuovi valori al grafico Helm del fornitore.

Per riconfigurare un'istanza in esecuzione di un pacchetto software del marketplace di Distributed Cloud, segui questi passaggi:

1. Nel selettore dei progetti della console GDC, seleziona il progetto in cui vuoi eseguire l'upgrade del pacchetto software.
2. Nella pagina del marketplace di Distributed Cloud, vai alla pagina della scheda del prodotto di cui vuoi eseguire l'upgrade.
3. Fai clic sulla scheda Gestione.
4. Fai clic su File di configurazione per l'istanza che vuoi riconfigurare.
5. Nel riquadro che si apre, inserisci i parametri personalizzati seguendo la documentazione del fornitore.
6. Fai clic su Salva per applicare i nuovi parametri. La riconfigurazione viene completata in pochi minuti.

Esegui l'upgrade di un pacchetto software del marketplace di Distributed Cloud

Avviso: anche se puoi attivare l'upgrade di un pacchetto software utilizzando il marketplace di Distributed Cloud, il processo di upgrade viene implementato dal fornitore che ha pubblicato il prodotto. La procedura di upgrade varia quindi da un pacchetto software all'altro. Ti consigliamo di esaminare attentamente le note di rilascio e la documentazione sull'upgrade del fornitore pertinente prima di procedere con un upgrade. A seconda di come il fornitore ha implementato il processo di upgrade, potresti riscontrare tempi di inattività nel servizio fornito o problemi di compatibilità tra le versioni precedenti e quelle più recenti.

È possibile eseguire l'upgrade di alcuni pacchetti software del marketplace di Distributed Cloud a una nuova versione tramite il marketplace di Google Distributed Cloud dopo che l'operatore dell'infrastruttura ha reso disponibili le nuove versioni.

Per eseguire l'upgrade di un pacchetto software del marketplace Distributed Cloud, segui questi passaggi:

1. Nel selettore dei progetti della console GDC, seleziona il progetto in cui vuoi eseguire l'upgrade del pacchetto software.
2. Nella pagina del marketplace di Distributed Cloud, vai alla pagina della scheda del prodotto di cui vuoi eseguire l'upgrade.
3. Fai clic sulla scheda Gestione.
4. Fai clic su Esegui l'upgrade sull'istanza di cui vuoi eseguire l'upgrade. L'upgrade viene completato in pochi minuti.

Nota: l'upgrade di un pacchetto software tramite la console Distributed Cloud comporta l'installazione della versione successiva disponibile del software. Se sono disponibili più nuove versioni del software, devi ripetere la procedura per ciascuna. Se necessario, utilizza l'API Marketplace per eseguire l'upgrade a una versione specifica.

Disinstalla un pacchetto software di Distributed Cloud Marketplace

Avviso: la disinstallazione di un pacchetto software del marketplace di Distributed Cloud è un'azione distruttiva e può comportare la perdita di dati o tempi di inattività dei sistemi che dipendono da questo software. Prima di procedere, assicurati di aver eseguito il backup di tutti i dati importanti e che nessun sistema importante dipenda dal software che vuoi disinstallare. Consulta la documentazione del fornitore pertinente per scoprire come eseguire il backup dei dati gestiti dal suo software.

Per disinstallare un pacchetto software del marketplace di Distributed Cloud, completa i seguenti passaggi:

1. Nel selettore di progetti della console GDC, seleziona il progetto da cui vuoi disinstallare il pacchetto software.
2. Nella pagina del marketplace di Distributed Cloud, visita la pagina della scheda del prodotto che vuoi disinstallare.
3. Fai clic sulla scheda Gestione.
4. Fai clic su Disinstalla per l'istanza che vuoi disinstallare. Il pacchetto software viene disinstallato in pochi minuti.