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.
# Résolution des problèmes AWS CodeBuild de connexion SSH au sandbox
Utilisez les informations de cette rubrique pour identifier, diagnostiquer et résoudre les problèmes de connexion SSH dans le CodeBuild sandbox.
**Topics**
+ [`StartSandboxConnection``InvalidInputException`erreur lors du SSH dans un environnement CodeBuild sandbox](#sandbox-troubleshooting.invalid-input)
+ [Erreur : « Impossible de localiser les informations d'identification » lors du SSH dans un environnement CodeBuild sandbox](#sandbox-troubleshooting.credentials)
+ [`StartSandboxConnection``AccessDeniedException`erreur lors du SSH dans un environnement CodeBuild sandbox](#sandbox-troubleshooting.access-denied)
+ [Erreur : « ssh : Impossible de résoudre le nom d'hôte » lors du SSH dans un environnement sandbox CodeBuild](#sandbox-troubleshooting.hostname)
## `StartSandboxConnection``InvalidInputException`erreur lors du SSH dans un environnement CodeBuild sandbox
**Problème :** Lorsque vous tentez de vous connecter à un environnement CodeBuild sandbox à l'aide de la commande`ssh codebuild-sandbox-ssh=`, vous pouvez rencontrer une `InvalidInputException` erreur telle que :
```
An error occurred (InvalidInputException) when calling the StartSandboxConnection
operation: Failed to start SSM session for {sandbox-arn}
User: arn:aws:sts:::assumed-role//AWSCodeBuild-
is not authorized to perform: ssm:StartSession on resource.
```
```
An error occurred (InvalidInputException) when calling the StartSandboxConnection
operation: Failed to start SSM session for
sandbox : codebuild: is not connected.
```
**Cause possible :**
+ Agent Amazon EC2 Systems Manager manquant : l'agent SSM n'est pas correctement installé ou configuré sur l'image de compilation.
+ Autorisations insuffisantes : le rôle de service de CodeBuild projet ne dispose pas des autorisations SSM requises.
**Solution recommandée :** Si vous utilisez une image personnalisée pour votre build, procédez comme suit.
1. Installez SSM Agent. Pour plus d'informations, consultez la section [Installation et désinstallation manuelles de l'agent SSM sur les instances Amazon EC2 pour](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html) Linux dans le. ** La version de l'agent SSM doit être `3.0.1295.0` ou ultérieure.
1. Copiez le fichier [ https://github.com/aws/aws-codebuild-docker-images/blob/master/ubuntu/standard/7.0/amazon-ssm-agent.json](https://github.com/aws/aws-codebuild-docker-images/blob/master/ubuntu/standard/7.0/amazon-ssm-agent.json) dans le `/etc/amazon/ssm/` répertoire de votre image. Cela active **le mode conteneur** dans l'agent SSM.
1. Assurez-vous que le rôle de service de votre CodeBuild projet dispose des autorisations suivantes, puis redémarrez l'environnement sandbox :
```
{
"Effect": "Allow",
"Action": [
"ssmmessages:CreateControlChannel",
"ssmmessages:CreateDataChannel",
"ssmmessages:OpenControlChannel",
"ssmmessages:OpenDataChannel"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ssm:StartSession"
],
"Resource": [
"arn:aws:codebuild:region:account-id:build/*",
"arn:aws:ssm:region::document/AWS-StartSSHSession"
]
}
```
## Erreur : « Impossible de localiser les informations d'identification » lors du SSH dans un environnement CodeBuild sandbox
**Problème :** Lorsque vous tentez de vous connecter à un environnement CodeBuild sandbox à l'aide de la commande`ssh codebuild-sandbox-ssh=`, vous pouvez rencontrer l'erreur d'identification suivante :
```
Unable to locate credentials. You can configure credentials by running
"aws configure".
```
**Cause possible :** les AWS informations d'identification n'ont pas été correctement configurées dans votre environnement local.
**Solution recommandée :** Configurez vos AWS CLI informations d'identification en suivant la documentation officielle : [Configuration des paramètres du Guide de AWS CLI l'](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)*utilisateur de l'interface de ligne de AWS commande pour la version 2*.
## `StartSandboxConnection``AccessDeniedException`erreur lors du SSH dans un environnement CodeBuild sandbox
**Problème :** Lorsque vous tentez de vous connecter à un environnement CodeBuild sandbox à l'aide de la commande`ssh codebuild-sandbox-ssh=`, vous pouvez rencontrer l'erreur d'autorisation suivante :
```
An error occurred (AccessDeniedException) when calling the StartSandboxConnection
operation:
User: arn:aws:sts::account-id:assumed-role/role-name
is not authorized to perform: codebuild:StartSandboxConnection on resource:
sandbox-arn
because no identity-based policy allows the codebuild:StartSandboxConnection action
```
**Cause possible :** Vos AWS informations d'identification ne disposent pas CodeBuild des autorisations nécessaires pour effectuer cette opération.
**Solution recommandée :** assurez-vous que l'utilisateur ou le rôle IAM associé à vos AWS CLI informations d'identification dispose des autorisations suivantes :
```
{
"Effect": "Allow",
"Action": [
"codebuild:StartSandboxConnection"
],
"Resource": [
"arn:aws:codebuild:region:account-id:sandbox/*"
]
}
```
## Erreur : « ssh : Impossible de résoudre le nom d'hôte » lors du SSH dans un environnement sandbox CodeBuild
**Problème :** Lorsque vous tentez de vous connecter à un environnement CodeBuild sandbox à l'aide de la commande`ssh codebuild-sandbox-ssh=`, vous rencontrez l'erreur de résolution de nom d'hôte suivante :
```
ssh: Could not resolve hostname
```
**Cause possible :** Cette erreur se produit généralement lorsque le script de connexion au CodeBuild sandbox requis n'a pas été correctement exécuté dans votre environnement local.
**Solution recommandée:**
1. Téléchargez le script de connexion au CodeBuild sandbox.
1. Exécutez le script dans votre terminal pour établir la configuration SSH nécessaire.
1. Réessayez de vous connecter SSH à l'environnement sandbox.