Mengembangkan kode menggunakan IDE JetBrains lokal

Plugin Cloud Workstations memungkinkan Anda memulai sesi pengembangan jarak jauh untuk Cloud Workstations menggunakan IDE JetBrains seperti IntelliJ IDEA Ultimate, PyCharm Professional, Rider, CLion, PhpStorm, dan WebStorm.

Sistem operasi yang didukung

Plugin Cloud Workstations mendukung sistem operasi berikut:

• Windows
• macOS (Intel dan Apple Silicon)
• Linux

Versi yang didukung

Plugin Cloud Workstations mendukung versi terbaru, dan satu versi sebelumnya, dari JetBrains IDE dan JetBrains Gateway. Saat versi utama JetBrains IDE baru dirilis, rilis plugin Cloud Workstations berikutnya akan mendukung versi baru dan menghentikan dukungan untuk versi paling awal yang sebelumnya didukung.

Catatan: Dukungan plugin Cloud Workstations untuk Program Akses Awal JetBrains (EAP) dilakukan sebaik mungkin. EAP terkadang memperkenalkan perubahan yang menyebabkan gangguan, dan mungkin perlu waktu beberapa saat untuk mengatasinya.

Untuk mempermudah update aplikasi JetBrains, Anda juga dapat menginstal JetBrains Toolbox.

Untuk mengetahui informasi selengkapnya tentang versi JetBrains IDE di image dasar yang telah dikonfigurasi sebelumnya, lihat catatan rilis Cloud Workstations.

Sebelum memulai

Pastikan untuk mengikuti langkah-langkah berikut sebelum menginstal plugin Cloud Workstations:

1. Ikuti langkah-langkah untuk Membuat workstation. Saat diminta untuk memasukkan Konfigurasi, pilih image yang sesuai dengan IDE JetBrains yang ingin Anda gunakan.

2. Setelah memasukkan nama untuk workstation, klik Buat.

3. Klik halaman Workstations dan tunggu hingga workstation selesai dibuat.

4. Download dan instal versi yang didukung JetBrains Gateway.

Menginstal plugin Cloud Workstations

Catatan: Jika Anda adalah pengguna BYOID, lanjutkan ke bagian Petunjuk koneksi alternatif untuk pengguna BYOID.

1. Instal plugin Cloud Workstations:

   1. Buka JetBrains Gateway.

   2. Pilih Semua Penyedia.

   3. Di bagian Install More Providers, cari Google Cloud, lalu klik Install untuk mendownload plugin Cloud Workstations.

      

2. Setelah penginstalan, Cloud Workstations akan muncul di bagian Run the IDE Remotely.

Menghubungkan menggunakan plugin Cloud Workstations

Untuk terhubung ke workstation menggunakan plugin, ikuti langkah-langkah berikut:

1. Buka JetBrains Gateway.

2. Di bagian Run the IDE Remotely, klik Connect to Google Cloud.

3. Klik Login untuk login ke Akun Google Anda.

   1. Ikuti petunjuk untuk memberikan akses plugin Cloud Workstations ke Google Cloud.

   2. Klik Lanjutkan untuk menyelesaikan login.

4. Klik Browse untuk membuka dialog pemilih project dan memilih project cloud.

   

5. Pilih workstation di bagian project cloud, klik Next, lalu tunggu workstation yang dipilih dimulai.

6. Pilih IDE dan project Anda:

   1. Pilih versi IDE di host jarak jauh.

   2. Masukkan jalur project IDE di host jarak jauh.

      

   Catatan: Perlu diingat bahwa hanya file yang disimpan di direktori /home yang disimpan di antara sesi.

7. Klik Connect dan tunggu IDE dan project terbuka.

Menghubungkan kembali ke workstation

Untuk terhubung kembali dengan cepat ke workstation dan project IDE:

1. Buka panel Koneksi terbaru.

2. Klik jalur project untuk membuka IDE di Cloud Workstations.

   

3. Tunggu IDE dan project terbuka.

Menggunakan penerusan port

Setelah klien JetBrains terbuka dengan IDE dan project, Anda dapat mengakses port jarak jauh di Cloud Workstations dari komputer lokal. Misalnya, saat Anda menjalankan server Python di workstation, python -m SimpleHTTPServer 8080. Dalam kasus tertentu, JetBrains Gateway akan otomatis melakukan penerusan port untuk Anda sehingga Anda dapat mengakses project yang berjalan dari jarak jauh melalui browser lokal.

Anda juga dapat meneruskan port secara manual dari Cloud Workstation ke komputer lokal sebagai berikut:

1. Untuk Windows dan Linux, pilih File > Settings dari menu utama.

   Untuk macOS, pilih IntelliJ IDEA > Preferences dari menu utama.

2. Buka Tools > Port Forwarding, lalu tambahkan aturan baru untuk meneruskan TCP untuk port 8080.

3. Setelah menetapkan aturan ini, Anda dapat mengakses port 8080 Cloud Workstations secara lokal di http://localhost:8080

Mengganti endpoint API

Untuk pengguna Virtual Private Cloud yang perlu mengganti endpoint API, pastikan plugin dapat terhubung ke layanan cloud Anda. Untuk mengganti endpoint API, ikuti langkah-langkah berikut:

1. Dari Windows dan Linux, klik setelan Menu opsi > Setelan.

   

   Dari macOS, klik setelan Menu opsi > Preferensi.

   

2. Opsional: Untuk mengakses Setelan JetBrains untuk IntelliJ dan IDE lainnya, lihat mengonfigurasi setelan project.

3. Buka Alat > Google Cloud Workstations > Lanjutan.

4. Tambahkan URL penggantian endpoint API.

   Catatan: Pastikan Anda menggunakan nama DNS p.googleapis.com Virtual Private Cloud. Jangan gunakan alamat IP.

   

5. Klik Terapkan.

Untuk informasi selengkapnya tentang penggunaan endpoint di Google Cloud, lihat deskripsi Virtual Private Cloud tentang mengakses Google API melalui endpoint.

Petunjuk koneksi alternatif untuk pengguna BYOID

Jika menggunakan BYOID, Anda perlu melakukan langkah-langkah tambahan untuk terhubung dengan Jetbrains Gateway. Ikuti langkah-langkah berikut:

Mulai workstation dan buka koneksi TCP

Langkah-langkah berikut akan memulai workstation dan membuka koneksi TCP:

1. Ikuti petunjuk di bagian Sebelum memulai.

2. Pastikan workstation Anda berjalan. Anda dapat menggunakan perintah CLI gcloud berikut untuk memulainya.

   gcloud workstations start WORKSTATION_ID –-project=PROJECT \
     --cluster=WORKSTATION_CLUSTER_ID --config=WORKSTATION_CONFIG_ID \
     --region=WORKSTATION_CLUSTER_REGION
   

3. Mulai tunnel TCP ke workstation Anda di port 22:

   gcloud workstations start-tcp-tunnel --project=PROJECT \
       --cluster=WORKSTATION_CLUSTER_ID \
       --config=WORKSTATION_CONFIG_ID \
       --region=WORKSTATION_CLUSTER_REGION \
       WORKSTATION_ID 22 --local-host-port=127.0.0.1:2222
   

Catatan: Anda harus memiliki gcloud CLI versi 387.0.0 atau yang lebih baru agar perintah ini didukung. Periksa versi gcloud CLI Anda dengan menjalankan perintah gcloud version. Jika perlu, perbarui dengan perintah gcloud components update.

Setelah penyiapan dan penginstalan awal selesai, langkah berikutnya adalah meluncurkan Jetbrains Gateway.

Meluncurkan Jetbrains Gateway

1. Setelah meluncurkan Jetbrains Gateway, pilih Connect via SSH.

2. Di halaman Connect to SSH, klik Settings untuk menyiapkan koneksi baru.

   Dari halaman Konfigurasi SSH:

   1. Klik Tambahkan koneksi baru.
   2. Masukkan informasi koneksi Anda. Misalnya, Host Lokal=127.0.0.1, Port=2222, dan Nama Pengguna=user. Pastikan untuk menggunakan nilai yang sesuai dengan konfigurasi Anda untuk host lokal, port, dan nama pengguna.
   3. Tetapkan Jenis autentikasi ke Sandi dan kosongkan kolom sandi.
   4. Hapus opsi untuk Parse config file ~/.ssh/config
   5. Klik OK untuk membuat koneksi.
   6. Klik Periksa Koneksi dan Lanjutkan.

3. Di halaman Choose IDE and Project, pilih hal berikut:

   1. Pilih IDE yang ingin Anda gunakan.

   2. Pilih direktori yang berisi project Anda dengan mengklik more_horiz Lainnya. Perhatikan bahwa Anda tidak dapat membuat project dari menu ini. Anda hanya dapat membuka project. Untuk membuat project baru, pilih Buka Terminal SSH dan jalankan perintah untuk membuat direktori bagi project JetBrains Anda.

      Atau, Anda juga dapat mengklik Buka terminal SSH untuk menjalankan perintah git di dalam workstation. Misalnya, perintah berikut meng-clone project Contoh Cloud Code di direktori utama Anda:

      git clone https://github.com/GoogleCloudPlatform/cloud-code-samples.git
      

   3. Setelah memilih direktori project, klik Download and Start IDE.

4. Setelah IDE terhubung, Anda dapat mengakses file di workstation langsung dari IDE Jetbrains, yang juga dapat menggunakan ekstensi Cloud Workstations untuk membantu mem-build dan menjalankan kode Anda.