Docker/Image/Webserver: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
Zeile 49: Zeile 49:
</syntaxhighlight>
</syntaxhighlight>


Die obige Datei beschreibt ein Image, das auf Ubuntu 22.04 basiert
; Beschreibung
* Darin wird zusätzlich der Webserver Apache installiert.
{|
* Er wird mit <code>a2ensite</code> und <code>a2enmod</code> auch für den HTTPS-Betrieb konfiguriert.
! Zeile || Beschreibung
* Dementsprechend sollen die Ports 80 und 443 des Containers nach außen hin zugänglich sein.
|-
* Die Einstellung der Zeitzone verhindert eine lästige interaktive Rückfrage während der Ausführung von <code>docker build</code>.
| 01 || Die obige Datei beschreibt ein Image, das auf der aktuellen Debian stable basiert
 
|-
Das lokale Verzeichnis <code>samplesite</code>, das sich im gleichen Verzeichnis wie das Dockerfile befindet, enthält die Dateien <code>index.html</code> und <code>style.css</code>.
| 01 || Darin wird der Webserver Apache installiert
* Der gesamte Inhalt dieses Verzeichnisses wird durch die <code>COPY</code>-Anweisung im Dockerfile in das Verzeichnis <code>/var/www/html</code> des Containers kopiert.
|-
| 01 || Er wird mit <code>a2ensite</code> und <code>a2enmod</code> auch für den HTTPS-Betrieb konfiguriert
|-
| 01 || Dementsprechend sollen die Ports 80 und 443 des Containers nach außen hin zugänglich sein
|-
| 01 || Die Einstellung der Zeitzone verhindert eine lästige interaktive Rückfrage während der Ausführung von <code>docker build</code>.
|-
| 01 || Das lokale Verzeichnis <code>samplesite</code>, das sich im gleichen Verzeichnis wie das Dockerfile befindet, enthält die Dateien <code>index.html</code> und <code>style.css</code>
|-
| 01 || Der Inhalt dieses Verzeichnisses wird durch die <code>COPY</code>-Anweisung im Dockerfile in das Verzeichnis <code>/var/www/html</code> des Containers kopiert
|}


; Image erzeugen und testen
; Image erzeugen und testen

Version vom 19. November 2026, 20:52 Uhr

Docker/Image/Webserver - Webserver-Image erstellen


Beschreibung

Hier soll ein Image für einen einfachen Webserver erstellt werden

Dockerfile
# Datei Dockerfile
FROM debian:latest

LABEL maintainer="name@somehost.com"
LABEL description="Test001: Debian-Webserver"

# Umgebungsvariablen und Zeitzone einstellen
# (erspart interaktive Rückfragen)
ENV TZ="Europe/Berlin" \
    APACHE_RUN_USER=www-data \
    APACHE_RUN_GROUP=www-data \
    APACHE_LOG_DIR=/var/log/apache2

# Zeitzone einstellen, Apache installieren, unnötige Dateien
# aus dem Paket-Cache gleich wieder entfernen, HTTPS aktivieren
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && \
    echo $TZ > /etc/timezone && \
    apt-get update && \
    apt-get install -y apache2 && \
    apt-get -y clean && \
    rm -r /var/cache/apt /var/lib/apt/lists/* && \
    a2ensite default-ssl && \
    a2enmod ssl

# Ports 80 und 443 freigeben
EXPOSE 80 443

# gesamten Inhalt des Projektverzeichnisses
# samplesite nach /var/www/html kopieren
COPY samplesite/ /var/www/html

# Startkommando
CMD ["/usr/sbin/apache2ctl", "-D", "FOREGROUND"]
Beschreibung
Zeile Beschreibung
01 Die obige Datei beschreibt ein Image, das auf der aktuellen Debian stable basiert
01 Darin wird der Webserver Apache installiert
01 Er wird mit a2ensite und a2enmod auch für den HTTPS-Betrieb konfiguriert
01 Dementsprechend sollen die Ports 80 und 443 des Containers nach außen hin zugänglich sein
01 Die Einstellung der Zeitzone verhindert eine lästige interaktive Rückfrage während der Ausführung von docker build.
01 Das lokale Verzeichnis samplesite, das sich im gleichen Verzeichnis wie das Dockerfile befindet, enthält die Dateien index.html und style.css
01 Der Inhalt dieses Verzeichnisses wird durch die COPY-Anweisung im Dockerfile in das Verzeichnis /var/www/html des Containers kopiert
Image erzeugen und testen

docker build erzeugt nun das Image

  • Mit der Option -t können Sie dem Image gleich den gewünschten Namen und eventuell auch ein Tag zuordnen
  • Dabei müssen Sie natürlich userinfo durch den Namen Ihres Docker-Accounts ersetzen
cd projektverzeichnis
docker build -t userinfo/testwebserver .
Step 1/8 : FROM ubuntu:22.04 ..
Step 2/8 : LABEL maintainer="name@somehost.com" ..
Step 3/8 : LABEL description="Test" ..
..
Successfully built 37e3a605b0eb
Successfully tagged userinfo/testwebserver:latest

Mit docker run erzeugen Sie vom lokalen Image einen Container und führen darin den Webserver aus.

  • Wegen der Option -d läuft der Container im Hintergrund, bis Sie den Prozess mit docker stop beenden.
  • docker start name startet den Container gegebenenfalls neu.
  • docker run setzt voraus, dass die Ports 8080 und 8443 auf dem lokalen Rechner frei sind.
docker run -d -p 8080:80 -p 8443:443 \
  --name testwebserver userinfo/testwebserver

..
docker stop testwebserver   # (Container stoppen)
docker start testwebserver  # (wieder starten)
docker rm testwebserver     # (oder löschen)

In einem Webbrowser auf dem Docker-Host können Sie nun http://localhost:8080 besuchen und so die Test-Website ansehen.

  • Die Adresse https://localhost:8443 führt zur HTTPS-Variante der Website.
  • Zur HTTPS-Verschlüsselung wird ein automatisch erzeugtes, selbstsigniertes Zertifikat verwendet.
  • Im Webbrowser wird deswegen eine entsprechende Warnung angezeigt.

Gegebenenfalls müssen Sie ein richtiges Zertifikat einrichten (siehe Docker/Webserver/Zertifikate)

Das bereits präsentierte Kommando docker run eignet sich für erste Tests, aber nicht für den dauerhaften Betrieb des Webservers

  • Für diesen ist es nämlich zweckmäßig, den Container von den veränderlichen Daten zu trennen
  • Das betrifft einerseits die Website an sich und andererseits die Logging-Dateien des Webservers

Abhilfe schaffen zwei lokale Verzeichnisse, von denen eines die HTML- und CSS-Seiten für die lokale Website aufnimmt und das andere die Logging-Dateien.

  • Diese Verzeichnisse werden nun über die Option -v als Volumes an den Container weitergegeben und ersetzen so dessen lokale Verzeichnisse /var/www/html und /var/log/apache2.

Im folgenden Beispiel gehen wir davon aus, dass sich die lokalen Verzeichnisse im Home-Verzeichnis befinden – aber jeder andere Ort ist ebenfalls denkbar:

docker run -d -p 80:80 -p 443:443 \
  -v /home/user/webdir:/var/www/html \
  -v /home/user/logdir:/var/log/apache2 \
  -h webtest --name webtest userinfo/testwebserver

Unter Fedora und RHEL müssen Sie die beiden Volume-Optionen um :z ergänzen, damit SELinux die Volumes außerhalb von /var/lib/docker akzeptiert.

Der entscheidende Vorteil dieser Container-Konfiguration besteht darin, dass es nun jederzeit möglich ist, einen neuen Container auf Basis eines aktualisierten Images einzurichten.

  • Wenn es also eine neue Apache-Version gibt, erzeugen Sie ein neues Image, stoppen den laufenden Container, richten einen neuen ein und starten ihn wie oben beschrieben – fertig ist das Server-Update!


Anhang

Siehe auch



Dokumentation

Projekt