Docker/Image/Definition/03 Webserver: Unterschied zwischen den Versionen
Keine Bearbeitungszusammenfassung |
|||
| (5 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 6: | Zeile 6: | ||
---- | ---- | ||
--> | --> | ||
'''{{BASEPAGENAME}}''' | '''{{BASEPAGENAME}}''' - Webserver-Image erstellen | ||
</noinclude> | </noinclude> | ||
== | == Beschreibung == | ||
Hier soll ein Image für einen einfachen Webserver erstellt werden | |||
== Dockerfile == | |||
<syntaxhighlight lang="dockerfile"> | <syntaxhighlight lang="dockerfile" line> | ||
# Datei Dockerfile | # Datei Dockerfile | ||
FROM | FROM debian:latest | ||
LABEL maintainer="name@somehost.com" | LABEL maintainer="name@somehost.com" | ||
LABEL description=" | LABEL description="Test001: Debian-Webserver" | ||
# Umgebungsvariablen und Zeitzone einstellen | # Umgebungsvariablen und Zeitzone einstellen | ||
| Zeile 49: | Zeile 49: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Die obige Datei beschreibt ein Image, das auf | ; Beschreibung | ||
{| | |||
! Zeile || Beschreibung | |||
|- | |||
| 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 | ||
|- | |||
| 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 | ||
<code>docker build</code> erzeugt nun das Image | <code>docker build</code> erzeugt nun das Image | ||
* Mit der Option <code>-t</code> können Sie dem Image gleich den gewünschten Namen und eventuell auch ein Tag zuordnen | * Mit der Option <code>-t</code> können Sie dem Image gleich den gewünschten Namen und eventuell auch ein Tag zuordnen | ||
* Dabei müssen Sie natürlich <code>userinfo</code> durch den Namen Ihres Docker-Accounts ersetzen | * Dabei müssen Sie natürlich <code>userinfo</code> durch den Namen Ihres Docker-Accounts ersetzen | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
| Zeile 91: | Zeile 101: | ||
In einem Webbrowser auf dem Docker-Host können Sie nun <code>http://localhost:8080</code> besuchen und so die Test-Website ansehen. | In einem Webbrowser auf dem Docker-Host können Sie nun <code>http://localhost:8080</code> besuchen und so die Test-Website ansehen. | ||
* Die Adresse <code>https://localhost:8443</code> führt zur HTTPS-Variante der Website. | * Die Adresse <code>https://localhost:8443</code> führt zur HTTPS-Variante der Website. | ||
* Zur HTTPS-Verschlüsselung wird ein automatisch erzeugtes, | * Zur HTTPS-Verschlüsselung wird ein automatisch erzeugtes, selbstsigniertes Zertifikat verwendet. | ||
* Im Webbrowser wird deswegen eine entsprechende Warnung angezeigt. | * Im Webbrowser wird deswegen eine entsprechende Warnung angezeigt. | ||
Das bereits präsentierte Kommando <code>docker run</code> eignet sich für erste Tests, aber nicht für den dauerhaften Betrieb des Webservers | Gegebenenfalls müssen Sie ein richtiges Zertifikat einrichten (siehe [[Docker/Webserver/Zertifikate]]) | ||
* 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 | Das bereits präsentierte Kommando <code>docker run</code> 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. | 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. | ||
Aktuelle Version vom 19. November 2026, 20:53 Uhr
Docker/Image/Definition/03 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
-tkönnen Sie dem Image gleich den gewünschten Namen und eventuell auch ein Tag zuordnen - Dabei müssen Sie natürlich
userinfodurch 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
-dläuft der Container im Hintergrund, bis Sie den Prozess mitdocker stopbeenden. docker start namestartet den Container gegebenenfalls neu.docker runsetzt 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:8443fü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
-vals Volumes an den Container weitergegeben und ersetzen so dessen lokale Verzeichnisse/var/www/htmlund/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