Cloud Run-Dienst lokal testen

Docker

So testen Sie das Container-Image lokal mit Docker:

1. Verwenden Sie den Docker-Befehl:

   PORT=8080 && docker run -p 9090:${PORT} -e PORT=${PORT} IMAGE_URL

   Ersetzen Sie IMAGE_URL durch einen Verweis auf das Container-Image, z. B. us-docker.pkg.dev/cloudrun/container/hello:latest. Wenn Sie Artifact Registry verwenden, muss das Repository REPO_NAME bereits erstellt sein. Die URL hat die Form LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.

   Die Umgebungsvariable PORT gibt den Port an, über den die Anwendung HTTP- oder HTTPS-Anfragen empfängt. Dies ist eine Anforderung des Containerlaufzeitvertrags. In diesem Beispiel verwenden wir Port 8080.

2. Öffnen Sie im Browser http://localhost:9090.

Wenn Sie zum ersten Mal mit Containern arbeiten, sollten Sie die Einführung in Docker lesen. Weitere Informationen zu Docker-Befehlen finden Sie in der Docker-Dokumentation.

Docker mit Google Cloud Access

Wenn Sie die Google Cloud-Clientbibliotheken verwenden, um Ihre Anwendung in Google Cloud-Dienste zu integrieren, und diese Dienste noch nicht zur Steuerung des externen Zugriffs gesichert haben, können Sie Ihren lokalen Container für die Authentifizierung bei Google Cloud-Diensten mit Standardanmeldedaten für Anwendungen einrichten.

Gehen Sie zum lokalen Ausführen so vor:

1. Wie Sie die Anmeldedaten Ihres Dienstkontos generieren, abrufen und konfigurieren, erfahren Sie unter Erste Schritte bei der Authentifizierung.

2. Mit den folgenden Docker-Ausführungsflags werden die Anmeldedaten und die Konfiguration des lokalen Systems in den lokalen Container eingefügt:

   1. Verwenden Sie das Flag --volume (-v), um die Datei mit den Anmeldedaten in den Container einzufügen. Dabei wird vorausgesetzt, dass Sie auf Ihrer Maschine bereits die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS festgelegt haben:

      -v $GOOGLE_APPLICATION_CREDENTIALS:/tmp/keys/FILE_NAME.json:ro

   2. Verwenden Sie das Flag --environment (-e), um die Variable GOOGLE_APPLICATION_CREDENTIALS im Container festzulegen:

      -e GOOGLE_APPLICATION_CREDENTIALS=/tmp/keys/FILE_NAME.json

3. Optional können Sie diesen vollständig konfigurierten run-Befehl von Docker verwenden:

   PORT=8080 && docker run \
   -p 9090:${PORT} \
   -e PORT=${PORT} \
   -e K_SERVICE=dev \
   -e K_CONFIGURATION=dev \
   -e K_REVISION=dev-00001 \
   -e GOOGLE_APPLICATION_CREDENTIALS=/tmp/keys/FILE_NAME.json \
   -v $GOOGLE_APPLICATION_CREDENTIALS:/tmp/keys/FILE_NAME.json:ro \
   IMAGE_URL

   Beachten Sie, dass der im obigen Beispiel aufgeführte Pfad

   /tmp/keys/FILE_NAME.json

   gut geeignet ist, um Ihre Anmeldedaten im Container zu platzieren.

   Sie können aber auch ein anderes Verzeichnis verwenden. Wichtig ist, dass die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS mit dem gebundenen Bereitstellungsspeicherort im Container übereinstimmt.

   Beachten Sie auch, dass Sie bei einigen Google Cloud-Diensten möglicherweise eine alternative Konfiguration verwenden sollten, um die lokale Fehlerbehebung von der Produktionsleistung und den Daten zu isolieren.

Cloud Code-Emulator

Mit dem Cloud Code-Plug-in für VS Code und mit JetBrains-IDEs können Sie Ihr Container-Image lokal in einem Cloud Run-Emulator in Ihrer IDE ausführen und dabei Fehler beheben. Der Emulator bietet die Möglichkeit, eine Umgebung zu konfigurieren, die für Ihren Dienst in Cloud Run typisch ist.

Sie können Attribute wie CPU- und Arbeitsspeicherzuweisung konfigurieren, Umgebungsvariablen angeben und Cloud SQL-Datenbankverbindungen festlegen.

1. Installieren Sie Cloud Code für VS Code oder eine JetBrains-IDE.
2. Folgen Sie der Anleitung für die lokale Entwicklung und Fehlerbehebung in Ihrer IDE.
3. VS Code: Lokal entwickeln und Fehler beheben
4. IntelliJ: Lokal entwickeln und Fehler beheben

gcloud-CLI

Google Cloud CLI enthält eine lokale Entwicklungsumgebung, um Cloud Run zu emulieren, das einen Container aus der Quelle erstellen, den Container auf Ihrem lokalen Computer ausführen und den Container nach Änderungen der Quelle automatisch neu erstellen kann.

So starten Sie die lokale Entwicklungsumgebung:

1. Wechseln Sie in das Verzeichnis, das den Quellcode Ihres Dienstes enthält.

2. Rufen Sie den Befehl auf:

   gcloud beta code dev

   Wenn im lokalen Verzeichnis ein Dockerfile vorhanden ist, wird es zum Erstellen des Containers verwendet. Wenn kein Dockerfile vorhanden ist, wird der Container mit den Buildpacks von Google Cloud erstellt.

Rufen Sie http://localhost:8080/ in Ihrem Browser auf, um den Dienst zu sehen. Wenn Sie einen benutzerdefinierten Port mit der Option --local-port angegeben haben, müssen Sie den Port in Ihrem Browser öffnen.

So beenden Sie den lokalen Server:

• Mac OS und Linux: Control + C
• Windows: Strg + Pause

Dienstkonfiguration anpassen

Sie können die Cloud Run-Konfiguration des lokal ausgeführten Dienstes mithilfe einer YAML-Datei anpassen. Das YAML-Format ist dasselbe, das zum Bereitstellen eines Cloud Run-Dienstes verwendet werden kann, aber nur einen Teil der Cloud Run-Diensteinstellungen unterstützt. gcloud beta code dev sucht und verwendet jede Datei, die im aktuellen Verzeichnis auf *.service.dev.yaml endet. Wenn keine gefunden werden, wird eine beliebige Datei verwendet, die mit *.service.yaml endet.

Sie können die folgenden Einstellungen für die lokale Entwicklung konfigurieren:

• Umgebungsvariablen
• Containerspeicherlimits
• Container-CPU-Limits
• Dienstname
• Dienstkonten

Das Feld image des Containers ist für die lokale Entwicklung nicht erforderlich, da das Image erstellt und für den Dienst bereitgestellt wird, wenn der Befehl ausgeführt wird.

Sie können die folgende Beispieldatei service.dev.yaml für die lokale Entwicklung verwenden:

  apiVersion: serving.knative.dev/v1
  kind: Service
  metadata:
    name: my-service-name
  spec:
    template:
      spec:
        containers:
        - env:
          - name: FOO
            value: bar

Mit Anmeldedaten testen

Wenn Sie dem Container die Berechtigung zur Verwendung von Google Cloud-Diensten erteilen möchten, müssen Sie dem Container Zugriffsdaten geben.

• Wenn Sie dem Container mit Ihrem eigenen Konto Zugriff auf Anmeldedaten gewähren möchten, melden Sie sich mit gcloud an und verwenden Sie das Flag --application-default-credential:

  gcloud auth application-default login
  gcloud beta code dev --dockerfile=PATH_TO_DOCKERFILE --application-default-credential

• Verwenden Sie das Flag --service-account, um der Anwendung Anmeldedaten als Dienstkonto zu geben:

  gcloud beta code dev --dockerfile=PATH_TO_DOCKERFILE --service-account=SERVICE_ACCOUNT_EMAIL

  Das Flag --service-account bewirkt, dass ein Dienstkontoschlüssel lokal heruntergeladen und im Cache gespeichert wird. Der Nutzer ist verantwortlich für die Sicherheit des Schlüssels und den Löschvorgang, wenn er nicht mehr benötigt wird.

Docker

Wenn Sie bestätigen möchten, dass der Code lokal in der Google Cloud CLI ausgeführt wird, können Sie versuchen, die Umgebungsvariable K_REVISION abzufragen. Da sie jedoch nicht festgelegt wurde, ist kein Wert vorhanden.

Docker mit Google Cloud Access

Wenn Sie die genauen Werte aus dem obigen Abschnitt in Schritt 3 verwendet haben, um zu bestätigen, dass Sie Ihren Code lokal in der Google Cloud CLI ausführen, können Sie die Umgebungsvariable K_REVISION abfragen und nach dem Wert dev-00001 suchen, um zu bestätigen, dass er lokal ausgeführt wird.

Cloud Code-Emulator

Wenn Sie bestätigen möchten, dass der Code lokal in Cloud Code ausgeführt wird, können Sie die Umgebungsvariable K_REVISION abfragen und nach dem Wert local suchen, um zu bestätigen, dass er lokal ausgeführt wird.

gcloud-CLI

Wenn Sie bestätigen möchten, dass der Code lokal in der Google Cloud CLI ausgeführt wird, können Sie die Umgebungsvariable K_REVISION abfragen und nach einem Wert suchen, der mit dev- beginnt, um zu bestätigen, dass er lokal ausgeführt wird.