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

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

Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

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

Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

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

Rôles requis

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

• Créer et gérer des clusters et des configurations de postes de travail : Administrateur Cloud Workstations (roles/workstations.admin) pour le projet
• Créez 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.
• Utilisez une station de travail : Utilisateur Cloud Workstations (roles/workstations.user) sur la station de travail. Cette autorisation est automatiquement accordée sur les postes 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 avec 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 Customer Success ou envoyez un e-mail à [e-mail].

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

   1. À l'étape 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 arrow_drop_down pour développer 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. À l'étape Ajouter des utilisateurs, accordez à vos développeurs les 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 poste de travail

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

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

   Accéder à Workstations

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 de dénomination des 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 Postes de travail.
2. Recherchez la station de travail que vous avez créée dans la liste des stations de travail disponibles, cochez la case à côté, 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 poste 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 RStudio Pro Posit Workbench

1. L'exemple suivant montre la page d'accueil de Posit Workbench. L'apparence de votre page peut varier en fonction de la façon dont votre organisation définit la configuration de votre poste de travail :

   

2. Cliquez sur Nouvelle session.

3. Sélectionnez RStudio Pro comme IDE et laissez 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 que la session démarre, puis commencez à coder.

   

Importer des fichiers sur votre poste de travail

1. Pour importer des fichiers de votre ordinateur local vers votre poste de travail, cliquez sur Importer.

   

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

3. Cliquez sur Sélectionner un fichier pour choisir 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 poste de travail

1. Pour importer des fichiers depuis votre poste 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 poste de travail, puis 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, certains packages doivent être installés. Si vous êtes invité à installer les packages requis, cliquez sur Oui.

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

Obtenir de l'aide pour 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].

Étapes suivantes

• Découvrez comment personnaliser les images de conteneurs pour répondre aux besoins de votre organisation.

• Pour en savoir plus sur Posit Workbench, consultez le hub de documentation de Posit Software.