12.3. カスタム GCE イメージの準備と GCP へのアップロードする

手順

1. テキストエディターを使用して、次の内容の gcp-config.toml 設定ファイルを作成します。

   provider = "gcp"
   [settings]
   bucket = "GCP_BUCKET"
   region = "GCP_STORAGE_REGION"
   object = "OBJECT_KEY"
   credentials = "GCP_CREDENTIALS"

   Copy to Clipboard Toggle word wrap
   • GCP_BUCKET は既存のバケットを指します。アップロード中のイメージの中間ストレージオブジェクトを格納するために使用されます。
   • GCP_STORAGE_REGION は、通常の Google ストレージリージョンであり、デュアルまたはマルチリージョンです。
   • OBJECT_KEY は、中間ストレージオブジェクトの名前です。アップロード前に存在してはならず、アップロードプロセスが完了すると削除されます。オブジェクト名が .tar.gz で終わらない場合、拡張子がオブジェクト名に自動的に追加されます。

   • GCP_CREDENTIALS は、GCP からダウンロードした認証情報 JSON ファイルの Base64 エンコードされたスキームです。認証情報によって、GCP がイメージをアップロードするプロジェクトが決まります。

     注記

     GCP での認証に別のメカニズムを使用する場合、gcp-config.toml ファイルでの GCP_CREDENTIALS の指定は任意です。他の認証方法は、Authenticating with GCP を参照してください。

2. GCP からダウンロードした JSON ファイルから GCP_CREDENTIALS を取得します。

   $ sudo base64 -w 0 cee-gcp-nasa-476a1fa485b7.json

   Copy to Clipboard Toggle word wrap

3. 追加のイメージ名とクラウドプロバイダープロファイルを使用して Compose を作成します。

   $ sudo composer-cli compose start BLUEPRINT-NAME gce IMAGE_KEY gcp-config.toml

   Copy to Clipboard Toggle word wrap

   イメージビルド、アップロード、およびクラウド登録プロセスは、完了に最大 10 分かかる場合があります。

1. 設定ファイルで composer-cli コマンドで指定された認証情報。
2. osbuild-composer ワーカー設定で設定された認証情報。

3. 次の方法で認証方法を自動的に見つけようとする、Google GCP SDK ライブラリーからの Application Default Credentials。

   1. GOOGLE_APPLICATION_CREDENTIALS 環境変数が設定されている場合、Application Default Credentials は、変数が指すファイルから認証情報を読み込んで使用しようとします。

   2. Application Default Credentials は、コードを実行しているリソースに関連付けられたサービスアカウントを使用して認証を試みます。たとえば、Google Compute Engine 仮想マシンです。

      注記

      イメージをアップロードする GCP プロジェクトを決定するには、GCP 認証情報を使用する必要があります。したがって、すべてのイメージを同じ GCP プロジェクトにアップロードする場合を除き、composer-cli コマンドを使用して gcp-config.toml 設定ファイルに認証情報を指定する必要があります。