Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Behebung von SSH-Verbindungsproblemen mit der AWS CodeBuild Sandbox
Verwenden Sie die Informationen in diesem Thema, um SSH-Verbindungsprobleme mit der CodeBuild Sandbox zu identifizieren, zu diagnostizieren und zu beheben.
**Topics**
+ [`StartSandboxConnection``InvalidInputException`Fehler beim Zugriff auf eine Sandbox-Umgebung per SSH CodeBuild](#sandbox-troubleshooting.invalid-input)
+ [Fehler: „Anmeldeinformationen konnten nicht gefunden werden“, wenn Sie eine SSH-Verbindung zur Sandbox-Umgebung herstellen CodeBuild](#sandbox-troubleshooting.credentials)
+ [`StartSandboxConnection``AccessDeniedException`Fehler beim Zugriff auf eine CodeBuild Sandbox-Umgebung per SSH](#sandbox-troubleshooting.access-denied)
+ [Fehler: „ssh: Hostname konnte nicht aufgelöst werden“ bei SSH in die Sandbox-Umgebung CodeBuild](#sandbox-troubleshooting.hostname)
## `StartSandboxConnection``InvalidInputException`Fehler beim Zugriff auf eine Sandbox-Umgebung per SSH CodeBuild
**Problem:** Wenn Sie versuchen, mithilfe des Befehls eine Verbindung zu einer CodeBuild Sandbox-Umgebung herzustellen`ssh codebuild-sandbox-ssh=`, kann ein `InvalidInputException` Fehler auftreten, z. B.:
```
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.
```
**Mögliche Ursache:**
+ Fehlender Amazon EC2 Systems Manager Manager-Agent: Auf dem Build-Image ist der SSM-Agent nicht ordnungsgemäß installiert oder konfiguriert.
+ Unzureichende Berechtigungen: Der CodeBuild Projekt-Servicerolle fehlen die erforderlichen SSM-Berechtigungen.
**Empfohlene Lösung:** Wenn Sie ein benutzerdefiniertes Image für Ihren Build verwenden, gehen Sie wie folgt vor.
1. Installieren Sie den SSM Agent. Weitere Informationen finden Sie unter [Manuelles Installieren und Deinstallieren des SSM-Agenten auf Amazon EC2 EC2-Instances für Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/manually-install-ssm-agent-linux.html) in der. ** Die SSM-Agent-Version muss oder höher sein. `3.0.1295.0`
1. Kopieren Sie die Datei [ 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) in das Verzeichnis in Ihrem Image. `/etc/amazon/ssm/` Dadurch wird der **Container-Modus im** SSM-Agent aktiviert.
1. Stellen Sie sicher, dass die Servicerolle Ihres CodeBuild Projekts über die folgenden Berechtigungen verfügt, und starten Sie dann die Sandbox-Umgebung neu:
```
{
"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"
]
}
```
## Fehler: „Anmeldeinformationen konnten nicht gefunden werden“, wenn Sie eine SSH-Verbindung zur Sandbox-Umgebung herstellen CodeBuild
**Problem:** Wenn Sie versuchen, mithilfe des Befehls eine Verbindung zu einer CodeBuild Sandbox-Umgebung herzustellen`ssh codebuild-sandbox-ssh=`, kann der folgende Anmeldeinformationsfehler auftreten:
```
Unable to locate credentials. You can configure credentials by running
"aws configure".
```
**Mögliche Ursache:** Die AWS Anmeldeinformationen wurden in Ihrer lokalen Umgebung nicht richtig konfiguriert.
**Empfohlene Lösung:** Konfigurieren Sie Ihre AWS CLI Anmeldeinformationen gemäß der offiziellen Dokumentation: [Konfiguration der Einstellungen für die AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) im *AWS Befehlszeilenschnittstellen-Benutzerhandbuch für Version 2.*
## `StartSandboxConnection``AccessDeniedException`Fehler beim Zugriff auf eine CodeBuild Sandbox-Umgebung per SSH
**Problem:** Wenn Sie versuchen, mithilfe des Befehls eine Verbindung zu einer CodeBuild Sandbox-Umgebung herzustellen`ssh codebuild-sandbox-ssh=`, kann der folgende Berechtigungsfehler auftreten:
```
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
```
**Mögliche Ursache:** Ihre AWS Anmeldeinformationen verfügen nicht über die erforderlichen CodeBuild Berechtigungen, um diesen Vorgang auszuführen.
**Empfohlene Lösung:** Stellen Sie sicher, dass der mit Ihren AWS CLI Anmeldeinformationen verknüpfte IAM-Benutzer oder die IAM-Rolle über die folgenden Berechtigungen verfügt:
```
{
"Effect": "Allow",
"Action": [
"codebuild:StartSandboxConnection"
],
"Resource": [
"arn:aws:codebuild:region:account-id:sandbox/*"
]
}
```
## Fehler: „ssh: Hostname konnte nicht aufgelöst werden“ bei SSH in die Sandbox-Umgebung CodeBuild
**Problem:** Beim Versuch, mithilfe des Befehls eine Verbindung zu einer CodeBuild Sandbox-Umgebung herzustellen`ssh codebuild-sandbox-ssh=`, tritt der folgende Fehler bei der Auflösung des Hostnamens auf:
```
ssh: Could not resolve hostname
```
**Mögliche Ursache:** Dieser Fehler tritt normalerweise auf, wenn das erforderliche CodeBuild Sandbox-Verbindungsskript in Ihrer lokalen Umgebung nicht ordnungsgemäß ausgeführt wurde.
**Empfohlene Lösung:**
1. Laden Sie das CodeBuild Sandbox-Verbindungsskript herunter.
1. Führen Sie das Skript in Ihrem Terminal aus, um die erforderliche SSH-Konfiguration einzurichten.
1. Versuchen Sie erneut, Ihre SSH-Verbindung zur Sandbox-Umgebung herzustellen.