Skaffold-Versionen verwalten

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

Auf dieser Seite wird beschrieben, wie Cloud Deploy die zu verwendende Skaffold-Version 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, die mit dem Repository aller Cloud Deploy-Images verknüpft ist. Die Versionsnummer jedes Cloud Deploy-Images entspricht der Skaffold-Versionsnummer.

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

Unterstützte Versionen

Skaffold-Version Maximale Schemaversion Ab Standard?
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 aktuellsten Datum für die neueste Version 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 Skafold-Version den neuesten Patchrelease. In den Versionshinweisen geben wir die Unterstützung neuer Versionen, einschließlich bestimmter Skafold-Version-Patches, bekannt.

Vorschauversion

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

Die Skaffold-Version im Vorschau-Image kann jederzeit aktualisiert werden und folgt keinem regulären Release-Zeitplan. Wir empfehlen, die Vorschauversion nicht für Produktionsarbeitslasten zu verwenden.

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

Für einige Vorschaufunktionen ist das Vorschau-Image von Cloud Deploy 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 Vorabversion 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 die Version ermitteln, die Cloud Deploy zu einem bestimmten Zeitpunkt verwendet:

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

Die Version wird im Attribut skaffoldVersion in der Ausgabe angezeigt.

Wählen Sie die gewünschte Skaffold-Version aus

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

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 Verwendung der Vorschauversion haben.

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 Skaffold-Vorschauversion ausgewählt:

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

So wählt Cloud Deploy neue Versionen aus

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 zum Erstellen und Verwalten aller Releases für die nächsten 90 Tage.

Die Versionshinweise für Cloud Deploy werden aktualisiert, um jeden neu unterstützten Release anzukündigen.

Einstellung und Wartungsrichtlinie für Skaffold-Version

Skaffold-Versionen werden 12 Monate lang mit einem 60-tägigen Wartungszeitraum unterstützt. Dieser Wartungszeitraum bedeutet, dass an eine Version gebundene Releases noch 60 Tage lang unterstützt werden, nachdem der Support 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 dem 60-tägigen Wartungszeitraum wird die Skaffold-Version nicht mehr unterstützt. Sie können keine Roll-outs mehr von 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.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
2.0.x (Versionshinweise) 9. Januar 2023 9. Januar 2024 10. März 2024

Nächste Schritte