Build-Umgebungsvariablen festlegen (Quellbereitstellung)

Build-Umgebungsvariablen sind Schlüssel/Wert-Paare, mit denen Sie Konfigurationsinformationen an Buildpacks übergeben können, wenn Sie eine Funktion aus dem Quellcode bereitstellen. So können Sie beispielsweise zum Zeitpunkt des Builds Compiler-Optionen anpassen, Buildzeit-Zertifikate angeben, Parameter konfigurieren usw.

Auf dieser Seite erfahren Sie, wie Sie Build-Umgebungsvariablen festlegen, die zum Zeitpunkt des Builds verfügbar sind. Diese Informationen sind für Plattformentwickler relevant, die Funktionen in Cloud Run bereitstellen.

Hinweise

Aktivieren Sie die Cloud Build API

gcloud services enable cloudbuild.googleapis.com

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Bereitstellen aus der Quelle benötigen:

Eine Liste der IAM-Rollen und -Berechtigungen im Zusammenhang mit Cloud Run finden Sie unter IAM-Rollen für Cloud Run und IAM-Berechtigungen für Cloud Run. Wenn Ihr Cloud Run Service mit Google Cloud APIs wie Cloud-Clientbibliotheken verknüpft ist, lesen Sie die Konfigurationsanleitung für Dienstidentitäten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Bereitstellungsberechtigungen und Zugriff verwalten.

Build-Umgebungsvariablen festlegen

Sie können Build-Umgebungsvariablen festlegen, um neue Variablen einzurichten oder vorhandene Build-Variablen vollständig zu ersetzen.

gcloud

Sie können Build-Umgebungsvariablen festlegen, wenn Sie eine Funktion aus dem Quellcode bereitstellen:

gcloud beta run deploy SERVICE \
  --source . \
  --function FUNCTION_ENTRY_POINT \
  --set-build-env-vars KEY1=VALUE1,KEY2=VALUE2

Ersetzen Sie:

  • SERVICE durch den Namen Ihrer Cloud Run-Funktion.
  • FUNCTION_ENTRY_POINT durch den Einstiegspunkt zur Funktion in Ihrem Quellcode.
  • KEY1=VALUE1,KEY2=VALUE2 durch die durch Kommas getrennte Liste der Variablennamen und ihrer Werte, die zusammen mit einer Funktion bereitgestellt werden, mit der Sie Konfigurationsinformationen an Buildpacks übergeben können.

Build-Umgebungsvariablen aktualisieren

Sie können Build-Umgebungsvariablen für vorhandene Funktionen aktualisieren. Bei diesem nicht destruktiven Ansatz werden Build-Umgebungsvariablen geändert oder hinzugefügt, jedoch nicht gelöscht.

gcloud

So aktualisieren Sie eine Build-Umgebungsvariable für vorhandene Funktionen:

gcloud beta run deploy SERVICE \
  --source . \
  --function FUNCTION_ENTRY_POINT \
  --update-build-env-vars KEY1=VALUE1,KEY2=VALUE2

Build-Umgebungsvariablen löschen

Sie können Build-Umgebungsvariablen für vorhandene Funktionen löschen.

gcloud

Wenn Sie Build-Umgebungsvariablen entfernen möchten, verwenden Sie die --remove-build-env-vars für vorhandene Funktionen:

gcloud beta run deploy SERVICE \
  --source . \
  --function FUNCTION_ENTRY_POINT \
  --remove-build-env-vars KEY1=VALUE1,KEY2=VALUE2

Alternativ können Sie Build-Umgebungsvariablen für vorhandene Funktionen mit --clear-build-env-vars löschen:

gcloud beta run deploy SERVICE \
  --source . \
  --function FUNCTION_ENTRY_POINT \
  --clear-build-env-vars KEY1=VALUE1,KEY2=VALUE2

Datei mit Build-Umgebungsvariablen

Sie verwenden eine Datei mit Build-Umgebungsvariablen für vorhandene Funktionen.

gcloud

So legen Sie Build-Umgebungsvariablen aus einer Datei fest:

gcloud beta run deploy SERVICE \
  --source . \
  --function FUNCTION_ENTRY_POINT \
  --build-env-vars-file FILE_NAME.yaml

Ersetzen Sie FILE_NAME.yaml, wenn der Inhalt der Datei so aussieht:

 KEY1: VALUE1
 KEY2: VALUE2