Mengembangkan kode menggunakan editor VS Code lokal

Pelajari cara membuka tunnel SSH dari mesin lokal ke workstation, lalu gunakan dukungan Pengembangan Jarak Jauh VS Code untuk terhubung ke Cloud Workstations dari editor VS Code lokal Anda.

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 luncurkan workstation Anda.
  3. Saat Anda berada di konsol Google Cloud , salin informasi berikut:

    1. Nama dan ID project: klik nama project di Google Cloud menu bar dan salin ID di dialog Project name and ID yang terbuka.
    2. Wilayah
    3. Nama cluster
    4. Nama konfigurasi
  4. Dari komputer lokal Anda, 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 menyetel project saat ini ke project ID yang Anda salin pada 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.

    Extension Marketplace

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

    2. Klik Install untuk menginstal ekstensi Remote - SSH.

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

      Instal ekstensi 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 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 .

    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 yang tidak digunakan dan arbitrer untuk Anda, serta menampilkan pesan dengan nomor port sehingga Anda mengetahui port lokal yang digunakan.

  4. Setelah mengisi placeholder, klik content_copy Salin contoh kode untuk menyalin perintah CLI gcloud.

  5. Tempel 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 Tunnel SSH 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.

    Menghubungkan ke host

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

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

    Menambahkan host SSH

  5. Jika diminta untuk menghubungkan setelah Anda melihat pesan konfirmasi Host Ditambahkan, klik Hubungkan.

    Sistem juga dapat 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: yang diikuti dengan nomor port.

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

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

    Terhubung ke workstation

    Anda juga dapat kembali ke Marketplace Ekstensi untuk menginstal Cloud Code dan ekstensi VS Code lokal lainnya untuk membantu Anda membangun, menjalankan, dan menguji kode.