組織の設定

組織に Cloud Workstations を設定すると、事前にダウンロードしてビルドしたコードを使用して、ユーザー ワークステーション構成を作成できます。これにより、デベロッパーはビルドプロセスが完了するのを待たずに、すぐに作業を開始できます。

ユーザー ワークステーション構成を作成するには、管理ワークステーションを作成し、ビルドプロセスを 1 回実行して、永続ディスクのスナップショットを作成します。次に、そのスナップショットを使用して新しいワークステーション構成を作成します。

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

ワークステーションを起動するの手順に沿って、単一の ワークステーションを作成して起動します。これはベースイメージとして機能します。

ターゲットをビルドする

管理ワークステーションで、ソースコードをダウンロードしてターゲットをビルドします。ターゲットを手動でビルドすることも、提供されたスクリプトを使用してビルドを自動化することもできます。

手動ビルド

ビルド スクリプトを実行する前に、ソース コードへのアクセス権の説明に沿ってコードにアクセスします。次に、ダウンロード、 ビルド、実行の説明に沿って、ターゲットを手動でビルドします。

自動ビルド

sdv-setup リポジトリに用意されている setup.sh スクリプトを実行します。この スクリプトは、Android ソースコードのクローン作成とターゲットのビルドを自動化します。

  1. ワークステーションでターミナルを開きます。

  2. Git 認証情報を設定します。

    git config --global user.email "Your email address"
git config --global user.name "Your name"

  3. partner-android.googlesource.com に対して認証します。

    1. Android パートナー アカウントで partner-android-review.googlesource.com に ログインします。
    2. [**設定**] に移動し、[**プロフィール**] を選択します。
    3. [HTTP 認証情報] セクションに移動し、[パスワードを取得] をクリックします。
    4. 画面上の手順に沿って操作し、認証スクリプトをワークステーション ターミナルに貼り付けます。これにより、アクセスに必要な ~/.gitcookies ファイルが作成されます。

  4. 次の手順に沿ってセットアップ スクリプトを実行します。

    1. アクセス権を取得するの認証手順に沿って操作します。これにより、セットアップ スクリプト リポジトリにアクセスできるようになります。
    2. sdv-setup リポジトリのクローンを作成し、セットアップ スクリプトを実行します。
    # Change directories to the home directory
cd ~/

# Clone the sdv-setup repository
git clone https://sdv.googlesource.com/external/sdv-setup

# Ensure the setup script is executable
chmod +x sdv-setup/setup/setup.sh

# Run the setup script
./sdv-setup/setup/setup.sh

スクリプトが完了するまでに数時間かかります。Android ソースコードのクローンを作成し（約 30 分）、SDV IVI（2 時間）、メディア（30 分）、コア（10 分）のターゲットをビルドします。

（省略可）Android Studio for Platform プロジェクトを設定する

Android Studio for Platform（ASfP）は、Cloud Workstation にプリインストールされている IDE です。デベロッパーがすべて同じプロジェクトで作業する場合は、全員が使用できるディスク スナップショットに ASfP プロジェクトを構成できます。プロジェクトを構成するには、 AAOS SDV プロジェクトを設定するの手順に沿って操作します。

ディスクのスナップショットを作成する

ビルドが完了したら、管理ワークステーションの永続ディスクのスナップショットを作成します。

  1. 個人用認証情報を他のユーザーと共有しないように、Git 構成と Cookie を削除します。

    rm ~/.gitcookies
rm ~/.gitconfig

  2. ベースイメージをクリーンな状態に保つため、sdv-setup リポジトリを削除します。

    rm -rf ~/sdv-setup

  3. 管理ワークステーションのディスクを見つけます。

    1. 管理ワークステーションを実行したままにします。
    2. Google Cloud コンソールで、検索バーに「VM Instances」と入力し、一番上の結果をクリックします。
    3. [フィルタ] バーに「workstation_id:work-station」と入力します。 work-station は、管理ワークステーションの ID と一致する必要があります。Enter キーを押して結果をフィルタします。
    4. 残りのエントリをクリックします。
    5. [VM インスタンス] ページの [ストレージ] に、2 つの異なるディスクが表示されます。 [サイズ（GB）] が 1000 で、[タイプ] が リージョン SSD 永続ディスク のディスクをクリックします。このディスクには、スナップショットを作成するホーム ディレクトリが含まれています。

  4. 管理ワークステーションを停止します。

    1. ディスクのページを開いたままにします。
    2. 新しいブラウザタブまたはウィンドウで Google Cloud コンソールを開き、Cloud Workstations ページに移動します。検索バーにCloud Workstationsと入力し、一番上の結果をクリックします。
    3. サイドパネルで [ワークステーション] をクリックします。
    4. 表で管理ワークステーション（ワークステーション ID が work-station ）をクリックします。
    5. ツールバーの [停止] をクリックし、ワークステーションが停止するまで待ちます。

  5. ディスクのスナップショットを作成します。

    1. ディスクのページに戻り、ツールバーの [スナップショットを作成] をクリックします。
    2. [名前] フィールドに「aaos-sdv-dev-snapshot」と入力します。
    3. 残りのフィールドはデフォルト値のままにします。
    4. ページの下部にある [作成] をクリックします。

しばらくすると、ディスク スナップショットが作成され、使用できるようになります。

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

スナップショットを開始点として使用する新しいワークステーション構成を作成します。

  1. 環境変数を設定するの手順に沿って Cloud Shell を起動し、環境変数を設定します。

  2. Terraform 構成を適用して、ユーザー ワークステーション構成を作成します。

    cd ~/dev/sdv-setup/tf/user_dev_env
terraform init
terraform apply -auto-approve

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

  1. Google Cloud コンソールで、Cloud Workstations ページに移動します。検索バーに「Cloud Workstations」と入力し、一番上の結果をクリックします。
  2. サイドパネルで [ワークステーション] をクリックします。
  3. ツールバーの [ワークステーションを作成] をクリックします。
  4. ワークステーションのID を入力するか、デフォルトのままにします。
  5. ワークステーションの表示名 を入力します。空白のままにすると、ID が使用されます。
  6. [構成] で [user-workstation-config] を選択します。
  7. [作成] をクリックします。
  8. ワークステーションのリストで、作成したワークステーションを見つけます。[クイック アクション] 列の [起動] をクリックします。
  9. ワークステーションが起動したら、[クイック アクション] 列の [起動] をクリックして、ワークステーションの使用を開始します。
  10. ファイル エクスプローラを開き、ホーム ディレクトリにディスク スナップショットのファイルが含まれていることを確認します。

これで、組織はデベロッパー用のワークステーションを作成できます。Cloud Workstations へのアクセス権の設定の詳細については、IAM によるアクセス制御 をご覧ください。