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 in che modo Cloud Deploy seleziona la versione di Skaffold da usare. Questa pagina include anche informazioni su:

• Frequenza di aggiornamento della versione di Skaffold
• Come scoprire la versione corrente
• Periodo di supporto di ogni versione

Quale versione di Skaffold utilizza Cloud Deploy?

Cloud Deploy esegue le sue 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.

Prima del 30 agosto 2022, Cloud Deploy utilizzava la versione LTS delle immagini Skaffold disponibili pubblicamente più recenti.

Versioni supportate

Ogni versione in questa tabella rimanda a un repository in Artifact Registry. In questo repository, cerca la data più recente della versione più recente o della 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 importazione.

Cloud Deploy utilizza la release patch più recente per ogni versione di Skaffold supportata. Annunciamo il supporto delle nuove versioni, incluse patch specifiche per le versioni 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 in 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 diversa di Skaffold quando crei una release utilizzando una funzionalità di anteprima, il comando non va a buon fine.

Scoprire la versione di Skaffold associata a una release

Puoi trovare la versione in uso da Cloud Deploy in qualsiasi momento eseguendo il seguente 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 --skaffold-version flag 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 indicata come 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 di questo ciclo di 90 giorni, Google Cloud aggiunge il supporto di 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 nuova release supportata.

Norme sulla deprecazione e sulla manutenzione delle versioni di Skaffold

Le versioni di Skaffold sono supportate per 12 mesi, con un periodo di manutenzione di 60 giorni. Questo periodo di manutenzione indica che le release associate a una versione sono ancora supportate per 60 giorni dopo la scadenza del supporto della versione. Puoi ancora creare implementazioni da queste release, ma non puoi creare release utilizzando una versione di Skaffold che si trova 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 farlo funzionare al meglio.

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