コンテナに関数を作成する

Cloud Run は関数の直接デプロイをサポートしていますが、Google Cloud の Buildpack を使用して関数をコンテナ イメージにビルドし、このコンテナ イメージを Cloud Run にデプロイすることもできます。

関数をコンテナにビルドする一般的なユースケースには、次のようなものがあります。

• 継続的インテグレーションと継続的デリバリー: デベロッパーが関数コードを作成してソース リポジトリに push すると、CI / CD システムが関数をコンテナに自動的にビルドし、テストを実行して、ステージング環境に自動的にデプロイします。
• Infrastructure as Code: YAML または Terraform を使用して管理される Cloud Run リソースは、コンテナ イメージの URL を参照します。デベロッパーが記述した関数コードは、コンテナ イメージにビルドする必要があります。

このページでは、次の 2 つの方法で Cloud Run functions のビルドプロセスを正確に複製する方法について説明します。

• pack CLI を使用する
• リモート ビルドシステムとして Cloud Build を使用する

関数のエントリ ポイント

Buildpack を使用して関数を作成する手順は以下のとおりです。

• Functions Framework ライブラリを組み込みます。

• GOOGLE_FUNCTION_TARGET 環境変数に、エントリポイントとして使用する関数の名前を設定します。これを行うには、ソースコードと同じフォルダに project.toml を含めます。project.toml ファイルは、次の構成でなければなりません。

[[build.env]]
    name = "GOOGLE_FUNCTION_TARGET"
    value =  "ENTRY_POINT"

ENTRY_POINT は、関数メソッドに置き換えます。

Cloud Run functions で環境変数を使用する方法については、Cloud Run functions サービスを構成するをご覧ください。

ビルダー

Cloud Run functions は、Google Cloud の Buildpack で管理され、公開されているベースイメージ上に作成されます。

ビルダーは、Buildpack とオペレーティング システム パッケージ（スタック）で構成されるイメージです。ビルダーは、関数のソースコードを実行中のコンテナに変換するために使用されます。

サポートされている Google Cloud Buildpack のビルダーのリストから選択できます。

pack を使用して作成する

Pack は、ビルドパックの使用をサポートするために CNB プロジェクトによって管理されている CLI ツールです。pack CLI を使用して、ローカルで関数をコンテナ イメージにビルドします。

始める前に

1. Docker Community Edition（CE）をワークステーションにインストールします。pack は Docker を OCI イメージ ビルダーとして使用します。
2. Pack CLI をインストールします。
3. GitHub からサンプル アプリケーションを取得するために Git ソース管理ツールをインストールします。

ローカルで関数を作成する

pack build コマンドを使用して、デフォルトのビルダー --builder=gcr.io/buildpacks/builder を指定し、コンテナ イメージをローカルでビルドします。

pack build --builder=gcr.io/buildpacks/builder IMAGE_NAME

IMAGE_NAME は、コンテナ イメージの名前に置き換えます。

ビルドイメージと実行イメージを拡張して、コンテナ イメージをカスタマイズすることもできます。

サンプル関数をローカルで作成する

次の例は、ローカルでサンプルを作成する方法を示しています。

1. ローカルマシンにサンプル リポジトリのクローンを作成します。

   git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git

2. アプリケーションのサンプルコードが含まれているディレクトリに移動します。

   Go

   cd buildpack-samples/sample-functions-framework-go

   Java

   cd buildpack-samples/sample-functions-framework-java-mvn

   Node.js

   cd buildpack-samples/sample-functions-framework-node

   Python

   cd buildpack-samples/sample-functions-framework-python

   Ruby

   cd buildpack-samples/sample-functions-framework-ruby

3. pack を使用してサンプル関数を作成します。

   Go

   pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-go

   Java

   pack build --builder gcr.io/buildpacks/builder:v1 sample-functions-java-mvn

   Node.js

   pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-node

   Python

   pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-python

   Ruby

   pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-ruby

4. docker を使用してイメージを実行します。

   Go

   docker run -p8080:8080 sample-functions-framework-go

   Java

   docker run -it -ePORT=8080 -p8080:8080 sample-functions-java-mvn

   Node.js

   docker run -it -ePORT=8080 -p8080:8080 sample-functions-framework-node

   Python

   docker run -it -ePORT=8080 -p8080:8080 sample-functions-framework-python

   Ruby

   docker run -it -ePORT=8080 -p8080:8080 sample-functions-framework-ruby

5. localhost:8080 を参照して、実行中の関数にアクセスします。

リモート ビルドシステムによるビルド

Cloud Build を使用して関数をコンテナ イメージにビルドし、コンテナ リポジトリとして Artifact Registry を使用してイメージの保存とデプロイを行います。

始める前に

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build and Artifact Registry APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Install the Google Cloud CLI.

外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

gcloud CLI を初期化するには、次のコマンドを実行します。

gcloud init

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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build and Artifact Registry APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Install the Google Cloud CLI.

外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。

gcloud CLI を初期化するには、次のコマンドを実行します。

gcloud init

すでに Google Cloud CLI をインストールしている場合は、gcloud components update を実行して、最新の利用可能なバージョンがインストールされていることをご確認ください。

1. 使用する Google Cloud プロジェクトがコンテナ イメージ リポジトリにアクセスできることを確認します。

   Artifact Registry の Docker リポジトリへのアクセスを構成する手順は次のとおりです。

   1. 使用する Google Cloud プロジェクトと同じ場所に Docker リポジトリを新規作成します。

      gcloud artifacts repositories create REPO_NAME \
      --repository-format=docker \
      --location=REGION --description="DESCRIPTION"

      次のように置き換えます。
      • REPO_NAME は、Docker リポジトリに選択した名前に置き換えます。
      • REGION は、使用する Google Cloud プロジェクトの場所、またはそれに最も近い場所に置き換えます。
      • DESCRIPTION は選択した説明に置き換えます。

      たとえば、「Docker repository」という説明を使用して us-west2 に docker リポジトリを作成するには、次のコマンドを実行します。

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

   2. リポジトリが作成されたことを確認します。

      gcloud artifacts repositories list

      Docker リポジトリに選択した名前がリストに表示されます。

リモートで関数を作成する

gcloud builds submit コマンドを使用して、コンテナ イメージをビルドしてリポジトリにアップロードします。

コマンドにコンテナ イメージを指定することも、構成ファイルを使用することもできます。

コマンドで作成する

構成ファイルなしで作成するには、image フラグを指定します。

gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME

次のように置き換えます。

• LOCATION は、コンテナ リポジトリのリージョン名（us-west2 など）に置き換えます。
• PROJECT_ID は、使用する Google Cloud プロジェクトの ID に置き換えます。
• REPO_NAME は Docker リポジトリの名前に置き換えます。
• IMAGE_NAME は、コンテナ イメージの名前に置き換えます。

例:

gcloud builds submit --pack image=us-west2-docker.pkg.dev/my-project-id/my-buildpacks-docker-repo

構成ファイルを使用してビルドする

構成ファイルを使用すると、ビルドコマンドだけでイメージ リポジトリの構成の詳細を定義できます。構成ファイルは YAML ファイル形式にして、pack CLI を使用するビルドステップを含める必要があります。

1. コンテナ イメージ リポジトリの URI を含む YAML ファイル（ファイル名: cloudbuild.yaml）を作成します。

  options:
    logging: CLOUD_LOGGING_ONLY
    pool: {}
  projectId: PROJECT_ID
  steps:
  - name: gcr.io/k8s-skaffold/pack
    entrypoint: pack
    args:
    - build
    - LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME
    - --builder
    - gcr.io/buildpacks/builder:latest
    - --network
    - cloudbuild
  images:
  - LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME

次のように置き換えます。

• LOCATION は、コンテナ リポジトリのリージョン名（us-west2 など）に置き換えます。
• PROJECT_ID は、使用する Google Cloud プロジェクトの ID に置き換えます。
• REPO_NAME は Docker リポジトリの名前に置き換えます。
• IMAGE_NAME は、コンテナ イメージの名前に置き換えます。

1. アプリケーションをビルドします。

   構成ファイルの名前が cloudbuild.yaml の場合は、次のコマンドを実行します。

   gcloud builds submit .
   

   ヒント: 構成ファイルに一意の名前を使用する場合は、--config フラグを使用できます。

例: リモートでサンプル関数を作成する

次の例では、サンプルをリモートで作成し、コンテナ イメージが Artifact Registry のリポジトリに push されたことを確認する方法を示します。

1. ローカルマシンにサンプル リポジトリのクローンを作成します。

   git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git

2. アプリケーションのサンプルコードが含まれているディレクトリに移動します。

   Go

   cd buildpack-samples/sample-functions-framework-go

   Java

   cd buildpack-samples/sample-functions-framework-java-mvn

   Node.js

   cd buildpack-samples/sample-functions-framework-node

   Python

   cd buildpack-samples/sample-functions-framework-python

   Ruby

   cd buildpack-samples/sample-functions-framework-ruby

3. gcloud を使用して、アプリケーションのソースコードを Cloud Build に送信します。

   Go

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-go

   Java

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-gradle

   Node.js

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-node

   Python

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-python

   Ruby

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-ruby

   次のように置き換えます。

   • LOCATION は、コンテナ リポジトリのリージョン名例: us-west2-docker.pkg.dev
   • PROJECT_ID は、使用する Google Cloud プロジェクトの ID に置き換えます。
   • REPO_NAME は Docker リポジトリの名前に置き換えます。

4. サンプル関数が REPO_NAME に正常に公開されていることを確認します。

   gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME

   次のように置き換えます。

   • LOCATION は、コンテナ リポジトリのリージョン名（us-west2 など）に置き換えます。
   • PROJECT_ID は、使用する Google Cloud プロジェクトの ID に置き換えます。
   • REPO_NAME は Docker リポジトリの名前に置き換えます。

ベースイメージの自動更新の関数を作成する

関数コンテナは scratch でビルドすることもできます。これにより、Cloud Run のセキュリティの自動更新と組み合わせて使用できます。

Dockerfile

既存のビルド ツールチェーンを使用して、ベースイメージの自動更新と互換性のある関数コンテナ イメージを作成できます。コンテナをゼロからビルドする方法をご覧ください。

pack CLI

pack build IMAGE_NAME \
  --builder LOCATION-docker.pkg.dev/serverless-runtimes/google-22-full/builder/LANGUAGE:latest
  --run-image LOCATION-docker.pkg.dev/serverless-runtimes/google-22/scratch/RUNTIME_ID:latest

次のように置き換えます。

• LOCATION は、コンテナ リポジトリのリージョン名（us-west2 など）に置き換えます。
• IMAGE_NAME は、コンテナ イメージの名前に置き換えます。
• LANGUAGE は、関数の言語（nodejs など）に置き換えます。
• RUNTIME_ID は、ランタイム ID（nodejs22 など）に置き換えます。

Cloud Build

options:
  logging: CLOUD_LOGGING_ONLY
  pool: {}
projectId: PROJECT_ID
steps:
- name: gcr.io/k8s-skaffold/pack
  entrypoint: pack
  args:
  - build
  - LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME
  - --builder
  - LOCATION-docker.pkg.dev/serverless-runtimes/google-22-full/builder/LANGUAGE:latest
  - --run-image
  - LOCATION-docker.pkg.dev/serverless-runtimes/google-22/scratch/RUNTIME_ID:latest
  - --network
  - cloudbuild
images:
- LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME

次のように置き換えます。

• LOCATION は、コンテナ リポジトリのリージョン名（us-west2 など）に置き換えます。
• PROJECT_ID は、使用する Google Cloud プロジェクトの ID に置き換えます。
• REPO_NAME は Docker リポジトリの名前に置き換えます。
• IMAGE_NAME は、コンテナ イメージの名前に置き換えます。
• LANGUAGE は、関数の言語（nodejs など）に置き換えます。
• RUNTIME_ID は、ランタイム ID（nodejs22 など）に置き換えます。

次のステップ

• 関数をコンテナにビルドしたら、Cloud Run にデプロイする前にローカルでテストします。詳細については、Cloud Run サービスをローカルでテストするをご覧ください。
• ビルドしたコンテナを Cloud Run にデプロイする。サービスをデプロイするをご覧ください。
• Cloud Build トリガーを使用して Cloud Run サービスのビルドとデプロイを自動化する。継続的デプロイの設定をご覧ください。