Cloud Deploy in Ihr CI-System einbinden

In diesem Dokument wird beschrieben, wie Sie Ihre Cloud Deploy-Bereitstellungspipeline aus Ihrem CI-System (Continuous Integration) aufrufen.

Das Einbinden von Cloud Deploy in Ihr CI-System ist so einfach wie das Hinzufügen eines Aufrufs zur Cloud Deploy gcloud CLI. Dieser Aufruf findet an Ihrer CI-Pipeline statt, an der Ihre Anwendung bereitgestellt werden kann.

Hinweis

Die Anleitung auf dieser Seite setzt voraus, dass Sie bereits die folgenden Bedingungen erfüllen:

  • Sie haben die entsprechenden APIs aktiviert.

  • Sie haben mindestens eine Bereitstellungspipeline definiert und registriert bei Cloud Deploy.

  • Sie haben mindestens ein Ziel definiert, und Ihre Bereitstellungspipeline verweist auf dieses Ziel.

Cloud Deploy über Ihre CI-Pipeline aufrufen

Mit dem folgenden Befehl wird ein neuer Release erstellt und damit eine Bereitstellungspipelineinstanz aufgerufen:

gcloud deploy releases create RELEASE_NAME \
  --delivery-pipeline=PIPELINE_NAME \
  --region=REGION \
  --annotations=[KEY=VALUE,...] \
  --images=[IMAGE_LIST]

Wobei:

  • RELEASE_NAME

    ist der Name, den Sie diesem Release zuweisen. Dieser Wert ist erforderlich.

    Sie können dynamische Releasenamen angeben, indem Sie '$DATE' oder '$TIME' oder beides einfügen. Wenn Sie diesen Befehl beispielsweise um 15:07 Uhr UTC aufrufen, 'rel-$TIME' wird in rel-1507 aufgelöst. '$DATE' und '$TIME' müssen in einfachen Anführungszeichen stehen.

  • PIPELINE_NAME

    ist der Name Ihrer registrierten Zustellungspipeline. Dieser Wert ist erforderlich.

  • REGION

    ist die Region, in der Sie diese Version erstellen. Die Region muss nicht mit der Region übereinstimmen, in der Sie Ihre Anwendung letztendlich bereitstellen.

  • [KEY=VALUE,...]

    ist eine optionale Liste mit einer oder mehreren Annotationen, die in Form von Schlüssel/Wert-Paaren auf den Release angewendet werden sollen.

    Sie können Annotationen verwenden, um die Releaseherkunft zu verfolgen, indem Sie beispielsweise eine Annotation wie commitId=0065ca0 übergeben. Alle Annotationen für den Release werden zurückgegeben, wenn Sie den Release list oder get ausführen und den Release in der Google Cloud konsole anzeigen lassen, sodass Sie auch dort die Releaseherkunft sehen können.

  • [IMAGE_LIST]

    ist eine durch Kommas getrennte Liste von Ersetzungen von Image-Name, Bild-Pfad und Pfad. Beispiel: --images=image1=path/to/image1:v1@sha256:45db24,image2=path/to/image2:v1@sha256:55xy18.