クイックスタート: ビルド

このページでは、Cloud Build を使用して Docker イメージをビルドし、そのイメージを Artifact Registry に push する方法について説明します。Artifact Registry は、パッケージと Docker コンテナイメージを 1 か所で管理できる場所として機能します。

まず、Docker 構成ファイルの Dockerfile を使用してイメージをビルドし、次に Cloud Build 構成ファイルを使用して同じイメージをビルドします。

始める前に

Google アカウントにログインします。
Google アカウントをまだお持ちでない場合は、新しいアカウントを登録します。

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

注: この手順で作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。

[プロジェクトの選択] ページに移動

Cloud プロジェクトに対して課金が有効になっていることを確認します。プロジェクトに対して課金が有効になっていることを確認する方法を学習する。

Cloud Build, Artifact Registry API を有効にします。
API を有効にする

Cloud SDK をインストールして初期化します。

ソースファイルの準備

コンテナイメージにパッケージ化するには、サンプルのソースコードが必要です。このセクションでは、簡単なシェルスクリプトと Dockerfile を作成します。Dockerfile は、Docker がイメージを作成するための指示を含むテキストドキュメントです。

ターミナルウィンドウを開きます。
quickstart-docker という名前で新しいディレクトリを作成し、そのディレクトリに移動します。
```
mkdir quickstart-docker
cd quickstart-docker
```
次の内容のファイルを quickstart.sh という名前で作成します。

GitHub で表示
```
echo "Hello, world! The time is $(date)."
```
次の内容のファイルを Dockerfile という名前で作成します。

GitHub で表示
```
FROM alpine
COPY quickstart.sh /
CMD ["/quickstart.sh"]
```
次のコマンドを実行して、quickstart.sh を実行可能にします。
```
chmod +x quickstart.sh
```

Artifact Registry で Docker リポジトリを作成する

場所 us-central1 に「Docker repository」という説明の付いた quickstart-docker-repo という新しい Docker リポジトリを作成します。
```
gcloud artifacts repositories create quickstart-docker-repo --repository-format=docker \
    --location=us-central1 --description="Docker repository"
```
リポジトリが作成されたことを確認します。
```
gcloud artifacts repositories list
```

Dockerfile によるビルド

Cloud Build で、Docker イメージを Dockerfile を使用してビルドできます。個別の Cloud Build 構成ファイルは不要です。

Dockerfile を使用してビルドするには:

次のコマンドを実行して、Cloud プロジェクト ID を取得します。
```
gcloud config get-value project
```
quickstart.sh と Dockerfile を含むディレクトリから次のコマンドを実行します。ここで、project-id は Cloud プロジェクト ID です。
```
gcloud builds submit --tag us-central1-docker.pkg.dev/project-id/quickstart-docker-repo/quickstart-image:tag1
```
注: プロジェクト ID にコロンが含まれている場合は、コロンをスラッシュに置き換えます。

ビルドが完了すると、次のような出力が表示されます。

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-central1-docker.pkg.dev/gcb-docs-project/quickstart-docker-repo/quickstart-image:tag1  SUCCESS

Dockerfile で、quickstart-image という名前の Docker イメージをビルドしました。このイメージを Artifact Registry に push します。

ビルド構成ファイルによるビルド

このセクションでは、Cloud Build 構成ファイルを使用して、上記と同じ Docker イメージを作成します。ビルド構成ファイルは、指定した内容に基づいてタスクを実行するよう Cloud Build に指示します。

quickstart.sh と Dockerfile があるディレクトリに、cloudbuild.yaml という名前のファイルを作成します。このファイルには以下を含めます。このファイルがビルド構成ファイルです。ビルド時に、Cloud Build が自動的に $PROJECT_ID をプロジェクト ID に置き換えます。

GitHub で表示
```
steps:
- name: 'gcr.io/cloud-builders/docker'
  args: [ 'build', '-t', 'us-central1-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1', '.' ]
images:
- 'us-central1-docker.pkg.dev/$PROJECT_ID/quickstart-docker-repo/quickstart-image:tag1'
```
次のコマンドを実行してビルドを開始します。
```
gcloud builds submit --config cloudbuild.yaml
```

ビルドが完了すると、次のような出力が表示されます。

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-central1-docker.pkg.dev/gcb-docs-project/quickstart-docker-repo/quickstart-image:tag1  SUCCESS

ビルド構成ファイルを使用して quickstart-image をビルドし、イメージを Artifact Registry に push しました。

ビルドの詳細の表示

Google Cloud Console で Cloud Build ページを開きます。

Cloud Build ページを開く
プロジェクトを選択し、[開く] をクリックします。

[ビルド履歴] ページが表示されます。
特定のビルドをクリックします。

[ビルドの詳細] ページが表示されます。
ビルドのアーティファクトを表示するには、[ビルドの概要] で [ビルドアーティファクト] をクリックします。

出力は次のようになります。

このページから、ビルドログをダウンロードして、Artifact Registry でイメージの詳細を表示できます。

クリーンアップ

このクイックスタートで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の手順を行います。

Google Cloud Console で Artifact Registry ページを開きます。

Artifact Registry ページを開きます。
プロジェクトを選択し、[開く] をクリックします。
[quickstart-docker-repo] を選択します。
[削除] をクリックします。

このクイックスタートで作成したリポジトリの削除は完了です。

これでクイックスタートの演習はすべて終了です。