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.
# Fehlerbehebung AWS CloudShell
Bei der Verwendung AWS CloudShell können Probleme auftreten, z. B. wenn Sie wichtige Aufgaben über die Shell-Befehlszeilenschnittstelle starten CloudShell oder ausführen. In diesem Kapitel wird beschrieben, wie Sie einige der häufigsten Probleme beheben können, auf die Sie möglicherweise stoßen.
Antworten auf eine Vielzahl von Fragen CloudShell zu finden Sie in den [AWS CloudShell häufig gestellten Fragen](https://aws.amazon.com/cloudshell/faqs/). Sie können auch im [AWS CloudShell Diskussionsforum](https://repost.aws/tags/TA5ZaPf1NkT4uNitnWVitlyQ/aws-cloud-shell) nach Antworten suchen und Fragen stellen. Wenn Sie dieses Forum betreten, müssen Sie sich möglicherweise anmelden AWS. Sie können uns auch direkt [kontaktieren](https://aws.amazon.com/contact-us/).
## Behebung von Fehlern
Wenn Sie auf einen der folgenden indizierten Fehler stoßen, können Sie die folgenden Lösungen verwenden, um diese Fehler zu beheben.
**Topics**
+ [Zugriff verweigert](#unable-to-launch-cloudshell)
+ [Unzureichende Berechtigungen](#no-access-cloudshell)
+ [Zugriff nicht möglich AWS CloudShell Befehlszeile](#locked-out-cloudshell)
+ [Externe IP-Adressen konnten nicht gepingt werden](#ping-cloudshell)
+ [Bei der Vorbereitung Ihres Terminals sind einige Probleme aufgetreten](#old-browser-issue-cloudshell)
+ [Die Pfeiltasten funktionieren nicht richtig in PowerShell](#pwsh-arrow-keys)
+ [Nicht unterstützte Web Sockets führen dazu, dass Sitzungen nicht gestartet CloudShell werden können](#web-sockets-cloudshell)
+ [Das `AWSPowerShell.NetCore`Modul konnte nicht importiert werden](#import-PowerShell-module)
+ [Docker läuft nicht bei der Verwendung AWS CloudShell](#docker-not-running)
+ [Docker hat keinen Speicherplatz mehr](#docker-space-full)
+ [`Docker Push` hat ein Timeout und versucht es immer wieder](#docker-push-timeout)
+ [Ich kann von meinem aus nicht auf Ressourcen innerhalb der VPC zugreifen AWS CloudShell VPC-Umgebung](#unable-access-VPC-resources)
+ [Das ENI, das verwendet wird von AWS CloudShell für meine VPC-Umgebung wurde nicht bereinigt](#unable-cleanup-VPC-ENI)
+ [Benutzer, die nur für VPC-Umgebungen `CreateEnvironment`berechtigt sind, haben auch Zugriff auf öffentliche Umgebungen AWS CloudShell Umgebungen](#user-has-access-to-publicCloudShellenv)
### Zugriff verweigert
**Problem:** Wenn Sie versuchen, CloudShell von der aus zu starten AWS-Managementkonsole, erhalten Sie die Meldung "Die Umgebung konnte nicht gestartet werden. Um es erneut zu versuchen, aktualisieren Sie den Browser oder starten Sie ihn neu, indem Sie „Aktionen, Neustart AWS CloudShell“ wählen. Ihnen wird der Zugriff verweigert, auch wenn Sie die Berechtigungen Ihres IAM-Administrators benötigen und Ihren Browser aktualisiert oder neu gestartet haben. CloudShell
**Lösung:** Wenden Sie sich an den [AWS Support](https://aws.amazon.com/contact-us/).
([zurück zum Seitenanfang](#troubleshooting))
### Unzureichende Berechtigungen
**Problem:** Wenn Sie versuchen, CloudShell von der aus zu starten AWS-Managementkonsole, erhalten Sie die Meldung „Die Umgebung konnte nicht gestartet werden. Sie verfügen nicht über die erforderlichen Berechtigungen. Bitten Sie Ihren IAM-Administrator, Zugriff auf AWS CloudShell"zu gewähren. Ihnen wird der Zugriff verweigert und Sie werden darüber informiert, dass Sie nicht über die erforderlichen Berechtigungen verfügen.
**Ursache:** Der IAM-Identität, die Sie für den Zugriff verwenden, AWS CloudShell fehlen die erforderlichen IAM-Berechtigungen.
**Lösung: Bitten** Sie Ihren IAM-Administrator, Ihnen die erforderlichen Berechtigungen zu erteilen. Dazu kann er entweder eine angehängte AWS verwaltete Richtlinie (AWSCloudShellFullAccess) oder eine eingebettete Inline-Richtlinie hinzufügen. Weitere Informationen finden Sie unter [Verwalten AWS CloudShell Zugriff und Nutzung mit IAM-Richtlinien](sec-auth-with-identities.md).
([zurück zum Seitenanfang](#troubleshooting))
### Zugriff nicht möglich AWS CloudShell Befehlszeile
**Problem:** Nachdem Sie eine Datei geändert haben, die von der Rechenumgebung verwendet wird, können Sie nicht mehr auf die Befehlszeile in zugreifen AWS CloudShell.
**Lösung:** Wenn Sie nach einer falschen Änderung `.bashrc` oder einer anderen Datei den Zugriff verlieren, können Sie AWS CloudShell zu den Standardeinstellungen zurückkehren, indem Sie [Ihr Home-Verzeichnis löschen](getting-started.md#delete-shell-session).
([zurück zum Seitenanfang](#troubleshooting))
### Externe IP-Adressen konnten nicht gepingt werden
**Problem:** Wenn Sie einen Ping-Befehl von der Befehlszeile aus ausführen (z. B.`ping amazon.com`), erhalten Sie die folgende Meldung.
```
ping: socket: Operation not permitted
```
**Ursache**: Das Ping-Hilfsprogramm verwendet das Internet Control Message Protocol (ICMP), um Echoanforderungspakete an einen Zielhost zu senden. Es wartet auf die Antwort eines Echos vom Ziel. Da das ICMP-Protokoll in nicht aktiviert ist AWS CloudShell, funktioniert das Ping-Hilfsprogramm nicht in der Rechenumgebung der Shell.
**Lösung**: Da ICMP in nicht unterstützt wird, können Sie den folgenden Befehl ausführen AWS CloudShell, um Netcat zu installieren. Netcat ist ein Computernetzwerkprogramm zum Lesen und Schreiben von Netzwerkverbindungen mithilfe von TCP oder UDP.
```
sudo yum install nc
nc -zv www.amazon.com 443
```
([zurück zum Seitenanfang](#troubleshooting))
### Bei der Vorbereitung Ihres Terminals sind einige Probleme aufgetreten
**Problem:** Wenn Sie versuchen, AWS CloudShell mit dem Microsoft Edge-Browser darauf zuzugreifen, können Sie keine Shell-Sitzung starten, und der Browser zeigt eine Fehlermeldung an.
**Ursache**: AWS CloudShell ist nicht mit früheren Versionen von Microsoft Edge kompatibel. Sie können AWS CloudShell mit den neuesten vier Hauptversionen der unterstützten Browser darauf zugreifen.
**Lösung:** Installieren Sie eine aktualisierte Version des Edge-Browsers von der [Microsoft-Website](https://www.microsoft.com/en-us/edge).
([zurück zum Seitenanfang](#troubleshooting))
### Die Pfeiltasten funktionieren nicht richtig in PowerShell
**Problem:** Im Normalbetrieb können Sie mit den Pfeiltasten in der Befehlszeilenschnittstelle navigieren und Ihren Befehlsverlauf vor- und zurückscannen. Wenn Sie jedoch in bestimmten Versionen von PowerShell on die Pfeiltasten drücken AWS CloudShell, werden Buchstaben möglicherweise falsch ausgegeben.
**Ursache**: Die Situation, dass Pfeiltasten Buchstaben falsch ausgeben, ist ein bekanntes Problem bei PowerShell 7.2.x-Versionen, die unter Linux ausgeführt werden.
**Lösung:** Um Escape-Sequenzen zu entfernen, die das Verhalten der Pfeiltasten verändern, bearbeiten Sie die PowerShell Profildatei und setzen Sie die `$PSStyle` Variable auf. `PlainText`
1. Geben Sie in der AWS CloudShell Befehlszeile den folgenden Befehl ein, um die Profildatei zu öffnen.
```
vim ~/.config/powershell/Microsoft.PowerShell_profile.ps1
```
**Anmerkung**
Wenn Sie bereits angemeldet sind PowerShell, können Sie die Profildatei auch mit dem folgenden Befehl im Editor öffnen.
```
vim $PROFILE
```
1. Gehen Sie im Editor zum Ende des vorhandenen Texts der Datei, drücken Sie **i**, um in den **Einfügemodus zu wechseln, und fügen** Sie dann die folgende Anweisung hinzu.
```
$PSStyle.OutputRendering = 'PlainText'
```
1. Nachdem Sie die Bearbeitung vorgenommen haben, drücken Sie, **Esc** um in den Befehlsmodus zu wechseln. Geben Sie anschließend den folgenden Befehl ein, um die Datei zu speichern und den Editor zu beenden.
```
:wq
```
**Anmerkung**
Ihre Änderungen werden wirksam, wenn Sie das nächste Mal beginnen PowerShell.
([zurück zum Seitenanfang](#troubleshooting))
### Nicht unterstützte Web Sockets führen dazu, dass Sitzungen nicht gestartet CloudShell werden können
**Problem:** Wenn Sie versuchen zu starten AWS CloudShell, erhalten Sie wiederholt die folgende Meldung:`Failed to open sessions : Timed out while opening the session`.
**Ursache**: CloudShell hängt vom *WebSocket Protokoll* ab, das eine wechselseitige interaktive Kommunikation zwischen Ihrem Webbrowser und AWS CloudShell ermöglicht. Wenn Sie einen Browser in einem privaten Netzwerk verwenden, wird der sichere Zugriff auf das Internet wahrscheinlich durch Proxyserver und Firewalls erleichtert. WebSocket Die Kommunikation kann normalerweise problemlos über Proxyserver erfolgen. In einigen Fällen verhindern WebSockets Proxyserver jedoch, dass sie ordnungsgemäß funktionieren. Wenn dieses Problem auftritt, CloudShell kann keine Shell-Sitzung gestartet werden, und der Verbindungsversuch läuft irgendwann ab.
**Lösung:** Ein Verbindungstimeout kann durch ein anderes als nicht WebSockets unterstütztes Problem verursacht werden. Wenn dies der Fall ist, aktualisieren Sie zunächst das Browserfenster, in dem sich die CloudShell Befehlszeilenschnittstelle befindet.
Wenn Sie nach der Aktualisierung immer noch Timeout-Fehler erhalten, lesen Sie in der Dokumentation Ihres Proxyservers nach. Stellen Sie außerdem sicher, dass Ihr Proxyserver so konfiguriert ist, dass er Web Sockets zulässt. Wenden Sie sich alternativ an den Systemadministrator Ihres Netzwerks.
**Anmerkung**
Angenommen, Sie möchten detaillierte Berechtigungen definieren, indem Sie bestimmte URLs auf eine Zulassungsliste setzen. Sie können einen Teil der URL hinzufügen, über die die AWS Systems Manager Sitzung eine WebSocket Verbindung zum Senden von Eingaben und Empfangen von Ausgaben herstellt. Ihre AWS CloudShell Befehle werden an diese Systems Manager Manager-Sitzung gesendet.
Das Format dafür StreamUrl , das von Systems Manager verwendet wird, ist` wss://ssmmessages.region.amazonaws.com/v1/data-channel/session-id?stream=(input|output)`.
Die **Region** stellt die Regionskennung für eine dar AWS-Region , die von unterstützt wird AWS Systems Manager. Dies `us-east-2` ist beispielsweise die Regionskennung für die Region USA Ost (Ohio).
Da die **Sitzungs-ID** erstellt wird, *nachdem* eine bestimmte Systems Manager Manager-Sitzung erfolgreich gestartet wurde, können Sie sie nur angeben, `wss://ssmmessages.region.amazonaws.com` wenn Sie Ihre URL-Zulassungsliste aktualisieren. *Weitere Informationen zu diesem [StartSession](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_StartSession.html)Vorgang finden Sie in der AWS Systems Manager API-Referenz.*
([zurück zum Seitenanfang](#troubleshooting))
### Das `AWSPowerShell.NetCore`Modul konnte nicht importiert werden
**Problem:** Wenn Sie das AWSPowerShell.NetCore Modul in PowerShell by importieren`Import-Module -Name AWSPowerShell.NetCore`, erhalten Sie die folgende Fehlermeldung:
Import-Module: Das angegebene Modul 'AWSPowerShell.NetCore' wurde nicht geladen, da in keinem Modulverzeichnis eine gültige Moduldatei gefunden wurde.
**Ursache:** Das `AWSPowerShell.NetCore` Modul wurde durch die dienstspezifischen AWS.Tools-Module in ersetzt. AWS CloudShell
**Lösung:** Alle expliziten Importanweisungen sind möglicherweise nicht mehr erforderlich oder müssen in das zugehörige .Tools-Modul für jeden Dienst AWS geändert werden.
**Example**
**Example**
+ In den meisten Fällen benötigen Sie keine explizite Importanweisung, solange keine.NET-Typen verwendet werden. Im Folgenden finden Sie Beispiele für Import-Anweisungen.
+ `Get-S3Bucket`
+ `(Get-EC2Instance).Instances`
+ Wenn .Net-Typen verwendet werden, importieren Sie das Service-Level-Modul (`AWS.Tools.`). Es folgt ein Beispiel für die Syntax.
```
Import-Module -Name AWS.Tools.EC2
$InstanceTag = [Amazon.EC2.Model.Tag]::new("Environment","Dev")
```
```
Import-Module -Name AWS.Tools.S3
$LifecycleRule = [Amazon.S3.Model.LifecycleRule]::new()
```
Weitere Informationen finden Sie in der [Ankündigung von Version 4](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-is-now-generally-available-with-version-4-0/) für. AWS -Tools für PowerShell
([zurück zum Seitenanfang](#troubleshooting))
### Docker läuft nicht bei der Verwendung AWS CloudShell
**Problem:** Docker läuft bei der Verwendung nicht richtig. AWS CloudShell Sie erhalten die folgende Fehlermeldung:`docker: Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?`.
**Lösung:** Versuchen Sie, Ihre Umgebung neu zu starten. Diese Fehlermeldung kann auftreten, wenn Sie Docker AWS CloudShell in einer GovCloud Region ausführen. Stellen Sie sicher, dass Sie Docker in den unterstützten AWS Regionen ausführen. Eine Liste der Regionen, in denen Docker verfügbar ist, finden Sie unter [Unterstützte AWS Regionen](supported-aws-regions.md) für. AWS CloudShell
### Docker hat keinen Speicherplatz mehr
**Problem:** Sie erhalten die folgende Fehlermeldung:`ERROR: failed to solve: failed to register layer: write [...]: no space left on device`.
**Ursache:** Das Dockerfile überschreitet den verfügbaren Speicherplatz in. AWS CloudShell Dies kann durch große Einzelbilder oder durch zu viele bereits vorhandene Docker-Images verursacht werden.
**Lösung:** Führen Sie `df -h` den Befehl aus, um die Festplattennutzung zu ermitteln. Führen Sie den Befehl aus`sudo du -sh /folder/folder1`, um die Größe bestimmter Ordner zu ermitteln, die Ihrer Meinung nach groß sein könnten, und erwägen Sie, andere Dateien zu löschen, um Speicherplatz freizugeben. Eine Option wäre, in Betracht zu ziehen, ungenutzte Docker-Images durch Ausführen `docker rmi` zu entfernen. [Sie sollten sich bewusst sein, dass Docker nur über begrenzten Speicherplatz in der Umgebung verfügt. Weitere Informationen zu Docker finden Sie im Docker-Dokumentationsleitfaden.](https://docs.docker.com/guides/docker-overview/)
### `Docker Push` hat ein Timeout und versucht es immer wieder
**Problem:** Bei der Ausführung kommt `docker push` es zu einem Timeout und es wird weiterhin ohne Erfolg wiederholt.
**Ursache:** Dies kann auf fehlende Berechtigungen, das Verschieben in das falsche Repository oder auf eine fehlende Authentifizierung zurückzuführen sein.
**Lösung:** Um dieses Problem zu lösen, stellen Sie sicher, dass Sie zum richtigen Repository pushen. Führen Sie `docker login` die Datei aus, um sich ordnungsgemäß zu authentifizieren. Stellen Sie sicher, dass Sie über alle erforderlichen Berechtigungen für das Pushen in ein Amazon ECR-Repository verfügen.
### Ich kann von meinem aus nicht auf Ressourcen innerhalb der VPC zugreifen AWS CloudShell VPC-Umgebung
**Problem:** Während ich meine VPC-Umgebung verwende, kann ich nicht auf Ressourcen innerhalb der AWS CloudShell VPC zugreifen.
**Ursache:** Ihre AWS CloudShell VPC-Umgebung erbt die Netzwerkeinstellungen Ihrer VPC.
**Lösung:** Um dieses Problem zu beheben, stellen Sie sicher, dass Ihre VPC korrekt für den Zugriff auf Ihre Ressourcen eingerichtet ist. Weitere Informationen finden Sie in der VPC-Dokumentation [Connect Sie Ihre VPC mit anderen Netzwerken](https://docs.aws.amazon.com//vpc/latest/userguide/extend-intro.html) und in der Network Access Analyzer-Dokumentation [Network Access](https://docs.aws.amazon.com//vpc/latest/network-access-analyzer/what-is-network-access-analyzer.html) Analyzer. Sie finden die IPv4-Adresse, die die AWS CloudShell VPC-Umgebung verwendet, indem Sie den Befehl in Ihrer **`ip -a`** Umgebung in der Befehlszeile oder auf der VPC-Konsolenseite ausführen.
### Das ENI, das verwendet wird von AWS CloudShell für meine VPC-Umgebung wurde nicht bereinigt
**Problem:** Die ENI, die von AWS CloudShell für meine VPC-Umgebung verwendet wurde, konnte nicht bereinigt werden.
**Ursache:** Die `ec2:DeleteNetworkInterface` Berechtigung ist für Ihre Rolle nicht aktiviert.
**Lösung:** Um dieses Problem zu beheben, stellen Sie sicher, dass die `ec2:DeleteNetworkInterface` Berechtigung für Ihre Rolle aktiviert ist, wie im folgenden Beispielskript gezeigt:
```
{
"Effect": "Allow",
"Action": [
"ec2:DeleteNetworkInterface"
],
"Condition": {
"StringEquals": {
"aws:ResourceTag/ManagedByCloudShell": ""
}
},
"Resource": "arn:aws:ec2:*:*:network-interface/*"
}
```
### Benutzer, die nur für VPC-Umgebungen `CreateEnvironment`berechtigt sind, haben auch Zugriff auf öffentliche Umgebungen AWS CloudShell Umgebungen
**Problem:** Benutzer, die nur `CreateEnvironment` auf VPC-Umgebungen beschränkt sind, können auch auf öffentliche AWS CloudShell Umgebungen zugreifen.
**Ursache:** Wenn Sie die `CreateEnvironment` Berechtigungen nur für die Erstellung von VPC-Umgebungen einschränken und bereits eine öffentliche Umgebung erstellt haben, behalten Sie Ihren Zugriff auf die vorhandene öffentliche CloudShell Umgebung, bis diese Umgebung über die Webbenutzeroberfläche gelöscht wird. Wenn Sie diese jedoch noch nie CloudShell zuvor verwendet haben, haben Sie keinen Zugriff auf öffentliche Umgebungen.
**Lösung:** Um den Zugriff auf öffentliche AWS CloudShell Umgebungen einzuschränken, muss der IAM-Administrator zuerst die IAM-Richtlinie mit der Einschränkung aktualisieren. Anschließend muss der Benutzer die vorhandene öffentliche Umgebung manuell über die AWS CloudShell Webbenutzeroberfläche löschen. (**Aktionen** → ** CloudShell Umgebung löschen**).