Testcontainers

Testcontainers es un conjunto de bibliotecas de código abierto que proporciona APIs sencillas y ligeras para arrancar el desarrollo local y las dependencias de pruebas con servicios reales empaquetados en contenedores Docker. Al utilizar Testcontainers, puedes escribir pruebas que dependan de los mismos servicios que utilizas en producción, sin necesidad de usar mocks o servicios en memoria.

Inicio rápido

Lenguajes compatibles

Testcontainers ofrece soporte para los lenguajes más populares, y Docker patrocina el desarrollo de las siguientes implementaciones de Testcontainers:

• Go
• Java

Las demás implementaciones están impulsadas por la comunidad y son mantenidas por colaboradores independientes.

Requisitos previos

Testcontainers requiere un entorno de ejecución de contenedores compatible con la API de Docker. Durante el desarrollo, Testcontainers se prueba activamente con versiones recientes de Docker en Linux, así como con Docker Desktop en Mac y Windows. Estos entornos Docker son detectados y utilizados automáticamente por Testcontainers sin necesidad de configuración adicional.

Es posible configurar Testcontainers para que funcione con otras configuraciones de Docker, como un host Docker remoto o alternativas a Docker. Sin embargo, estas configuraciones no se prueban de manera activa en el flujo de trabajo de desarrollo principal, por lo que es posible que no todas las funciones de Testcontainers estén disponibles y que sea necesaria una configuración manual adicional.

Si tienes más preguntas sobre los detalles de configuración para tu entorno o sobre si este es compatible con la ejecución de pruebas basadas en Testcontainers, ponte en contacto con el equipo de Testcontainers y con otros usuarios de la comunidad de Testcontainers en Slack.

Guías

Explora las guías prácticas de Testcontainers para aprender a utilizar Testcontainers con diferentes lenguajes y frameworks populares:

• Introducción a Testcontainers para .NET
• Introducción a Testcontainers para Go
• Introducción a Testcontainers para Java
• Introducción a Testcontainers para Node.js
• Introducción a Testcontainers para Python
• Probar una API REST de Spring Boot con Testcontainers
• Gestión del ciclo de vida del contenedor en Testcontainers
• Reemplazar H2 con una base de datos real para pruebas
• Configuración de servicios que se ejecutan en un contenedor
• Probar una aplicación web ASP.NET Core
• Probar un Kafka Listener de Spring Boot
• Probar integraciones de API REST usando MockServer
• Probar integraciones de servicios de AWS usando LocalStack
• Probar aplicaciones Quarkus con Testcontainers
• Trabajar con jOOQ y Flyway utilizando Testcontainers
• Probar integraciones de API REST usando WireMock
• Asegurar Spring Boot con Keycloak y Testcontainers
• Probar la integración de la API REST de Micronaut con WireMock
• Probar un Kafka Listener de Micronaut