Penyiapan organisasi

Jika menyiapkan Cloud Workstations untuk organisasi, Anda dapat membuat konfigurasi workstation pengguna dengan kode yang telah didownload dan dibuat sebelumnya. Hal ini memungkinkan developer segera mulai bekerja tanpa menunggu proses build selesai.

Untuk membuat konfigurasi workstation pengguna, Anda membuat workstation admin, menjalankan proses build satu kali, membuat snapshot persistent disk, lalu menggunakan snapshot tersebut untuk membuat konfigurasi workstation baru.

Membuat workstation admin

Ikuti langkah-langkah di bagian Meluncurkan workstation untuk membuat dan meluncurkan satu workstation. Workstation ini berfungsi sebagai image dasar Anda.

Mem-build target

Di workstation admin, download kode sumber dan build target. Anda dapat mem-build target secara manual atau mengotomatiskan build menggunakan skrip yang disediakan.

Build manual

Sebelum menjalankan skrip build, dapatkan akses ke kode seperti yang dijelaskan dalam Akses kode sumber. Kemudian, build target secara manual seperti yang dijelaskan dalam Mendownload, mem-build, dan menjalankan.

Build otomatis

Jalankan skrip setup.sh yang disediakan di repositori sdv-setup. Skrip ini mengotomatiskan proses cloning kode sumber Android dan mem-build target.

1. Buka terminal di workstation.

2. Tetapkan kredensial Git Anda:

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

3. Lakukan autentikasi ke partner-android.googlesource.com:

   1. Login ke partner-android-review.googlesource.com dengan akun partner Android Anda.
   2. Buka Settings, lalu pilih Profile.
   3. Buka bagian HTTP Credentials, lalu klik Obtain password.
   4. Ikuti petunjuk di layar, lalu tempel skrip autentikasi ke terminal workstation. Tindakan ini akan membuat file ~/.gitcookies, yang diperlukan untuk akses.

4. Jalankan skrip penyiapan dengan menyelesaikan langkah-langkah berikut:

   1. Ikuti langkah-langkah autentikasi di bagian Mendapatkan akses. Tindakan ini akan memberikan akses ke repositori skrip penyiapan.
   2. Clone repositori sdv-setup, lalu jalankan skrip penyiapan:

   # 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
   

Skrip memerlukan waktu beberapa jam untuk diselesaikan. Skrip ini akan meng-clone kode sumber Android (sekitar 30 menit), lalu mem-build target SDV IVI (2 jam), Media (30 menit), dan Core (10 menit).

(Opsional) Menyiapkan project Android Studio untuk Platform

Android Studio untuk Platform (ASfP) adalah IDE yang telah diinstal sebelumnya di Cloud Workstation. Jika semua developer Anda mengerjakan project yang sama, Anda dapat mengonfigurasi project ASfP di snapshot disk yang dapat digunakan oleh semua orang. Ikuti petunjuk di bagian Menyiapkan project SDV AAOS untuk mengonfigurasi project.

Membuat snapshot disk

Setelah build selesai, buat snapshot persistent disk workstation admin.

1. Hapus konfigurasi dan cookie Git Anda untuk mencegah kredensial pribadi dibagikan kepada pengguna lain:

   rm ~/.gitcookies
   rm ~/.gitconfig
   

2. Hapus repositori sdv-setup agar image dasar tetap bersih:

   rm -rf ~/sdv-setup
   

3. Temukan disk workstation admin:

   1. Biarkan workstation admin tetap berjalan.
   2. Di konsol Google Cloud, masukkan VM Instances di kotak penelusuran, lalu klik hasil teratas.
   3. Di kotak Filter, masukkan workstation_id:work-station. work-station harus cocok dengan ID workstation admin Anda. Tekan Enter untuk memfilter hasilnya.
   4. Klik entri yang tersisa.
   5. Di halaman instance VM, dua disk berbeda tercantum di bagian Storage. Klik disk yang memiliki Size (GB) sebesar 1000 dan Type berupa Regional SSD persistent disk. Disk ini berisi direktori utama yang ingin Anda buat snapshot-nya.

4. Hentikan workstation admin:

   1. Biarkan halaman disk tetap terbuka.
   2. Di tab browser atau jendela baru, buka Konsol Google Cloud dan buka halaman Cloud Workstations. Di kotak penelusuran, masukkan Cloud Workstations, lalu klik hasil teratas.
   3. Klik Workstations di panel samping.
   4. Klik workstation admin (dengan ID workstation work-station) di tabel.
   5. Klik Stop di toolbar, lalu tunggu hingga workstation berhenti.

5. Buat snapshot disk:

   1. Beralih kembali ke halaman disk, lalu klik Create snapshot di toolbar.
   2. Di kolom Name, masukkan aaos-sdv-dev-snapshot.
   3. Biarkan kolom yang tersisa tetap pada nilai defaultnya.
   4. Di bagian bawah halaman, klik Create.

Setelah beberapa saat, snapshot disk akan dibuat dan siap digunakan.

Membuat konfigurasi workstation pengguna

Buat konfigurasi workstation baru yang menggunakan snapshot sebagai titik awal:

1. Ikuti petunjuk di bagian Menetapkan variabel lingkungan untuk meluncurkan Cloud Shell, lalu tetapkan variabel lingkungan.

2. Terapkan konfigurasi Terraform untuk membuat konfigurasi workstation pengguna:

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

Membuat workstation pengguna

1. Di konsol Google Cloud, buka halaman Cloud Workstations. Masukkan Cloud Workstations ke kotak penelusuran, lalu klik hasil teratas.
2. Klik Workstations di panel samping.
3. Klik Create workstation di toolbar.
4. Masukkan ID untuk workstation, atau biarkan nilai default.
5. Masukkan Display Name untuk workstation. Jika Anda mengosongkan kolom ini, ID akan digunakan.
6. Pilih user-workstation-config sebagai Configuration.
7. Klik Create.
8. Dalam daftar workstation, temukan workstation yang baru saja Anda buat. Klik Start di kolom Quick actions.
9. Setelah workstation dimulai, klik Launch di kolom Quick actions untuk mulai menggunakan workstation.
10. Buka file explorer untuk memverifikasi bahwa direktori utama berisi file dari snapshot disk.

Organisasi Anda kini dapat membuat workstation untuk developer. Untuk mengetahui informasi selengkapnya tentang cara menyiapkan akses ke Cloud Workstations, lihat Kontrol akses dengan IAM.