Skip to main content
Testkube 2.6.0 is out! A new AI Agent Framework that integrates with external MCP Servers for agentic troubleshooting, remediation, etc. Read More

Using TestContainers with Testkube

info

This Workflows functionality is not available when running the Testkube Agent in Standalone Mode - Read More

TestContainers is a popular framework for managing test dependencies on specific Docker containers.

To make sure TestContainers can successfully launch defined Docker images, it is recommended to define a separate service in your Workflow that runs a docker-in-docker (dind) image, which can then be used by TestContainers by overriding the DOCKER_HOST environment variable in your test executions.

The below example runs an Ollama Hugging Face example test from the testcontainers-java repository that uses TestContainers to spawn corresponding Ollama dependencies

  • The spec.content property defines the location of the GitHub project
  • The spec.services.dind property starts the Docker-in-Docker container (read more about Services)
  • the spec.steps property defines a single step that runs the Ollama test with gradle, overriding the DOCKER_HOST environment variable with the internal service ip of the dind service.
Ollama HuggingFace test with Gradle and TestContainers Workflow
kind: TestWorkflow
apiVersion: testworkflows.testkube.io/v1
metadata:
  name: gradle-with-testcontainers
  namespace: testkube
spec:
  content:
    git:
      uri: https://github.com/testcontainers/testcontainers-java
      revision: main
  container:
    workingDir: /data/repo/examples/ollama-hugging-face
    resources:
      requests:
        cpu: 512m
        memory: 512Mi
  services:
    dind:
      logs: always
      timeout: 5m
      image: docker:27.4.0-dind
      env:
        - name: DOCKER_TLS_CERTDIR
      securityContext:
        privileged: true
      readinessProbe:
        tcpSocket:
          port: 2375
  steps:
    - name: Run tests
      run:
        image: gradle:8.5.0-jdk11
        env:
          - name: TESTKUBE_GRADLE
            value: "true"
          - name: DOCKER_HOST
            value: tcp://{{ services.dind.0.ip }}:2375
        command:
          - gradle
          - --no-daemon
          - test
      artifacts:
        paths:
        - reports/**/*
        - test-results/**/*

After execution, you can see the output from the test executions under the executions panel tabs:

The log output from the test execution:

Ollama TestContainers Log Output