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 per l'utilizzo. Questa pagina include anche informazioni su:

Quale versione di Skaffold utilizza Cloud Deploy?

Cloud Deploy esegue le operazioni utilizzando un'immagine personalizzata, include una versione Skaffold LTS. 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 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

Versione Skaffold Versione dello schema massima Dati aggiornati Valore predefinito?
2.11.x (note di rilascio) v4beta10 6 maggio 2024 ✓
2.10.x (note di rilascio) v4beta9 2 febbraio 2024
2.8.x (note di rilascio) v4beta7 27 ottobre 2023

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 Cloud Deploy disponibili. L'immagine che viene utilizzata si trova nella regione in cui viene effettuata la distribuzione è stata creata.

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 funzionalità di anteprima.

La versione Skaffold nell'immagine di anteprima può essere aggiornata in qualsiasi momento e non segue un normale programma di pubblicazione. 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 le immagini con un tag che inizia con skaffold_preview.

Alcune funzionalità in anteprima richiedono l'immagine di anteprima di Cloud Deploy. Per queste funzionalità, Cloud Deploy utilizza la versione di anteprima senza che tu debba fare niente. 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 mostrata nell'attributo skaffoldVersion nell'output.

Scegli la versione di Skaffold da utilizzare

Puoi utilizzare qualsiasi versione supportata di Skaffold. Per selezionare la versione da utilizzare, includi il comando --skaffold-version sul 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 usare per questa release. La versione deve avere il 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

In che modo Cloud Deploy seleziona nuove versioni

Viene selezionata una nuova versione di Skaffold ogni 90 giorni. Al termine dei 90 giorni di Skaffold, Google Cloud aggiunge il supporto per una nuova versione di Skaffold. Ora puoi utilizzare quella versione con Cloud Deploy. Diventa la versione predefinita utilizzata per creare e gestire tutte le release per il successivo ciclo di 90 giorni.

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

Criterio di ritiro e manutenzione della versione 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 creare comunque implementazioni da queste release, ma non puoi creare release utilizzando è una versione di Skaffold in fase 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 all'uscita verranno mantenuti.

Versione Skaffold Dati aggiornati Inizio manutenzione Scadenza
2.11.x (note di rilascio) 6 maggio 2024 6 maggio 2025 5 luglio 2025
2.10.x (note di rilascio) 2 febbraio 2024 2 febbraio 2025 3 aprile 2025
2.8.x (note di rilascio) 26 ottobre 2023 26 ottobre 2024 25 dicembre 2024

Passaggi successivi