Skaffold-Versionen verwalten

Cloud Deploy verwendet Skaffold über Cloud Build, um Ihre Anwendung durch Rendering und Bereitstellung von Manifesten bereitzustellen.

Auf dieser Seite wird beschrieben, wie Cloud Deploy die zu verwendende Skaffold-Version auswählt. Auf dieser Seite finden Sie außerdem Informationen zu folgenden Themen:

Welche Version von Skaffold verwendet Cloud Deploy?

Cloud Deploy führt seine Vorgänge mit einem benutzerdefinierten Image aus, das eine Skaffold-LTS-Version enthält. Jede unterstützte Version von Skaffold ist in der Tabelle in diesem Dokument aufgeführt und mit dem Repository aller Cloud Deploy-Images verknüpft. Die Versionsnummer jedes Cloud Deploy-Images entspricht der Skaffold-Versionsnummer.

Vor dem 30. August 2022 verwendete Cloud Deploy die LTS-Version der neuesten öffentlich verfügbaren Skaffold-Images.

Unterstützte Versionen

Skaffold-Version Max. Schemaversion Ab Standard?
2.11.x (Versionshinweise) v4beta10 6. Mai 2024 ✓
2.10.x (Versionshinweise) V4Beta9 2. Februar 2024
2.8.x (Versionshinweise) V4Beta7 27. Oktober 2023
2.6.x (Versionshinweise) v4beta6 6. Juli 2023
2.3.x (Versionshinweise) v4beta4 24. April 2023
2.0.x (Versionshinweise) v4beta1 9. Januar 2023

Jede Version in dieser Tabelle ist mit einem Repository in Artifact Registry verknüpft. Suchen Sie in diesem Repository nach dem neuesten Datum für die neueste oder die gewünschte Version. Das verknüpfte Repository befindet sich in der Region us-central1. Diese Images sind jedoch in jeder Region verfügbar, in der Cloud Deploy verfügbar ist. Das verwendete Image befindet sich in der Region, in der die Bereitstellungspipeline erstellt wurde.

Cloud Deploy verwendet für jede unterstützte Skaffold-Version den neuesten Patchrelease. In den Versionshinweisen geben wir die Unterstützung neuer Versionen bekannt, einschließlich bestimmter Skaffold-Version-Patches.

Vorschauversion

Sie können das Cloud Deploy-Vorschaubild verwenden, das Vorschaufunktionen umfasst.

Die Skaffold-Version im Vorschau-Image kann jederzeit aktualisiert werden und folgt keinem regelmäßigen Veröffentlichungszeitplan. Wir empfehlen, die Vorabversion nicht für Produktionsarbeitslasten zu verwenden.

Die Vorschauversion befindet sich im selben Repository wie die unterstützten Versionen. Suchen Sie nach Bildern mit einem Tag, das mit skaffold_preview beginnt.

Für einige Vorschaufunktionen ist das Vorschau-Image von Cloud Deploy erforderlich. Für diese Features verwendet Cloud Deploy diese Vorabversion, ohne dass Sie etwas tun müssen. Wenn Sie beim Erstellen eines Release mit einer Vorschaufunktion versuchen, eine andere Skaffold-Version auszuwählen, schlägt der Befehl fehl.

Skaffold-Version ermitteln, die mit einem Release verknüpft ist

Sie können die von Cloud Deploy verwendete Version jederzeit mit dem folgenden Befehl ermitteln:

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

Die Version wird im Attribut skaffoldVersion in der Ausgabe angezeigt.

Auswählen, welche Skaffold-Version verwendet werden soll

Sie können jede unterstützte Version von Skaffold verwenden. Fügen Sie das Flag --skaffold-version in den Befehl gcloud deploy releases create ein, um die gewünschte Version auszuwählen:

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

Dabei ist SKAFFOLD_VERSION die (unterstützte) Skaffold-Version, die für diesen Release verwendet werden soll. Die Version muss das Format n.nn für eine nummerierte Version oder skaffold_preview haben, wenn die Vorschauversion verwendet wird.

Mit dem folgenden Befehl wird beispielsweise die Skaffold-Version 2.8 ausgewählt:

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

Mit diesem Befehl wird die Vorschauversion von Skaffold ausgewählt:

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

Auswahl neuer Versionen durch Cloud Deploy

Eine neue Version von Skaffold wird alle 90 Tage ausgewählt. Am Ende dieses 90-Tage-Zyklus bietet Google Cloud Unterstützung für eine neue Skaffold-Version. Sie können diese Version jetzt mit Cloud Deploy verwenden. Sie wird zur Standardversion, die zum Erstellen und Verwalten aller Releases für den nächsten 90-Tage-Zyklus verwendet wird.

Die Versionshinweise für Cloud Deploy werden aktualisiert und enthalten alle neu unterstützten Versionen.

Einstellung und Wartungsrichtlinie für Skaffold-Version

Skaffold-Versionen werden 12 Monate mit einem Wartungszeitraum von 60 Tagen unterstützt. Dieser Wartungszeitraum bedeutet, dass Releases, die mit einer Version verknüpft sind, noch 60 Tage lang unterstützt werden, nachdem die Unterstützung für diese Version abgelaufen ist. Sie können weiterhin Roll-outs aus diesen Releases erstellen, aber keine Releases mit einer Skaffold-Version erstellen, die sich im Wartungszeitraum befindet.

Nach der 60-tägigen Wartungsperiode wird die Skaffold-Version nicht mehr unterstützt. Sie können keine Roll-outs mehr aus einem Release erstellen, der die nicht unterstützte Version verwendet. Alle mit dem Release verknüpften Daten bleiben jedoch erhalten.

Skaffold-Version Ab Wartungsbeginn Ablauffrist
2.11.x (Versionshinweise) 6. Mai 2024 6. Mai 2025 5. Juli 2025
2.10.x (Versionshinweise) 2. Februar 2024 2. Februar 2025 3. April 2025
2.8.x (Versionshinweise) 26. Oktober 2023 26. Oktober 2024 25. Dezember 2024
2.6.x (Versionshinweise) 6. Juli 2023 6. Juli 2024 4. September 2024
2.3.x (Versionshinweise) 24. April 2023 1. Mai 2024 1. Juli 2024

Nächste Schritte