Membuat konfigurasi workstation

Pelajari cara memulai pembuatan konfigurasi workstation dengan Cloud Workstations.

Konfigurasi workstation berfungsi sebagai template untuk pembuatan workstation yang konsisten bagi beberapa developer, dan menentukan setelan konfigurasi seperti jenis mesin, zona, ukuran disk, alat, dan library yang telah diinstal sebelumnya. Setiap operasi yang dilakukan pada konfigurasi workstation, seperti mengubah jenis mesin atau image container, akan tercermin pada setiap workstation saat workstation dimulai berikutnya.

Bagian ini menjelaskan langkah-langkah pembuatan konfigurasi workstation:

1. Mengonfigurasi dasar-dasar
2. Menentukan setelan mesin
3. Menyesuaikan lingkungan
4. Menambahkan pengguna
5. Menambahkan label dan tag

---

Untuk mengikuti panduan langkah demi langkah untuk tugas ini langsung di Google Cloud konsol, klik Pandu saya:

Guide me

---

Sebelum memulai

Sebelum mulai menggunakan Cloud Workstations, pastikan Anda memiliki izin yang diperlukan dan menyelesaikan langkah-langkah penyiapan yang diperlukan ini. Anda dapat melewati bagian ini jika telah menyelesaikan penyiapan ini.

Login keakun Anda. Google Cloud Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Aktifkan Cloud Workstations API.

   Peran yang diperlukan untuk mengaktifkan API

   Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Service Usage (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

   Mengaktifkan API

2. Pastikan Anda memiliki peran IAM Cloud Workstations Admin pada project tersebut agar dapat membuat konfigurasi workstation. Untuk memeriksa peran IAM Anda di Google Cloud konsol, buka halaman IAM:

   Buka IAM

3. Cloud Workstations dihosting di VM yang di-boot dari image Container-Optimized OS (COS) publik yang telah dikonfigurasi sebelumnya dari Compute Engine. Jika batasan kebijakan organisasi constraints/compute.trustedimageProjects diterapkan, Anda harus menetapkan batasan akses image untuk mengizinkan pengguna membuat boot disk dari projects/cos-cloud atau semua image publik.
4. Cloud Workstations menggunakan Private Service Connect untuk terhubung ke layanan yang dikelola Google. Jika batasan kebijakan organisasi constraints/compute.restrictPrivateServiceConnectProducer diterapkan di organisasi Anda, Anda harus menambahkan Google sebagai produsen yang diizinkan (under:organizations/433637338589).
5. Jika batasan kebijakan organisasi constraints/compute.disablePrivateServiceConnectCreationForConsumers diterapkan di organisasi Anda, Anda harus memastikan bahwa endpoint Private Service Connect yang terhubung ke Google API (GOOGLE_APIS) diizinkan allowed. Jika Anda mengonfigurasi cluster pribadi, endpoint yang terhubung ke layanan yang dipublikasikan (SERVICE_PRODUCERS) juga harus diizinkan.
6. Opsional: Aktifkan Container File System API untuk memungkinkan startup workstation yang lebih cepat.

   Mengaktifkan Container File System API

   Untuk mengetahui informasi selengkapnya, lihat Mengurangi waktu startup workstation dengan Streaming image.

Mengonfigurasi dasar-dasar

Untuk mengonfigurasi dasar-dasar konfigurasi workstation, ikuti langkah-langkah berikut:

1. Di konsol, buka Cloud Workstations > Workstation configurations.

   Buka Konfigurasi workstation

2. Dari halaman Workstation configurations, klik add_boxCreate.

   

3. Di kolom Name, masukkan test-configuration sebagai nama konfigurasi Anda.

4. Di kolom Region, pilih region cluster workstation yang ingin Anda gunakan untuk konfigurasi ini, atau pilih region tempat Anda ingin membuat cluster.

5. Dari daftar Clusters, pilih cluster workstation Anda, lalu klik Continue.

   Jika tidak ada cluster workstation yang tersedia di region yang dipilih, cluster akan dibuat secara otomatis bersama dengan konfigurasi Anda. Cluster baru dibuat dengan setelan default, dan Anda dapat menyesuaikannya dengan mengklik Customize cluster settings. Untuk mengetahui informasi selengkapnya tentang setelan cluster workstation, lihat Membuat cluster workstation.

6. Untuk Machine preset, pilih salah satu opsi yang telah dikonfigurasi sebelumnya (misalnya, Moderate), atau pilih Custom untuk menyesuaikan setelan komputasi dan penyimpanan.

7. Untuk Quick start workstations, pilih Enabled untuk startup workstation yang lebih cepat atau Disabled untuk biaya yang lebih rendah.

   Nilai ini menentukan jumlah virtual machine (VM) yang disimpan dalam status pra-mulai, yang memungkinkan waktu mulai workstation yang lebih cepat. Namun, project Anda akan ditagih untuk VM ini.

8. Di menu Code editors, pilih Cloud Workstations Base Editor (Code OSS for Cloud Workstations). Jika organisasi Anda lebih memilih IDE lain, Anda juga dapat memilih dari daftar IDE yang telah dikonfigurasi sebelumnya. Jika tidak ingin menggunakan image yang telah dikonfigurasi sebelumnya, Anda dapat memilih image kustom di halaman Environment settings.

9. Klik Continue untuk melanjutkan ke halaman Machine configuration.

Menentukan setelan mesin

1. Untuk menggunakan jenis mesin selain preset, pilih Machine type berdasarkan kebutuhan Anda. Misalnya, Anda dapat memilih e2-standard-4 (4 CPU, memori 16 GB).

2. Pilih dua Zones dalam region yang Anda pilih. Cloud Workstations membuat resource VM dan menyimpan data di zona ini.

   Pemilihan zona juga memengaruhi jenis resource komputasi yang tersedia. Misalnya, jika Anda memilih jenis mesin N1 dan ingin menggunakan GPU, pastikan untuk memilih dua zona tempat jenis GPU yang dipilih tercantum sebagai tersedia dalam tabel ketersediaan GPU menurut region dan zona.

3. Untuk Enable quick start workstations, pilih ukuran pool berdasarkan jumlah developer yang Anda perkirakan, kasus penggunaan, dan anggaran Anda. Quick start pool size default adalah 1.

4. Di bagian Cost savings, tetapkan jumlah waktu yang akan ditunggu sebelum tidur otomatis. Biarkan kolom Auto-sleep ditetapkan ke After 2 hours of inactivity (default) untuk otomatis mematikan workstation yang tidak aktif selama lebih dari dua jam.

5. Opsional: Di bagian Advanced options, klik expand_moreExpand More.

   1. Untuk menambahkan tag jaringan, masukkan teks di kolom Network tags.

      Tag jaringan adalah metadata yang diterapkan ke VM Compute Engine yang mendasarinya yang memungkinkan Anda membuat aturan dan rute firewall yang berlaku untuk instance VM tertentu. Di Cloud Workstations, Anda dapat menggunakan tag jaringan untuk membuat aturan atau rute firewall yang berlaku untuk semua workstation dalam konfigurasi workstation.

   2. Untuk menonaktifkan alamat IP publik, centang kotak Disable public IP addresses.

      Jika menonaktifkan alamat IP publik, Anda harus menyiapkan Akses Google Pribadi atau Cloud NAT di jaringan Anda. Jika Anda menggunakan Akses Google Pribadi dan menggunakan private.googleapis.com atau restricted.googleapis.com untuk Artifact Registry, pastikan Anda menyiapkan data DNS untuk domain *.pkg.dev.

   3. Untuk mengaktifkan virtualisasi bertingkat, centang kotak Enable nested virtualization. Virtualisasi bertingkat memungkinkan Anda menjalankan instance VM di dalam workstation.

      Sebelum mengaktifkan virtualisasi bertingkat, pertimbangkan pertimbangan penting berikut.

      Instance Cloud Workstations juga tunduk pada batasan yang sama dengan instance Compute Engine:

      • Kebijakan organisasi: project, folder, atau organisasi mungkin dibatasi untuk membuat VM bertingkat jika batasan Disable VM nested virtualization diterapkan dalam kebijakan organisasi. Untuk mengetahui informasi selengkapnya, lihat bagian Compute Engine, Memeriksa apakah virtualisasi bertingkat diizinkan.

      • Performa: VM bertingkat mungkin mengalami penurunan performa sebesar 10% atau lebih untuk workload yang terikat ke CPU dan penurunan yang kemungkinan lebih besar dari 10% untuk workload yang terikat input atau output.

      • Jenis Mesin: virtualisasi bertingkat hanya dapat diaktifkan pada konfigurasi workstation yang menentukan jenis mesin dalam seri mesin N1 atau N2.

   4. Untuk mengenkripsi data Anda saat diproses di VM ini, centang kotak Confidential VM service. Untuk mengetahui informasi selengkapnya, lihat Membuat instance Confidential VM.

   5. Untuk menetapkan setelan Shielded VM, centang kotak fitur yang sesuai. Fitur Shielded VM mencakup firmware UEFI tepercaya dan menyediakan opsi untuk booting, vTPM, dan pemantauan integritas.

   6. Secara default, Cloud Workstations mengenkripsi resource yang dibuat dengan konfigurasi workstation ini menggunakan Google-owned and Google-managed encryption key. Untuk menggunakan kunci enkripsi yang dikelola pelanggan sebagai gantinya, pilih Use customer-managed encryption key (CMEK).

6. Klik Continue untuk melanjutkan ke halaman Environment settings.

Menyesuaikan lingkungan

Sesuaikan lingkungan Cloud Workstations dengan mengonfigurasi image container workstation dan penyimpanan persisten menggunakan langkah-langkah berikut:

1. Konfigurasi image container dengan memilih apakah akan menggunakan salah satu dari image dasar yang telah dikonfigurasi sebelumnya atau memberikan referensi ke image container yang disesuaikan yang telah Anda buat.

   1. Untuk menggunakan image dasar yang telah dikonfigurasi sebelumnya:

      1. Biarkan jenis container ditetapkan ke Code editors on base images.

      2. Di menu Code editors, pilih Cloud Workstations Base Editor (Code OSS for Cloud Workstations). Jika organisasi Anda lebih memilih IDE lain, Anda juga dapat memilih dari daftar IDE yang telah dikonfigurasi sebelumnya.

      3. Opsional: Di menu Service account, pilih dari daftar akun layanan.

   2. Opsional: Untuk menggunakan image container kustom Anda sendiri, bukan salah satu image dasar yang telah dikonfigurasi sebelumnya:

      1. Pilih image container kustom.

      2. Tentukan URL image container.

      3. Klik menu Service account dan pilih akun layanan yang akan digunakan pada instance VM yang dibuat dalam konfigurasi workstation. Akun layanan ini harus memiliki izin untuk menarik image container kustom Anda (atau image harus dapat diakses secara publik). Untuk mengetahui informasi selengkapnya, lihat deskripsi serviceAccount di Menyesuaikan lingkungan pengembangan Anda.

2. Di bagian Storage settings, pilih preferensi untuk direktori utama awal dan untuk atribut disk:

   1. Untuk membuat direktori utama kosong, pilih Create a blank persistent disk. Untuk menggunakan snapshot disk untuk direktori utama, pilih Create a persistent disk from a source disk snapshot.

   2. Tetapkan Disk type direktori persisten Anda ke Balanced, yang memiliki performa lebih tinggi tetapi lebih ekonomis daripada SSD.

   3. Tetapkan Disk size direktori persisten Anda. Defaultnya adalah 200 GB, tetapi nilai yang valid adalah 10, 50, 100, 200, 500, atau 1000 GB. Pilih ukuran disk yang paling sesuai dengan kebutuhan tim Anda.

   4. Tetapkan Reclaim policy ke Delete atau Retain. Defaultnya adalah Delete. Kebijakan ini menentukan apa yang terjadi pada persistent disk saat workstation dihapus.

      Catatan:

      • Anda tidak dapat mengubah jenis disk setelah membuat workstation.
      • Memilih Retain memungkinkan administrator mengaudit konten disk utama workstation setelah workstation dihapus, tetapi administrator bertanggung jawab untuk menghapus disk secara manual.
      • Jika Anda memilih opsi Retain , lalu menghapus workstation, persistent disk Anda tidak akan dihapus. Namun, jika Anda membuat ulang workstation, disk baru akan dilampirkan ke workstation yang tidak akan berisi data dari workstation yang dihapus.

        Untuk mengakses data di disk, Anda dapat mengikuti langkah-langkah berikut:

        1. Buat instance Compute Engine baru.
        2. Tambahkan persistent disk ke instance.
        3. Pasang disk di VM Anda.

Anda juga dapat menyesuaikan lebih lanjut dengan mengikuti langkah-langkah opsional berikut:

1. Opsional: Tambahkan Readiness checks.

   Jika diperlukan, tentukan pemeriksaan kesiapan untuk memverifikasi bahwa workstation menerima permintaan di jalur dan port tertentu saat memulai workstation yang terkait dengan konfigurasi workstation ini.

2. Opsional: Luaskan Advanced container options.

   Jika diperlukan, tentukan parameter tambahan untuk image container yang digunakan. Misalnya, tentukan penggantian direktori kerja, penggantian pengguna, penggantian perintah, argumen yang akan diteruskan ke perintah entrypoint, dan variabel lingkungan.

3. Klik Continue untuk melanjutkan ke halaman Users and permissions.

Menambahkan pengguna

Untuk mengizinkan beberapa pengguna membuat workstation, tambahkan pengguna ke konfigurasi workstation Anda:

1. Dari halaman Users and permissions, klik kolom Users dan masukkan alamat email satu atau beberapa pengguna atau grup Google yang ingin Anda beri akses. Tindakan ini akan menyiapkan kebijakan IAM Cloud Workstations Creator untuk pengguna ini.

2. Opsional: Untuk menambahkan akses administrator kebijakan Cloud Workstations, luaskan Advanced IAM options.

   Untuk memberikan peran roles/workstations.policyAdmin kepada pembuat workstation, centang kotak Grant Policy Admin role to workstation creators. Hal ini memungkinkan pembuat workstation memperbarui kebijakan IAM workstation, yang memberikan akses ke workstation dan port individualnya.

   Untuk mengetahui informasi selengkapnya tentang berbagi port Cloud Workstations, lihat halaman Memberikan akses ke port Cloud Workstations individual.

   Catatan: Secara default, pembuat workstation mendapatkan roles/workstations.user peran di workstation yang mereka buat, terlepas dari setelan Grant Policy Admin role to workstation creators.

1. Klik Continue untuk melanjutkan ke halaman Labels and tags.

Menambahkan label dan tag

1. Dari halaman Labels and tags, konfigurasi label dan tag:

   1. Opsional: Tambahkan Labels untuk menerapkan label pasangan kunci-nilai ke resource Compute Engine yang mendasarinya.

2. Untuk membuat konfigurasi workstation, klik Create.

   Jika Anda memilih untuk membuat cluster baru, proses pembuatan dapat memerlukan waktu hingga 20 menit.

Anda baru saja membuat konfigurasi workstation pertama dan menambahkan pengguna ke konfigurasi tersebut.

Untuk membuat dan meluncurkan workstation berdasarkan konfigurasi ini, klik Next.

Pembersihan

Jika Anda membuat konfigurasi workstation baru untuk mempelajari Cloud Workstations dan Anda tidak lagi memerlukan konfigurasi tersebut, Anda dapat menghapusnya dari konsol Google Cloud :

1. Di Google Cloud konsol, buka Cloud Workstations > Workstation configurations.
2. Centang kotak di samping konfigurasi workstation yang ingin Anda hapus.
3. Klik menu opsi more_vertMore , lalu pilih Delete untuk menghapus konfigurasi workstation yang dipilih.

Untuk mengetahui informasi selengkapnya tentang cara menghapus workstation, cluster workstation, dan Google Cloud project, lihat Menghapus resource.

Langkah berikutnya

• Buat workstation menggunakan konfigurasi workstation yang baru dibuat.

• Gunakan editor dasar Cloud Workstations.

• Sesuaikan konfigurasi workstation Anda melalui API.

• Buat image container kustom yang memperluas image dasar yang telah dikonfigurasi sebelumnya yang disediakan oleh Cloud Workstations.