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 Version von Skaffold auswählt. Diese Seite enthält auch 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 wurde in Cloud Deploy die LTS-Version der neuesten öffentlich verfügbaren Skaffold-Images verwendet.

Unterstützte Versionen

Skaffold-Version Maximale Schemaversion Ab Standard?
2.13.x (Versionshinweise) v4beta11 1. August 2024 ✓
2.11.x (Versionshinweise) v4beta10 6. Mai 2024
2.10.x (Versionshinweise) v4beta9 2. Februar 2024
2.8.x (Versionshinweise) v4beta7 27. Oktober 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 Version oder für 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 Patch-Release. Informationen zur Unterstützung neuer Versionen, einschließlich bestimmter Patches für Skaffold-Versionen, finden Sie in den Versionshinweisen.

Vorschauversion

Sie können das Cloud Deploy-Vorschau-Image verwenden, das Vorschaufunktionen enthält.

Die Skaffold-Version im Vorschaubild kann jederzeit aktualisiert werden und unterliegt keinem regelmäßigen Release-Zeitplan. Wir empfehlen, die Vorabversion nicht für Produktionsarbeitslasten zu verwenden.

Die Vorabversion 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 Vorabversionsfunktionen ist das Cloud Deploy-Vorabversions-Image erforderlich. Für diese Funktionen verwendet Cloud Deploy diese Vorschauversion, 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

Mit dem folgenden Befehl können Sie jederzeit ermitteln, welche Version Cloud Deploy verwendet:

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

Die Version wird im Attribut skaffoldVersion in der Ausgabe angezeigt.

Version von Skaffold auswählen

Sie können jede unterstützte Version von Skaffold verwenden. Wenn Sie die gewünschte Version auswählen möchten, fügen Sie dem Befehl gcloud deploy releases create das Flag --skaffold-version hinzu:

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 sollte das Format n.nn für eine nummerierte Version oder skaffold_preview für die Vorabversion haben.

Mit dem folgenden Befehl wird beispielsweise 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 Vorabversion 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, mit der alle Releases für den nächsten 90-Tage-Zyklus erstellt und verwaltet werden.

Die Versionshinweisen zu Cloud Deploy werden aktualisiert, um die neu unterstützten Releases anzukündigen.

Einstellung und Wartungsrichtlinie für Skaffold-Version

Skaffold-Versionen werden zwölf Monate lang mit einem Wartungszeitraum von 60 Tagen unterstützt. Dieser Wartungszeitraum bedeutet, dass an eine Version gebundene Releases nach Ablauf der Unterstützung für diese Version 60 Tage lang unterstützt werden. Sie können weiterhin Rollouts aus diesen Releases erstellen, aber keine Releases mit einer Skaffold-Version, die sich im Wartungszeitraum befindet.

Nach Ablauf der 60-tägigen Wartungsdauer wird die Skaffold-Version nicht mehr unterstützt. Sie können keine Rollouts 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.13.x (Versionshinweise) 1. August 2024 14. August 2025 13. Oktober 2025
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

Nächste Schritte