Développer du code à l'aide de Posit Workbench (y compris RStudio Pro)

Attention : Un fournisseur tiers gère l'image de conteneur listée dans cette section. Google Cloud ne crée pas, ne gère pas et n'assure officiellement pas la compatibilité de cette image. Évaluez attentivement les solutions avant de les déployer dans votre environnement de production.

Découvrez comment commencer à développer du code à l'aide de Posit Workbench et de RStudio Pro avec Cloud Workstations. Ce guide vous explique comment configurer votre environnement, créer une station de travail et lancer une session RStudio Pro.

Avant de commencer

Ce guide explique aux administrateurs comment configurer Cloud Workstations et aux développeurs comment utiliser les stations de travail.

Pour configurer Cloud Workstations, procédez comme suit :

Connectez-vous à votre Google Cloud compte. Si vous n'avez jamais utilisé Google Cloud, créez un compte pour évaluer les performances de nos produits dans des scénarios réels. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

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. Activez l'API Cloud Workstations.

   Rôles requis pour activer les API

   Pour activer les API, vous avez besoin de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez l'obtenir via le rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

   Activer l'API

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer et utiliser les stations de travail, demandez à votre administrateur de vous accorder les rôles IAM suivants :

• Créer et gérer des clusters et des configurations de stations de travail: Administrateur Cloud Workstations (roles/workstations.admin) sur le projet
• Créer des stations de travail à l'aide d'une configuration: Créateur Cloud Workstations (roles/workstations.workstationCreator) sur le projet ou la configuration de la station de travail
• Utiliser une station de travail: Utilisateur Cloud Workstations (roles/workstations.user) sur la station de travail. Cette autorisation est automatiquement accordée sur les stations de travail que vous créez.

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Pour obtenir une présentation détaillée de tous les rôles Cloud Workstations, consultez Contrôle des accès avec IAM.

Créer la configuration de la station de travail

Pour utiliser Posit Workbench (y compris RStudio Pro), vous devez créer une configuration de station de travail pour les développeurs de votre organisation :

1. Recherchez votre clé de licence Posit Workbench et gardez-la à portée de main, car vous en aurez besoin à une étape ultérieure. Si vous avez besoin d'une clé de licence Posit Workbench, contactez votre représentant Posit Réussite des clients ou envoyez un e-mail à [e-mail].

2. Suivez les instructions pour créer une configuration de station de travail.

   1. Lorsque vous arrivez à l' étape de personnalisation de l'environnement, sélectionnez Éditeurs de code sur des images de base.

   2. Dans le menu Éditeurs de code, sélectionnez Posit Workbench (y compris RStudio Pro) fourni par un tiers.

   3. Cliquez sur la flèche de développement arrow_drop_down dans la section Options avancées des conteneurs.

      1. Accédez à la section Variables d'environnement, puis cliquez sur Ajouter une variable.

      2. Saisissez RSW_LICENSE dans le champ Clé , puis collez votre clé de licence Posit Workbench dans le champ Valeur.

         

      3. Cliquez sur Continuer.

   4. Lorsque vous arrivez à l' étape d'ajout d'utilisateurs, accordez à vos développeurs des autorisations d'accès IAM Cloud Workstations à la configuration de la station de travail.

   5. Pour créer la configuration de votre station de travail et y ajouter ces utilisateurs, cliquez sur Créer.

      Si vous avez également choisi de créer un cluster, la création du cluster peut prendre jusqu'à 20 minutes.

   Les développeurs de votre équipe devraient maintenant pouvoir créer des stations de travail avec Posit Workbench.

Configurer votre station de travail

Pour créer une station de travail, procédez comme suit :

1. Dans la Google Cloud console, accédez à la Cloud Workstations > Workstations page.

   Accéder aux stations de travail

2. Cliquez sur add_boxCréer.

   Le lien Créer peut être désactivé s'il n'existe aucune configuration dans le projet ou si vous ne disposez pas des autorisations nécessaires pour les afficher. Demandez à l'administrateur Cloud Workstations de votre organisation de créer une configuration de station de travail pour vous.

3. Saisissez le nom de votre station de travail.

   Suivez les conventions d'attribution de noms aux ressources Compute Engine et choisissez un nom unique dans le cluster de stations de travail.

4. Cliquez sur la flèche de développement arrow_drop_down dans le champ Configuration , puis sélectionnez la configuration de station de travail Posit Workbench (tiers).

5. Cliquez sur Créer pour créer votre station de travail.

Lancer votre station de travail

Maintenant que vous avez créé votre station de travail, vous pouvez la démarrer, puis la lancer pour commencer le développement :

1. Cliquez sur Stations de travail.
2. Recherchez la station de travail que vous avez créée dans la liste des stations de travail disponibles, cochez la case correspondante, puis cliquez sur Démarrer. Votre station de travail est alors lancée et correspond à la configuration de la station de travail parente.
3. Si vous êtes invité à démarrer votre station de travail, cliquez sur Démarrer pour confirmer. L'état passe à Démarrage et l'icône d'état Actualiser tourne pendant l'opération de démarrage. Le démarrage de votre station de travail peut prendre quelques minutes.
4. Lorsque votre station de travail est prête, l'état passe à En cours d'exécution et l'icône d'état affiche la coche check_circle.
5. Cliquez sur Lancement.

Lancer une session Posit Workbench RStudio Pro

1. L'exemple suivant montre la page de bienvenue de Posit Workbench. Votre page peut être différente, selon la façon dont votre organisation définit la configuration de votre station de travail :

   

2. Cliquez sur Nouvelle session.

3. Sélectionnez RStudio Pro comme IDE et laissez le cluster défini sur Local.

   

   Pour en savoir plus sur Posit Workbench et les IDE qu'il prend en charge, tels que Jupyter Notebook, JupyterLab et VS Code, consultez la documentation Posit.

4. Cliquez sur Démarrer la session.

5. Attendez le démarrage de la session, puis commencez à coder.

   

Importer des fichiers dans votre station de travail

1. Pour importer des fichiers depuis votre machine locale vers votre station de travail, cliquez sur Importer.

   

2. Sélectionnez le répertoire cible dans lequel vous souhaitez stocker les fichiers sur votre station de travail.

3. Cliquez sur Sélectionner un fichier pour sélectionner le fichier à importer.

4. Pour lancer l'importation, cliquez sur OK.

Pour importer plusieurs fichiers ou un répertoire, créez un fichier ZIP. Le fichier ZIP est développé après l'importation.

Importer des fichiers depuis votre station de travail

1. Pour importer des fichiers depuis votre station de travail, cliquez sur Importer un ensemble de données , puis sélectionnez le type d'ensemble de données.

   

2. Accédez à l'ensemble de données à importer depuis votre station de travail et sélectionnez-le.

   L'IDE Posit Workbench dépend de différents packages R pour différentes fonctionnalités. Par exemple, si vous importez un fichier Excel, vous devez installer certains packages. Si vous êtes invité à installer les packages requis, cliquez sur Oui.

3. Pour lancer l'importation, cliquez sur Importer.

Obtenir de l'aide pour résoudre les problèmes liés à Posit Workbench

Si vous rencontrez des problèmes avec Posit Workbench ou avec l'image de conteneur Posit Workbench, signalez-les à Posit à l'adresse [e-mail].

Étape suivante

• Découvrez comment personnaliser les images de conteneurs en fonction des besoins de votre organisation.

• Consultez le centre de documentation Posit Software pour en savoir plus sur Posit Workbench.