Cloud Development

Google Cloud の Cloud Workstations を使用すると、ローカルマシンを必要とせずに SDV を開発できます。続行する前に、Google Cloud プロジェクトにアクセスする必要があります。Google Cloud プロジェクトにアクセスできない場合は、Google の担当者にお問い合わせください。Qwiklabs 環境は、一時的な評価に使用できます。

Workflows

このガイドは、次の両方に適用されます。

  • 個人のデベロッパー: 独自の環境を設定する個人のデベロッパー向け。

  • 組織: 組織で再利用可能なワークステーション構成を設定する管理者向け。このガイドの手順を完了したら、組織の設定に進みます。

環境のセットアップ

次の手順に沿って Google Cloud 環境を構成し、ワークステーション リソースをデプロイします。

環境変数を設定する

  1. Google Cloud プロジェクトで Cloud Shell を起動します。

  2. Google Cloud プロジェクトに固有の環境変数を設定します。これらの変数は、後続のスクリプトで使用されます。

    • Qwiklabs 環境を使用している場合:
      1. Qwiklabs ページからスクリプトを実行します。

    • 独自の Google Cloud プロジェクトを使用している場合:

      1. Cloud Shell でプロジェクト ID とユーザー名を確認します。

        リージョンとゾーンは、Cloud のロケーションで確認できます。指定しない場合は、リージョンとして us-central1 が使用され、ゾーンとして us-central1-c が使用されます。

      2. 次のスクリプトを正しい情報で編集して実行します。

        # REQUIRED
export TF_VAR_gcp_project_id=GCP Project ID
export TF_VAR_gcp_username=GCP Username
# OPTIONAL
export TF_VAR_gcp_region=Region to use for the resources (default: us-central1)
export TF_VAR_gcp_zone=Zone to use for the resources (default: us-central1-c)

設定スクリプトを取得する

Google の担当者に sdv-setup リポジトリへのアクセス権をリクエストし、~/dev/sdv-setup にクローンを作成します。テレメトリー リポジトリについては、GitHub リポジトリにアクセスするをご覧ください。

コンテナ リポジトリを作成する

Terraform 構成を適用してコンテナ リポジトリを作成します。

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

このスクリプトは約 2 分で完了します。

Docker コンテナ イメージをビルドする

Cloud Workstations の Docker イメージをビルドします。

cd ~/dev/sdv-setup/docker/android-studio-for-platform
gcloud builds submit --timeout=3h --substitutions=_IMAGE_NAME=${TF_VAR_gcp_region}-docker.pkg.dev/${TF_VAR_gcp_project_id}/aaos-sdv/android-studio-for-platform-canary,_ASFP_VERSION=canary

このスクリプトは約 1 時間で完了します。完了すると、コンテナ イメージが Artifact Registry に保存されます。

開発環境をデプロイする

Terraform 構成を適用して、開発環境を作成します。

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

このスクリプトは約 20 分で完了します。

Cloud Workstations を使用する

ワークステーションの起動、クリップボードへのアクセス、アクティビティの管理方法について説明します。

ワークステーションを起動する

  1. Google Cloud コンソールで、検索バーに「Cloud Workstations」と入力します。[プロダクトとページ] セクションで、[Cloud Workstations] をクリックします。

  2. ナビゲーション メニューで [ワークステーション] をクリックします。

  3. ワークステーションのリストで、work-station という名前のワークステーションの [クイック操作] 列にある [開始] をクリックします。

  4. ワークステーションが起動したら、同じワークステーションの [クイック操作] 列で [起動] をクリックします。

    新しいウィンドウが開き、デスクトップ インターフェースが表示されます。エラーが表示された場合は、1 分待ってからページを更新します。

クリップボードへのアクセス

特別なインターフェースを介して、ローカルマシンと Cloud Workstations の間でコピーして貼り付けることができます。画面の左端の中央に、小さな灰色の矢印が表示されます。矢印をクリックすると、5 つのボタンを含む小さなメニューが開きます。クリップボード アイコンをクリックします。

表示されたテキスト領域を使用して、ワークステーションでクリップボードを管理します。ローカルマシンからワークステーションにテキストを貼り付けるには、ボックスにテキストを追加してから貼り付けます。ワークステーションからテキストをコピーするには、テキストをコピーします。テキストがボックスに表示されたら、再度コピーしてローカルマシンに貼り付けることができます。

アクティビティの概要

アクティビティの概要でアプリを起動できます。

  1. 上部のバーで [アクティビティの概要] に移動します。

  2. アプリのリストをフィルタするには、上部の検索バーにアプリの名前を入力します。

  3. アプリを起動するには、それぞれのアイコンをクリックします。

次のステップ

開発環境がセットアップされ、SDV を使用してビルドを開始する準備が整いました。ワークフローに応じて、次の手順を行います。