Docker-Anleitung: Dockerisierung einer Nodejs Express-Anwendung auf Ubuntu 18.04

Docker ist ein Open-Source-Projekt, das eine offene Plattform für Entwickler und Systemadministratoren bietet, um Anwendungen überall als leichtgewichtigen Container zu erstellen, zu verpacken und auszuführen. Docker automatisiert die Bereitstellung von Anwendungen innerhalb von Softwarecontainern.

Nodejs ist eine Open-Source-JavaScript-Laufzeitumgebung. Es ist eine plattformübergreifende Laufzeit, die auf Linux, Windows, MacOS, FreeBSD usw. installiert werden kann. Nodejs ist sehr nützlich für den Aufbau von Server- und Desktop-Anwendungen.

In diesem Tutorial zeige ich Ihnen, wie Sie ein Docker-Image für ein bestehendes Nodejs Express-Anwendungsprojekt in Ubuntu 18.04 erstellen. Wir werden lernen, wie man eine Nodejs-Anwendung dockerisiert und dann die Anwendung als Container in der Docker-Umgebung mit einem Docker-Compose-Skript bereitstellt.

Voraussetzungen

• Ubuntu 18.04
• Root-Rechte

Was wir tun werden

1. Docker CE installieren
2. Docker-Compose installieren
3. Nodejs Express-Projekt einrichten
4. Das Projekt erstellen
5. Testen

Schritt 1 - Docker CE installieren

In diesem Tutorial werden wir die Docker-CE-Community-Edition aus dem Docker-Repository installieren. Wir werden die Docker-CE-Community-Edition und Docker-Compose installieren, die die Compose-Dateiversion 3 unterstützt.

Bevor Sie Docker-CE installieren, installieren Sie die benötigten Docker-Abhängigkeiten mit dem apt-Befehl.

sudo apt install -y \  
    apt-transport-https \  
    ca-certificates \  
    curl \  
    software-properties-common

Fügen Sie jetzt den Docker-Schlüssel und das Repository hinzu, indem Sie die folgenden Befehle ausführen.

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -  
sudo add-apt-repository \  
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \  
   $(lsb_release -cs) \  
   stable"

Installieren Sie das Docker-CE-Paket.

sudo apt install docker-ce

Nachdem die Installation abgeschlossen ist, starten Sie den Docker-Dienst und aktivieren Sie ihn, damit er bei jedem Systemstart gestartet wird.

systemctl start docker  
systemctl enable docker

Als Nächstes geben wir dem normalen Benutzer die Berechtigung, Docker-Container auszuführen und zu verwalten.

Fügen Sie einen neuen Benutzer namens ‘mohammad’ hinzu und fügen Sie ihn zur Docker-Gruppe hinzu.

useradd -m -s /bin/bash mohammad  
usermod -a -G docker mohammad

Melden Sie sich jetzt als Benutzer ‘mohammad’ an und führen Sie den Docker-Container hello-world aus.

su - mohammad  
docker run hello-world

Und Sie erhalten das Ergebnis wie unten gezeigt.

Schritt 2 - Docker-Compose installieren

In diesem Schritt werden wir Docker-Compose manuell aus der Binärdatei installieren, die von GitHub heruntergeladen werden kann. Wir werden die neueste Docker-Compose-Version installieren, die die Compose v3 unterstützt.

Laden Sie die neueste Version 1.22.0 von Docker-Compose mit dem Curl-Befehl in das Verzeichnis ‘/usr/local/bin’ herunter und machen Sie sie dann mit chmod ausführbar.

Führen Sie die folgenden Befehle aus.

sudo curl -L https://github.com/docker/compose/releases/download/1.22.0/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose  
sudo chmod +x /usr/local/bin/docker-compose

Und die neueste Docker-Compose-Version wurde installiert, überprüfen Sie dies, indem Sie den Docker-Compose-Befehl unten ausführen.

docker-compose version

Das folgende ist das Ergebnis.

Schritt 3 - Nodejs Express-Projekt einrichten

In diesem Abschnitt werden wir die Nodejs-Anwendungsumgebung konfigurieren. Wir werden eine einfache Nodejs-Anwendung verwenden, die mit dem ‘express-generator’ generiert werden kann.

Melden Sie sich beim Benutzer ‘mohammad’ an.

su - mohammad

Erstellen Sie ein neues Verzeichnis mit dem Namen ‘project’ und wechseln Sie zu diesem.

mkdir -p project  
cd project

Generieren Sie jetzt eine einfache Hello-World-Nodejs-Anwendung mit dem folgenden ‘express’-Befehl.

express hakase-app

Hinweis:

Stellen Sie sicher, dass Nodejs, npm und die Pakete ‘express-generator’ auf dem System installiert sind.

Und Sie erhalten die einfache Nodejs Express-App im Verzeichnis ‘hakase-app’.

Als Nächstes werden wir unser benutzerdefiniertes Docker-Image für die Nodejs-Anwendung ‘hakase-app’ erstellen.

Erstellen Sie im Verzeichnis ‘project’ eine neue ‘Dockerfile’ mit vim.

vim Dockerfile

Fügen Sie die folgende Docker-Image-Konfiguration dort ein.

FROM node:8.11.4-alpine

RUN mkdir -p /src
RUN npm install express-generator -g

WORKDIR /src
ADD hakase-app/package.json /src/package.json
RUN npm install

EXPOSE 3000
CMD node hakase-app/bin/www

Speichern und beenden.

Wir erstellen ein neues benutzerdefiniertes Docker-Image für unsere Nodejs-Anwendung mit den folgenden Spezifikationen.

• Das benutzerdefinierte Image basiert auf dem offiziellen Nodejs-Image 8.11.4 Alpine-Version.
• Wir erstellen ein neues Verzeichnis für unser Projekt ‘/src’.
• Installieren Sie den ‘express-generator’ im benutzerdefinierten Image.
• Fügen Sie die ‘package.json’-Datei hinzu, die das Anwendungsprofil und die benötigten Pakete im Verzeichnis ‘/src’ enthält.
• Installieren Sie alle benötigten Nodejs-Pakete für das Projekt, basierend auf der ‘package.json’-Datei.
• Exportieren Sie den Port 3000 mit dem Standardausführungsbefehl ‘node hakase-app/bin/www’.

Als Nächstes werden wir das benutzerdefinierte Image basierend auf dem Docker-Compose-Skript erstellen.

Erstellen Sie eine neue yml-Datei ‘docker-compose.yml’ mit vim.

vim docker-compose.yml

Fügen Sie die folgende Konfiguration dort ein.

version: '3'

services:

  hakase-app:
    build: .
    volumes:
      - ./hakase-app:/src/hakase-app
    ports:
      - "3000:3000"
    restart: always

Speichern und beenden.

Wir erstellen einen neuen Docker-Dienst namens ‘hakase-app’, und gleichzeitig bauen wir das benutzerdefinierte Docker-Image basierend auf der ‘Dockerfile’ im Projektverzeichnis und montieren automatisch die Anwendungsdateien von hakase-app.

Die Nodejs Express-Einrichtung wurde abgeschlossen.

Schritt 4 - Projekt erstellen und ausführen

Melden Sie sich als Benutzer ‘mohammad’ an und wechseln Sie in das Verzeichnis ‘project’

su - mohammad  
cd project/

Bauen Sie das Image und erstellen Sie den Docker-Dienst hakase-app mit dem folgenden Docker-Compose-Befehl.

docker-compose build

Jetzt erhalten Sie das Ergebnis wie unten gezeigt.

Und wenn es abgeschlossen ist, führen Sie den Docker-Dienst ‘hakase-app’ aus.

docker-compose up -d

Das folgende ist das Ergebnis.

Das benutzerdefinierte Docker-Image für unsere Nodejs-Anwendung wurde erstellt, und der Docker-Dienst hakase-app läuft.

Schritt 5 - Testen

Zeigen Sie das verfügbare Docker-Image auf dem Server an.

docker-compose images  
docker images

Ein neues benutzerdefiniertes Docker-Image für unsere Nodejs-Anwendung wurde erstellt.

Zeigen Sie den laufenden Docker-Dienst an.

docker-compose ps  
docker ps

Die Nodejs-App läuft auf dem Host-Port 3000.

Öffnen Sie den Webbrowser und geben Sie die IP-Adresse des Servers mit dem Port ein.

http://10.0.15.2:3000/

Und Sie erhalten die einfache Express-Seite.

Die Dockerisierung der Nodejs Express-Anwendung auf Ubuntu 18.04 wurde erfolgreich abgeschlossen.

Referenz

• https://nodejs.org/en/docs/guides/nodejs-docker-webapp/
• https://expressjs.com/en/starter/hello-world.html