Docker/Containerisieren

Docker/Workshop/Containerisieren - Beschreibung

Beschreibung

Containerisieren einer Anwendung

Im weiteren Verlauf dieser Anleitung werden Sie mit einem einfachen ToDo-Listen-Manager arbeiten, der auf Node.js läuft

• Wenn Sie mit Node.js nicht vertraut sind, machen Sie sich keine Sorgen
• Für diese Anleitung sind keine Vorkenntnisse in JavaScript erforderlich

Voraussetzungen

• Sie haben die neueste Version von Docker Desktop installiert
• Sie haben einen Git-Client installiert
• Sie verfügen über eine IDE oder einen Texteditor zum Bearbeiten von Dateien
• Docker empfiehlt die Verwendung von Visual Studio Code

Holen Sie sich die Anwendung

Bevor Sie die Anwendung ausführen können, müssen Sie den Quellcode der Anwendung auf Ihren Rechner holen

Klonen des getting-started-app-Repositorys

git clone https://github.com/docker/getting-started-app.git

Inhalt des geklonten Repositorys

├── getting-started-app/
├── .dockerignore
├── package.json
├── README.md
├── spec/
├── src/
└── yarn.lock

Image der Anwendung erstellen

Um das Image zu erstellen, müssen Sie ein Dockerfile verwenden

• Ein Dockerfile ist einfach eine textbasierte Datei, die ein Skript mit Anweisungen enthält
• Docker verwendet dieses Skript, um ein Container-Image zu erstellen

Erstellen Sie im Verzeichnis getting-started-app, demselben Ort wie die Datei package.json, eine Datei namens Dockerfile mit folgendem Inhalt

 # syntax=docker/dockerfile:1
 node:lts-alpine
 /app
 COPY . 
 RUN yarn install --production
 CMD ["node", "src/index.js"]
 EXPOSE 3000

1. https://docs.docker.com/reference/dockerfile/#from
2. https://docs.docker.com/reference/dockerfile/#workdir
3. https://docs.docker.com/reference/dockerfile/#copy
4. https://docs.docker.com/reference/dockerfile/#run
5. https://docs.docker.com/reference/dockerfile/#cmd
6. https://docs.docker.com/reference/dockerfile/#expose

Dieses Dockerfile beginnt mit einem node:lts-alpine-Basis-Image, einem leichtgewichtigen Linux-Image, auf dem Node.js und der Yarn-Paketmanager vorinstalliert sind

• Es kopiert den gesamten Quellcode in das Image, installiert die notwendigen Abhängigkeiten und startet die Anwendung

Erstellen Sie das Image mit den folgenden Befehlen

Vergewissern Sie sich im Terminal, dass Sie sich im getting-started-app-Verzeichnis befinden

• Ersetzen Sie /path/to/getting-started-app durch den Pfad zu Ihrem getting-started-app-Verzeichnis

cd /pfad/bis/getting-started-app

Erstellen Sie das Image

docker buildx build -t getting-started

Der Befehl docker buildx build verwendet das Dockerfile, um ein neues Image zu erstellen

• Sie haben vielleicht bemerkt, dass Docker eine Menge "Schichten" heruntergeladen hat
• Das liegt daran, dass Sie dem Builder mitgeteilt haben, dass Sie mit dem node:lts-alpine-Abbild beginnen wollen
• Da Sie dieses aber nicht auf Ihrem Rechner hatten, musste Docker das Abbild herunterladen

Nachdem Docker das Image heruntergeladen hatte, kopierten die Anweisungen aus der Dockerdatei Ihre Anwendung und installierten mit Hilfe von Garn die Abhängigkeiten Ihrer Anwendung

• Die CMD-Direktive gibt den Standardbefehl an, der beim Starten eines Containers aus diesem Image ausgeführt werden soll

Das Flag -t schließlich kennzeichnet Ihr Image

• Stellen Sie sich dies als einen für Menschen lesbaren Namen für das endgültige Image vor
• Da Sie dem Abbild den Namen getting-started gegeben haben, können Sie auf dieses Abbild verweisen, wenn Sie einen Container starten

Das . am Ende des Docker-Build-Befehls teilt Docker mit, dass es im aktuellen Verzeichnis nach dem Dockerfile suchen soll

Starten eines App-Containers

Jetzt, da Sie ein Image haben, können Sie die Anwendung mit dem Befehl docker run in einem Container ausführen

Starten Sie Ihren Container mit dem Befehl docker run und geben Sie den Namen des soeben erstellten Images an

docker run -d -p 127.0.0.1:3000:3000 getting-started

Mit dem Flag -d (kurz für --detach ) wird der Container im Hintergrund ausgeführt

• Das bedeutet, dass Docker Ihren Container startet und Sie zur Terminal-Eingabeaufforderung zurückkehren
• Außerdem werden keine Protokolle im Terminal angezeigt

Das Flag -p (kurz für --publish ) erstellt eine Port-Zuordnung zwischen dem Host und dem Container

• Das Flag -p nimmt einen String-Wert im Format HOST:CONTAINER an, wobei HOST die Adresse des Hosts und CONTAINER der Port des Containers ist
• Der Befehl veröffentlicht den Port 3000 des Containers auf 127.0.0.1:3000 (localhost:3000) auf dem Host
• Ohne die Portzuordnung wäre es nicht möglich, vom Host aus auf die Anwendung zuzugreifen.# Öffnen Sie nach ein paar Sekunden Ihren Webbrowser auf http://localhost:3000
• Sie sollten Ihre Anwendung sehen

Hinweis

Um diesen Port nach außen zu veröffentlichen, muss die Syntax <port:port> verwendet werden

docker run -d -p 3000:3000 getting-started

Fügen Sie ein oder zwei Elemente hinzu und prüfen Sie, ob sie wie erwartet funktioniert

• Sie können Elemente als vollständig markieren und entfernen
• Ihr Frontend speichert erfolgreich Elemente im Backend

Zu diesem Zeitpunkt haben Sie einen laufenden ToDo-Listen-Manager mit ein paar Einträgen

Wenn Sie einen kurzen Blick auf Ihre Container werfen, sollten Sie mindestens einen Container sehen, der das Getting-Started-Image verwendet und auf Port 3000 läuft

• Um Ihre Container zu sehen, können Sie die CLI oder die grafische Oberfläche von Docker Desktop verwenden

Führen Sie den Befehl docker ps in einem Terminal aus, um Ihre Container aufzulisten

docker ps

Es sollte eine ähnliche Ausgabe wie die folgende erscheinen

CONTAINER ID   IMAGE             COMMAND                  CREATED         STATUS        PORTS                      NAMES
df784548666d getting-started "docker-entrypoint.s..." vor 2 Minuten Up 2 Minuten 127.0.0.1:3000->3000/tcp priceless_mcclintock

Zusammenfassung

In diesem Abschnitt haben Sie die Grundlagen über die Erstellung eines Dockerfiles zur Erstellung eines Images gelernt

• Nachdem Sie ein Image erstellt haben, haben Sie einen Container gestartet und die laufende Anwendung gesehen

Konfiguration

Dateien

Datei	Beschreibung

Nächste Schritte

Als Nächstes werden Sie eine Änderung an Ihrer Anwendung vornehmen und lernen, wie Sie Ihre laufende Anwendung mit einem neuen Image aktualisieren können

• Nebenbei lernen Sie einige weitere nützliche Befehle kennen

Aktualisieren der Anwendung

Anhang

---

Dokumentation

Man-Page

1. prep(1)

Links

Weblinks

1. Dockerfile-Referenz
2. Docker-CLI-Referenz