Gestire le versioni di Skaffold

Cloud Deploy utilizza Skaffold, tramite Cloud Build, per eseguire il deployment dell'applicazione eseguendo il rendering e il deployment dei manifest.

La pagina descrive come Cloud Deploy seleziona la versione di Skaffold da utilizzare. Questa pagina include anche informazioni su:

• Frequenza di modifica della versione di Skaffold
• Come scoprire la versione attuale
• Per quanto tempo è supportata ogni versione

Quale versione di Skaffold utilizza Cloud Deploy?

Cloud Deploy esegue le operazioni utilizzando un'immagine personalizzata, che include una versione LTS di Skaffold. Ogni versione supportata di Skaffold è elencata nella tabella di questo documento, collegata al repository di tutte le immagini di Cloud Deploy. Il numero di versione di ogni immagine Cloud Deploy corrisponde al numero di versione di Skaffold.

Versioni supportate

Ogni versione di questa tabella è collegata a un repository in Artifact Registry. In questo repository, cerca la data più recente per trovare l'ultima versione o la versione che ti interessa. Il repository collegato si trova nella regione us-central1, ma queste immagini sono disponibili in ogni regione in cui è disponibile Cloud Deploy. L'immagine utilizzata si trova nella regione in cui è stata creata la pipeline di distribuzione.

Cloud Deploy utilizza l'ultima release di patch per ogni versione di Skaffold supportata. Annunciamo il supporto per le nuove versioni, incluse le patch specifiche della versione di Skaffold, nelle note di rilascio.

Versione di anteprima

Puoi utilizzare l'immagine di anteprima di Cloud Deploy, che include le funzionalità di anteprima.

La versione di Skaffold nell'immagine di anteprima può essere aggiornata in qualsiasi momento e non segue una pianificazione delle release regolare. Ti consigliamo di non utilizzare la versione di anteprima per i carichi di lavoro di produzione.

La versione di anteprima si trova nello stesso repository delle versioni supportate. Cerca immagini con un tag che inizia con skaffold_preview.

Alcune funzionalità di anteprima richiedono l'immagine di anteprima di Cloud Deploy. Per queste funzionalità, Cloud Deploy utilizza la versione di anteprima senza che tu debba fare nulla. Se provi a selezionare una versione di Skaffold diversa quando crei una release utilizzando una funzionalità di anteprima, il comando non va a buon fine.

Trovare la versione di Skaffold associata a una release

Puoi trovare la versione utilizzata da Cloud Deploy in un determinato momento eseguendo questo comando:

gcloud deploy releases describe RELEASE \
       --delivery-pipeline=DELIVERY_PIPELINE \
       --region=REGION

La versione viene visualizzata nell'attributo skaffoldVersion nell'output.

Scegliere la versione di Skaffold da utilizzare

Puoi utilizzare qualsiasi versione supportata di Skaffold. Per selezionare la versione che vuoi utilizzare, includi il flag --skaffold-version nel comando gcloud deploy releases create:

gcloud deploy releases create RELEASE_NAME \
       --delivery-pipeline=PIPELINE_NAME \
       --skaffold-version=SKAFFOLD_VERSION \
       --region=REGION

dove "SKAFFOLD_VERSION" è la versione (supportata) di Skaffold da utilizzare per questa release. La versione deve essere nel formato n.nn per una versione numerata o skaffold_preview per utilizzare la versione di anteprima.

Ad esempio, il seguente comando seleziona la versione 2.8 di Skaffold:

gcloud deploy releases create release-001 \
                              --delivery-pipeline=my-pipeline \
                              --skaffold-version=2.8 \
                              --region=us-central1

Questo comando seleziona la versione di anteprima di Skaffold:

gcloud deploy releases create release-001 \
                       --delivery-pipeline=my-pipeline \
                       --skaffold-version=skaffold_preview \
                       --region=us-central1

Come Cloud Deploy seleziona le nuove versioni

Ogni 90 giorni viene selezionata una nuova versione di Skaffold. Al termine del ciclo di 90 giorni, Google Cloud viene aggiunto il supporto per una nuova versione di Skaffold. Ora puoi utilizzare questa versione con Cloud Deploy. Diventa la versione predefinita utilizzata per creare e gestire tutte le release per il ciclo di 90 giorni successivo.

Le note di rilascio di Cloud Deploy vengono aggiornate per annunciare ogni release appena supportata.

Norme di manutenzione e deprecazione della versione di Skaffold

Le versioni di Skaffold sono supportate per 12 mesi, con un periodo di manutenzione di 60 giorni. Questo periodo di manutenzione significa che le release associate a una versione sono ancora supportate per 60 giorni dopo la scadenza del supporto per quella versione. Puoi comunque creare implementazioni da queste release, ma non puoi creare release utilizzando una versione di Skaffold nel periodo di manutenzione.

Al termine del periodo di manutenzione di 60 giorni, la versione di Skaffold non è più supportata. Non puoi più creare implementazioni da una release che utilizza la versione non supportata. Tuttavia, tutti i dati associati alla release rimangono.

Passaggi successivi

• Scopri di più sull'integrazione di Cloud Deploy con altri sistemi.

• Scopri di più su come Skaffold funziona con Cloud Deploy e su come utilizzarlo al meglio.

• Il documento Gestione dei manifest in Cloud Deploy descrive in dettaglio come utilizzare Skaffold, anche con altri strumenti di gestione dei manifest di terze parti.