Mengembangkan kode menggunakan editor VS Code lokal

Pelajari cara membuka tunnel SSH dari mesin lokal Anda ke workstation, lalu gunakan dukungan VS Code Remote Development untuk terhubung ke Cloud Workstation dari editor VS Code lokal Anda.

Tips: Untuk pengalaman dalam browser, Anda dapat menggunakan IDE Cloud Workstations Code OSS for Cloud Workstations, yang didasarkan pada project open source Code-OSS.

Sebelum memulai

Sebelum memulai, pastikan Anda mengikuti langkah-langkah untuk tugas berikut:

1. Pastikan seseorang di tim Anda telah membuat konfigurasi workstation.
2. Buat dan mulai workstation Anda.

3. Saat Anda berada di konsol Google Cloud, salin informasi berikut:

   1. Nama dan ID project: klik nama project di menu bar Google Cloud dan salin ID di dialog Project name and ID yang terbuka.
   2. Wilayah
   3. Nama cluster
   4. Nama konfigurasi

4. Dari komputer lokal, instal gcloud CLI.

   Jika menjalankan gcloud CLI untuk pertama kalinya, Anda mungkin juga perlu menjalankan gcloud auth login untuk mendapatkan kredensial dan gcloud config set project PROJECT_ID untuk menetapkan project saat ini ke project ID yang Anda salin di langkah sebelumnya.

5. Saat menggunakan ssh untuk pertama kalinya, instal ekstensi SSH jarak jauh agar Anda dapat terhubung ke workstation dari editor VS Code melalui Extension Marketplace atau melalui palet perintah.

   Extensions Marketplace

   1. Buka aplikasi editor VS Code lokal Anda, lalu buka Extension Marketplace dengan memilih
      Extensions di panel Aktivitas.

   2. Klik Instal untuk menginstal ekstensi Remote - SSH.

   3. Masukkan remote ssh di kolom penelusuran, yang akan membuka halaman ekstensi untuk Remote - SSH.

      

   Palet perintah

   1. Untuk membuka palet perintah, tekan Control+Shift+P (atau Command+Shift+P di macOS), atau klik View > Command Palette.

   2. Masukkan ext install ms-vscode-remote.remote-ssh untuk menginstal ekstensi.

Membuka tunnel SSH

Buka tunnel SSH dari komputer lokal Anda ke workstation menggunakan perintah gcloud workstations start-tcp-tunnel:

1. Di konsol Google Cloud, buka halaman Cloud Workstations > Workstations.

   Buka Workstation

2. Klik nama workstation untuk membuka halaman Workstation details.

3. Pada contoh berikut, ganti placeholder untuk nama workstation, region (lokasi), nama cluster workstation, dan nama konfigurasi workstation. Salin nilai dari panel detail Workstation ke placeholder yang ditandai dengan ikon Edit edit.

   gcloud workstations start-tcp-tunnel \
     --project=PROJECT_ID \
     --region=REGION \
     --cluster=CLUSTER_NAME \
     --config=CONFIG_NAME \
     --local-host-port=:LOCAL_PORT \
     WORKSTATION_NAME 22
   

   Lihat bagian Sebelum memulai untuk menemukan project ID.

   Flag --local-host-port=:LOCAL_PORT bersifat opsional. Jika Anda ingin menentukan port lokal, ganti LOCAL_PORT dengan nomor port lokal yang ingin Anda gunakan. Jika Anda tidak menentukan port lokal, sistem akan memilih port lokal arbitrer yang tidak digunakan untuk Anda, dan menampilkan pesan dengan nomor port sehingga Anda tahu port lokal mana yang digunakan.

4. Setelah mengisi placeholder, klik content_copy Copy code sample untuk menyalin perintah CLI gcloud.

5. Tempelkan perintah ke jendela terminal lokal Anda, lalu tekan Enter untuk membuat tunnel.

   Jika perintah berhasil, pesan Listening on port akan muncul, diikuti dengan nomor port lokal.

Untuk mengetahui detail selengkapnya tentang setiap flag konfigurasi, lihat SSH tunnel atau start-tcp-tunnel.

Menghubungkan ke host Cloud Workstations

Ikuti langkah-langkah berikut untuk terhubung ke host Cloud Workstations:

1. Buka atau kembali ke aplikasi VS Code.

2. Untuk meluncurkan Remote - SSH, klik Open a Remote Window di status bar.

   

3. Pilih opsi Connect to Host saat palet perintah terbuka.

   

4. Masukkan user@localhost:LOCAL_PORT, dengan mengganti LOCAL_PORT dengan nomor port lokal Anda.

   Contoh berikut terhubung ke port lokal 1025 dengan menentukan user@localhost:1025.

   

   Catatan: Kunci host untuk workstation berubah di antara sesi karena workstation berjalan di VM sementara. Pastikan validasi kunci host dinonaktifkan untuk konfigurasi workstation karena alasan ini.

5. Jika diminta untuk terhubung setelah Anda melihat pesan konfirmasi Host Added, klik Connect.

   Sistem juga mungkin meminta Anda untuk mengonfirmasi hash. Jika diminta, klik Lanjutkan.

6. Editor VS Code baru akan terbuka dan status bar VS Code akan menampilkan SSH: localhost: diikuti dengan nomor port.

   Sekarang Anda memiliki akses ke file dan server bahasa di workstation jarak jauh, dan Anda dapat mem-build dan menjalankan proses yang berjalan di dalam workstation.

   Contoh berikut menunjukkan jendela editor VS Code yang terhubung ke Cloud Workstation melalui SSH: localhost: 1025.

   

   Anda juga dapat kembali ke Extensions Marketplace untuk menginstal Cloud Code dan ekstensi VS Code lokal lainnya untuk membantu Anda mem-build, menjalankan, dan menguji kode.