Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

ホスト VM でカスタム起動スクリプトを実行する

Cloud Workstations を使用すると、ワークステーションコンテナが起動する前に、ホストワークステーション VM でカスタム起動スクリプトを実行できます。これは、VM レベルの構成を実行する場合や、ワークステーションコンテナの外部で実行する必要がある追加のソフトウェアをインストールする場合に便利です。

ホスト VM でカスタム起動スクリプトを実行することは高度な機能です。起動スクリプトを使用する代わりに、コンテナイメージをカスタマイズすることをおすすめします。

起動スクリプトを使用する場合は、ホスト VM が COS に基づいてオペレーティングシステムの定期的な更新を受け取るため、スクリプトが Container-Optimized OS（COS）イメージの変更と互換性があることを確認してください。

始める前に

Google Cloud CLI をインストールし、フェデレーション ID を使用して gcloud CLI にログインします。ログイン後、初期化するには、次のコマンドを実行して Google Cloud CLI を初期化します。

gcloud init

起動スクリプトを準備する

ホストワークステーション VM で実行する起動スクリプトを作成します。スクリプトを作成する際は、次のガイドラインに従ってください。

Cloud Workstations は、ワークステーションが適切に機能するように、指定したワークステーションコンテナと複数のシステムコンテナをホストワークステーション VM で実行します。すべてのコンテナは、containerd ランタイムと crictl クライアントを使用して実行されます。
起動スクリプトによって起動された追加のコンテナは、containerd を使用して実行します。ワークステーションコンテナ内で実行されている Docker デーモンとの干渉を防ぐため、ホスト VM で Docker は無効になっています。
起動スクリプトによって起動されたホストレベルのコンテナは、メインのワークステーションコンテナとやり取りできません。このような直接的なやり取りは、Identity and Access Management（IAM）チェックをバイパスするため、サポートされていません。

起動スクリプトを Cloud Storage に保存する

スクリプトを Cloud Storage バケットにアップロードし、ワークステーションに関連付けられたサービスアカウントからスクリプトにアクセスできることを確認します。

スクリプトをバケットにアップロードします。
```
gcloud storage cp LOCAL_SCRIPT_PATH gs://BUCKET_NAME/SCRIPT_NAME
```
次のように置き換えます。
- LOCAL_SCRIPT_PATH: 起動スクリプトファイルのローカルパス。
- BUCKET_NAME: Cloud Storage バケットの名前。
- SCRIPT_NAME: バケット内のスクリプトファイルに付ける名前。
ワークステーション構成で使用されるサービスアカウントに、バケットとスクリプトファイルにアクセスする権限があることを確認します。または、スクリプトを一般公開することもできます。

ワークステーション構成を作成する

カスタム起動スクリプトを使用するには、ワークステーション構成を作成し、スクリプトの Cloud Storage URI を指定します。

コンソール

ワークステーション構成を作成するときにカスタム起動スクリプトを構成するには:

コンソールで、[**ワークステーションの構成**] ページに移動します。 Google Cloud

[ワークステーションの構成] に移動
[add] [Create] をクリックします。
[基本情報] ページで、構成の名前を入力し、ワークステーションクラスタを選択して、[続行] をクリックします。
[マシンの設定] ページで、マシンの設定を構成して、[続行] をクリックします。
[環境設定] ページで、[コンテナの詳細オプション] セクションを開きます。
[カスタム起動スクリプト] フィールドに、起動スクリプトの Cloud Storage パス（gs://BUCKET_NAME/SCRIPT_NAME など）を入力します。
残りの手順を完了し、[作成] をクリックします。

REST

REST API を使用してカスタム起動スクリプトを構成するには、ワークステーション構成を作成し、host.gceInstance メッセージの startupScriptUri フィールドをスクリプトの Cloud Storage URI に設定します。

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
       "host": {
         "gceInstance": {
           "poolSize": 1,
           "startupScriptUri": "gs://BUCKET_NAME/SCRIPT_NAME",
           "serviceAccount": "SERVICE_ACCOUNT"
         }
       }
     }' \
     https://workstations.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/workstationClusters/CLUSTER_ID/workstationConfigs?workstation_config_id=CONFIG_ID

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

SERVICE_ACCOUNT: ワークステーション構成に関連付けられたサービスアカウントのメールアドレス。
PROJECT_ID: 実際の Google Cloud プロジェクト ID。
LOCATION: ワークステーションクラスタが配置されているリージョン。
CLUSTER_ID: ワークステーションクラスタの ID。
CONFIG_ID: 新しいワークステーション構成に割り当てる ID。

スクリプトの実行を確認する

スクリプトが正しく実行されたことを確認するには、次のいずれかの方法を使用します。

シリアルポート 3 の出力ログ: スクリプトによって生成された出力ログは、自動的にシリアルポート 3 の出力に送信されます。ワークステーションに割り当てられた VM の名前を確認するには、プラットフォームログをご覧ください。
VM に SSH で接続する: 必要に応じて、ワークステーション VM に SSH で接続してスクリプトをデバッグできます。
準備状況チェック: 起動スクリプトはベストエフォート型であり、ワークステーションの起動をブロックしません。スクリプトの実行に時間がかかる場合や失敗した場合でも、ワークステーションが準備完了としてマークされることがあります。スクリプトが完了するまでワークステーションが準備完了としてマークされないようにするには、準備状況チェックの実装を検討してください。

ホスト VM でカスタム起動スクリプトを実行する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。