Docker/Image/Webserver: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
 
(12 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
== Eigenes Webserver-Image ==
<noinclude>
Das Ziel dieses Beispiels ist es, ein Image für einen simplen Webserver zu erstellen
<!--
Die folgenden Zeilen zeigen das Dockerfile :
----
{{Navigation|<zurück>|<nachste>}}
{{Navigation|BSI/200-3|BSI/200-3/Einleitung/Beispiele}}
----
-->
'''{{BASEPAGENAME}}''' - Einfaches Webserver-Image erstellen
</noinclude>


# Datei Dockerfi l e
== Beschreibung ==
FROM ubuntu:22.04
Docker-Image für einen einfachen Webserver erstellen


LABEL maintaine r" name@some h o s t
== Dockerfile ==
* com"
<syntaxhighlight lang="dockerfile" line>
LABEL descripti o n"Test"
# Datei Dockerfile
FROM debian:latest


# Umgebung s v a ri a b l en und Zeitzone einstell en
LABEL maintainer="name@somehost.com"
# ( erspart interakti v e R ückfragen )
LABEL description="Test001: Debian-Webserver"
ENV TZ =" Europe/Berlin" \
  APACHE_R U N_ U S E R = www - data \
  APACHE_R U N_ G R O UP = www -data \
  APACHE_L O G_ D I R =/var/log/apache2


# Zeitzone einstellen, Apache installieren, unn ö tige Dateien
# Umgebungsvariablen und Zeitzone einstellen
# aus dem Paket - Cache gleich wieder entfernen, HTTPS aktiviere n
# (erspart interaktive Rückfragen)
RUN ln -snf/usr/share/zoneinfo/$TZ/etc/localtime && \
ENV TZ="Europe/Berlin" \
echo $TZ >/etc/timezone && \
    APACHE_RUN_USER=www-data \
apt -get update && \
    APACHE_RUN_GROUP=www-data \
    APACHE_LOG_DIR=/var/log/apache2


  apt -get install -y apache2 && \
# Zeitzone einstellen, Apache installieren, unnötige Dateien
  apt -get -y clean && \
# aus dem Paket-Cache gleich wieder entfernen, HTTPS aktivieren
  rm -r/var/cache/apt/var/lib/apt/lists/* && \
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && \
  a2ensite default - ssl && \
    echo $TZ > /etc/timezone && \
  a2enmod ssl
    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 freigebe n
# Ports 80 und 443 freigeben
EXPOSE 80 443
EXPOSE 80 443


# gesamten Inhalt des Projektv er z e i c hn i s s e s
# gesamten Inhalt des Projektverzeichnisses
# samplesi t e nach/var/www/html kopieren
# samplesite nach /var/www/html kopieren
COPY samplesi te//var/www/html
COPY samplesite/ /var/www/html


# Startkom m a n do
# Startkommando
CMD ["/usr/sbin/apache2c tl", " -D", " FOREGROUN D"]
CMD ["/usr/sbin/apache2ctl", "-D", "FOREGROUND"]
</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 a2ensite und a2enmod 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 docker build
| 01 || Die obige Datei beschreibt ein Image, das auf der aktuellen Debian stable basiert
Das lokale Verzeichnis samplesite, das sich im gleichen Verzeichnis wie das Docker - file befindet, enthält die Dateien index.html und style.css
|-
* Der gesamte Inhalt dieses Verzeichnisses wird durch die COPY-Anweisung im Dockerfile in das Verzeichnis
| 01 || Darin wird der Webserver Apache installiert
/var/www/html 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 docker build erzeugt nun das Image
; Image erzeugen und testen
* Mit der Option -t können Sie dem Image gleich den gewünschten Namen und eventuell auch ein Tag zuordnen
<code>docker build</code> erzeugt nun das Image
* Dabei müssen Sie natürlich userinfo durch den Namen Ihres Docker-Accounts ersetzen
* 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


cd projektv e r ze i c h ni s
<syntaxhighlight lang="bash">
docker build -t userin fo/testwebs e rv e r
cd projektverzeichnis
Step 1/8 : FROM ubuntu :22.04 ..
docker build -t userinfo/testwebserver .
Step 2/8 : LABEL maintain e r"name@som e h o st
Step 1/8 : FROM ubuntu:22.04 ..
* com" ..
Step 2/8 : LABEL maintainer="name@somehost.com" ..
Step 3/8 : LABEL descript i o n" Test" ..
Step 3/8 : LABEL description="Test" ..
..
..
Successf u l l y built 37 e3a605b0e b
Successfully built 37e3a605b0eb
Successf u l l y tagged userin fo/testwebs e rv e r : latest
Successfully tagged userinfo/testwebserver:latest
</syntaxhighlight>


Mit docker run erzeugen Sie vom lokalen Image einen Container und führen darin den Webserver aus
Mit <code>docker run</code> 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
* Wegen der Option <code>-d</code> läuft der Container im Hintergrund, bis Sie den Prozess mit <code>docker stop</code> beenden.
* docker start name startet den Container gegebenenfalls neu
* <code>docker start name</code> startet den Container gegebenenfalls neu.
* docker run setzt voraus, dass die Ports 8080 und 8443 auf dem lokalen Rechner frei sind
* <code>docker run</code> setzt voraus, dass die Ports 8080 und 8443 auf dem lokalen Rechner frei sind.


docker run -d -p 8080:80 -p 8443:443 \
<syntaxhighlight lang="bash">
--name testwebs e rv e r userinf o/testwebs er v e r
docker run -d -p 8080:80 -p 8443:443 \
  --name testwebserver userinfo/testwebserver


..
..
docker stop testwebse r v er                ( Containe r stoppen )
docker stop testwebserver  # (Container stoppen)
docker start testwebse r v er              ( wieder starten )
docker start testwebserver  # (wieder starten)
docker rm   testwebse r v er              ( oder l ö schen )
docker rm testwebserver    # (oder löschen)
</syntaxhighlight>


In einem Webbrowser auf dem Docker-Host können Sie nun http://localhost:8080
In einem Webbrowser auf dem Docker-Host können Sie nun <code>http://localhost:8080</code> besuchen und so die Test-Website ansehen.
besuchen und so die Test-Website ansehen
* Die Adresse <code>https://localhost:8443</code> führt zur HTTPS-Variante der Website.
* Die Adresse https://localhost:8443 führt zur HTTPS-Variante der Website
* Zur HTTPS-Verschlüsselung wird ein automatisch erzeugtes, selbstsigniertes Zertifikat verwendet.
* Zur HTTPS-Verschlüsselung wird ein automatisch erzeugtes, selbst signiertes Zertifikat verwendet
* Im Webbrowser wird deswegen eine entsprechende Warnung angezeigt.
* Im Webbrowser wird deswegen eine entsprechende Warnung angezeigt
 
* Gegebenenfalls müssen Sie ein richtiges Zertifikat einrichten (siehe Kapitel 9, ''Webserver und Co.'')
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,
Das bereits präsentierte Kommando <code>docker run</code> eignet sich für erste Tests, aber nicht für den dauerhaften Betrieb des Webservers
den Container von den veränderlichen Daten zu trennen
* 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 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 \
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.
-v/home/user/webdir :/var/www/html \
* Diese Verzeichnisse werden nun über die Option <code>-v</code> als Volumes an den Container weitergegeben und ersetzen so dessen lokale Verzeichnisse <code>/var/www/html</code> und <code>/var/log/apache2</code>.
-v/home/user/logdir :/var/log/apache2 \
 
-h webtest --name webtest userin fo/testwebs e rv e r
Im folgenden Beispiel gehen wir davon aus, dass sich die lokalen Verzeichnisse im Home-Verzeichnis befinden – aber jeder andere Ort ist ebenfalls denkbar:
 
<syntaxhighlight lang="bash">
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
</syntaxhighlight>


Unter Fedora und RHEL müssen Sie die beiden Volume-Optionen um :z ergänzen,
Unter Fedora und RHEL müssen Sie die beiden Volume-Optionen um <code>:z</code> ergänzen, damit SELinux die Volumes außerhalb von <code>/var/lib/docker</code> akzeptiert.
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
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!
* 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!
<noinclude>
<!--
----
{{Navigation|<zurück>|<nachste>}}
----
-->
== Anhang ==
=== Siehe auch ===
<div style="column-count:2">
<categorytree hideroot=on mode="pages">Docker/Image</categorytree>
</div>
----
{{Special:PrefixIndex/{{BASEPAGENAME}}/}}
=== Dokumentation ===
<!--
; Man-Page
# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]
; Info-Pages
; Hinweise
<div class="card h-100 bg-warning">
<div class="card-header">'''<big>Header</big>'''</div>
<div class="card-body bg-white">
Hier steht der Kartentext
</div>
</div>
-->
=== Links ===
==== Projekt ====
==== Weblinks ====
<!--
{{DEFAULTSORT:new}}
{{DISPLAYTITLE:new}}
-->
[[Kategorie:Docker/Image]]
</noinclude>

Aktuelle Version vom 21. November 2026, 12:46 Uhr

Docker/Image/Webserver - Einfaches Webserver-Image erstellen


Beschreibung

Docker-Image für einen einfachen Webserver erstellen

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