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.

Dépannage des problèmes de connexion

Les informations suivantes peuvent vous aider à résoudre les problèmes courants liés aux connexions aux ressources dans AWS CodeBuild AWS CodeDeploy, et AWS CodePipeline.

Je ne peux pas créer de connexions

Vous ne disposez peut-être pas des autorisations suffisantes pour créer une connexion. Pour plus d’informations, consultez Autorisations et exemples pourAWS CodeConnections.

Je reçois une erreur d'autorisation lorsque j'essaie de créer ou d'établir une connexion

Le message d'erreur suivant peut s'afficher lorsque vous tentez de créer ou d'afficher une connexion dans la CodePipeline console.

Utilisateur : n'usernameest pas autorisé à effectuer : permission sur la ressource : connection-ARN

Si ce message s'affiche, assurez-vous de disposer des autorisations suffisantes.

Les autorisations permettant de créer et d'afficher des connexions dans le AWS Command Line Interface (AWS CLI) ou dans le ne Console de gestion AWS constituent qu'une partie des autorisations dont vous avez besoin pour créer et terminer des connexions sur la console. Les autorisations requises pour simplement afficher, modifier ou créer une connexion puis établir la connexion en attente doivent être limitées pour les utilisateurs qui n'ont besoin que de certaines tâches. Pour plus d’informations, consultez Autorisations et exemples pourAWS CodeConnections.

Je reçois une erreur d'autorisation lorsque j'essaie d'utiliser une connexion

L'un des messages d'erreur suivants ou les deux peuvent être renvoyés si vous essayez d'utiliser une connexion dans la CodePipeline console, même si vous disposez des autorisations nécessaires pour répertorier, obtenir et créer des autorisations.

Vous n'avez pas réussi à authentifier votre compte.

Utilisateur : n'usernameest pas autorisé à effectuer : codestar-connections : sur la ressource : UseConnection connection-ARN

Si cela se produit, assurez-vous de disposer des autorisations suffisantes.

Assurez-vous de disposer des autorisations nécessaires à l'utilisation d'une connexion, y compris la liste des référentiels disponibles dans l'emplacement du fournisseur. Pour plus d’informations, consultez Autorisations et exemples pourAWS CodeConnections.

La connexion n'est pas disponible ou n'est plus en attente

Si la console affiche un message indiquant qu'une connexion n'est pas disponible, sélectionnez Complete connection (Établir la connexion).

Si vous choisissez d'établir la connexion et qu'un message s'affiche indiquant que la connexion n'est pas en attente, vous pouvez annuler la demande, car la connexion est déjà disponible.

Si votre connexion à GitHub Enterprise Server passe AWS par l'Internet public via un proxy ou un pare-feu, un webhook d'installation bloqué peut laisser la connexion en Pending état. Consultez GitHub La connexion au serveur Enterprise reste en attente (proxy sortant ou pare-feu bloquant le webhook d'installation).

Ajouter GitClone des autorisations pour les connexions

Lorsque vous utilisez une AWS CodeStar connexion dans une action source et dans une CodeBuild action, l'artefact d'entrée peut être transmis à la génération de deux manières :

Pour ajouter des autorisations à votre politique CodeBuild de rôle de service, vous créez une politique gérée par le client que vous associez à votre rôle CodeBuild de service. Les étapes suivantes créent une stratégie dans laquelle l'autorisation UseConnection est spécifiée dans le champ action et l'Amazon Resource Name (ARN) de connexion est spécifié dans le champ Resource.

L'hôte n'est pas disponible

Si la console affiche un message indiquant qu'un hôte ne présente pas l'état Available, choisissez Set up host (Configurer l'hôte).

Suite à la première étape de la création de l'hôte, l'hôte créé présente l'état Pending. Pour déplacer l'hôte vers un état Available, vous devez choisir de configurer l'hôte dans la console. Pour plus d’informations, consultez Configurer un hôte en attente.

Résolution des problèmes liés à un hôte avec des erreurs de connexion

Les connexions et les hôtes peuvent passer à l'état d'erreur si l' GitHub application sous-jacente est supprimée ou modifiée. Les hôtes et les connexions à l'état d'erreur ne peuvent pas être restaurés et l'hôte doit être recréé.

Si la console ou la CLI renvoie un hôte ou une connexion liée à un hôte avec un état Error, vous pourriez avoir besoin de suivre l'étape suivante :

Je ne suis pas en mesure de créer une connexion pour mon hôte

Pour créer une connexion ou un hôte, les conditions suivantes sont requises.

Résolution des problèmes liés à la configuration d'un VPC pour votre hôte

Lorsque vous créez une ressource hôte, vous devez fournir des informations de connexion réseau ou de VPC pour l'infrastructure sur laquelle votre instance GitHub Enterprise Server est installée. Pour résoudre les problèmes liés à la configuration de votre VPC ou sous-réseau pour votre hôte, utilisez l'exemple d'informations sur les VPC illustré ici comme référence.

Dans cet exemple, vous devez utiliser le processus suivant pour configurer le VPC et le serveur sur lesquels votre instance GitHub Enterprise Server sera installée :

L'image suivante montre une instance EC2 lancée à l'aide de l' GitHub Enterprise AMI.

Lorsque vous utilisez un VPC pour une connexion GitHub Enterprise Server, vous devez fournir les éléments suivants pour votre infrastructure lorsque vous configurez votre hôte :

Pour plus d'informations sur l'utilisation des VPC et des sous-réseaux, veuillez consulter Dimensionnement des VPC et des sous-réseaux pour IPv4 dans le guide de l'utilisateur Amazon VPC.

Je ne parviens pas à obtenir un hôte à l'état en attente

Si votre hôte passe à l'état VPC_CONFIG_FAILED_INITIALIZATION, cela est probablement dû à un problème avec le VPC, les sous-réseaux ou les groupes de sécurité que vous avez sélectionnés pour votre hôte.

Je ne parviens pas à obtenir un hôte à l'état disponible

Si vous ne parvenez pas à terminer la configuration de CodeConnections l'application pour votre hôte, cela peut être dû à un problème lié à la configuration de votre VPC ou à votre instance GitHub Enterprise Server.

Le connection/host mien travaillait et a cessé de fonctionner maintenant

Si connection/host a fonctionnait auparavant et ne fonctionne plus maintenant, cela peut être dû à un changement de configuration de votre VPC ou à une modification de l' GitHub application. Vérifiez les éléments suivants :

Je ne suis pas en mesure de supprimer mes interfaces réseau

Si vous ne parvenez pas à détecter vos interfaces réseau, vérifiez les points suivants :

Résolution des problèmes liés aux points de terminaison VPC Webhook (PrivateLink) pour les connexions Enterprise Server GitHub

Lorsque vous créez un hôte avec une configuration VPC, le point de terminaison VPC webhook est créé pour vous.

Lorsque vous créez une connexion à un type de fournisseur installé et que vous avez spécifié que votre serveur est configuré dans un VPC, puis que vous AWS CodeConnections créez votre hôte, et le point de terminaison VPC (PrivateLink) pour les webhooks est créé pour vous. Cela permet à l'hôte d'envoyer les données de l'événement via des webhooks à vos AWS services intégrés via le réseau Amazon. Pour plus d’informations, consultez AWS CodeConnections et points de terminaison VPC d'interface ()AWS PrivateLink.

Je ne suis pas en mesure de supprimer mes points de terminaison de VPC webhook

AWS CodeConnections gère le cycle de vie des points de terminaison VPC Webhook de votre hôte. Si vous souhaitez supprimer le point de terminaison, vous devez supprimer la ressource hôte correspondante.

GitHub La connexion au serveur Enterprise reste en attente (proxy sortant ou pare-feu bloquant le webhook d'installation)

Lorsque vous créez une connexion à GitHub Enterprise Server AWS via l'Internet public, votre instance GitHub Enterprise Server doit envoyer un installation.created webhook unique à AWS. Votre instance envoie ce webhook une fois que vous avez installé l' GitHub application et AWS enregistre l'installation de l'application uniquement lorsqu'elle reçoit le webhook. Si un proxy sortant ou un pare-feu situé devant votre instance d' GitHub Enterprise Server bloque cette demande, AWS n'enregistre jamais l'installation et vous ne pouvez pas terminer la connexion.

Symptômes

Cette erreur signifie que je AWS n'ai pas reçu le webhook d'installation et que l'installation n'a donc jamais été enregistrée. Cela ne signifie pas que l'ID d'installation n'est pas valide.

Résolution

Résolution des problèmes liés à un hôte créé avant le 24 novembre 2020

À compter du 24 novembre 2020, lors de AWS CodeConnections la configuration de votre hôte, un support VPC endpoint (PrivateLink) supplémentaire est configuré pour vous. Pour les hôtes créés avant cette mise à jour, utilisez cette section de résolution des problèmes.

Pour plus d’informations, consultez AWS CodeConnections et points de terminaison VPC d'interface ()AWS PrivateLink.

J'ai un hôte qui a été créé avant le 24 novembre 2020 et je souhaite utiliser des points de terminaison VPC (PrivateLink) pour les webhooks

Lorsque vous configurez votre hôte pour GitHub Enterprise Server, le point de terminaison Webhook est créé pour vous. Les connexions utilisent désormais des points de terminaison PrivateLink Webhook VPC. Si vous avez créé votre hôte avant le 24 novembre 2020 et que vous souhaitez utiliser les points de terminaison du PrivateLink webhook VPC, vous devez d'abord supprimer votre hôte, puis en créer un nouvel.

Je ne parviens pas à obtenir un hôte à l'état disponible (erreur de VPC)

Si votre hôte a été créé avant le 24 novembre 2020 et que vous ne parvenez pas à terminer la configuration de CodeConnections l'application pour votre hôte, cela peut être dû à un problème lié à vos configurations VPC ou à votre instance GitHub Enterprise Server.

Votre VPC aura besoin d'une passerelle NAT (ou d'un accès Internet sortant) pour que votre instance GitHub Enterprise Server puisse envoyer du trafic réseau sortant pour les webhooks. GitHub

Impossible de créer la connexion pour un GitHub référentiel

Problème :

Étant donné qu'une connexion à un GitHub référentiel utilise le AWS connecteur pour GitHub, vous avez besoin des autorisations du propriétaire de l'organisation ou des autorisations d'administrateur sur le référentiel pour créer la connexion.

Correctifs possibles : pour plus d'informations sur les niveaux d'autorisation pour un GitHub référentiel, consultez https://docs.github.com/en/free-pro-team @ latest/github teams/permission /setting-up-and-managing-organizations-and- -levels-for-an-organization.

Modifier les autorisations de votre application de connexion GitHub Enterprise Server

Si vous avez installé l'application pour GitHub Enterprise Server le 23 décembre 2020 ou avant cette date, vous devrez peut-être autoriser l' Read-only accès à l'application aux membres de l'organisation. Si vous êtes le propriétaire de GitHub l'application, procédez comme suit pour modifier les autorisations de l'application qui a été installée lors de la création de votre hôte.

Erreur de connexion lors de la connexion à GitHub : « Un problème est survenu, assurez-vous que les cookies sont activés dans votre navigateur » ou « Le propriétaire de l'organisation doit installer l' GitHub application »

Problème :

Pour créer la connexion à un GitHub référentiel, vous devez être le propriétaire de GitHub l'organisation. Pour les référentiels qui ne font pas partie d'une organisation, vous devez en être le propriétaire. Lorsqu'une connexion est créée par une personne autre que le propriétaire de l'organisation, une demande est créée pour le propriétaire de l'organisation et l'une des erreurs suivantes s'affiche :

Un problème est survenu, assurez-vous que les cookies sont activés dans votre navigateur

OU

Le propriétaire de l'organisation doit installer l' GitHub application

Correctifs possibles : pour les référentiels d'une GitHub organisation, le propriétaire de l'organisation doit créer la connexion au GitHub référentiel. Pour les référentiels qui ne font pas partie d'une organisation, vous devez être le propriétaire du référentiel.

Le préfixe du service Connections dans les ressources peut avoir besoin d'être mis à jour pour les politiques IAM

Le 29 mars 2024, le service a été renommé AWS CodeStar Connections à AWS CodeConnections. À compter du 1er juillet 2024, la console crée des connexions avec codeconnections l'ARN de la ressource. Les ressources avec les deux préfixes de service continueront à s'afficher dans la console. Le préfixe de service pour les ressources créées à l'aide de la console estcodeconnections. De nouvelles SDK/CLI ressources sont créées codeconnections dans l'ARN de la ressource. Les ressources créées auront automatiquement le nouveau préfixe de service.

Les ressources créées dans AWS CodeConnections :

Problème :

Les ressources qui ont été créées codestar-connections dans l'ARN ne seront pas automatiquement renommées avec le nouveau préfixe de service dans l'ARN de la ressource. La création d'une nouvelle ressource créera une ressource dotée du préfixe du service de connexions. Cependant, les politiques IAM avec le préfixe codestar-connections de service ne fonctionneront pas pour les ressources avec le nouveau préfixe de service.

Correctifs possibles : pour éviter les problèmes d'accès ou d'autorisations pour les ressources, effectuez les actions suivantes :

Mettez à jour les actions, les ressources et les conditions de la politique, le cas échéant. Dans l'exemple suivant, le Resource champ a été mis à jour pour les deux préfixes de service.

JSON

{
    "Version":"2012-10-17",
    "Statement": {
        "Effect": "Allow",
        "Action": [
            "codeconnections:UseConnection"
        ],
        "Resource": [
            "arn:aws:codestar-connections:*:*:connection/*",
            "arn:aws:codeconnections:*:*:connection/*"
        ]
    }
}

Erreur d'autorisations due au préfixe de service dans les ressources créées à l'aide de la console

Actuellement, les ressources de connexions créées à l'aide de la console n'auront que le préfixe codestar-connections de service. Pour les ressources créées à l'aide de la console, les actions de déclaration de stratégie doivent être incluses codestar-connections comme préfixe de service.

Problème :

Lors de la création d'une ressource de connexions à l'aide de la console, le préfixe de codestar-connections service doit être utilisé dans la politique. Lorsque vous utilisez une politique avec le préfixe de codeconnections service dans la politique, les ressources de connexions créées à l'aide de la console reçoivent le message d'erreur suivant :

User: user_ARN is not authorized to perform: codestar-connections:action on resource: resource_ARN because no identity-based policy allows the codestar-connections:action action

Correctifs possibles : pour les ressources créées à l'aide de la console, les actions de déclaration de stratégie doivent inclure codestar-connections comme préfixe de service, comme indiqué dans l'exemple de politique présenté dansExemple : politique de créationAWS CodeConnectionsavec la console.

Configuration de la connexion et de l'hôte pour les fournisseurs installés qui soutiennent les organisations

Pour les fournisseurs installés qui prennent en charge les organisations, tels que GitHub les organisations, vous ne transmettez pas d'hôte disponible. Vous créez un nouvel hôte pour chaque connexion de votre organisation et veillez à saisir les mêmes informations dans les champs réseau suivants :

Consultez les étapes associées pour créer une connexion GHES ou une connexion GitLab autogérée.

Je souhaite augmenter mes limites de connexion

Vous pouvez demander une augmentation de la limite pour certaines limites dans CodeConnections. Pour plus d'informations, consultez Quotas de connexions.