Sviluppare codice utilizzando Posit Workbench (incluso RStudio Pro)

Scopri come iniziare a sviluppare codice utilizzando Posit Workbench e RStudio Pro con Cloud Workstations. Questa guida ti illustra la configurazione dell'ambiente, la creazione di una workstation e l'avvio di una sessione di RStudio Pro.

Prima di iniziare

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

Per configurare Cloud Workstations, completa i seguenti passaggi:

  1. Accedi al tuo Google Cloud account. Se non hai mai utilizzato Google Cloud, crea un account per valutare il rendimento dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per eseguire, testare ed eseguire il deployment dei carichi di lavoro.

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

    Go to project selector

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

  4. Verify that billing is enabled for your Google Cloud project.

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

    Go to project selector

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

  7. Verify that billing is enabled for your Google Cloud project.

  8. Abilita l'API Cloud Workstations.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin), che contiene 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 di Cloud Workstations (roles/workstations.admin) sul progetto
  • Crea workstation utilizzando una configurazione: Creator di Cloud Workstations (roles/workstations.workstationCreator) sul progetto o sulla configurazione della workstation
  • Utilizza una workstation: Utente di 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 di Cloud Workstations, consulta Controllo dell'accesso 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 di Posit Workbench, contatta il tuo rappresentante di Posit Customer Success o invia un'email all'indirizzo sales@posit.co.

  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, quindi 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 le autorizzazioni di accesso IAM di Cloud Workstations alla configurazione della workstation.

    5. Per creare la configurazione della workstation e aggiungere questi 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 workstation

Per creare una workstation:

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

    Vai a Workstation

  2. Fai clic su add_boxCrea.

    Il link Crea potrebbe essere disattivato se non sono presenti 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 freccia di espansione arrow_drop_down nel campo Configurazione e seleziona la configurazione della workstation Posit Workbench (di 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 poi fai clic su Avvia. In questo modo la workstation viene avviata e associata alla configurazione della workstation principale.
  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 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 supportati, 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 scrivere codice.

Carica i file sulla workstation

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

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

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

  4. Per avviare 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 workstation

  1. Per importare i file dalla 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 ha dipendenze 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.

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 support@posit.co.

Passaggi successivi

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

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