Votre serveur clone et pousse lui-même vos dépôts, il a donc besoin de sa propre porte d'entrée vers GitHub, GitLab, Bitbucket ou votre propre serveur Git. Les dépôts publics n'ont besoin de rien. Pour les dépôts privés, donnez une fois une clé ou un jeton au serveur ; ensuite, chaque projet fonctionne simplement.
Les clés et les jetons restent sur votre serveur. rdev.cloud ne voit que les clés publiques, et un jeton que vous saisissez dans le panneau est chiffré dans votre navigateur pour votre serveur avant d'être envoyé.
Trois façons d'accéder
| Méthode | Accède à | Idéal pour |
|---|---|---|
| Clé du serveur | Tous les dépôts que votre compte Git peut ouvrir | Un seul compte personnel |
| Comptes | Les dépôts des propriétaires que vous listez, chacun avec sa propre clé SSH ou son jeton | Plusieurs comptes, professionnels et personnels, d'autres hôtes |
| Clé de déploiement | Un seul dépôt | L'accès le plus restreint, dépôts clients |
Quand le serveur clone, il choisit la première méthode qui convient : la clé de déploiement du projet, puis un compte dont l'hôte et le propriétaire correspondent à l'URL, puis la clé du serveur. Si un clone SSH est refusé et que le dépôt est public, il bascule sur HTTPS. Chaque clone se souvient de la façon dont il a été ouvert, de sorte que git pull et git push continuent de fonctionner.
La clé du serveur
Ouvrez le serveur sous Serveurs, allez à l'onglet Accès et trouvez Accès Git. Choisissez Générer la clé la première fois, copiez la clé et ajoutez-la à votre compte : GitHub, GitLab et Bitbucket ont chacun un bouton qui ouvre la bonne page. La même clé fonctionne pour les push, votre agent IA peut donc aussi pousser.
Depuis le terminal du serveur :
rdev git key # print the key (made on first use)
rdev git key --rotate # make a new one; remove the old one from your hosts
Comptes
Ajoutez autant de comptes que vous voulez : deux comptes GitHub, un GitLab d'entreprise, Bitbucket et un Gitea auto-hébergé côte à côte. Chaque compte a :
- Nom : court, comme
workoupersonal. - Hôte :
github.com,gitlab.com,bitbucket.orgou le vôtre, avec:portquand SSH n'est pas sur 22. - Propriétaires : utilisateurs ou organisations, facultatif. Les dépôts qui en dépendent utilisent ce compte ; sans propriétaires, tous les dépôts de l'hôte l'utilisent.
- Clé SSH ou jeton : un compte SSH reçoit sa propre clé à ajouter sur l'hôte. Un compte à jeton clone en HTTPS avec un jeton d'accès personnel (jeton à granularité fine GitHub, jeton personnel ou de projet GitLab, jeton d'API Bitbucket, PAT Azure DevOps). GitLab attend le nom d'utilisateur
oauth2, Bitbucket votre e-mail.
Dans le panneau, choisissez Ajouter un compte. Dans l'application pour ordinateur portable, la même liste se trouve dans l'onglet Intégrations. Depuis le terminal :
rdev git account add work --host github.com --owner acme
echo "$TOKEN" | rdev git account add lab --host git.example.com --token --user oauth2
rdev git account list
rdev git account remove lab
Clés de déploiement
Une clé de déploiement ouvre un seul dépôt. Sous Clés de déploiement, saisissez le nom du projet (un projet existant ou celui que vous êtes sur le point d'ajouter) et choisissez Générer la clé de déploiement, puis ajoutez la clé aux clés de déploiement du dépôt, avec accès en écriture si l'agent doit pousser. Quand vous ajoutez le projet, cochez Utiliser la clé de déploiement du projet, ou exécutez :
rdev git key --project shop
rdev project add shop --git [email protected]:acme/shop.git --deploy-key
Faire confiance à un hôte
Le serveur connaît déjà les clés de GitHub, GitLab et Bitbucket. La première fois qu'il rencontre un autre hôte, il ne se connecte pas à l'aveugle : l'hôte apparaît sous Hôtes en attente de confiance avec son empreinte. Comparez-la à celle que publie votre hôte Git et choisissez Faire confiance, ou exécutez rdev git trust git.example.com --fingerprint SHA256:….
Tester l'accès
Avant d'ajouter un projet, collez son URL sous Tester l'accès. Le serveur essaie de le lire et, si vous cochez Vérifier aussi qu'il peut faire un push, d'y pousser sans rien modifier. La réponse indique quelle clé ou quel jeton il a utilisé, ou ce qu'il faut faire ensuite. Depuis le terminal : rdev git test <url> [--write].