Docker/Image/Webserver: Unterschied zwischen den Versionen

Aus Foxwiki
Wechseln zu:Navigation, Suche
Zeile 1: Zeile 1:
== Eigenes Webserver-Image ==
== Eigenes Webserver-Image ==
Das Ziel dieses Beispiels ist es, ein Image für einen simplen Webserver zu erstellen
Das Ziel dieses Beispiels ist es, ein Image für einen simplen Webserver zu erstellen.


; Dockerfile
; Dockerfile
# Datei Dockerfi l e
<syntaxhighlight lang="dockerfile">
FROM ubuntu:22.04
# Datei Dockerfile
FROM ubuntu:22.04


LABEL maintaine r" name@some h o s t
LABEL maintainer="name@somehost.com"
* com"
LABEL description="Test"
LABEL descripti o n"Test"


# Umgebung s v a ri a b l en und Zeitzone einstell en
# Umgebungsvariablen und Zeitzone einstellen
# ( erspart interakti v e R ückfragen )
# (erspart interaktive Rückfragen)
ENV TZ =" Europe/Berlin" \
ENV TZ="Europe/Berlin" \
  APACHE_R U N_ U S E R = www - data \
    APACHE_RUN_USER=www-data \
  APACHE_R U N_ G R O UP = www -data \
    APACHE_RUN_GROUP=www-data \
  APACHE_L O G_ D I R =/var/log/apache2
    APACHE_LOG_DIR=/var/log/apache2


# Zeitzone einstellen, Apache installieren, unn ö tige Dateien
# Zeitzone einstellen, Apache installieren, unnötige Dateien
# aus dem Paket - Cache gleich wieder entfernen, HTTPS aktiviere n
# aus dem Paket-Cache gleich wieder entfernen, HTTPS aktivieren
RUN ln -snf/usr/share/zoneinfo/$TZ/etc/localtime && \
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && \
echo $TZ >/etc/timezone && \
    echo $TZ > /etc/timezone && \
apt -get update && \
    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


  apt -get install -y apache2 && \
# Ports 80 und 443 freigeben
  apt -get -y clean && \
EXPOSE 80 443
  rm -r/var/cache/apt/var/lib/apt/lists/* && \
  a2ensite default - ssl && \
  a2enmod ssl


# Ports 80 und 443 freigebe n
# gesamten Inhalt des Projektverzeichnisses
EXPOSE 80 443
# samplesite nach /var/www/html kopieren
COPY samplesite/ /var/www/html


# gesamten Inhalt des Projektv er z e i c hn i s s e s
# Startkommando
# samplesi t e nach/var/www/html kopieren
CMD ["/usr/sbin/apache2ctl", "-D", "FOREGROUND"]
COPY samplesi te//var/www/html
</syntaxhighlight>


# Startkom m a n do
Die obige Datei beschreibt ein Image, das auf Ubuntu 22.04 basiert.
CMD ["/usr/sbin/apache2c tl", " -D", " FOREGROUN D"]
* 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.
* 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>.


Die obige Datei beschreibt ein Image, das auf Ubuntu 22.04 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>.
* Darin wird zusätzlich 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.
* Er wird mit a2ensite und a2enmod auch für den HTTPS-Betrieb konfiguriert
* 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
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
/var/www/html 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, selbst signiertes 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 Kapitel 9, ''Webserver und Co.'')
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
Das bereits präsentierte Kommando <code>docker run</code> eignet sich für erste Tests, aber nicht für den dauerhaften Betrieb des Webservers.
docker run -d -p 80:80 -p 443:443 \
* Für diesen ist es nämlich zweckmäßig, den Container von den veränderlichen Daten zu trennen.
-v/home/user/webdir :/var/www/html \
* Das betrifft einerseits die Website an sich und andererseits die Logging-Dateien des Webservers.
-v/home/user/logdir :/var/log/apache2 \
-h webtest --name webtest userin fo/testwebs e rv e r


Unter Fedora und RHEL müssen Sie die beiden Volume-Optionen um :z ergänzen,
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.
damit SELinux die Volumes außerhalb von/var/lib/docker akzeptiert
* 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>.
Der entscheidende Vorteil dieser Container-Konfiguration besteht darin, dass es nun jederzeit möglich ist, einen neuen Container auf Basis eines aktualisierten Images einzurichten
 
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 <code>:z</code> ergänzen, damit SELinux die Volumes außerhalb von <code>/var/lib/docker</code> 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!
* 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!

Version vom 19. November 2026, 07:35 Uhr

Eigenes Webserver-Image

Das Ziel dieses Beispiels ist es, ein Image für einen simplen Webserver zu erstellen.

Dockerfile
# Datei Dockerfile
FROM ubuntu:22.04

LABEL maintainer="name@somehost.com"
LABEL description="Test"

# 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"]

Die obige Datei beschreibt ein Image, das auf Ubuntu 22.04 basiert.

  • Darin wird zusätzlich der Webserver Apache installiert.
  • Er wird mit a2ensite und a2enmod auch für den HTTPS-Betrieb konfiguriert.
  • 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.

Das lokale Verzeichnis samplesite, das sich im gleichen Verzeichnis wie das Dockerfile 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 /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, selbst signiertes Zertifikat verwendet.
  • Im Webbrowser wird deswegen eine entsprechende Warnung angezeigt.
  • Gegebenenfalls müssen Sie ein richtiges Zertifikat einrichten (siehe Kapitel 9, Webserver und Co.).

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!