Docker-Image mit Cloud Build erstellen und per Push übertragen

Erfahren Sie mehr zu den ersten Schritten mit Cloud Build, indem Sie ein Docker-Image erstellen und das Image per Push an Artifact Registry übertragen. Artifact Registry bietet einen zentralen Speicherort für die Verwaltung von privaten Paketen und Docker-Container-Images.

Sie erstellen das Image mit einem Dockerfile, der Konfigurationsdatei von Docker, und generieren dann dasselbe Image mit der Build-Konfigurationsdatei von Cloud Build.

Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:

Anleitung

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Cloud Build, Compute Engine and Artifact Registry APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  6. Install the Google Cloud CLI.

  7. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  8. To initialize the gcloud CLI, run the following command: 

    gcloud init

  9. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  10. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  11. Verify that billing is enabled for your Google Cloud project.

  12. Enable the Cloud Build, Compute Engine and Artifact Registry APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  13. Install the Google Cloud CLI.

  14. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  15. To initialize the gcloud CLI, run the following command: 

    gcloud init

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Cloud Build-Dienstkonto zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen eines Docker-Images und zum Übertragen in Artifact Registry benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Quelldateien zum Erstellen vorbereiten

Zum Verpacken in ein Container-Image benötigen Sie Beispiel-Quellcode. In diesem Abschnitt erstellen Sie ein Shell-Skript und eine Dockerfile. Ein Dockerfile ist ein Textdokument, das Anweisungen für das Erstellen eines Images durch Docker enthält.

  1. Öffnen Sie ein Terminalfenster.

  2. Erstellen Sie ein neues Verzeichnis mit dem Namen quickstart-docker und rufen Sie dieses Verzeichnis auf:

    mkdir quickstart-docker
cd quickstart-docker

  3. Erstellen Sie eine Datei mit dem Namen quickstart.sh und mit folgendem Inhalt:

    #!/bin/sh
echo "Hello, world! The time is $(date)."

  4. Erstellen Sie eine Datei mit dem Namen Dockerfile und mit folgendem Inhalt:

    FROM alpine
COPY quickstart.sh /
CMD ["/quickstart.sh"]

  5. Führen Sie im Terminalfenster den folgenden Befehl aus, um quickstart.sh ausführbar zu machen:

    chmod +x quickstart.sh

Docker-Repository in Artifact Registry erstellen

  1. Verwenden Sie den Befehl gcloud artifacts repositories create, um ein Docker-Repository mit dem Namen quickstart-docker-repo am Speicherort us-west2 mit der Beschreibung „Docker repository“ zu erstellen:

    gcloud artifacts repositories create quickstart-docker-repo --repository-format=docker \
    --location=us-west2 --description="Docker repository"

  2. Prüfen Sie, ob das Repository erstellt wurde:

    gcloud artifacts repositories list

    Die Liste der angezeigten Repositories sollte quickstart-docker-repo enthalten.

    In Artifact Registry wird eine Namenskonvention verwendet, um Repositories und Images zu identifizieren. Wenn Sie beispielsweise mit Docker-Images interagieren, die in Artifact Registry in der Region us-west2 gespeichert sind, verwenden Sie us-west2-docker.pkg.dev als Registry-Hostname in Ihren Befehlen.

Image mit einem Dockerfile erstellen

Verwenden Sie den Befehl gcloud builds submit, um ein Docker-Image mit einem Dockerfile zu erstellen. Sie benötigen keine separate Cloud Build-Konfigurationsdatei.

  1. Ermitteln Sie Ihre Projekt-ID Google Cloud mit dem folgenden Befehl:

    gcloud config get-value project

  2. Führen Sie den folgenden Befehl in dem Verzeichnis aus, das quickstart.sh und Dockerfile enthält:

    gcloud builds submit --region=us-west2 --tag us-west2-docker.pkg.dev/PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1

    Nach Abschluss des Builds sollte die Ausgabe in etwa so aussehen:

    DONE
------------------------------------------------------------------------------------------------------------------------------------
ID                                    CREATE_TIME                DURATION  SOURCE   IMAGES     STATUS
545cb89c-f7a4-4652-8f63-579ac974be2e  2020-11-05T18:16:04+00:00  16S       gs://gcb-docs-project_cloudbuild/source/1604600163.528729-b70741b0f2d0449d8635aa22893258fe.tgz  us-west2-docker.pkg.dev/gcb-docs-project/quickstart-docker-repo/quickstart-image:tag1  SUCCESS

Sie haben nun mithilfe von Dockerfile ein Docker-Image mit dem Namen quickstart-image erstellt und das Image per Push an Artifact Registry übertragen.

Image mit einer Build-Konfigurationsdatei erstellen

In diesem Abschnitt verwenden Sie eine Cloud Build-Konfigurationsdatei, um dasselbe Docker-Image zu erstellen, das in den vorherigen Schritten erstellt wurde. Die Build-Konfigurationsdatei weist Cloud Build an, Aufgaben basierend auf Ihren Spezifikationen auszuführen.

  1. Erstellen Sie im selben Verzeichnis, das auch quickstart.sh und Dockerfile enthält, eine Datei mit dem Namen cloudbuild.yaml und dem folgenden Inhalt. Diese Datei ist Ihre Build-Konfigurationsdatei. Bei der Build-Erstellung ersetzt Cloud Build $PROJECT_ID automatisch durch Ihre Projekt-ID.

    steps:
- name: 'gcr.io/cloud-builders/docker'
  script: |
    docker build -t us-west2-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1 .
  automapSubstitutions: true
images:
- 'us-west2-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1'

  2. Starten Sie den Build mit dem folgenden Befehl:

    gcloud builds submit --region=us-west2 --config cloudbuild.yaml

    Nach Abschluss des Builds sollte die Ausgabe in etwa so aussehen:

     DONE
 ------------------------------------------------------------------------------------------------------------------------------------
 ID                                    CREATE_TIME                DURATION  SOURCE          IMAGES          STATUS
 046ddd31-3670-4771-9336-8919e7098b11  2020-11-05T18:24:02+00:00  15S       gs://gcb-docs-project_cloudbuild/source/1604600641.576884-8153be22c94d438aa86c78abf11403eb.tgz  us-west2-docker.pkg.dev/gcb-docs-project/quickstart-docker-repo/quickstart-image:tag1  SUCCESS

Sie haben mithilfe der Build-Konfigurationsdatei gerade quickstart-image erstellt und das Image per Push an Artifact Registry übertragen.

Build-Details ansehen

  1. Öffnen Sie in der Google Cloud Console die Seite „Cloud Build“.

    Zur Seite "Cloud Build"

  2. Wählen Sie bei Bedarf Ihr Projekt aus und klicken Sie auf Öffnen.

    Sie sehen die Seite Build-Verlauf:

    Screenshot der Seite "Build-Verlauf"

  3. Wählen Sie bei Bedarf im Drop-down-Menü Region die Option us-west2 aus, um die Builds in dieser Region aufzurufen.

    Es werden zwei Builds aufgeführt, einer für jeden Build, den Sie in dieser Kurzanleitung ausgeführt haben.

  4. Klicken Sie auf einen der Builds.

    Es wird die Seite Build-Details angezeigt.

  5. Klicken Sie unter Build-Zusammenfassung auf Build-Artefakte, um sich die Artefakte Ihres Builds anzeigen zu lassen.

    Die Ausgabe sollte in etwa so aussehen:

    Grafik: Screenshot von Build-Artefakten

    Auf dieser Seite können Sie Ihr Build-Log herunterladen und die Image-Details in Artifact Registry aufrufen.

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud -Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden:

  1. Öffnen Sie in der Google Cloud Console die Seite „Artifact Registry“.

    Seite „Artifact Registry“ öffnen

  2. Wählen Sie Ihr Projekt aus und klicken Sie auf Öffnen.

  3. Wählen Sie quickstart-docker-repo aus.

  4. Klicken Sie auf Löschen.

Sie haben nun das Repository, das Sie im Rahmen dieser Kurzanleitung erstellt haben, gelöscht.

Nächste Schritte