{"meta":{"title":"Gestion des environnements pour le déploiement","intro":"Vous pouvez créer des environnements et les sécuriser à l'aide de règles de protection du déploiement. Une tâche qui fait référence à un environnement doit respecter les règles de protection de l’environnement avant d’exécuter les secrets de l’environnement ou d’y accéder.","product":"GitHub Actions","breadcrumbs":[{"href":"/fr/actions","title":"GitHub Actions"},{"href":"/fr/actions/how-tos","title":"Guides pratiques"},{"href":"/fr/actions/how-tos/deploy","title":"Déployer"},{"href":"/fr/actions/how-tos/deploy/configure-and-manage-deployments","title":"Configurer et gérer les déploiements"},{"href":"/fr/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments","title":"Gérer les environnements"}],"documentType":"article"},"body":"# Gestion des environnements pour le déploiement\n\nVous pouvez créer des environnements et les sécuriser à l'aide de règles de protection du déploiement. Une tâche qui fait référence à un environnement doit respecter les règles de protection de l’environnement avant d’exécuter les secrets de l’environnement ou d’y accéder.\n\n## Prérequis\n\n> \\[!NOTE]\n> Les utilisateurs disposant de plans GitHub Free peuvent configurer des environnements seulement pour les dépôts publics. Si vous convertissez un dépôt public en dépôt privé, les règles de protection et les secrets d’environnement configurés sont ignorés et vous ne pourrez pas configurer d’environnements. Si vous convertissez votre dépôt pour le rendre à nouveau public, vous avez accès à toutes les règles de protection et à tous les secrets d’environnement précédemment configurés.\n>\n> Les organisations avec GitHub Team et les utilisateurs avec GitHub Pro peuvent configurer des environnements pour les référentiels privés. Pour plus d’informations, consultez « [plans de GitHub](/fr/get-started/learning-about-github/githubs-plans) ».\n\n* Pour obtenir des informations générales sur les environnements, consultez [Déploiement avec GitHub Actions](/fr/actions/concepts/use-cases/deploying-with-github-actions#using-environments).\n* Pour plus d’informations sur les règles disponibles, consultez [Déploiements et environnements](/fr/actions/reference/deployments-and-environments).\n\n## Création d’un environnement\n\nPour configurer un environnement dans un référentiel de comptes personnels, vous devez être le propriétaire du référentiel. Pour configurer un environnement dans un référentiel d’organisation, vous devez disposer d’un accès `admin`.\n\n> \\[!NOTE]\n>\n> * La création d’un environnement dans un dépôt privé est disponible pour les organisations avec GitHub Team et les utilisateurs avec GitHub Pro.\n> * Certaines fonctionnalités pour les environnements offrent peu voire aucune disponibilité pour les dépôts privés. Si vous ne parvenez pas à accéder à une fonctionnalité décrite dans les instructions ci-dessous, consultez la documentation liée à l’étape associée pour obtenir des informations sur la disponibilité.\n\n1. Sur GitHub, accédez à la page principale du référentiel.\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 \n3. Dans la barre latérale gauche, cliquez sur **Environnements**.\n4. Cliquez sur **Nouvel environnement**.\n5. Entrez un nom pour l’environnement, puis cliquez sur **Configurer l’environnement**. Les noms d’environnements ne respectent pas la casse. Un nom d’environnement ne peut pas dépasser 255 caractères et doit être unique dans le dépôt.\n6. Si vous le souhaitez, spécifiez des personnes ou des équipes qui doivent approuver les travaux de workflow qui utilisent cet environnement. Pour plus d’informations, consultez « [Déploiements et environnements](/fr/actions/reference/deployments-and-environments#required-reviewers) ».\n 1. Sélectionnez **Réviseurs requis**.\n 2. Entrez jusqu’à 6 personnes ou équipes. Seul l’un des réviseurs requis doit approuver le travail pour qu’il continue.\n 3. Si vous le souhaitez, pour empêcher les utilisateurs d’approuver les exécutions de flux de travail qu’ils ont déclenchées, sélectionnez **Empêcher l’auto-révision**.\n 4. Cliquez sur **Enregistrer les règles de protection**.\n7. Si vous le souhaitez, spécifiez le temps d’attente avant d’autoriser les travaux de workflow qui utilisent cet environnement à poursuivre. Pour plus d’informations, consultez « [Déploiements et environnements](/fr/actions/reference/deployments-and-environments#wait-timer) ».\n 1. Sélectionnez **Minuteur d’attente**.\n 2. Entrez le nombre de minutes à attendre.\n 3. Cliquez sur **Enregistrer les règles de protection**.\n8. Si vous le souhaitez, interdisez le contournement des règles de protection configurées. Pour plus d’informations, consultez « [Déploiements et environnements](/fr/actions/reference/deployments-and-environments#allow-administrators-to-bypass-configured-protection-rules) ».\n 1. Désélectionnez **Autoriser les administrateurs à contourner les règles de protection configurées**.\n 2. Cliquez sur **Enregistrer les règles de protection**.\n9. Si vous le souhaitez, activez toutes les règles de protection de déploiement personnalisées qui ont été créées avec GitHub Apps. Pour plus d’informations, consultez « [Déploiements et environnements](/fr/actions/reference/deployments-and-environments#custom-deployment-protection-rules) ».\n 1. Sélectionnez la règle de protection personnalisée que vous souhaitez activer.\n 2. Cliquez sur **Enregistrer les règles de protection**.\n10. Si vous le souhaitez, vous pouvez spécifier les branches et les balises qui peuvent être déployées dans cet environnement. Pour plus d’informations, consultez « [Déploiements et environnements](/fr/actions/reference/deployments-and-environments#deployment-branches-and-tags) ».\n 1. Sélectionnez l’option souhaitée dans la liste déroulante **Branches de déploiement**.\n\n 2. Si vous avez choisi **Branches et balises sélectionnées**, pour ajouter une nouvelle règle, cliquez sur **Ajouter une règle de branche ou de balise de déploiement**\n\n 3. Dans le menu déroulant « Type de référence », en fonction de la règle que vous souhaitez appliquer, cliquez sur ** Branche** ou ** Balise**.\n\n 4. Entrez le modèle de nom de la branche ou de la balise que vous souhaitez autoriser.\n\n > \\[!NOTE]\n > Les modèles de nom doivent être configurés individuellement pour les branches ou les balises.\n\n 5. Cliquez sur **Ajouter une règle**.\n11. Si vous le souhaitez, ajoutez des secrets d’environnement. Ces secrets sont disponibles uniquement pour les travaux de workflow qui utilisent l’environnement. En outre, les travaux de workflow qui utilisent cet environnement peuvent uniquement accéder à ces secrets après la validation des règles éventuellement configurées (par exemple, les réviseurs requis). Pour plus d’informations, consultez « [Déploiements et environnements](/fr/actions/reference/deployments-and-environments#environment-secrets) ».\n 1. Sous **Secrets d’environnement**, cliquez sur **Ajouter un secret**.\n 2. Entrez le nom secret.\n 3. Entrez la valeur du secret.\n 4. Cliquez sur **Ajouter un secret**.\n12. Si vous le souhaitez, ajoutez des variables d’environnement. Ces variables sont uniquement disponibles pour les travaux de workflow qui utilisent l’environnement, et sont uniquement accessibles à l’aide du contexte [`vars`](/fr/actions/learn-github-actions/contexts#vars-context). Pour plus d’informations, consultez « [Déploiements et environnements](/fr/actions/reference/deployments-and-environments#environment-variables) ».\n 1. Sous **Variables d’environnement**, cliquez sur **Ajouter une variable**.\n 2. Entrez le nom de la variable.\n 3. Entrez la valeur de la variable.\n 4. Cliquez sur **Ajouter une variable**.\n\nVous pouvez également créer et configurer des environnements via l’API REST. Pour plus d’informations, consultez [Points de terminaison d’API REST pour les environnements de déploiement](/fr/rest/deployments/environments), [Points d'accès d’API REST pour les secrets GitHub Actions](/fr/rest/actions/secrets), [Points de terminaison d’API REST pour les variables GitHub Actions](/fr/rest/actions/variables) et [Points de terminaison de l'API REST pour les politiques de branche de déploiement](/fr/rest/deployments/branch-policies).\n\nL’exécution d’un workflow qui référence un environnement qui n’existe pas crée un environnement avec le nom référencé. Si l'environnement est créé à partir de l'exécution de constructions de pages implicites (par exemple, à partir d'une branche ou d'un dossier source), la branche source sera ajoutée en tant que règle de protection à l'environnement. Sinon, l’environnement nouvellement créé n’aura pas de règles de protection ni de secrets configurés. Toute personne qui peut modifier des workflows dans le dépôt peut créer des environnements via un fichier de workflow, mais seuls les administrateurs de dépôt peuvent configurer l’environnement.\n\n## Suppression d’un environnement\n\nPour configurer un environnement dans un référentiel de comptes personnels, vous devez être le propriétaire du référentiel. Pour configurer un environnement dans un référentiel d’organisation, vous devez disposer d’un accès `admin`.\n\nLa suppression d’un environnement supprime toutes les règles de protection et tous les secrets associés à l’environnement. Tous les travaux actuellement en attente en raison de règles de protection de l’environnement supprimé échouent automatiquement.\n\n1. Sur GitHub, accédez à la page principale du référentiel.\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 \n3. Dans la barre latérale gauche, cliquez sur **Environnements**.\n4. À côté de l’environnement que vous souhaitez supprimer, cliquez sur .\n5. Cliquez sur **Je comprends, supprimez cet environnement**.\n\nVous pouvez également supprimer des environnements via l’API REST. Pour plus d’informations, consultez « [Points de terminaison d’API REST pour les référentiels](/fr/rest/repos#environments) ».\n\n## Relation entre les environnements et les déploiements\n\nQuand un travail de workflow qui référence un environnement s’exécute, il crée un objet de déploiement avec la propriété `environment` définie sur le nom de votre environnement. Au fur et à mesure que le workflow progresse, il crée aussi des objets d’état de déploiement avec la propriété `environment` définie sur le nom de votre environnement, la propriété `environment_url` définie sur l’URL de l’environnement (si elle est spécifiée dans le workflow) et la propriété `state` définie sur l’état du travail.\n\nVous pouvez accéder à ces objets via l’API REST ou l’API GraphQL. Vous pouvez également vous abonner à ces événements webhook. Pour plus d’informations, consultez « [Points de terminaison d’API REST pour les référentiels](/fr/rest/repos#deployments) », « [Objets](/fr/graphql/reference/objects#deployment) » (API GraphQL) ou « [Événements et charges utiles du webhook](/fr/webhooks-and-events/webhooks/webhook-events-and-payloads#deployment) ».\n\n## Étapes suivantes\n\nGitHub Actions fournit plusieurs fonctionnalités pour la gestion de vos déploiements. Pour plus d’informations, consultez « [Déploiement avec GitHub Actions](/fr/actions/deployment/about-deployments/deploying-with-github-actions) »."}