ory/dockertest
4,521 Stars·268 Forks·Go·Apache-2.0·2 Aufrufewww.ory.com/?utm_source=github&utm_medium=banner&utm_campaign=dockertest↗
Dockertest
dockertest ist eine Docker-Integrations-Testbibliothek und ein programmatischer Go-Client zum Booten und Verwalten ephemerer Container. Er fungiert als containerisierter Test-Orchestrator, der isolierte Umgebungen für Integrationstests bereitstellt, indem er den Lifecycle abhängiger Dienste verwaltet.
Die Bibliothek handhabt die Orchestrierung ephemerer Umgebungen durch die Bereitstellung temporärer Container und Netzwerke. Sie stellt die Umgebungskonsistenz durch Service-Readiness-Checks und automatisierte Ressourcenbereinigung sicher, um Lecks nach Abschluss der Testausführung zu verhindern.
Das Projekt deckt die Validierung containerisierter Dienste ab, einschließlich der Möglichkeit, dynamische Verbindungsdetails abzurufen und Container-Netzwerke zu verwalten. Es unterstützt zudem das Erfassen von Container-Logs und die Ausführung von Befehlen innerhalb laufender Container.
Features
- Ephemeral Container Orchestrators - Orchestrates the rapid creation and destruction of isolated containers for integration tests.
- Docker Integration Testing Libraries - A Go library for booting and managing ephemeral Docker containers to provide isolated environments for integration tests.
- Integration Testing Utilities - Provides a framework for managing temporary Docker containers within Go tests to verify system behavior.
- Ephemeral Container Cleanup - Automatically removes temporary Docker containers and networks after test execution to prevent resource leaks.
- Containerized Service Integrations - Integrates containerized services by verifying readiness and retrieving dynamic connection details for tests.
- Docker Engine API Clients - Implements a programmatic Go client to interact directly with the Docker Engine API for container management.
- Service Readiness Checks - Verifies that containers are ready to accept connections using a polling probe with a backoff strategy.
- Containerized Test Libraries - Provides a programmatic API for controlling containerized dependencies during integration testing.
- Container Command Executors - Executes shell commands inside running containers and captures the output and exit status.
- Cloud Resource Cleanups - Automatically releases containers and networks via hooks to prevent resource leaks.
- Runtime Environment Variable Injections - Injects runtime environment variables into containers via the Docker API to customize service behavior.
- Container Image Runs - Compiles local configuration into images and starts them as containers.
- Container Reuse Strategies - Allows attaching to existing containers using image tags to reduce test startup time.
- Programmatic Docker Clients - Provides a programmatic Go interface for controlling Docker containers, networks, and images.
- Container Networking Configurations - Creates isolated networks to connect or disconnect containers for inter-service communication.
- Container Port Mapping - Retrieves dynamically assigned host ports to establish connections between the test suite and internal services.
- Dynamic Connection Detail Extraction - Extracts mapped host IPs and ports for internal services to establish successful client connections.
- Deferred Cleanup Registration - Provides automated hooks to register container deletion, ensuring environment teardown after tests.
- Container Log Retrieval - Retrieves historical logs or streams real-time output from running containers for debugging.
