Mengembangkan kode menggunakan Posit Workbench (termasuk RStudio Pro)

Perhatian: Penyedia pihak ketiga mengelola image penampung yang tercantum di bagian ini. Google Cloud tidak membuat, mengelola, atau mendukung secara resmi image ini. 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 mencakup langkah-langkah bagi administrator untuk menyiapkan Cloud Workstations dan bagi developer untuk menggunakan workstation.

Untuk menyiapkan Cloud Workstations, selesaikan langkah-langkah berikut:

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

Jika Anda menggunakan project yang sudah ada untuk panduan ini, pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini. Jika berhasil membuat project baru, berarti Anda sudah memiliki izin yang diperlukan.

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

Jika Anda menggunakan project yang sudah ada untuk panduan ini, pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini. Jika berhasil membuat project baru, berarti Anda sudah memiliki izin yang diperlukan.

Verify that billing is enabled for your Google Cloud project.

1. Enable the Cloud Workstations API.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the 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
• Buat workstation menggunakan konfigurasi: Cloud Workstations Creator (roles/workstations.workstationCreator) di project atau konfigurasi workstation
• Menggunakan workstation: Pengguna Cloud Workstations (roles/workstations.user) di workstation. Izin 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 mengetahui ringkasan mendetail tentang semua peran Cloud Workstations, lihat Kontrol akses dengan IAM.

Buat 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 akan memerlukannya di langkah berikutnya. Jika Anda memerlukan kunci lisensi Posit Workbench, hubungi perwakilan Customer Success Posit Anda atau kirim email ke [e-mail].

2. Ikuti petunjuk untuk membuat konfigurasi workstation.

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

   2. Dari menu Code editors, pilih 'Posit Workbench (including RStudio Pro) Third-party provided'.

   3. Klik panah peluas arrow_drop_downdi 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 mencapai langkah Tambahkan pengguna, berikan izin akses IAM Cloud Workstations kepada developer Anda untuk konfigurasi workstation.

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

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

   Developer di tim Anda kini 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_boxBuat.

   Link Buat 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 arrow_drop_downpeluas di kolom Configuration, lalu pilih konfigurasi workstation Posit Workbench (Pihak ketiga).

5. Klik Buat untuk membuat workstation Anda.

Luncurkan workstation Anda

Setelah membuat workstation, Anda dapat memulainya, lalu meluncurkannya untuk memulai pengembangan:

1. Klik Workstation.
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 berubah menjadi Memulai dan ikon status refreshberputar saat operasi mulai sedang berlangsung. Mungkin perlu waktu beberapa menit untuk memulai workstation.
4. Setelah workstation Anda siap, statusnya akan berubah menjadi Running dan ikon status akan berubah menjadi tanda centang check_circle.
5. Klik Launch.

Meluncurkan sesi RStudio Pro Posit Workbench

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

   

2. Klik Sesi Baru.

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 Mulai Sesi.

5. Tunggu hingga sesi dimulai, lalu mulai coding.

   

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 diekstrak setelah diupload.

Mengimpor file dari workstation Anda

1. Untuk mengimpor file dari workstation Anda, klik Impor set data, lalu 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 harus diinstal. Jika diminta untuk menginstal paket yang diperlukan, klik Ya.

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 masalah tersebut ke Posit di [e-mail].

Langkah berikutnya

• Pelajari cara menyesuaikan image container dengan kebutuhan organisasi Anda.

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