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 JetBrains IDEs dan JetBrains Gateway versi terbaru, dan satu versi sebelumnya. Saat versi utama JetBrains IDE yang baru dirilis, rilis plugin Cloud Workstations berikutnya akan mendukung versi baru tersebut dan menghentikan dukungan untuk versi paling awal yang sebelumnya didukung.

Untuk memudahkan Anda memperbarui aplikasi JetBrains, Anda juga dapat menginstal JetBrains Toolbox.

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

Sebelum memulai

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

Ikuti langkah-langkah untuk Membuat workstation. Saat diminta memasukkan Configuration, pilih gambar yang sesuai dengan JetBrains IDE yang ingin Anda gunakan.
Setelah memasukkan nama workstation Anda, klik Create.
Klik halaman Workstations dan tunggu hingga workstation selesai dibuat.
Download dan instal Gateway JetBrains versi yang didukung.

Menginstal plugin Cloud Workstations

Instal plugin Cloud Workstations:
1. Buka JetBrains Gateway.
2. Pilih All Provider.
3. Di bagian Install More Provider, cari Google Cloud, lalu klik Install untuk mendownload plugin Cloud Workstations.
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:

Buka JetBrains Gateway.
Di bagian Run the IDE Remotely, klik Connect to Google Cloud.
Klik Login untuk login ke Akun Google Anda.
1. Ikuti petunjuk untuk memberi plugin Cloud Workstations akses ke Google Cloud.
2. Klik Continue untuk menyelesaikan proses login.
Klik Browse untuk membuka dialog pemilih project lalu pilih project cloud.
Pilih workstation dalam project cloud, klik Next, dan tunggu hingga workstation yang dipilih dimulai.
Pilih IDE dan project Anda:
1. Pilih versi IDE di host jarak jauh.
2. Masukkan jalur project IDE pada host jarak jauh.
Catatan: Perlu diingat bahwa hanya file yang disimpan dalam direktori /home yang dipertahankan di antara sesi.
Klik Connect, lalu tunggu IDE dan project terbuka.

Menghubungkan kembali ke workstation

Untuk menghubungkan kembali ke workstation dan project IDE dengan cepat:

Buka panel Koneksi terbaru.
Klik jalur project untuk membuka IDE di Cloud Workstations.
Tunggu IDE dan project terbuka.

Gunakan penerusan port

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

Anda juga dapat melakukan porting maju dari Cloud Workstations ke komputer lokal Anda secara manual sebagai berikut:

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

Untuk macOS, pilih IntelliJ IDEA > Preferences dari menu utama.
Buka Alat > Penerusan Port, lalu tambahkan aturan baru untuk meneruskan TCP untuk port 8080.
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:

Dari Windows dan Linux, klik settings menu Options > Settings.

Dari macOS, klik settings Options menu > Preferences.
Opsional: Untuk mengakses Settings JetBrains untuk IntelliJ dan IDE lainnya, lihat mengonfigurasi setelan project.
Buka Tools > Google Cloud Workstations > Advanced.
Tambahkan URL pengganti endpoint API.

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

Untuk mengetahui 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 tambahan agar dapat terhubung dengan Gateway Jetbrains. Ikuti langkah-langkah berikut:

Memulai workstation Anda dan membuka koneksi TCP

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

Ikuti petunjuk di bagian Sebelum memulai.

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

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

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

Luncurkan Jetbrains Gateway

Setelah meluncurkan Jetbrains Gateway, pilih Connect via SSH.
Di halaman Connect to SSH, klik Settings untuk menyiapkan koneksi baru.

Dari halaman Konfigurasi SSH:
1. Klik addAdd a new connection.
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, port, dan nama pengguna lokal.
3. Tetapkan Authentication type ke Password dan kosongkan kolom sandi.
4. Hapus opsi untuk Parse file konfigurasi ~/.ssh/config
5. Klik OK untuk membuat koneksi.
6. Klik Check Connection and Continue.
Di halaman Choose IDE and Project, pilih berikut ini:
1. Pilih IDE yang ingin Anda gunakan.
2. Pilih direktori yang berisi project Anda dengan mengklik more_horiz More. Perhatikan bahwa Anda tidak dapat membuat project dari menu ini. Anda hanya dapat membuka project. Untuk membuat project baru, pilih Open an SSH Terminal, lalu jalankan perintah untuk membuat direktori bagi project JetBrains Anda.
  
  Atau, Anda juga dapat mengklik Open an SSH terminal untuk menjalankan perintah git di dalam workstation Anda. Misalnya, perintah berikut meng-clone project Cloud Code Samples di direktori beranda Anda:
```
git clone https://github.com/GoogleCloudPlatform/cloud-code-samples.git
```
3. Setelah memilih direktori project, klik Download and Start IDE.
Setelah IDE terhubung, Anda dapat mengakses file di workstation langsung dari Jetbrains IDE, yang juga dapat menggunakan ekstensi Cloud Workstations untuk membantu mem-build dan menjalankan kode Anda.