Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Création d'un hôte
Vous pouvez utiliser le AWS Management Console ou le AWS Command Line Interface (AWS CLI) pour créer une connexion à un référentiel de code tiers installé sur votre infrastructure. Par exemple, GitHub Enterprise Server peut s'exécuter en tant que machine virtuelle sur une EC2 instance Amazon. Avant de créer une connexion à GitHub Enterprise Server, vous devez créer un hôte à utiliser pour la connexion.
Pour voir une présentation du flux de travail de création d’hôte pour les fournisseurs installés, consultez Flux de travail de création ou de mise à jour d’un hôte.
Avant de commencer :
-
(Facultatif) Si vous souhaitez créer votre hôte avec unVPC, vous devez déjà avoir créé un réseau ou un cloud privé virtuel (VPC).
-
Vous devez déjà avoir créé votre instance et, si vous prévoyez de vous connecter à votre instanceVPC, vous devez avoir lancé votre hôte dans votreVPC.
Note
Chacun ne VPC peut être associé qu'à un seul hôte à la fois.
Vous pouvez éventuellement configurer votre hôte avec unVPC. Pour plus d'informations sur le réseau et VPC la configuration de votre ressource hôte, consultez les VPC conditions requises dans (Facultatif) Conditions préalables : VPC configuration réseau ou Amazon pour votre connexion etRésolution des problèmes VPC de configuration pour votre hôte.
Pour utiliser la console afin de créer un hôte et une connexion à GitHub Enterprise Server, consultezCréez votre connexion au serveur GitHub d'entreprise (console). La console crée un hôte pour vous.
Pour utiliser la console afin de créer un hôte et une connexion à l' GitLab autogestion, consultezCréation d'une connexion à l' GitLabautogestion. La console crée un hôte pour vous.
(Facultatif) Conditions préalables : VPC configuration réseau ou Amazon pour votre connexion
Si votre infrastructure est configurée avec une connexion réseau, vous pouvez ignorer cette section.
Si votre hôte n'est accessible que dans unVPC, respectez ces VPC exigences avant de continuer.
VPCexigences
Vous pouvez éventuellement choisir de créer votre hôte avec unVPC. Voici les VPC exigences générales, en fonction de ce VPC que vous avez configuré pour votre installation.
-
Vous pouvez configurer un réseau public VPC avec des sous-réseaux publics et privés. Vous pouvez utiliser la valeur par défaut VPC pour votre Compte AWS si vous n'avez pas de CIDR blocs ou de sous-réseaux préférés.
-
Si vous avez VPC configuré une instance privée et que vous avez configuré votre instance de serveur GitHub d'entreprise pour effectuer une TLS validation à l'aide d'une autorité de certification non publique, vous devez fournir le TLS certificat de votre ressource hôte.
-
Lorsque Connections crée votre hôte, le VPC point de terminaison (PrivateLink) pour les webhooks est créé pour vous. Pour de plus amples informations, veuillez consulter AWS CodeConnections et VPC points de terminaison d'interface ()AWS PrivateLink.
-
Configuration du groupe de sécurité :
-
Les groupes de sécurité utilisés lors de la création de l'hôte nécessitent des règles entrantes et sortantes qui permettent à l'interface réseau de se connecter à votre instance de serveur GitHub d'entreprise.
-
Les groupes de sécurité attachés à votre instance GitHub Enterprise Server (qui ne font pas partie de la configuration de l'hôte) ont besoin d'un accès entrant et sortant depuis les interfaces réseau créées par les connexions.
-
-
Vos VPC sous-réseaux doivent résider dans différentes zones de disponibilité de votre région. Les zones de disponibilité sont des emplacements distincts isolés des défaillances dans d'autres zones de disponibilité. Chaque sous-réseau doit résider entièrement dans une zone de disponibilité et ne peut pas s'étendre sur plusieurs zones.
Pour plus d'informations sur l'utilisation des sous-réseaux VPCs et des sous-réseaux, consultez la section VPCrelative au dimensionnement des sous-réseaux dans IPv4 le guide de l'utilisateur Amazon VPC.
VPCinformations que vous fournissez pour la configuration de l'hôte
Lorsque vous créez votre ressource hôte pour vos connexions à l'étape suivante, vous devez fournir les éléments suivants :
-
VPCID : ID du VPC serveur sur lequel votre instance GitHub Enterprise Server est installée ou VPC qui a accès à votre instance GitHub Enterprise Server installée par le biais VPN de Direct Connect.
-
ID de sous-réseau ou IDs : ID du sous-réseau du serveur sur lequel est installée votre instance de serveur GitHub d'entreprise ou d'un sous-réseau ayant accès à votre instance de serveur GitHub d'entreprise installée via VPN Direct Connect.
-
Groupe ou groupes de sécurité : le groupe de sécurité du serveur sur lequel votre instance GitHub Enterprise Server est installée ou un groupe de sécurité ayant accès à votre instance GitHub Enterprise Server installée via VPN ou Direct Connect.
-
Point de terminaison : préparez votre point de terminaison de serveur et passez à l'étape suivante.
Pour plus d'informations, notamment sur le dépannage VPC ou les connexions hôtes, consultezRésolution des problèmes VPC de configuration pour votre hôte.
Conditions d'autorisation
Dans le cadre du processus de création de l'hôte, AWS CodeConnections crée des ressources réseau en votre nom pour faciliter la VPC connectivité. Cela inclut une interface réseau AWS CodeConnections permettant d'interroger les données de votre hôte, et un VPC point de terminaison ou PrivateLinkpermettant à l'hôte d'envoyer des données d'événements via des webhooks aux connexions. Pour pouvoir créer ces ressources réseau, veillez à ce que le rôle utilisé pour créer l'hôte dispose des autorisations suivantes :
ec2:CreateNetworkInterface ec2:CreateTags ec2:DescribeDhcpOptions ec2:DescribeNetworkInterfaces ec2:DescribeSubnets ec2:DeleteNetworkInterface ec2:DescribeVpcs ec2:CreateVpcEndpoint ec2:DeleteVpcEndpoints ec2:DescribeVpcEndpoints
Pour plus d'informations sur la résolution des problèmes liés aux autorisations ou aux connexions hôtes dans unVPC, consultezRésolution des problèmes VPC de configuration pour votre hôte.
Pour plus d'informations sur le point de VPC terminaison du webhook, consultezAWS CodeConnections et VPC points de terminaison d'interface ()AWS PrivateLink.
Créer un hôte pour une connexion (console)
Pour les connexions destinées à des installations, telles qu'avec GitHub Enterprise Server ou avec des serveurs GitLab autogérés, vous utilisez un hôte pour représenter le point de terminaison de l'infrastructure sur laquelle votre fournisseur tiers est installé.
Note
À compter du 1er juillet 2024, la console crée des connexions avec codeconnections la ressourceARN. Les ressources associées aux deux préfixes de service continueront de s'afficher dans la console.
Pour en savoir plus sur les considérations relatives à la configuration d'un hôte dans unVPC, voirCréation d'une connexion à l' GitLabautogestion.
Pour utiliser la console afin de créer un hôte et une connexion à GitHub Enterprise Server, consultezCréez votre connexion au serveur GitHub d'entreprise (console). La console crée un hôte pour vous.
Pour utiliser la console afin de créer un hôte et une connexion à l' GitLab autogestion, consultezCréation d'une connexion à l' GitLabautogestion. La console crée un hôte pour vous.
Note
Vous ne créez un hôte qu'une seule fois par serveur GitHub d'entreprise ou compte GitLab autogéré. Toutes vos connexions à un serveur d' GitHub entreprise ou à un compte GitLab autogéré spécifique utiliseront le même hôte.
Création d'un hôte pour une connexion (CLI)
Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer un hôte pour les connexions installées.
Note
Vous ne créez un hôte qu'une seule fois par compte GitHub Enterprise Server. Toutes vos connexions à un compte GitHub Enterprise Server spécifique utiliseront le même hôte.
Vous utilisez un hôte pour représenter le point de terminaison de l'infrastructure sur laquelle votre fournisseur tiers est installé. Pour créer un hôte avec leCLI, vous devez utiliser la create-host commande. Une fois que vous avez terminé la création de l'hôte, l'hôte est En attente. Ensuite, configurez l'hôte pour le passer à l'état Disponible. Une fois l'hôte disponible, procédez comme suit pour créer une connexion.
Important
Un hôte créé via le AWS CLI est en Pending statut par défaut. Après avoir créé un hôte avec leCLI, utilisez la console pour configurer l'hôte afin qu'il définisse son statutAvailable.
Pour utiliser la console afin de créer un hôte et une connexion à GitHub Enterprise Server, consultezCréez votre connexion au serveur GitHub d'entreprise (console). La console crée un hôte pour vous.
Pour utiliser la console afin de créer un hôte et une connexion à l' GitLab autogestion, consultezCréation d'une connexion à l' GitLabautogestion. La console crée un hôte pour vous.
