Docker-py: Docker-Container mit Python verwalten

Einführung in das Docker SDK for Python

Containerisierung ist ein Grundpfeiler moderner DevOps-Infrastrukturen. Docker hat sich als De-facto-Standard für die Isolierung von Anwendungen und das Management von Umgebungen etabliert. Wenn jedoch eine flexiblere und programmierbare Steuerung von Containern erforderlich ist, kommt das Docker SDK for Python ins Spiel, besser bekannt als docker-py.

Diese Bibliothek ermöglicht die direkte Interaktion mit dem Docker-Daemon über Python-Code. Sie steuert Container, Images, Netzwerke, Volumes und alles, was normalerweise über die CLI erledigt wird. Dadurch wird docker-py häufig in CI/CD-Pipelines, Automatisierung, Tests und dynamischer Orchestrierung eingesetzt.

Was ist das Docker SDK for Python?

Das Docker SDK for Python ist die offizielle Python-Bibliothek, die eine High-Level-Schnittstelle zur Interaktion mit der Docker Engine API bereitstellt. Die Bibliothek ermöglicht es Entwicklern, Docker-Funktionalität direkt in Python-Anwendungen zu integrieren und Prozesse zur Bereitstellung und Verwaltung von Containern zu automatisieren.

Hauptfunktionen der Bibliothek

Das Docker SDK bietet einen vollständigen Werkzeugsatz für die Arbeit mit Docker:

• Programmgesteuerte Verwaltung des Container-Lebenszyklus
• Automatisierung des Build- und Deployment-Prozesses von Images
• Konfiguration von Netzwerken und Datenspeichern
• Integration mit Monitoring- und Logging-Systemen
• Unterstützung von Docker Swarm für die Orchestrierung
• Echtzeit-Verarbeitung von Docker-Ereignissen

Installation und erste Einrichtung

Installation der Bibliothek

Zur Installation des Docker SDKs wird der Standard-Paketmanager pip verwendet:

pip install docker

Für die Installation mit zusätzlichen Abhängigkeiten zur Unterstützung von SSH und TLS:

pip install docker[ssh,tls]

Verbindung zur Docker Engine herstellen

Grundlegende Verbindung zum lokalen Docker-Daemon:

import docker

# Automatische Verbindung über Umgebungsvariablen
client = docker.from_env()

# Explizite Angabe der Verbindungsparameter
client = docker.DockerClient(base_url='unix://var/run/docker.sock')

# Verbindung zu einer entfernten Docker Engine
client = docker.DockerClient(base_url='tcp://192.168.1.100:2376')

Verbindung prüfen

try:
    # Prüfung der Verfügbarkeit der Docker Engine
    print("Docker Engine verfügbar:", client.ping())
    
    # Systeminformationen abrufen
    info = client.info()
    print(f"Docker-Version: {info['ServerVersion']}")
    print(f"Architektur: {info['Architecture']}")
    
except docker.errors.DockerException as e:
    print(f"Fehler bei der Verbindung zu Docker: {e}")

Architektur und Struktur der Bibliothek

Das Docker SDK for Python ist als Wrapper um die REST-API der Docker Engine aufgebaut und bietet sowohl High-Level- als auch Low-Level-Schnittstellen für die Interaktion mit Docker.

Modulstruktur

Die Bibliothek ist in mehrere Hauptmodule unterteilt:

• docker.DockerClient — Hauptclient für die High-Level-Interaktion
• docker.APIClient — Low-Level-API-Client
• docker.models — objektorientierte Modelle für die Arbeit mit Ressourcen
• docker.types — Hilfsdatentypen
• docker.errors — Ausnahmen und Fehlerbehandlung

Architekturprinzipien

Die Bibliothek folgt den Prinzipien der REST-API der Docker Engine:

• Jede Ressource (Container, Image, Netzwerk) wird durch ein separates Objekt repräsentiert
• Operationen werden über Methoden der Objekte ausgeführt
• Asynchrone Ausführung von Operationen wird unterstützt
• Automatische Behandlung von Verbindungen und Wiederverbindungen

Container verwalten

Erstellen