Les "clés de déploiement" dans GitHub permettent à votre serveur de se connecter directement à votre référentiel GitHub. Lorsque votre serveur est connecté, vous pouvez envoyer des builds directement de votre référentiel vers votre serveur, ce qui peut réduire votre travail. Si votre serveur a besoin d'accéder à plusieurs référentiels, vous pouvez créer un utilisateur machine pour gérer l'accès.
Pas
Partie 1 sur 3: Génération de nouvelles clés
Étape 1. Ouvrez le programme de terminal sur votre ordinateur
Le programme de terminal sur votre ordinateur vous permet d'accéder à distance à votre serveur. Si vous utilisez un ordinateur Linux ou Mac, vous utiliserez le programme Terminal intégré. Si vous utilisez Windows, vous devrez installer un programme comme Cygwin ou GitBash.
- Linux - Appuyez sur Ctrl+Alt+T ou recherchez "terminal".
- Mac - Vous pouvez trouver le programme Terminal dans le dossier Utilitaires.
- Windows - Vous pouvez télécharger Cygwin depuis cygwin.com ou GitBash depuis git-scm.com/downloads.
Étape 2. Connectez-vous à votre serveur à l'aide de votre programme de terminal
Vous générerez la clé de déploiement sur votre serveur afin qu'il puisse accéder à votre référentiel GitHub. Pour ce faire, vous devrez vous connecter à votre serveur, soit à distance via votre terminal, soit localement sur le serveur.
Dans votre programme de terminal, tapez ssh username@hostname pour vous connecter. Entrez votre mot de passe si vous y êtes invité
Étape 3. Saisissez la commande pour générer la clé SSH
La commande suivante créera une nouvelle clé avec votre adresse e-mail GitHub comme libellé:
- ssh-keygen -t rsa -b 4096 -C "[email protected]"
- Une clé SSH est une paire de clés cryptée qui authentifie votre identité. Dans ce cas, vous attribuerez la clé à votre référentiel GitHub, lui permettant d'identifier votre serveur.
Étape 4. Appuyez sur
Entrée/⏎ Retour lorsque vous êtes invité à sélectionner un emplacement.
Cela enregistrera la clé dans l'emplacement par défaut, qui est le répertoire.ssh dans votre répertoire utilisateur.
Étape 5. Créez une phrase secrète
Cela ajoute une couche de sécurité supplémentaire à votre clé, car les utilisateurs inconnus devront saisir la phrase secrète avant que la clé ne fonctionne.
Vous serez invité à confirmer la phrase secrète lors de sa création
Étape 6. Copiez le contenu de la clé SSH dans votre presse-papiers
Une fois la clé créée, vous devrez l'ajouter à votre référentiel. Pour ce faire, vous devrez copier le contenu de la clé. La commande suivante copiera le contenu de la clé dans votre presse-papiers:
- Linux - xclip -sel clip < ~/.ssh/id_rsa.pub. Vous devrez peut-être d'abord exécuter sudo apt-get install xclip.
- Windows - clip < ~/.ssh/id_rsa.pub
- Mac - pbcopy < ~/.ssh/id_rsa.pub
Partie 2 sur 3: Ajout de la clé à votre référentiel
Étape 1. Connectez-vous au site Web GitHub
Assurez-vous de vous connecter avec un compte pouvant accéder au référentiel.
Étape 2. Cliquez sur votre image de profil dans le coin supérieur droit et sélectionnez "Votre profil
" Cela ouvrira votre page de profil GitHub.
Étape 3. Cliquez sur l'onglet "Référentiels"
Cela affichera tous vos dépôts.
Étape 4. Sélectionnez le référentiel auquel vous souhaitez ajouter la clé
Cela permettra à votre serveur d'accéder au référentiel pour déployer automatiquement les builds.
Étape 5. Cliquez sur l'onglet "Paramètres" en haut de l'écran
Cela ouvrira les paramètres de votre référentiel.
Étape 6. Cliquez sur le bouton "Déployer les clés" dans le menu de gauche
Cela affichera les clés de déploiement actuellement affectées au référentiel.
Étape 7. Cliquez sur le bouton "Ajouter une clé de déploiement"
Un champ de texte pour la clé apparaîtra.
Étape 8. Collez la clé de déploiement copiée dans le champ
Cliquez sur le champ et appuyez sur ⌘ Commande/Ctrl+V pour coller la clé de déploiement copiée dans le champ.
Si vous souhaitez que le serveur ait un accès en écriture au référentiel, cochez la case "Autoriser l'accès en écriture"
Étape 9. Cliquez sur "Ajouter une clé" pour ajouter votre clé de déploiement
Cela permettra à votre serveur d'accéder au référentiel et de déployer des builds à partir de celui-ci.
Partie 3 sur 3: Création d'un utilisateur de machine
Étape 1. Créez un compte GitHub dédié pour l'utilisateur de la machine
Un « utilisateur machine » est un utilisateur automatisé qui peut accéder à plusieurs référentiels. Ceci est utile si votre serveur a besoin d'accéder à plusieurs référentiels, car les clés de déploiement n'accordent l'accès qu'à un seul référentiel.
Vous pouvez créer un nouvel utilisateur en cliquant sur le bouton "S'inscrire" sur la page d'accueil GitHub et en suivant les instructions
Étape 2. Générez une clé SSH sur votre serveur
Suivez les étapes de la première section pour générer une clé sur votre serveur et copiez-la dans votre presse-papiers.
Étape 3. Connectez-vous au site Web GitHub avec le nouveau compte d'utilisateur de la machine
Vous allez attribuer la clé nouvellement créée à cet utilisateur.
Étape 4. Cliquez sur la photo de profil de l'utilisateur de la machine et sélectionnez "Paramètres
" Cela ouvrira les paramètres du compte pour l'utilisateur de la machine.
Étape 5. Cliquez sur l'option "Clés SSH et GPG" dans le menu de gauche
Cela affichera les touches actuellement attribuées à l'utilisateur.
Étape 6. Cliquez sur le bouton "Nouvelle clé SSH"
Cela vous permettra d'entrer la clé SSH.
Étape 7. Collez la clé et cliquez sur "Ajouter une clé SSH
" Cela ajoutera la clé SSH au profil de l'utilisateur de la machine, lui permettant d'accéder à votre serveur.
Étape 8. Ouvrez le premier référentiel auquel vous souhaitez donner accès à l'utilisateur de la machine
Vous pouvez trouver vos référentiels dans l'onglet "Dépôts" de votre page de profil.
Étape 9. Cliquez sur l'onglet "Paramètres" sur la page du référentiel
Cela affichera les paramètres du référentiel.
Étape 10. Cliquez sur l'option "Collaborateurs" dans le menu de gauche
Cela vous permettra d'ajouter des collaborateurs au référentiel. En ajoutant l'utilisateur de votre machine en tant que collaborateur, il pourra pousser les builds de votre référentiel vers votre serveur.
Étape 11. Saisissez le nom de l'utilisateur de la machine et cliquez sur « Ajouter un collaborateur
" L'utilisateur de la machine disposera d'un accès en lecture/écriture au référentiel.