Container erstellen

Cloud Run akzeptiert Container-Images, die mit einem beliebigen Tool erstellt wurden, das Container-Images erstellen kann, solange diese den Containervertrag berücksichtigen. Insbesondere muss Ihr Code den mit der Umgebungsvariable PORT definierten Port auf HTTP-Anfragen überwachen. Diese Umgebungsvariable PORT wird von Cloud Run automatisch in Ihren Container eingefügt.

Auf dieser Seite werden mehrere Möglichkeiten zum Erstellen von Container-Images beschrieben:

  • Dockerfile verwenden
  • Buildpacks verwenden

Mit einem Dockerfile erstellen

Bevor Sie Ihre Quellen mit Docker oder mit Cloud Build in ein Container-Image verpacken („containerisieren“), benötigen Sie zusätzlich ein Dockerfile. Die Hello World-Beispiele enthalten Beispielanwendungen und Dockerfiles in vielen gängigen Sprachen.

Wenn Sie Dockerfiles verwenden, können Sie eine der folgenden Methoden zum Erstellen nutzen:

  • Mit Cloud Build erstellen
  • Lokal mit Docker erstellen

Mit Cloud Build erstellen

Sie können das Image mithilfe von Cloud Build in Google Cloud erstellen:

  1. Öffnen Sie den Ordner, der die Quellen und das Dockerfile enthält.

  2. Führen Sie diesen Befehl aus:

    gcloud builds submit --tag 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 REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.

Tipps zur Optimierung der Build-Leistung finden Sie unter Builds beschleunigen.

Lokal erstellen und mit Docker per Push übertragen

Wenn Sie Docker lokal installiert haben, können Sie docker build anstelle von Cloud Build oder Buildpacks verwenden.

So erstellen Sie Container-Image mit Docker:

  1. Öffnen Sie den Ordner, der die Quellen und das Dockerfile enthält.

  2. Führen Sie diesen Befehl aus:

    docker build . --tag 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 REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.

  3. Wenn Docker noch nicht dafür konfiguriert ist, Anfragen an die Container Registry mithilfe der Google Cloud CLI zu authentifizieren, holen Sie dies jetzt mit folgendem Befehl nach:

    gcloud auth configure-docker

    Dieser Schritt ist erforderlich, damit Docker Images per Push oder Pull übertragen kann. Die Konfiguration ist nur einmal notwendig.

  4. Übertragen Sie das Container-Image per Push an eine unterstützte Container-Registry:

    docker push 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 REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.

Wie Sie lokale Dateien von diesem Prozess ausschließen entnehmen Sie der Anleitung in der Konfigurationsdatei .dockerignore.

Mit den Buildpacks von Google Cloud erstellen

Google Cloud Buildpacks sind eine Reihe von CNCF-kompatiblen Buildpacks, die Quellcode in Container-Images erzeugen, die für die Ausführung auf Google Cloud-Containerplattformen, einschließlich Cloud Run, entwickelt wurden.

Eine Liste der unterstützten Sprachen finden Sie in der Buildpacks-Dokumentation von Google Cloud.

Mit Buildpacks von Google Cloud mithilfe von Cloud Build erstellen

So erstellen Sie mit den Buildpacks von Google Cloud:

  1. Öffnen Sie den Ordner, der die Quellen enthält.

  2. Führen Sie diesen Befehl aus:

    gcloud builds submit --pack image=IMAGE_URL

    Ersetzen Sie IMAGE_URL durch die Container-Image-URL, z. B. gcr.io/myproject/myservice.

  3. Warten Sie, bis der Build abgeschlossen ist.

Mit den Buildpacks von Google Cloud über die pack-Befehlszeile erstellen

So erstellen Sie mit dem pack-Befehl:

  1. Installieren Sie Docker, falls noch nicht geschehen.

  2. Wenn Docker noch nicht dafür konfiguriert ist, Anfragen an die Container Registry mithilfe der Google Cloud CLI zu authentifizieren, holen Sie dies jetzt mit folgendem Befehl nach:

    gcloud auth configure-docker

    Dieser Schritt ist erforderlich, damit Docker Images per Push oder Pull übertragen kann. Die Konfiguration ist nur einmal notwendig.

  3. Installieren Sie pack, falls noch nicht geschehen.

  4. Öffnen Sie den Ordner, der die Quellen enthält.

  5. Führen Sie den folgenden Befehl aus, um einen Build zu erstellen und per Push in die Container Registry zu übertragen:

    pack build --publish 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 REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG.

  6. Warten Sie, bis pack abgeschlossen ist.

Weitere Informationen finden Sie in der Anleitung unter Anwendung erstellen.

Nächste Schritte