Questa pagina descrive come utilizzare Cloud Deploy per distribuire l'applicazione negli ambienti di runtime di destinazione previsti. Prima di farlo, devi crea la pipeline di distribuzione e i target.
Prima di iniziare
Questa sezione descrive cosa devi disporre prima di poter il deployment della tua applicazione con Cloud Deploy.
Assicurati che il tuo account di servizio di esecuzione abbia i ruoli e le autorizzazioni IAM necessari.
Crea la pipeline di distribuzione e i target.
Cloud Deploy può eseguire il deployment su Google Kubernetes Engine, Cloud Run e GKE Enterprise. La configurazione di destinazione varia in base a quale di questi ambienti scegli per il deployment.
Avere le immagini container e i manifest.
Ti servono una o più immagini container di cui eseguire il deployment e una o più immagini Kubernetes (per il deployment su GKE) o i file YAML del servizio (per il deployment in Cloud Run).
Per creare e posizionare le immagini, hai bisogno di una pipeline di integrazione continua o di un altro processo. Il tuo strumento CI può essere Cloud Build, Jenkins o qualsiasi altro strumento che produca immagini container che puoi fornire alla tua pipeline di distribuzione di Cloud Deploy.
Disporre di un file di configurazione
skaffold.yaml
.Chiamate Cloud Deploy
skaffold render
eseguire il rendering dei manifest Kubernetes utilizzando questo fileskaffold apply
per eseguirne il deployment nel tuo target. Per farlo, Skaffold richiede almeno un valore minimo diskaffold.yaml
. Puoi riceverne uno in due modi:Creane una personalizzata.
Tieni presente che il file
skaffold.yaml
deve fare riferimento al namespace corrispondente a una versione di Skaffold supportata nella prima riga, come in questo esempio:`apiVersion: skaffold/v4beta7`
Fai in modo che venga generato per te.
Se non hai ancora un file
skaffold.yaml
, puoi chiedere a Cloud Deploy di crearne uno per te. Questo file è adatto per l'onboarding, l'apprendimento o la dimostrazione Cloud Deploy e non deve essere utilizzato per carichi di lavoro di produzione.
Consulta Utilizzo di Skaffold con Cloud Deploy per ulteriori dettagli. Inoltre, vedi Gestire i manifest in Cloud Deploy ha maggiori dettagli sull'utilizzo di Skaffold e Cloud Deploy con di gestione dei manifest come Helm, Kustomize e kpt.
Configura Cloud Deploy per l'ambiente di runtime che preferisci
Cloud Deploy può eseguire il deployment della tua applicazione in uno dei seguenti ambienti di runtime:
Richiama la pipeline di distribuzione per creare una release
Dopo aver configurato Cloud Deploy per il deployment nel runtime, ora può inviare la tua applicazione di cui eseguire il deployment in base la pipeline che hai creato.
Esegui il regolare processo di integrazione continua (CI), creando l'elemento di cui è possibile o artefatti.
Avvia la pipeline di distribuzione chiamando Cloud Deploy per creare una release.
Esegui il comando seguente dalla directory contenente la configurazione di Skaffold:
gcloud deploy releases create RELEASE_NAME --delivery-pipeline=PIPELINE_NAME --region=REGION
Poiché questo comando crea un file tar di tutti i contenuti della directory e di eventuali sottodirectory, ti consigliamo di non eseguirlo dalla home directory o dalla directory principale. Esegui il comando dalla directory contenente la configurazione di Skaffold o includi l'opzione
--source=
, descritta di seguito.In questo comando...
RELEASE_NAME
è il nome da assegnare a questa release. La deve essere univoco tra tutte le release per questa pipeline di distribuzione.Puoi specificare i nomi delle release dinamici includendo
'$DATE'
o'$TIME'
oppure entrambi. Ad esempio, se esegui questo comando alle 15:07 UTC,'rel-$TIME'
si risolve inrel-1507
.'$DATE'
e'$TIME'
devono essere racchiusi tra virgolette singole e l'ora è l'ora UTC sulla macchina in cui richiami il comando.PIPELINE_NAME
è il nome della pipeline di distribuzione che gestirà il deployment di questa release attraverso l'avanzamento target. Questo nome deve corrispondere al camponame
nella definizione della pipeline.REGION
è il nome della regione in cui ti trovi creando la release, ad esempious-central1
. Campo obbligatorio.
Questo comando carica un file tar contenente le tue configurazioni in un Cloud Storage bucket e crea la release. Cloud Deploy crea anche automaticamente un rollout e esegue il deployment dell'immagine nel primo target definito nella pipeline di distribuzione.
Oltre ai parametri mostrati con questo comando, puoi includere una delle seguenti opzioni:
--images=<name=path/name:$IMAGE_SHA>,<name=path/name:$IMAGE_SHA>
Una raccolta di nomi delle immagini alle sostituzioni del percorso completo.
--build-artifacts=<path/file>
Un riferimento a un file di output degli elementi della build di Skaffold, che può essere passato per rappresentare le sostituzioni dei percorsi completi delle immagini.
Queste due opzioni si escludono a vicenda.
Puoi anche includere uno dei seguenti flag per consentire a Cloud Deploy di generare un file skaffold.yaml
per te:
--from-k8s-manifest=K8S_MANIFEST
La configurazione Skaffold generata si basa sul manifest Kubernetes che superi questa segnalazione. L'utilizzo di questo flag con il flag
--skaffold-file
o con il--source
genera un errore. Per ulteriori dettagli, consulta Generare il tuoskaffold.yaml
.--from-run-manifest=RUN_MANIFEST
La configurazione Skaffold generata si basa su Cloud Run YAML dal servizio. Se usi questo flag con Il flag
--skaffold-file
o--source
genera un errore. Consulta: Generazione diskaffold.yaml
per ulteriori dettagli.
Queste due opzioni si escludono a vicenda.
Puoi anche includere un file .gcloudignore
se nella directory sono presenti file che non vuoi includere nel file tar.
Crea una release dalla console Google Cloud
Puoi usare la console Google Cloud per creare una release per una distribuzione una pipeline o un blocco note personalizzato. Questa opzione è utile per provare Cloud Deploy, ma non è adatta per i carichi di lavoro di produzione.
La procedura riportata di seguito presuppone che tu abbia già creato una pipeline di distribuzione e uno o più target. Puoi anche utilizzare la console Google Cloud per creare la pipeline di importazione.
Nella pagina Dettagli pipeline di distribuzione, fai clic su Crea uscita per una pipeline di distribuzione specifica.
Nel campo Scegli un contenitore, incolla o digita il percorso dell'immagine del contenitore di cui vuoi eseguire il deployment. Per la valutazione, puoi anche utilizzare il contenitore predefinito precompilato in questo campo.
Puoi anche fare clic su Seleziona per scegliere un'immagine container da Artifact Registry o Container Registry.
Fornisci un nome univoco per questa release nel campo Nome release oppure usa il nome predefinito fornito.
Specifica un nome per l'implementazione nel campo Nome implementazione oppure utilizza il metodo fornito il nome predefinito.
Questo nome viene utilizzato per l'implementazione nel primo target di questa release. Per i target successivi, puoi assegnare un nome all'implementazione nella finestra di dialogo Promuovi o nel comando
gcloud deploy releases promote
.Se vuoi, includi una descrizione di questa release nel campo Descrizione.
In Dettagli di deployment, inserisci un nome per il deployment GKE o per il servizio Cloud Run oppure utilizza il nome predefinito fornito.
Per GKE, Cloud Deploy genera il manifest te. Per Cloud Run, Cloud Deploy genera la definizione del servizio, che viene utilizzata per creare il servizio.
Fai clic su Crea.
Cloud Deploy utilizza il manifest generato
la definizione del servizio Cloud Run e l'oggetto skaffold.yaml
generato,
per creare la release.
Modifica il timeout del deployment
Per i deployment nei cluster di destinazione GKE e GKE Enterprise, esistono tre timeout distinti che influiscono sul tempo di attesa del sistema per il report di un deployment stabile da parte di Kubernetes:
Cloud Build ha un timeout di 1 ora per le operazioni eseguite per Cloud Deploy.
Puoi modificare questo timeout nella configurazione dell'ambiente di esecuzione.
Skaffold ha un timeout del controllo di integrità (
deploy.statusCheckDeadlineSeconds
), ovvero il tempo, in secondi, di attesa prima che i deployment si stabilizzino.Il valore predefinito è 600 secondi (10 minuti). Per usare questo timeout,
deploy.statusCheck
deve essere impostato sutrue
. Per impostazione predefinita, è così. SestatusCheck
èfalse
, non viene eseguito alcun controllo dello stato e l'implementazione viene contrassegnata come riuscita al termine dikubectl apply
.Per le risorse Kubernetes di
kind: Deployment
,Deployment.spec.progressDeadlineSeconds
, ovvero il tempo di attesa da parte di Kubernetes affinché il deployment segnali come stabile.Questo timeout si applica solo alle risorse
Deployment
. Ecco come i primi due timeout funzionano insieme:Se
Deployment.spec.progressDeadlineSeconds
in Kubernetes non è configurato: il timeout del controllo di integrità di Skaffold è il timeout effettivo, che si tratti di predefinito o impostato in modo esplicito.Se in Kubernetes è impostato
Deployment.spec.progressDeadlineSeconds
, Skaffold ignora il proprio timeout del controllo di integrità e la scadenza dell'avanzamento di Kubernetes è il timeout effettivo. Tuttavia, se il timeout di Kubernetes è impostato esplicitamente su600
(10 minuti), Skaffold presume che sia il valore predefinito (non impostato) e lo ignora, quindi viene utilizzato il timeout di Skaffold (se impostato).Se non viene impostato alcun timeout, il timeout effettivo è lo Skaffold il valore predefinito è
600
(10 minuti).
Oltre ai
Deployment
, altre risorse Kubernetes possono avere timeout, che non influiscono sul timeout di stabilità. Se una di queste opzioni è presente, controlla per assicurarsi di non essere in conflitto con il timeout della stabilità.Se Skaffold (o Cloud Build) scade, il deployment GKE continua a essere eseguito. Cloud Deploy mostra un errore, ma può comunque riuscire o non riuscire nel cluster GKE.
Per modificare il timeout di stabilità del deployment:
Assicurati che
deploy.statusCheck
sia impostato sutrue
inskaffold.yaml
.true
è l'impostazione predefinita. Quandotrue
, Skaffold attende che i controlli di integrità registrino un deployment stabile, in base al valore di timeout nel passaggio successivo.In
skaffold.yaml
, impostastatusCheckDeadlineSeconds
sul numero di secondi che vuoi attendere.deploy: ... statusCheck: true statusCheckDeadlineSeconds: 600 ...
Il valore predefinito è
600
(10 minuti). Skaffold attende questo periodo di tempo per un deployment stabile. Se questo tempo viene superato prima che il deployment sia stabile, un deployment non va a buon fine.Se vuoi, puoi aggiungere
tolerateFailuresUntilDeadline: true
dopo il giornostatusCheckDeadlineSeconds
.Questa impostazione indica a Skaffold di non uscire in caso di errore di un singolo deployment, ma sono tollerati errori fino alla scadenza di
statusCheckDeadlineSeconds
. Questa impostazione può essere utile in situazioni in cui le risorse potrebbero richiedere più tempo (fino alla scadenza del controllo dello stato) per raggiungere uno stato stabile.Ad esempio, se utilizzi Istio o Cloud Service Mesh, potresti avere una richiesta deployment non riuscito con un messaggio simile a questo:
error iptables validation failed; workload is not ready for Istio. When using Istio CNI, this can occur if a pod is scheduled before the node is ready.
L'impostazione funziona solo con Skaffold 2.0 o versioni successive.
Nel manifest Kubernetes, per le risorse di
kind: Deployment
, impostaDeployment.spec.progressDeadlineSeconds
sullo stesso valore impostato perstatusCheckDeadlineSeconds
.
Passaggi successivi
Scopri di più sul deployment in GKE
Scopri di più sul deployment in Cloud Run
Scopri di più sul deployment in GKE Enterprise
Scopri come creare la pipeline di distribuzione e i target
Scopri come promuovere un'uscita