{"meta":{"title":"Ajout d’exécuteurs auto-hébergés","intro":"Vous pouvez ajouter un exécuteur auto-hébergé à un dépôt, à une organisation ou à une entreprise.","product":"GitHub Actions","breadcrumbs":[{"href":"/fr/actions","title":"GitHub Actions"},{"href":"/fr/actions/how-tos","title":"Guides pratiques"},{"href":"/fr/actions/how-tos/manage-runners","title":"Gérer les exécuteurs"},{"href":"/fr/actions/how-tos/manage-runners/self-hosted-runners","title":"Exécuteurs auto-hébergés"},{"href":"/fr/actions/how-tos/manage-runners/self-hosted-runners/add-runners","title":"Ajouter des runners"}],"documentType":"article"},"body":"# Ajout d’exécuteurs auto-hébergés\n\nVous pouvez ajouter un exécuteur auto-hébergé à un dépôt, à une organisation ou à une entreprise.\n\n> \\[!WARNING]\n> Nous vous recommandons d’utiliser uniquement des exécuteurs auto-hébergés avec des dépôts privés. En effet, les duplications (forks) de votre dépôt public peuvent exécuter du code potentiellement dangereux sur la machine de votre exécuteur auto-hébergé en créant une demande de tirage qui exécute le code dans un workflow.\n>\n> Pour plus d’informations, consultez « [Informations de référence sur l’utilisation sécurisée](/fr/actions/reference/security/secure-use) ».\n\n## Prérequis\n\nAvant d’ajouter un runner auto-hébergé, vous devez comprendre ce qu’ils sont et comment ils fonctionnent. Consultez [Exécuteurs auto-hébergés](/fr/actions/concepts/runners/self-hosted-runners).\n\nEn outre, vous devez répondre aux exigences suivantes :\n\n* Vous devez avoir accès à la machine que vous utiliserez comme exécuteur auto-hébergé dans votre environnement.\n\n## Ajout d’un exécuteur auto-hébergé dans un dépôt\n\nVous pouvez ajouter des exécuteurs auto-hébergés dans un dépôt individuel. Pour ajouter un exécuteur auto-hébergé dans un dépôt utilisateur, vous devez être propriétaire du dépôt. Pour un référentiel d’organisation, « Gérer les exécuteurs d’organisation et les groupes d’exécuteurs ».vous devez être propriétaire de l’organisation ou avoir un accès administrateur au référentiel.\n\nPour obtenir des informations sur la façon d’ajouter un exécuteur auto-hébergé avec l’API REST, consultez « [Points de terminaison d’API REST pour les exécuteurs auto-hébergés](/fr/rest/actions/self-hosted-runners) ».\n\n> \\[!NOTE]\n> Organisation peuvent choisir quels référentiels sont autorisés à créer des exécuteurs auto-hébergés au niveau du dépôt.\n>\n> Pour plus d’informations, consultez [Désactivation ou limitation des GitHub Actions pour votre organisation](/fr/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#limiting-the-use-of-self-hosted-runners).\n\n1. Sur GitHub, accédez à la page principale du référentiel.\n\n2. Sous le nom de votre référentiel, cliquez sur ** Paramètres**. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant **** , puis cliquez sur **Paramètres**.\n\n \n\n3. Dans la barre latérale gauche, cliquez sur ** Actions**, puis sur **Exécuteurs**.\n\n4. Cliquez sur **Nouvel exécuteur auto-hébergé**.\n\n5. Sélectionnez l’image et l’architecture du système d’exploitation de votre machine d’exécuteur auto-hébergée.\n\n \n\n6. Des instructions vous montrent comment télécharger l’application d’exécuteur et l’installer sur votre machine d’exécuteur auto-hébergée.\n\n Ouvrez un interpréteur de commandes sur votre machine d’exécuteur auto-hébergée et exécutez toutes les commandes shell dans l’ordre indiqué.\n\n > \\[!NOTE]\n > Sur Windows, si vous souhaitez installer l’application d’exécuteur auto-hébergée en tant que service, vous devez ouvrir un interpréteur de commandes avec des privilèges d’administrateur. Nous vous recommandons également d’utiliser `C:\\actions-runner` comme répertoire pour l’application de l’exécuteur auto-hébergé afin que les comptes système Windows puissent accéder au répertoire de l’exécuteur.\n\n Les instructions vous guident tout au long des tâches suivantes :\n\n * Téléchargement et extraction de l’application d’exécuteur auto-hébergée.\n * Exécution du script `config` pour configurer l’application d’exécuteur auto-hébergé et l’inscrire auprès de GitHub Actions. L’URL de destination et un jeton limité dans le temps généré automatiquement sont nécessaires pour permettre au script `config` d’authentifier la demande. Le jeton expire au bout d’une heure.\n * Sur Windows, le script `config` vous demande également si vous souhaitez installer l’application d’exécuteur auto-hébergée en tant que service. Pour Linux et macOS, vous pouvez installer un service une fois que vous avez terminé d’ajouter l’exécuteur. Pour plus d’informations, consultez « [Configuration de l’application d’exécuteur auto-hébergé en tant que service](/fr/actions/how-tos/manage-runners/self-hosted-runners/configure-the-application) ».\n * Exécution de l'application de runner auto-hébergé pour connecter la machine à GitHub Actions.\n\n### Vérification de la réussite de l’ajout de votre exécuteur autohébergé\n\nAprès avoir effectué les étapes pour ajouter un exécuteur autohébergé, l’exécuteur et son statut sont listés sous « Exécuteurs ».\n\nL’application de l’exécuteur autohébergée doit être active pour que l’exécuteur accepte les travaux. Quand l’application d’exécuteur est connectée à GitHub et qu’elle est prête à recevoir des travaux, le message suivant s’affiche sur le terminal de la machine.\n\n```shell\n√ Connected to GitHub\n\n2019-10-24 05:45:56Z: Listening for Jobs\n```\n\nPour plus d’informations, consultez « [Surveillance des exécuteurs auto-hébergés et résolution des problèmes](/fr/actions/how-tos/manage-runners/self-hosted-runners/monitor-and-troubleshoot) ».\n\n## Ajout d’un exécuteur auto-hébergé dans une organisation\n\nVous pouvez ajouter des exécuteurs auto-hébergés au niveau de l’organisation, où ils peuvent être utilisés pour traiter des travaux pour plusieurs dépôts de l’organisation. Pour ajouter un runner auto-hébergé à une organisation, vous devez être propriétaire de l’organisation. Pour obtenir des informations sur la façon d’ajouter un exécuteur auto-hébergé avec l’API REST, consultez « [Points de terminaison d’API REST pour les exécuteurs auto-hébergés](/fr/rest/actions/self-hosted-runners) ».\n\n1. Sur GitHub, accédez à la page principale de l’organisation.\n\n2. Sous le nom de votre organisation, cliquez sur ** Settings**. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant **** , puis cliquez sur **Paramètres**.\n\n \n\n3. Dans la barre latérale gauche, cliquez sur ** Actions**, puis sur **Exécuteurs**.\n\n4. Cliquez sur **Nouvel exécuteur**, puis sur **Nouvel exécuteur auto-hébergé**.\n\n5. Sélectionnez l’image et l’architecture du système d’exploitation de votre machine d’exécuteur auto-hébergée.\n\n \n\n6. Des instructions vous montrent comment télécharger l’application d’exécuteur et l’installer sur votre machine d’exécuteur auto-hébergée.\n\n Ouvrez un interpréteur de commandes sur votre machine d’exécuteur auto-hébergée et exécutez toutes les commandes shell dans l’ordre indiqué.\n\n > \\[!NOTE]\n > Sur Windows, si vous souhaitez installer l’application d’exécuteur auto-hébergée en tant que service, vous devez ouvrir un interpréteur de commandes avec des privilèges d’administrateur. Nous vous recommandons également d’utiliser `C:\\actions-runner` comme répertoire pour l’application de l’exécuteur auto-hébergé afin que les comptes système Windows puissent accéder au répertoire de l’exécuteur.\n\n Les instructions vous guident tout au long des tâches suivantes :\n\n * Téléchargement et extraction de l’application d’exécuteur auto-hébergée.\n * Exécution du script `config` pour configurer l’application d’exécuteur auto-hébergé et l’inscrire auprès de GitHub Actions. L’URL de destination et un jeton limité dans le temps généré automatiquement sont nécessaires pour permettre au script `config` d’authentifier la demande. Le jeton expire au bout d’une heure.\n * Sur Windows, le script `config` vous demande également si vous souhaitez installer l’application d’exécuteur auto-hébergée en tant que service. Pour Linux et macOS, vous pouvez installer un service une fois que vous avez terminé d’ajouter l’exécuteur. Pour plus d’informations, consultez « [Configuration de l’application d’exécuteur auto-hébergé en tant que service](/fr/actions/how-tos/manage-runners/self-hosted-runners/configure-the-application) ».\n * Exécution de l'application de runner auto-hébergé pour connecter la machine à GitHub Actions.\n\n### Vérification de la réussite de l’ajout de votre exécuteur autohébergé\n\nAprès avoir effectué les étapes pour ajouter un exécuteur autohébergé, l’exécuteur et son statut sont listés sous « Exécuteurs ».\n\nL’application de l’exécuteur autohébergée doit être active pour que l’exécuteur accepte les travaux. Quand l’application d’exécuteur est connectée à GitHub et qu’elle est prête à recevoir des travaux, le message suivant s’affiche sur le terminal de la machine.\n\n```shell\n√ Connected to GitHub\n\n2019-10-24 05:45:56Z: Listening for Jobs\n```\n\nPour plus d’informations, consultez « [Surveillance des exécuteurs auto-hébergés et résolution des problèmes](/fr/actions/how-tos/manage-runners/self-hosted-runners/monitor-and-troubleshoot) ».\n\n> \\[!NOTE]\n> Pour des raisons de sécurité, les dépôts publics ne peuvent pas utiliser d’exécuteurs dans un groupe d’exécuteurs par défaut, mais vous pouvez remplacer ce comportement dans les paramètres du groupe d’exécuteurs. Pour plus d’informations, consultez « [Gestion de l’accès aux exécuteurs auto-hébergés à l’aide de groupes](/fr/actions/how-tos/manage-runners/self-hosted-runners/manage-access#changing-which-repositories-can-access-a-runner-group) ».\n\n## Ajout d’un exécuteur auto-hébergé dans une entreprise\n\nSi vous utilisez GitHub Enterprise Cloud, vous pouvez ajouter des runners auto-hébergés à une entreprise, puis les affecter à plusieurs organisations. Les propriétaires d’organisation peuvent ensuite contrôler quels référentiels peuvent les utiliser.\nPour plus d’informations, consultez la [GitHub Enterprise Cloud documentation](/fr/enterprise-cloud@latest/actions/how-tos/manage-runners/self-hosted-runners/add-runners#adding-a-self-hosted-runner-to-an-enterprise).\n\n## Étapes suivantes\n\nVous pouvez configurer l’automatisation pour mettre à l’échelle le nombre d’exécuteurs auto-hébergés. Pour plus d’informations, consultez « [Documentation de référence relative aux runners auto-hébergés](/fr/actions/reference/runners/self-hosted-runners#autoscaling) »."}