Container-Images erstellen

Auf dieser Seite wird beschrieben, wie Cloud Build konfiguriert wird, um Docker-Images zu erstellen und zu speichern. Wenn Sie Cloud Build noch nicht kennen, lesen Sie zuerst die Kurzanleitungen sowie die Übersicht über die Build-Konfiguration.

Cloud Build bietet vordefinierte Images, auf die Sie in einer Cloud Build-Konfigurationsdatei verweisen können, um Ihre Aufgaben auszuführen. Diese Images werden von Google Cloud unterstützt und verwaltet. Sie können das unterstützte, vordefinierte Docker-Image verwenden, um Docker-Befehle auszuführen und Docker-Images zu erstellen.

Hinweis

Die Anleitung auf dieser Seite setzt voraus, dass Sie mit Docker vertraut sind. Außerdem gilt:

• Halten Sie Ihren Anwendungsquellcode zusammen mit dem Dockerfile bereit.
• Wenn Sie die auf dieser Seite angegebenen gcloud-Befehle verwenden möchten, müssen Sie das gcloud-Befehlszeilentool installieren.
• Wenn Sie die Images ausführen möchten, installieren Sie Docker.

Mit einer Build-Konfigurationsdatei erstellen

So erstellen Sie Ihr Docker-Image mit einer Build-Konfigurationsdatei:

1. Erstellen Sie in dem Verzeichnis, das den Quellcode Ihrer Anwendung enthält, eine Datei mit dem Namen cloudbuild.yaml oder cloudbuild.json.

2. In der Build-Konfigurationsdatei:

   • Fügen Sie ein name-Feld hinzu und geben Sie das vordefinierte Docker-Image an. Das vordefinierte Image ist in der Container Registry unter gcr.io/cloud-builders/docker gespeichert. In der Beispielkonfigurationsdatei unten gibt das Feld name an, dass das vordefinierte Docker-Image von Cloud Build zum Ausführen der im Feld args angegebenen Aufgabe verwendet wird.

   • Fügen Sie im Feld args die Argumente zum Erstellen des Images hinzu.

     YAML

     steps:
     - name: 'gcr.io/cloud-builders/docker'
       args: [ 'build', '-t', 'gcr.io/PROJECT_ID/IMAGE_NAME', '.' ]
     

     JSON

     {
      "steps": [
       {
           "name": "gcr.io/cloud-builders/docker",
           "args": [
             "build",
             "-t",
             "gcr.io/PROJECT_ID/IMAGE_NAME",
             "."
            ]
        }
        ]
      }
     

     Ersetzen Sie die Platzhalterwerte in der obigen Build-Konfiguration durch Folgendes:

     • PROJECT_ID: Ihre Cloud-Projekt-ID
     • IMAGE_NAME ist der Name Ihres Container-Images.

     Wenn sich Dockerfile und Quellcode in verschiedenen Verzeichnissen befinden, fügen Sie der Liste der Argumente im Feld args den Pfad -f und den Pfad zu Dockerfile hinzu:

     YAML

     steps:
     - name: 'gcr.io/cloud-builders/docker'
       args: [ 'build', '-t', 'gcr.io/PROJECT_ID/IMAGE_NAME', '-f', 'DOCKERFILE_PATH', '.' ]
     

     JSON

     {
      "steps": [
       {
           "name": "gcr.io/cloud-builders/docker",
           "args": [
             "build",
             "-t",
             "gcr.io/PROJECT_ID/IMAGE_NAME", '-f', 'DOCKERFILE_PATH', "."
            ]
        }
        ]
      }
     

     Ersetzen Sie die Platzhalterwerte in der obigen Build-Konfiguration durch Folgendes:

     • PROJECT_ID: Ihre Cloud-Projekt-ID
     • IMAGE_NAME ist der Name Ihres Container-Images.
     • DOCKERFILE_PATH: Pfad zu Ihrem Dockerfile

3. Starten Sie mit der Build-Konfigurationsdatei den Build:

   gcloud builds submit --config CONFIG_FILE_PATH SOURCE_DIRECTORY
   

   Ersetzen Sie die Platzhalterwerte im obigen Befehl durch Folgendes:

   • CONFIG_FILE_PATH: der Pfad zur Build-Konfigurationsdatei
   • SOURCE_DIRECTORY: der Pfad oder URL zum Quellcode

   Wenn Sie CONFIG_FILE_PATH und SOURCE_DIRECTORY im Befehl gcloud builds submit nicht angeben, geht Cloud Build davon aus, dass sich die Konfigurationsdatei und der Quellcode im aktuellen Arbeitsverzeichnis befinden.

Mit einem Dockerfile erstellen

Mit Cloud Build können Sie ein Docker-Image mithilfe nur eines Dockerfile erstellen. Sie benötigen keine separate Build-Konfigurationsdatei.

Führen Sie zum Erstellen mit einem Dockerfile den folgenden Befehl aus dem Verzeichnis aus, das Ihren Quellcode und das Dockerfile enthält:

    gcloud builds submit --tag gcr.io/PROJECT_ID/IMAGE_NAME

Ersetzen Sie die Platzhalterwerte im obigen Befehl durch Folgendes:

• PROJECT_ID: Ihre Cloud-Projekt-ID
• IMAGE_NAME ist der Name Ihres Container-Images.

Mit Cloud Native Buildpacks erstellen

Mit Cloud Build können Sie ein Image ohne Dockerfile oder Build-Konfigurationsdatei erstellen. Sie können dazu Cloud Native Buildpacks verwenden.

Führen Sie zum Erstellen mit Buildpacks den folgenden Befehl im Verzeichnis aus, das Ihren Quellcode enthält:

    gcloud builds submit --pack builder=BUILDPACK_BUILDER, \
        env=ENVIRONMENT_VARIABLE, \
        image=IMAGE

Ersetzen Sie die Platzhalterwerte in den obigen Befehlen durch Folgendes:

• BUILDPACK_BUILDER: Der zu verwendende Buildpacks-Builder. Wenn Sie keinen Builder angeben, verwendet Cloud Build standardmäßig gcr.io/buildpacks/builder.
• ENVIRONMENT_VARIABLE: Alle Umgebungsvariablen für Ihren Build.
• IMAGE: Die URL des Images in Container Registry. Der Image-Name muss sich in den Namespaces gcr.io/ oder pkg.dev befinden.

Hier einige Beispielbefehle:

• Build mit dem Standard-gcr.io/buildpacks/builder ausführen, um das Image gcr.io/gcb-docs-project/hello zu erstellen:

    gcloud alpha builds submit --pack image=gcr.io/gcb-docs-project/hello
  

• Mehrere Umgebungsvariablen werden mit ^--^ als Trennzeichen an Ihren Build übergeben. Weitere Informationen zum Maskieren von Argumenten finden Sie unter gcloud topic escaping.

    gcloud builds submit --pack \
        ^--^image=gcr.io/my-project/myimage--env=GOOGLE_ENTRYPOINT='java -jar target/myjar.jar',GOOGLE_RUNTIME_VERSION='3.1.301'
  

Images in Container Registry speichern

Sie können Cloud Build zum Speichern Ihres erstellten Images auf eine der folgenden Arten konfigurieren:

• Mithilfe des images-Felds, das das Image nach Abschluss des Builds in Container Registry speichert
• Mithilfe des docker push-Befehls, der das Image als Teil des Build-Ablaufs in Container Registry speichert

Der Unterschied zwischen der Verwendung des Feldes images und des Docker-Befehls push besteht darin, dass mit dem Feld images das gespeicherte Image in den Build-Ergebnissen angezeigt wird. Dazu gehören die Seite Build-Beschreibung für einen Build in der Cloud Console sowie die Ergebnisse von Build.get() und von gcloud builds list. Wenn Sie dagegen das Build-Image mit dem Docker-Befehl push speichern, wird das Image nicht in den Build-Ergebnissen angezeigt.

Wenn Sie das Image als Teil Ihres Build-Ablaufs speichern und in den Build-Ergebnissen anzeigen lassen möchten, verwenden Sie sowohl den Docker-Befehl push als auch das images-Feld in Ihrer Build-Konfigurationsdatei.

So speichern Sie ein Container-Image in Container Registry, nachdem der Build abgeschlossen ist:

1. Erstellen Sie in dem Verzeichnis, das den Quellcode Ihrer Anwendung und das Dockerfile enthält, eine Datei mit dem Namen cloudbuild.yaml oder cloudbuild.json.

2. Fügen Sie Ihrer Build-Konfigurationsdatei einen Build-Schritt hinzu, um ein Image zu erstellen, und fügen Sie dann ein images-Feld hinzu, das das erstellte Image angibt. Dadurch wird das Image in Container Registry gespeichert. Das folgende Snippet zeigt eine Build-Konfiguration, um ein Image zu erstellen und in Container Registry zu speichern:

   YAML

   steps:
   - name: 'gcr.io/cloud-builders/docker'
     args: ['build', '-t', 'gcr.io/PROJECT_ID/IMAGE_NAME', '.']
   images: ['gcr.io/PROJECT_ID/IMAGE_NAME']
   

   JSON

   {
   "steps": [
   {
       "name": "gcr.io/PROJECT_ID/IMAGE_NAME",
       "args": [
           "build",
           "-t",
           "gcr.io/PROJECT_ID/IMAGE_NAME",
           "."
       ]
   }
   ],
   "images": [
       "gcr.io/PROJECT_ID/IMAGE_NAME"
   ]
   }
   

   Dabei gilt:

   • PROJECT_ID ist die ID Ihres Cloud-Projekts.
   • IMAGE_NAME ist der Name Ihres Container-Images.

3. Starten Sie mit der Build-Konfigurationsdatei den Build:

   gcloud builds submit --config CONFIG_FILE_PATH SOURCE_DIRECTORY
   

   Dabei gilt:

   • CONFIG_FILE_PATH ist der Pfad zur Build-Konfigurationsdatei.
   • SOURCE_DIRECTORY ist der Pfad oder die URL zum Quellcode.

So speichern Sie das Image als Teil Ihres Build-Ablaufs in Container Registry:

1. Erstellen Sie in dem Verzeichnis, das den Quellcode Ihrer Anwendung und das Dockerfile enthält, eine Datei mit dem Namen cloudbuild.yaml oder cloudbuild.json.

2. Fügen Sie der Build-Konfigurationsdatei einen docker-Build-Schritt hinzu, um ein Image zu erstellen, fügen Sie dann einen weiteren docker-Build-Schritt hinzu und übergeben Sie Argumente, um den push-Befehl aufzurufen:

   YAML

   steps:
   - name: 'gcr.io/cloud-builders/docker'
     args: ['build', '-t', 'gcr.io/PROJECT_ID/IMAGE_NAME', '.']
   - name: 'gcr.io/cloud-builders/docker'
     args: ['push', 'gcr.io/PROJECT_ID/IMAGE_NAME']
   

   JSON

   {
     "steps": [
      {
         "name": "gcr.io/cloud-builders/docker",
         "args": [
             "build",
             "-t",
             "gcr.io/PROJECT_ID/IMAGE_NAME",
             "."
          ]
      },
      {
          "name": "gcr.io/cloud-builders/docker",
          "args": [
             "push",
             "gcr.io/PROJECT_ID/IMAGE_NAME"
           ]
      }
     ]
   }
   

   Dabei gilt:

   • PROJECT_ID ist die ID Ihres Cloud-Projekts.
   • IMAGE_NAME ist der Name Ihres Container-Images.

3. Starten Sie mit der Build-Konfigurationsdatei den Build:

   gcloud builds submit --config CONFIG_FILE_PATH SOURCE_DIRECTORY
   

   Dabei gilt:

   • CONFIG_FILE_PATH ist der Pfad zur Build-Konfigurationsdatei.
   • SOURCE_DIRECTORY ist der Pfad oder die URL zum Quellcode.

So speichern Sie ein Image als Teil des Build-Ablaufs und sorgen dafür, dass es in den Build-Ergebnissen angezeigt wird:

1. Erstellen Sie in dem Verzeichnis, das den Quellcode Ihrer Anwendung und das Dockerfile enthält, eine Datei mit dem Namen cloudbuild.yaml oder cloudbuild.json.

2. Fügen Sie der Build-Konfigurationsdatei nach dem Schritt, mit dem das Image erstellt wird, einen Schritt hinzu, um den Docker-Befehl push aufzurufen, und fügen Sie dann das Feld images hinzu:

   YAML

   steps:
   - name: 'gcr.io/cloud-builders/docker'
     args: ['build', '-t', 'gcr.io/PROJECT_ID/IMAGE_NAME', '.']
   - name: 'gcr.io/cloud-builders/docker'
     args: ['push', 'gcr.io/PROJECT_ID/IMAGE_NAME']
   images: ['gcr.io/PROJECT_ID/IMAGE_NAME']
   

   JSON

   {
       "steps": [
      {
          "name": "gcr.io/cloud-builders/docker",
          "args": [
              "build",
              "-t",
              "gcr.io/PROJECT_ID/IMAGE_NAME",
              "."
           ]
      },
      {
          "name": "gcr.io/cloud-builders/docker",
          "args": [
              "push",
              "gcr.io/PROJECT_ID/IMAGE_NAME"
           ]
      }
      ],
       "images": [
          "gcr.io/PROJECT_ID/IMAGE_NAME"
       ]
   }
   

   Dabei gilt:

   • PROJECT_ID ist die ID Ihres Cloud-Projekts.
   • IMAGE_NAME ist der Name Ihres Container-Images.

3. Starten Sie mit der Build-Konfigurationsdatei den Build:

   gcloud builds submit --config CONFIG_FILE_PATH SOURCE_DIRECTORY
   

   Dabei gilt:

   • CONFIG_FILE_PATH ist der Pfad zur Build-Konfigurationsdatei.
   • SOURCE_DIRECTORY ist der Pfad oder die URL zum Quellcode.

Docker-Image ausführen

Sie können überprüfen, ob das von Ihnen erstellte Image wie erwartet funktioniert, indem Sie es mit Docker ausführen.

1. Konfigurieren Sie Docker so, dass die Anmeldedaten von Container Registry für die Interaktion mit Container Registry verwendet werden (Sie müssen dies nur einmal tun):

   gcloud auth configure-docker
   

   Es kann eine Meldung wie die folgende angezeigt werden:

   The following settings will be added to your Docker config file
   located at [/.docker/config.json]:
   
   {
     "credHelpers": {
       "gcr.io": "gcloud",
       "us.gcr.io": "gcloud",
       "eu.gcr.io": "gcloud",
       "asia.gcr.io": "gcloud",
       "staging-k8s.gcr.io": "gcloud",
       "marketplace.gcr.io": "gcloud"
     }
   }
   
   Do you want to continue (Y/n)?
   

2. Geben Sie y ein und drücken Sie die Eingabetaste.

3. Führen Sie das zuvor erstellte Docker-Image aus, wobei PROJECT_ID die Cloud-Projekt-ID ist:

   docker run gcr.io/PROJECT_ID/IMAGE_NAME
   

   Die Ausgabe sollte in etwa so aussehen:

   Hello, world! The time is Fri Feb  2 16:09:54 UTC 2018.
   

Nächste Schritte

• Go-Anwendungen erstellen
• Build-Artefakte in Cloud Storage speichern
• Build-Artefakte in Artifact Registry speichern