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 la configurazione dell'ambiente, la creazione di una workstation e l'avvio di una sessione 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 dei 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.

   Ruoli richiesti per abilitare le API

   Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. 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:

• Crea e gestisci cluster e configurazioni di workstation: Amministratore Cloud Workstations (roles/workstations.admin) sul progetto
• Crea workstation utilizzando una configurazione: Creatore Cloud Workstations (roles/workstations.workstationCreator) sul progetto o sulla configurazione della workstation
• Utilizza una workstation: Utente Cloud Workstations (roles/workstations.user) sulla workstation. Questo accesso viene concesso automaticamente alle 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 Cloud Workstations, consulta Controllo dell'accesso con IAM.

Crea la configurazione della workstation

Per utilizzare Posit Workbench (incluso RStudio Pro), devi creare una configurazione di 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 di 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. Nel menu Editor di codice, seleziona 'Posit Workbench (incluso RStudio Pro) fornito da terze parti'.

   3. Fai clic sulla freccia di espansione arrow_drop_down 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 agli sviluppatori 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 ora dovrebbero essere in grado di creare workstation con Posit Workbench.

Configurare la workstation

Per creare una workstation:

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

   Vai a Workstations

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 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 Postazioni di lavoro.
2. Trova la workstation che hai creato nell'elenco delle workstation disponibili, seleziona la casella di controllo accanto e poi 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 (aggiorna)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 .

Avviare una sessione di RStudio Pro di Posit Workbench

1. L'esempio seguente mostra la pagina di benvenuto di Posit Workbench. L'aspetto della pagina potrebbe variare 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 saperne di più 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 inizia a programmare.

   

Caricare i file sulla workstation

1. Per caricare 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.

Importare file dalla workstation

1. Per importare 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 workstation e selezionalo.

   L'IDE Posit Workbench dipende da vari pacchetti R per diverse funzionalità. Ad esempio, se carichi un file Excel, è necessario 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.

Ricevere assistenza per problemi relativi a 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.

• Consulta l'hub di documentazione di Posit Software per scoprire di più su Posit Workbench.