Mengembangkan kode menggunakan Posit Workbench (termasuk RStudio Pro)

Perhatian: Penyedia pihak ketiga mengelola image container yang tercantum di bagian ini. Google Cloud tidak membangun, mengelola, atau mendukung image ini secara resmi. Evaluasi setiap solusi dengan cermat sebelum men-deploy-nya di lingkungan produksi Anda.

Pelajari cara mulai mengembangkan kode menggunakan Posit Workbench dan RStudio Pro dengan Cloud Workstations. Panduan ini akan memandu Anda mengonfigurasi lingkungan, membuat workstation, dan meluncurkan sesi RStudio Pro.

Sebelum memulai

Panduan ini membahas langkah-langkah bagi administrator untuk menyiapkan Cloud Workstations dan bagi developer untuk menggunakan workstation.

Untuk menyiapkan Cloud Workstations, selesaikan langkah-langkah berikut:

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

1. Aktifkan Cloud Workstations API, jika belum diaktifkan.

   Peran yang diperlukan untuk mengaktifkan API

   Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

   Mengaktifkan API

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola dan menggunakan workstation, minta administrator untuk memberi Anda peran IAM berikut:

• Membuat dan mengelola cluster dan konfigurasi workstation: Cloud Workstations Admin (roles/workstations.admin) di project
• Membuat workstation menggunakan konfigurasi: Cloud Workstations Creator (roles/workstations.workstationCreator) pada project atau konfigurasi workstation
• Menggunakan workstation: Cloud Workstations User (roles/workstations.user) di workstation. Peran ini otomatis diberikan di workstation yang Anda buat.

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk ringkasan mendetail tentang semua peran Cloud Workstations, lihat Kontrol akses dengan IAM.

Membuat konfigurasi workstation

Untuk menggunakan Posit Workbench (termasuk RStudio Pro), Anda harus membuat konfigurasi workstation untuk developer di organisasi Anda:

1. Temukan kunci lisensi Posit Workbench Anda dan simpan di dekat Anda karena Anda memerlukannya di langkah berikutnya. Jika Anda memerlukan kunci lisensi Posit Workbench, hubungi perwakilan Posit Customer Success atau kirim email ke [e-mail].

2. Ikuti petunjuk untuk membuat konfigurasi workstation.

   1. Saat Anda sampai pada langkah Penyesuaian lingkungan, pilih Editor kode pada image dasar.

   2. Dari menu Editor Kode, pilih 'Posit Workbench (termasuk RStudio Pro) Third-party provided'.

   3. Klik panah peluas arrow_drop_down di bagian Opsi container lanjutan.

      1. Buka bagian Environment variables, lalu klik Add variable.

      2. Masukkan RSW_LICENSE di kolom Key dan tempelkan kunci lisensi Posit Workbench Anda ke kolom Value.

         

      3. Klik Lanjutkan.

   4. Saat Anda sampai pada langkah Add users, berikan izin akses IAM Cloud Workstations kepada developer Anda untuk konfigurasi workstation.

   5. Untuk membuat konfigurasi workstation dan menambahkan pengguna ini ke dalamnya, klik Create.

      Jika Anda juga memilih untuk membuat cluster baru, pembuatan cluster dapat memerlukan waktu hingga 20 menit.

   Developer di tim Anda sekarang dapat membuat workstation dengan Posit Workbench.

Menyiapkan workstation Anda

Untuk membuat workstation, ikuti langkah-langkah berikut:

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

   Buka Workstations

2. Klik add_boxCreate.

   Link Create mungkin dinonaktifkan jika tidak ada konfigurasi dalam project atau jika Anda tidak memiliki izin untuk melihatnya. Minta Admin Cloud Workstations organisasi Anda untuk membuat konfigurasi workstation untuk Anda.

3. Masukkan Nama workstation Anda.

   Ikuti konvensi penamaan resource Compute Engine dan pilih nama yang unik dalam cluster workstation.

4. Klik panah peluas arrow_drop_down di kolom Configuration, lalu pilih konfigurasi workstation Posit Workbench (Third-party).

5. Klik Create untuk membuat workstation Anda.

Meluncurkan workstation Anda

Setelah membuat workstation, Anda dapat memulai dan meluncurkannya untuk memulai pengembangan:

1. Klik Workstations.
2. Temukan workstation yang Anda buat dalam daftar workstation yang tersedia, centang kotak di sampingnya, lalu klik Start. Tindakan ini akan memulai workstation Anda, dan mencocokkannya dengan konfigurasi workstation induk.
3. Jika diminta untuk memulai workstation, klik Start untuk mengonfirmasi. Status akan berubah menjadi Starting dan ikon status refreshakan berputar saat operasi mulai sedang berlangsung. Mungkin perlu waktu beberapa menit untuk memulai workstation Anda.
4. Setelah workstation siap, statusnya akan berubah menjadi Running dan ikon status akan berubah menjadi tanda centang check_circle.
5. Klik Launch.

Meluncurkan sesi Posit Workbench RStudio Pro

1. Contoh berikut menunjukkan halaman sambutan untuk Posit Workbench. Halaman Anda mungkin terlihat berbeda, bergantung pada cara organisasi Anda menentukan konfigurasi workstation:

   

2. Klik New Session.

3. Pilih RStudio Pro sebagai IDE dan biarkan Cluster ditetapkan ke Local.

   

   Untuk mengetahui informasi selengkapnya tentang Posit Workbench dan IDE yang didukungnya, seperti Jupyter Notebook, JupyterLab, dan VS Code, lihat dokumentasi Posit.

4. Klik Start Session.

5. Tunggu hingga sesi dimulai, lalu mulailah membuat kode.

   

Mengupload file ke workstation Anda

1. Untuk mengupload file dari komputer lokal ke workstation, klik Upload.

   

2. Pilih Target directory tempat Anda ingin menyimpan file di workstation.

3. Klik Pilih File untuk memilih file yang akan diupload.

4. Untuk memulai upload, klik OK.

Untuk mengupload beberapa file atau direktori, buat file ZIP. File ZIP akan diperluas setelah diupload.

Mengimpor file dari workstation Anda

1. Untuk mengimpor file dari workstation Anda, klik Import dataset dan pilih jenis set data.

   

2. Buka dan pilih set data yang akan diimpor dari workstation Anda.

   IDE Posit Workbench memiliki dependensi pada berbagai paket R untuk berbagai bagian fitur. Misalnya, jika Anda mengupload file Excel, paket tertentu perlu diinstal. Jika diminta untuk menginstal paket yang diperlukan, klik Yes.

3. Untuk memulai impor, klik Impor.

Mendapatkan dukungan untuk masalah Posit Workbench

Jika Anda mengalami masalah dengan Posit Workbench atau dengan image container Posit Workbench, laporkan ke Posit di [e-mail].

Langkah berikutnya

• Pelajari cara menyesuaikan image container dengan kebutuhan organisasi Anda.

• Lihat hub dokumentasi Posit Software untuk mempelajari lebih lanjut Posit Workbench.