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.

# Tutoriel : Connexion à un sandbox via SSH
<a name="sandbox-ssh-tutorial"></a>

Ce didacticiel explique comment se connecter à un CodeBuild sandbox à l'aide d'un client SSH.

Pour effectuer ce didacticiel, vous devez d'abord :
+ Assurez-vous d'avoir un AWS CodeBuild projet existant.
+ Configurez les autorisations IAM appropriées configurées pour votre rôle dans le CodeBuild projet. 
+ Installez et configurez AWS CLI sur votre machine locale.

## Étape 1 : démarrer un bac à sable
<a name="sandbox-ssh-tutorial.start-sandbox"></a>

**Pour démarrer un CodeBuild bac à sable dans la console**

1. Ouvrez la AWS CodeBuild console sur [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).

1. Dans le volet de navigation, choisissez **Projets de génération**. Choisissez le projet de génération, puis choisissez **Debug build**.  
![\[La page détaillée du projet de création dans la console.\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/images/project-debug-build.png)

1. Dans l'onglet **Client SSH**, choisissez **Start sandbox**.  
![\[L'onglet « Client SSH » de la console avec le bouton « Démarrer le bac à sable ».\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/images/ssh-client-sandbox.png)

1. Le processus d'initialisation du sandbox peut prendre un certain temps. Vous pouvez vous connecter au sandbox lorsque son statut passe à`RUN_SANDDBOX`.  
![\[La connexion au sandbox SSH une fois que le statut passe à « RUN_SANDDBOX ».\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/images/run-sandbox.png)

## Étape 2 : Modifier la configuration SSH locale
<a name="sandbox-ssh-tutorial.modify-ssh"></a>

Si vous vous connectez au sandbox pour la première fois, vous devez effectuer un processus de configuration unique en suivant les étapes suivantes :

**Pour modifier la configuration SSH locale dans la console**

1. Localisez les commandes de configuration de votre système d'exploitation.

1. Ouvrez votre terminal local, puis copiez et exécutez les commandes fournies pour télécharger et exécuter le script permettant de configurer votre configuration SSH locale. Par exemple, si votre système d'exploitation est macOS, utilisez la commande suivante :  
![\[Les commandes macOS pour la connexion SSH au CodeBuild sandbox de la console.\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/images/modify-ssh-macOS.png)

1. Le script de configuration ajoutera les configurations requises pour la connexion à vos sandbox. Vous serez invité à accepter ces modifications.

1. Une fois la configuration réussie, une nouvelle entrée de configuration SSH pour le CodeBuild sandbox sera créée.  
![\[Connexion sandbox SSH réussie.\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/images/ssh-terminal-success.png)

## Étape 3 : Connectez-vous au bac à sable
<a name="sandbox-ssh-tutorial.connect-sandbox"></a>

**Pour modifier la configuration SSH locale dans la console**

1. Configurez AWS CLI l'authentification et assurez-vous que votre AWS CLI utilisateur dispose de l'`codebuild:StartSandboxConnection`autorisation. Pour plus d'informations, consultez la section [Authentification à l'aide des informations d'identification utilisateur IAM AWS CLI dans le](https://docs.aws.amazon.com/cli/v1/userguide/cli-authentication-user.html) *guide de l'utilisateur de l'interface de ligne de AWS commande pour la version 1*.

1. Connectez-vous à votre sandbox à l'aide de la commande suivante :

   ```
   ssh codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1:<account-id>:sandbox/<sandbox-id>
   ```
**Note**  
Pour résoudre les problèmes de connexion, utilisez l'`-v`indicateur pour activer la sortie détaillée. Par exemple, `ssh -v codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1:<account-id>:sandbox/<sandbox-id>`.  
Pour obtenir des conseils de dépannage supplémentaires, consultez[Résolution des problèmes AWS CodeBuild de connexion SSH au sandbox](sandbox-troubleshooting.md).

## Étape 4 : Passez en revue vos résultats
<a name="sandbox-ssh-tutorial.review-results"></a>

Une fois connecté, vous pouvez corriger les échecs de compilation, tester les commandes de compilation, expérimenter des modifications de configuration et vérifier les variables d'environnement et les dépendances avec votre sandbox.