Sviluppare codice utilizzando Posit Workbench (incluso RStudio Pro)

Attenzione: un provider di terze parti gestisce l'immagine container elencata in questa sezione. Google Cloud non crea, gestisce o supporta ufficialmente questa immagine. Valuta attentamente qualsiasi soluzione prima di eseguirne il deployment nel tuo ambiente di produzione.

Scopri come iniziare a sviluppare codice utilizzando Posit Workbench e RStudio Pro con Cloud Workstations. Questa guida illustra come configurare l'ambiente, creare una workstation e avviare una sessione di RStudio Pro.

Prima di iniziare

Questa guida illustra i passaggi per gli amministratori per configurare Cloud Workstations e per gli sviluppatori per utilizzare le workstation.

Per configurare Cloud Workstations, completa i seguenti passaggi:

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment di 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. Abilita l'API Cloud Workstations, se non è già abilitata.

   Ruoli richiesti per abilitare le API

   Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

   Abilitare l'API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire e utilizzare le workstation, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Creare e gestire configurazioni e cluster di workstation: Cloud Workstations Admin (roles/workstations.admin) nel progetto
• Creare workstation utilizzando una configurazione: Cloud Workstations Creator (roles/workstations.workstationCreator) sul progetto o sulla configurazione della workstation
• Utilizza una workstation: Cloud Workstations User (roles/workstations.user) sulla workstation. Questo ruolo viene concesso automaticamente sulle workstation che crei.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per una panoramica dettagliata di tutti i ruoli di Cloud Workstations, consulta Controllo degli accessi con IAM.

Crea la configurazione della workstation

Per utilizzare Posit Workbench (incluso RStudio Pro), devi creare una configurazione della workstation per gli sviluppatori della tua organizzazione:

1. Trova il codice licenza di Posit Workbench e tienilo a portata di mano perché ti servirà in un passaggio successivo. Se hai bisogno di un codice licenza Posit Workbench, contatta il tuo rappresentante Customer Success di Posit o invia un'email all'indirizzo [e-mail].

2. Segui le istruzioni per creare una configurazione della workstation.

   1. Quando arrivi al passaggio Personalizzazione dell'ambiente, seleziona Editor di codice su immagini di base.

   2. Dal menu Editor di codice, seleziona "Posit Workbench (con RStudio Pro) fornito da terze parti".

   3. Fai clic sulla arrow_drop_downfreccia di espansione nella sezione Opzioni container avanzate.

      1. Vai alla sezione Variabili di ambiente e fai clic su Aggiungi variabile.

      2. Inserisci RSW_LICENSE nel campo Chiave e incolla il codice licenza di Posit Workbench nel campo Valore.

         

      3. Fai clic su Continua.

   4. Quando arrivi al passaggio Aggiungi utenti, concedi ai tuoi sviluppatori le autorizzazioni di accesso IAM di Cloud Workstations alla configurazione della workstation.

   5. Per creare la configurazione di workstation e aggiungervi utenti, fai clic su Crea.

      Se hai scelto di creare un nuovo cluster, questa operazione può richiedere fino a 20 minuti.

   Gli sviluppatori del tuo team dovrebbero ora essere in grado di creare workstation con Posit Workbench.

Configura la tua workstation

Per creare una workstation:

1. Nella console Google Cloud , vai alla pagina Cloud Workstations > Workstation.

   Vai a Workstation

2. Fai clic su add_boxCrea.

   Il link Crea potrebbe essere disabilitato se non esistono configurazioni nel progetto o se non hai le autorizzazioni per visualizzarle. Chiedi all'amministratore di Cloud Workstations della tua organizzazione di creare per te una configurazione della workstation.

3. Inserisci il Nome della workstation.

   Segui le convenzioni di denominazione delle risorse di Compute Engine e scegli un nome univoco all'interno del cluster di workstation.

4. Fai clic sulla arrow_drop_downfreccia di espansione nel campo Configurazione e seleziona la configurazione della workstation Posit Workbench (terze parti).

5. Fai clic su Crea per creare la workstation.

Avvia la workstation

Ora che hai creato la workstation, puoi avviarla e poi lanciarla per iniziare lo sviluppo:

1. Fai clic su Workstation.
2. Trova la workstation che hai creato nell'elenco delle workstation disponibili, seleziona la casella di controllo accanto e fai clic su Avvia. La workstation viene avviata e abbinata alla configurazione della workstation padre.
3. Se ti viene chiesto di avviare la workstation, fai clic su Avvia per confermare. Lo stato diventa In fase di avvio e l'icona di stato refresh gira mentre è in corso l'operazione di avvio. L'avvio della workstation potrebbe richiedere alcuni minuti.
4. Quando la workstation è pronta, lo stato diventa In esecuzione e l'icona di stato check_circle diventa un segno di spunta.
5. Fai clic su Launch .

Avvia una sessione di Posit Workbench RStudio Pro

1. L'esempio seguente mostra la pagina di benvenuto di Posit Workbench. La pagina potrebbe avere un aspetto diverso, a seconda di come la tua organizzazione definisce la configurazione della workstation:

   

2. Fai clic su Nuova sessione.

3. Seleziona RStudio Pro come IDE e lascia Cluster impostato su Locale.

   

   Per ulteriori informazioni su Posit Workbench e sugli IDE che supporta, come Jupyter Notebook, JupyterLab e VS Code, consulta la documentazione di Posit.

4. Fai clic su Avvia sessione.

5. Attendi l'avvio della sessione e poi inizia a programmare.

   

Carica i file sulla tua workstation

1. Per caricare i file dalla tua macchina locale alla tua workstation, fai clic su Carica.

   

2. Seleziona la directory di destinazione in cui vuoi archiviare i file sulla tua workstation.

3. Fai clic su Scegli file per selezionare il file da caricare.

4. Per iniziare il caricamento, fai clic su Ok.

Per caricare più file o una directory, crea un file ZIP. Il file ZIP viene espanso dopo il caricamento.

Importa i file dalla tua workstation

1. Per importare i file dalla tua workstation, fai clic su Importa set di dati e seleziona il tipo di set di dati.

   

2. Vai al set di dati da importare dalla tua workstation e selezionalo.

   L'IDE Posit Workbench ha dipendenze da vari pacchetti R per diverse funzionalità. Ad esempio, se carichi un file Excel, devi installare determinati pacchetti. Se ti viene chiesto di installare i pacchetti richiesti, fai clic su Sì.

3. Per avviare l'importazione, fai clic su Importa.

Ricevi assistenza per i problemi di Posit Workbench

Se riscontri problemi con Posit Workbench o con l'immagine container di Posit Workbench, segnalali a Posit all'indirizzo [e-mail].

Passaggi successivi

• Scopri come personalizzare le immagini container in base alle esigenze della tua organizzazione.

• Per saperne di più su Posit Workbench, consulta l'hub della documentazione di Posit Software.