

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Risoluzione dei problemi AWS CodeBuild di connessione SSH nella sandbox
<a name="sandbox-troubleshooting"></a>

Utilizza le informazioni contenute in questo argomento per identificare, diagnosticare e risolvere i problemi di connessione SSH CodeBuild nella sandbox.

**Topics**
+ [`StartSandboxConnection``InvalidInputException`errore quando SSH entra nell'ambiente sandbox CodeBuild](#sandbox-troubleshooting.invalid-input)
+ [Errore: «Impossibile individuare le credenziali» quando SSH entra nell'ambiente sandbox CodeBuild](#sandbox-troubleshooting.credentials)
+ [`StartSandboxConnection``AccessDeniedException`errore quando SSH entra nell'ambiente sandbox CodeBuild](#sandbox-troubleshooting.access-denied)
+ [Errore: «ssh: impossibile risolvere il nome host» quando SSH entra nell'ambiente sandbox CodeBuild](#sandbox-troubleshooting.hostname)

## `StartSandboxConnection``InvalidInputException`errore quando SSH entra nell'ambiente sandbox CodeBuild
<a name="sandbox-troubleshooting.invalid-input"></a>

**Problema:** quando si tenta di connettersi a un ambiente CodeBuild sandbox utilizzando il comando`ssh codebuild-sandbox-ssh=<sandbox-arn>`, è possibile che si verifichi un `InvalidInputException` errore del tipo:

```
An error occurred (InvalidInputException) when calling the StartSandboxConnection 
operation: Failed to start SSM session for {sandbox-arn}
User: arn:aws:sts::<account-ID>:assumed-role/<service-role-name>/AWSCodeBuild-<UUID> 
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 <sandbox-arn>: codebuild:<UUID> is not connected.
```

**Causa possibile:**
+ Agente Amazon EC2 Systems Manager mancante: nell'immagine di build non è installato o configurato correttamente l'agente SSM.
+ Autorizzazioni insufficienti: il ruolo del servizio di CodeBuild progetto non dispone delle autorizzazioni SSM richieste.

**Soluzione consigliata:** se utilizzi un'immagine personalizzata per la build, procedi come segue.

1. Installazione di SSM Agent Per ulteriori informazioni, consulta [Installazione e disinstallazione manuale dell'agente SSM su istanze Amazon EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html) per Linux nel. ** La versione di SSM Agent deve essere o successiva. `3.0.1295.0`

1. Copia il file, [ 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) nella directory dell'immagine. `/etc/amazon/ssm/` **Ciò abilita la modalità contenitore nell'agente SSM.**

1. Assicurati che il ruolo di servizio del tuo CodeBuild progetto disponga delle seguenti autorizzazioni, quindi riavvia l'ambiente 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"
        ]
    }
   ```

## Errore: «Impossibile individuare le credenziali» quando SSH entra nell'ambiente sandbox CodeBuild
<a name="sandbox-troubleshooting.credentials"></a>

**Problema:** quando si tenta di connettersi a un ambiente CodeBuild sandbox utilizzando il comando`ssh codebuild-sandbox-ssh=<sandbox-arn>`, è possibile che si verifichi il seguente errore di credenziali:

```
Unable to locate credentials. You can configure credentials by running 
"aws configure".
```

**Possibile causa:** AWS le credenziali non sono state configurate correttamente nell'ambiente locale.

**Soluzione consigliata:** configura AWS CLI le credenziali seguendo la documentazione ufficiale: [Configurazione delle impostazioni per la Guida utente dell'](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)*interfaccia AWS CLI a riga di AWS comando per* la versione 2.

## `StartSandboxConnection``AccessDeniedException`errore quando SSH entra nell'ambiente sandbox CodeBuild
<a name="sandbox-troubleshooting.access-denied"></a>

**Problema:** quando si tenta di connettersi a un ambiente CodeBuild sandbox utilizzando il comando`ssh codebuild-sandbox-ssh=<sandbox-arn>`, è possibile che si verifichi il seguente errore di autorizzazione:

```
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
```

**Possibile causa:** AWS le tue credenziali non dispongono delle CodeBuild autorizzazioni necessarie per eseguire questa operazione.

**Soluzione consigliata:** assicurati che l'utente o il ruolo IAM associato alle tue AWS CLI credenziali disponga delle seguenti autorizzazioni:

```
{
    "Effect": "Allow",
    "Action": [
       "codebuild:StartSandboxConnection"
     ],
     "Resource": [
        "arn:aws:codebuild:region:account-id:sandbox/*"
     ]
}
```

## Errore: «ssh: impossibile risolvere il nome host» quando SSH entra nell'ambiente sandbox CodeBuild
<a name="sandbox-troubleshooting.hostname"></a>

**Problema:** quando si tenta di connettersi a un ambiente CodeBuild sandbox utilizzando il comando`ssh codebuild-sandbox-ssh=<sandbox-arn>`, si verifica il seguente errore di risoluzione del nome host:

```
ssh: Could not resolve hostname
```

**Possibile causa:** questo errore si verifica in genere quando lo script di connessione alla CodeBuild sandbox richiesto non è stato eseguito correttamente nell'ambiente locale.

**Soluzione consigliata:**

1. Scarica lo script di connessione alla CodeBuild sandbox.

1. Esegui lo script nel tuo terminale per stabilire la configurazione SSH necessaria.

1. Riprova la connessione SSH all'ambiente sandbox.