組織設定

如果您為機構設定 Cloud Workstations,可以建立使用者工作站設定,並預先下載及建構程式碼。開發人員可以立即開始工作,不必等待建構程序完成。

如要建立使用者工作站設定,請建立管理員工作站、執行一次建構程序、建立永久磁碟的快照,然後使用該快照建立新的工作站設定。

建立管理員工作站

請按照「啟動工作站」一文中的步驟,建立及啟動單一工作站。做為基本映像檔。

建立目標

在管理員工作站上,下載原始碼並建構目標。您可以手動建構目標,也可以使用提供的指令碼自動建構。

手動建構

執行建構指令碼前,請先按照「原始碼存取權」一文的說明取得程式碼存取權。然後按照「下載、建構及執行」一文的說明,手動建構目標。

自動建構

執行 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 分鐘) 和 Core (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-stationwork-station 應與管理員工作站的 ID 相符。按下 Enter 鍵即可篩選結果。
    4. 按一下其餘項目。
    5. 在 VM 執行個體頁面的「Storage」(儲存空間) 中,會列出兩個不同的磁碟。 按一下「大小 (GB)」為「1000」且「類型」為「區域 SSD 永久磁碟」的磁碟。這個磁碟包含您要建立快照的住家目錄。
  4. 停止管理員工作站:

    1. 請勿關閉磁碟頁面。
    2. 開啟新的瀏覽器分頁或視窗,前往 Google Cloud 控制台並開啟 Cloud Workstations 頁面。在搜尋列中輸入 Cloud Workstations,然後點選頂端結果。
    3. 按一下側邊面板中的「工作站」
    4. 按一下表格中的管理員工作站 (工作站 ID 為 work-station)。
    5. 按一下工具列中的「停止」,然後等待工作站停止運作。
  5. 建立磁碟快照:

    1. 切換回磁碟頁面,然後按一下工具列中的「建立快照」
    2. 在「Name」(名稱) 欄位中,輸入 aaos-sdv-dev-snapshot
    3. 其餘欄位則保留預設值。
    4. 按一下頁面底部的 [Create] (建立)。

過一小段時間後,磁碟快照就會建立完成,並可供使用。

建立使用者工作站設定

建立新的工作站設定,並以快照做為起點:

  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」做為「Configuration」
  7. 點選「建立」
  8. 在工作站清單中,找到您剛才建立的工作站。按一下「快速動作」欄下方的「開始」
  9. 工作站啟動後,按一下「快速操作」欄下方的「啟動」,即可開始使用工作站。
  10. 開啟檔案總管,確認主目錄包含磁碟快照中的檔案。

貴機構現在可以為開發人員建立工作站。如要進一步瞭解如何設定 Cloud Workstations 的存取權,請參閱「使用 IAM 控管存取權」。