13.3. カスタム GCE イメージの準備と Google Cloud へのアップロード

手順

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

   provider = "gcp"
   [settings]
   bucket = "GOOGLE_CLOUD_BUCKET"
   region = "GOOGLE_CLOUD_STORAGE_REGION"
   object = "OBJECT_KEY"
   credentials = "GOOGLE_CLOUD_CREDENTIALS"

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

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

     注記

     Google Cloud との認証に別のメカニズムを使用する場合は、gcp-config.toml ファイルで GOOGLE_CLOUD_CREDENTIALS を 指定する必要はありません。その他の認証方法は、Authenticating with Google Cloud を参照してください。

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

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

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

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

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

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

3. Google Cloud SDK ライブラリーの Application Default Credentials。これは、次の選択肢を使用して認証方法の自動検出を試みます。

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

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

      注記

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