Docker-Tutorial für AWS Cloud9

Connect Sie mithilfe eines SSH Clients wie dem sshUtility oder Pu eine Verbindung zur laufenden EC2 Amazon-Instance herTTY. Wie das funktioniert, ist unter „Schritt 3: Herstellen einer Verbindung mit Ihrer Instance“ in Starten einer virtuellen Linux-Maschine beschrieben.

Überprüfen Sie, ob Docker auf der Instance installiert ist. Führen Sie zu diesem Zweck den Befehl docker auf der Instance mit der Option --version aus.

docker --version

Wenn Docker installiert ist, werden die Docker-Version und die Build-Nummer angezeigt. In diesem Fall fahren Sie mit Schritt 5 dieses Verfahrens fort.

Docker-Installation. Dazu führen Sie den Befehl yum oder apt mit der Aktion install aus und geben das zu installierende Paket docker oder docker.io an.

Für Amazon Linux:

sudo yum install -y docker

Für Ubuntu Server:

sudo apt install -y docker.io

Vergewissern Sie sich, dass Docker installiert ist. Führen Sie dazu den Befehl docker --version erneut aus. Die Docker-Version und die Build-Nummer werden angezeigt.

Führen Sie Docker aus. Dazu führen Sie den Befehl service mit dem Service docker und der Aktion start aus.

sudo service docker start

Überprüfen Sie, ob Docker ausgeführt wird. Führen Sie zu diesem Zweck den Befehl docker mit der Aktion info aus.

sudo docker info

Wenn Docker ausgeführt wird, werden Informationen über Docker angezeigt.

Klicken Sie das Dockerfile auf der Instance. Erstellen Sie dazu, während der SSH Client weiterhin mit der Instance verbunden ist, im /tmp Verzeichnis auf der Instance eine Datei mit dem NamenDockerfile. Führen Sie beispielsweise den Befehl touch wie folgt aus.

sudo touch /tmp/Dockerfile

Fügen Sie der Datei Dockerfile die folgenden Inhalte hinzu.

# Build a Docker image based on the Amazon Linux 2 Docker image.
FROM amazonlinux:2

# install common tools
RUN yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
RUN yum update -y
RUN yum install -y sudo bash curl wget git man-db nano vim bash-completion tmux  gcc gcc-c++ make tar

# Enable the Docker container to communicate with AWS Cloud9 by
# installing SSH.
RUN yum install -y openssh-server

# Ensure that Node.js is installed.
RUN yum install -y nodejs

# Create user and enable root access
RUN useradd --uid 1000 --shell /bin/bash -m --home-dir /home/ubuntu ubuntu && \
    sed -i 's/%wheel\s.*/%wheel ALL=NOPASSWD:ALL/' /etc/sudoers && \
    usermod -a -G wheel ubuntu

# Add the AWS Cloud9 SSH public key to the Docker container.
# This assumes a file named authorized_keys containing the
# AWS Cloud9 SSH public key already exists in the same
# directory as the Dockerfile.
RUN mkdir -p /home/ubuntu/.ssh
ADD ./authorized_keys /home/ubuntu/.ssh/authorized_keys
RUN chown -R ubuntu /home/ubuntu/.ssh /home/ubuntu/.ssh/authorized_keys && \
chmod 700 /home/ubuntu/.ssh && \
chmod 600 /home/ubuntu/.ssh/authorized_keys

# Update the password to a random one for the user ubuntu.
RUN echo "ubuntu:$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)" | chpasswd

# pre-install Cloud9 dependencies
USER ubuntu
RUN curl https://d2j6vhu5uywtq3.cloudfront.net/static/c9-install.sh | bash

USER root
# Start SSH in the Docker container.
CMD ssh-keygen -A && /usr/sbin/sshd -D

Um den vorherigen Inhalt der Datei Dockerfile hinzuzufügen, könnten Sie das Dienstprogramm vi auf der Instance wie folgt verwenden.

1. Verwenden Sie die AWS Cloud9 , um die /tmp/Dockerfile Datei zu öffnen und zu bearbeiten.

   sudo vi /tmp/Dockerfile

2. Fügen Sie den vorherigen Inhalt in die Dockerfile-Datei ein. Wenn Sie sich nicht sicher sind, wie das geht, lesen Sie in der Dokumentation Ihres SSH Kunden nach.

3. Wechseln Sie in den Befehlsmodus. Um dies zu tun, drücken Sie die Esc-Taste. (-- INSERT -- verschwindet unten im Fenster).

4. Geben Sie :wq ein (um in die /tmp/Dockerfile-Datei zu schreiben, die Datei zu speichern und vi zu verlassen), und drücken Sie dann Enter.

Erstellen Sie auf der Instanz eine Datei, die den AWS Cloud9 SSH öffentlichen Schlüssel für den zu verwendenden Docker-Container enthält. Erstellen Sie dazu im selben Verzeichnis, in dem sich die Dockerfile-Datei befindet, eine Datei beispielsweise namens authorized_keys, indem Sie den Befehl touch ausführen.

sudo touch /tmp/authorized_keys

Fügen Sie den AWS Cloud9 SSH öffentlichen Schlüssel zur authorized_keys Datei hinzu. Gehen Sie wie folgt vor, um den AWS Cloud9 SSH öffentlichen Schlüssel zu erhalten:

1. Öffnen Sie die AWS Cloud9 Konsole unter https://console.aws.amazon.com/cloud9/.

2. Wählen Sie in der AWS Navigationsleiste in der AWS Regionsauswahl die AWS Region aus, in der Sie später in diesem Thema die AWS Cloud9 Entwicklungsumgebung erstellen möchten.

3. Wenn eine Willkommensseite angezeigt wird, wählen Sie für Neue AWS Cloud9 Umgebung die Option Umgebung erstellen aus. Andernfalls wählen Sie Create environment (Umgebung erstellen) aus.

4. Geben Sie auf der Seite Name environment (Umgebung benennen) für Name einen Namen für die Umgebung ein. (Der Name spielt hier keine Rolle. Sie werden später einen anderen Namen wählen.)

5. Klicken Sie auf Nächster Schritt.

6. Wählen Sie als Umgebungstyp die Option Connect und auf dem Remoteserver ausführen (SSH).

7. Erweitern Sie „Öffentlichen SSH Schlüssel anzeigen“.

8. Wählen Sie Copy key to clipboard (Schlüssel in Zwischenablage kopieren). (Dies liegt zwischen den Einstellungen „Öffentlichen SSH Schlüssel anzeigen“ und „Erweiterte Einstellungen“.)

9. Klicken Sie auf Abbrechen.

10. Kopieren Sie den Inhalt der Zwischenablage in die authorized_keys-Datei und speichern Sie die Datei. Beispielsweise können Sie das Dienstprogramm vi verwenden, wie weiter oben in diesem Schritt beschrieben.

Erstellen Sie das Image, indem Sie den Befehl docker mit der Aktion build ausführen, dem Image das Tag cloud9-image:latest hinzufügen und den Pfad zu der zu verwendenden Dockerfile-Datei angeben.

sudo docker build -t cloud9-image:latest /tmp

Ist der Befehl erfolgreich, enthalten die letzten beiden Zeilen der Build-Ausgabe Successfully built und Successfully tagged.

Um zu bestätigen, dass Docker das Image erfolgreich erstellt hat, führen Sie den Befehl docker mit der Aktion image ls aus.

sudo docker image ls

Ist dieser erfolgreich, zeigt die Ausgabe einen Eintrag an, in dem das Feld REPOSITORY auf cloud9-image und das Feld TAG auf latest gesetzt sind.

Notieren Sie sich die öffentliche IP-Adresse der EC2 Amazon-Instance. Sie benötigen sie für Schritt 4: Erstellen der Umgebung. Wenn Sie sich nicht sicher sind, was die öffentliche IP-Adresse der Instance ist, können Sie den folgenden Befehl auf der Instance ausführen, um sie abzurufen.

curl http://169.254.169.254/latest/meta-data/public-ipv4

Um den Docker-Container auszuführen, führen Sie den Befehl docker auf der Instance mit der Aktion run und den folgenden Optionen aus.

sudo docker run -d -it --expose 9090 -p 0.0.0.0:9090:22 --name cloud9 cloud9-image:latest

Um zu bestätigen, dass Docker den Container erfolgreich ausführt, führen Sie den Befehl docker mit der Aktion container ls aus.

sudo docker container ls

Ist dieser erfolgreich, zeigt die Ausgabe einen Eintrag an, in dem das Feld IMAGE auf cloud9-image:latest und das Feld NAMES auf cloud9 gesetzt sind.

Melden Sie sich bei dem ausgeführten Container an. Führen Sie dazu den Befehl docker mit der Aktion exec und den folgenden Optionen aus.

sudo docker exec -it cloud9 bash

Ist der Befehl erfolgreich ändert sich die Terminal-Eingabeaufforderung und zeigt den Namen des angemeldeten Benutzers für den Container und die ID des Containers an.

Legen Sie für das Verzeichnis auf dem laufenden Container, von dem aus Sie nach der Anmeldung beginnen möchten AWS Cloud9 , die Zugriffsberechtigungen auf fest. rwxr-xr-x Das bedeutet read-write-execute Berechtigungen für den Besitzer, Lese- und Ausführungsberechtigungen für die Gruppe und Lese- und Ausführungsberechtigungen für andere. Beispiel: Wenn der Pfad des Verzeichnisses ~ ist, können Sie diese Berechtigungen für das Verzeichnis festlegen, indem Sie folgendermaßen den Befehl chmod in dem ausgeführten Container ausführen.

sudo chmod u=rwx,g=rx,o=rx ~

Notieren Sie den Pfad zu dem Verzeichnis auf dem laufenden Container, der die Binärdatei Node.js enthält, weil Sie ihn für Schritt 4: Erstellen der Umgebung benötigen. Wenn Sie sich nicht sicher sind, was dieser Pfad ist, führen Sie den folgenden Befehl auf dem ausgeführten Container aus, um ihn abzurufen.

which node

Achten Sie darauf, dass die folgenden Voraussetzungen erfüllt sind.

Stellen Sie mithilfe eines SSH Clients eine Connect zu Ihrer vorhandenen Instanz oder Ihrem eigenen Server her, sofern Sie noch nicht damit verbunden sind. Dadurch wird sichergestellt, dass Sie der Instanz oder dem Server den erforderlichen Wert für den öffentlichen SSH Schlüssel hinzufügen können. Dies wird später in dieser Anleitung beschrieben.

Melden Sie sich bei der AWS Cloud9 Konsole an, unter https://console.aws.amazon.com/cloud9/.

Nachdem Sie sich bei der AWS Cloud9 Konsole angemeldet haben, wählen Sie in der oberen Navigationsleiste eine aus AWS-Region , in der die Umgebung erstellt werden soll. Eine Liste der verfügbaren AWS-Regionen finden Sie AWS Cloud9in der Allgemeine AWS-Referenz.

Wenn Sie zum ersten Mal eine Entwicklungsumgebung erstellen, wird eine Willkommensseite angezeigt. Wählen Sie im Bereich Neue AWS Cloud9 Umgebung die Option Umgebung erstellen aus.

Wenn Sie zuvor bereits Entwicklungsumgebungen erstellt haben, können Sie auch den Bereich auf der linken Seite des Bildschirms erweitern. Wählen Sie Your environments (Ihre Umebungen) und dann Create environment (Umgebung erstellen) aus.

In derWillkommen-Seite:

Oder in derIhre Umgebungen-Seite:

Geben Sie auf der Seite Create environment (Umgebung erstellen) einen Namen für Ihre Umgebung ein.

Geben Sie unter Description (Beschreibung) eine Beschreibung für Ihre Umgebung ein. Verwenden Sie für dieses Tutorial This environment is for the AWS Cloud9 tutorial.

Wählen Sie als Environment type (Umgebungstyp) Existing Compute (Bestehendes Computing) aus den folgenden Optionen aus:

Geben Sie im Bereich Existing Compute (Bestehendes Computing) für User (Benutzer) den Anmeldenamen ein, den Sie zuvor in diesem Verfahren für die Verbindung mit der Instance oder dem Server verwendet haben. Für eine AWS Cloud -Computing-Instance könnte dies z. B. ec2-user, ubuntu oder root sein.

Geben Sie in das Feld Host die öffentliche IP-Adresse (bevorzugt) oder den Hostnamen der Instance oder des Servers ein.

Geben Sie unter Port den Port ein, über den Sie versuchen AWS Cloud9 möchten, eine Verbindung mit der Instance oder dem Server herzustellen. Sie können auch den Standardport beibehalten.

Wählen Sie Zusätzliche Details — optional, um den Umgebungspfad, den Pfad zur Binärdatei node.js und die Informationen zum SSH Jump-Host anzuzeigen.

Geben Sie unter Umgebungspfad den Pfad zu dem Verzeichnis auf der Instance oder dem Server ein, von dem aus Sie beginnen AWS Cloud9 möchten. Sie haben dies bereits in den Voraussetzungen für dieses Verfahren identifiziert. Wenn Sie dieses Feld leer lassen, verwendet AWS Cloud9 das Verzeichnis, mit dem die Instance oder der Server normalerweise nach der Anmeldung startet. Dies ist normalerweise ein Stamm- oder Standardverzeichnis.

Geben Sie unter Path to Node.js binary path (Pfad zur Binäredatei Node.js) die Pfadinformationen ein, um den Pfad zur Binärdatei node.js auf der Instance oder dem Server anzugeben. Um den Pfad abzurufen, können Sie den Befehl which node (oder nvm which node , wenn Sie nvm verwenden) auf der Instance oder dem Server ausführen. Der Pfad kann beispielsweise /usr/bin/node sein. Wenn Sie dieses Feld leer lassen, versucht AWS Cloud9 zu erraten, wo sich die Node.js-Binärdatei befindet, wenn sie versucht, eine Verbindung herzustellen.

Geben Sie für SSHJump-Host Informationen über den Jump-Host ein, den die Instanz oder der Server verwendet. Verwenden Sie das Format USER_NAME@HOSTNAME:PORT_NUMBER (z. B. ec2-user@:ip-192-0-2-0:22).

Der Sprunghost muss die folgenden Anforderungen erfüllen:

Fügen Sie bis zu 50 Tags hinzu, indem Sie für jeden Tag einen Key (Schlüssel) und einen Value (Wert) angeben. Wählen Sie dazu Add new tag (Neues Tag hinzufügen) aus. Die Tags werden als Ressourcen-Tags an die AWS Cloud9 Umgebung angehängt und an die folgenden zugrunde liegenden Ressourcen weitergegeben: den AWS CloudFormation Stack, die EC2 Amazon-Instance und EC2 Amazon-Sicherheitsgruppen. Weitere Informationen zu Tags finden Sie unter Zugriffskontrolle mithilfe von AWS Ressourcen-Tags im IAMBenutzerhandbuch und unter den erweiterten Informationen zu Tags in diesem Handbuch.

Wählen Sie Create (Erstellen) aus, um Ihre Umgebung zu erstellen. Sie werden dann zur Startseite weitergeleitet. Wenn das Konto erfolgreich erstellt wurde, erscheint oben in der AWS Cloud9 Konsole eine grüne Flash-Leiste. Sie können die neue Umgebung auswählen und Open in Cloud9 wählen, um die IDE zu starten.

Wenn das Konto nicht erstellt werden konnte, erscheint oben in der AWS Cloud9 -Konsole eine rote Flashleiste. Ihr Konto kann möglicherweise aufgrund eines Problems mit Ihrem Webbrowser, Ihren AWS Zugriffsberechtigungen, der Instanz oder dem zugehörigen Netzwerk nicht erstellt werden. Informationen zu möglichen Lösungen für Probleme, die die Erstellung des Kontos verhindern könnten, finden Sie im Abschnitt AWS Cloud9 -Fehlerbehebung.

Starten Sie den Beispiel-Chat-Server mit dem für den laufenden Container AWS Cloud9 IDE angezeigten. Dazu klicken Sie im Fenster Environment (Umgebung) mit der rechten Maustaste auf die Beispieldatei workspace/server.js und wählen dann Run (Ausführen).

Zeigen Sie die Vorschau für die Beispielanwendung an. Dazu öffnen Sie im Fenster Environment (Umgebung) die Datei workspace/client/index.html. Wählen Sie dann auf der Menüleiste Tools, Preview, Preview Running Application (Extras, Vorschau, Vorschau auf die ausgeführte Anwendung).

Geben Sie auf der Registerkarte für die Anwendungsvorschau für Your Name (Ihr Name) Ihren Namen ein. Geben Sie die Nachricht unter Message (Meldung) ein. Wählen Sie Send (Senden). Der Chat-Server fügt Ihren Namen und Ihre Nachricht der Liste hinzu.

Entfernen des Docker-Containers von der Instance. Dazu führen Sie den Befehl docker auf der Instance mit den Stopp-Aktionen stop und rm und dem vom Menschen lesbaren Namen des Containers aus.

sudo docker stop cloud9
sudo docker rm cloud9

Entfernen Sie das Docker-Image von der Instance. Dazu führen Sie den Befehl docker auf der Instance mit der Aktion image rm und dem Tag des Image aus.

sudo docker image rm cloud9-image:latest

Entfernen Sie alle weiteren Docker-Supportdateien, die möglicherweise noch vorhanden sind. Dazu führen Sie den Befehl docker auf der Instance mit der Aktion system prune aus.

sudo docker system prune -a

Deinstallieren Sie Docker. Dazu führen Sie den Befehl yum auf der Instance mit der Aktion remove aus und geben das zu deinstallierende Paket docker an.

Für Amazon Linux:

sudo yum -y remove docker

Für Ubuntu Server:

sudo apt -y remove docker

Sie können auch die zuvor erstellten Dockerfile- und authorized_keys-Dateien entfernen. Führen Sie zum Beispiel den Befehl rm auf der Instance aus.

sudo rm /tmp/Dockerfile
sudo rm /tmp/authorized_keys