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:

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

Se utilizzi un progetto esistente per questa guida, verifica di disporre delle autorizzazioni necessarie per completare la guida. Se hai creato un nuovo progetto, disponi già delle autorizzazioni necessarie.

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

Se utilizzi un progetto esistente per questa guida, verifica di disporre delle autorizzazioni necessarie per completare la guida. Se hai creato un nuovo progetto, disponi già delle autorizzazioni necessarie.

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

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. Questa autorizzazione viene concessa 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 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 una 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 la 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 RStudio Pro di Posit Workbench

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