Aller au contenu

PlaidCloud Git

PlaidCloud Git est un service Git privé intégré à votre espace de travail. Chaque espace de travail dispose de son propre serveur Git pour stocker du code, de la configuration, des notebooks et tout autre fichier versionné, ainsi que les tickets, les pull requests et les tableaux de projet que votre équipe utilise pour collaborer dessus.

Vous vous connectez avec votre compte PlaidCloud : il n’y a donc ni nom d’utilisateur ni mot de passe distinct à configurer. Les nouveaux dépôts sont privés par défaut, visibles uniquement des membres auxquels vous accordez l’accès.

Sélectionnez Git dans la liste des applications de votre espace de travail. L’onglet Git s’ouvre avec l’hôte de l’espace de travail, votre rôle et une liste Repositories. Utilisez View all in Git pour accéder à l’interface web de Git, Manage who can push (si vous pouvez gérer les groupes) pour ouvrir la gestion des groupes, et le bouton d’actualisation pour recharger. Utilisez ← Back to your workspace in Git pour revenir à PlaidCloud.

Un indicateur de rôle affiche votre niveau : Administrator, Contributor ou Lecteur, avec une ligne précisant ce que cela vous permet de faire. Chaque ligne de dépôt affiche son nom, sa description (lorsqu’il en a une), Mis à jour avec la date, un champ de clonage en lecture seule avec un bouton de copie, et Ouvrir, qui ouvre le dépôt dans Git. Les dépôts que vous créez en privé se trouvent directement dans Git, pas dans cette liste.

Si Git n’est pas configuré pour votre espace de travail, ou est inaccessible, l’onglet Git affiche Git is not available avec le motif, et Réessayer relance la vérification.

Copiez l’adresse de clonage du dépôt depuis sa ligne. La première fois que vous copiez, une carte Set up Git on your computer apparaît avec les étapes ci-dessous. Sélectionnez Ignorer pour la masquer, et How to clone dans l’en-tête pour la faire réapparaître.

  1. Git doit être installé sur votre ordinateur.
  2. Créez un jeton dans Settings → Applications avec l’autorisation write:repository. La carte renvoie vers cette page.
  3. Indiquez à Git qui vous êtes, à l’aide des deux commandes git config --global user.name et user.email affichées, qui contiennent déjà votre nom et votre adresse e-mail.
  4. Clonez le dépôt avec la commande git clone affichée. Lorsque Git demande un mot de passe, collez ce jeton, et non votre mot de passe PlaidCloud.

Chaque commande dispose de son propre bouton de copie. Consultez Dépôts pour la procédure complète. La copie nécessite un accès en écriture et un compte Git activé : si le bouton de copie est désactivé, ouvrez n’importe quel dépôt une fois pour activer votre compte ou, en tant que Lecteur, demandez un accès en écriture comme décrit ci-dessous.

Toute personne ayant accès à Git peut lire les dépôts partagés de l’espace de travail. Deux niveaux supplémentaires permettent d’effectuer des push.

Rôle Ce que vous pouvez faire Accordé par
Lecteur Consulter et cloner les dépôts partagés. Par défaut pour chaque membre.
Contributor Tout ce que peut faire un lecteur, et effectuer des push vers le dépôt apps, où se trouve le code des applications Panel et Dash. Le groupe de sécurité Git Contributors.
Administrator Tout ce que peut faire un contributeur, effectuer des push vers tous les dépôts, y compris udfs, et créer des organisations. Le groupe de sécurité Git Administration.

Le dépôt udfs est réservé aux administrateurs, car les fonctions définies par l’utilisateur s’exécutent sous l’identité du workflow qui les appelle.

Si vous êtes Lecteur, l’onglet Git indique jusqu’à trois administrateurs de l’espace de travail à qui vous pouvez demander de vous ajouter à Git Contributors.

La fenêtre d’une application Panel ou Dash comporte une section Dépôt qui affiche son dépôt, sa branche et l’état de sa génération, avec Edit in browser et Copy clone URL pour les membres qui peuvent effectuer des push. Les applications Panel Studio, ainsi que les applications App Runner sur la connexion PlaidCloud Git gérée, sont des dossiers du dépôt apps : c’est donc ce dépôt qu’affiche leur fenêtre. Consultez Où se trouve votre application. La barre d’outils d’une UDF reposant sur Git comporte Ouvrir, qui ouvre le dépôt sur sa branche dans Git, et Edit in browser pour les administrateurs.

Les administrateurs de l’espace de travail accordent l’accès dans Identité en ajoutant des membres à un groupe de sécurité, ou en ajoutant l’autorisation à un groupe que vous avez créé.

  1. Ajoutez le membre à Git Contributors pour lui permettre d’effectuer des push du code d’application, ou à Git Administration pour en faire un administrateur Git.
  2. Pour donner à chaque nouveau membre l’accès en écriture au code d’application, ajoutez Git Contributors à vos groupes par défaut. Git Administration ne peut pas être un groupe par défaut.
  3. Pour vérifier ce qu’un membre peut faire, ouvrez le membre et sélectionnez l’onglet Git. Il affiche le nom d’utilisateur Git du membre, son niveau et le groupe qui l’accorde.

Une modification s’applique à la prochaine connexion du membre à Git ou à l’ouverture de l’onglet Git. Le compte Git d’un membre suit son appartenance à PlaidCloud. La désactivation ou la suppression d’un membre bloque son compte Git, y compris ses jetons et ses clés SSH, en une heure environ, et sa réactivation le débloque. Rien n’est supprimé : ses dépôts et son historique sont conservés. La connexion à Git par authentification unique ouvre le compte propre du membre. Le personnel du support PlaidCloud dispose automatiquement d’un accès administrateur.

  • Dépôts : créez un dépôt, puis clonez, validez et poussez votre travail
  • Tickets : suivez les tâches, les bogues et les idées avec des étiquettes, des jalons et des responsables
  • Pull requests : proposez des modifications sur une branche et faites-les relire avant la fusion
  • Tableaux de projet : organisez les tickets et les pull requests sur un tableau Kanban
  • Versions et tags : marquez et publiez des instantanés versionnés d’un dépôt
  • Wikis : conservez une documentation détaillée à côté de votre code
  • Paquets : publiez et installez des artefacts de build depuis le registre du dépôt
  • Recherche de code : retrouvez du code, des tickets et des pull requests dans vos dépôts