Mengembangkan kode menggunakan editor VS Code lokal

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

Tips: Untuk pengalaman dalam browser, Anda dapat menggunakan Code OSS for Cloud Workstations Cloud Workstations IDE, 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 berada di konsol Google Cloud, salin informasi berikut:

   1. Nama dan ID project: klik nama project di panel menu Google Cloud dan salin ID dalam dialog Nama dan ID project yang terbuka.
   2. Region
   3. Nama cluster
   4. Nama konfigurasi

4. Dari komputer lokal Anda, instal gcloud CLI.

   Jika Anda 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 Anda 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 Extensions Marketplace atau melalui palet perintah.

   Marketplace Ekstensi

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

   2. Klik Install 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 Detail workstation.

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 porta lokal arbitrer yang tidak digunakan untuk Anda, dan menghasilkan pesan yang berisi nomor port tersebut sehingga Anda tahu port lokal mana yang digunakannya.

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

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

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

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

Terhubung 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 antar-sesi karena workstation berjalan pada VM sementara. Pastikan validasi kunci host dinonaktifkan untuk konfigurasi workstation karena alasan ini.

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

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

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

   Anda kini memiliki akses ke file dan server bahasa di workstation jarak jauh, dan Anda dapat membangun serta menjalankan proses yang berjalan di dalam workstation Anda.

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

   

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