Skip to content

exasol/exasol-testcontainers

Repository files navigation

exasol-testcontainers

exasol-testcontainer logo

Build Status Maven Central – Test containers for Exasol on Docker

Quality Gate Status

Security Rating Reliability Rating Maintainability Rating Technical Debt

Code Smells Coverage Duplicated Lines (%) Lines of Code

This project provides an abstraction to Exasol running on Docker for the purpose of integration testing based on Java Testcontainers.

You can create a dockerized instance of Exasol with a few Java commands from within the test framework (e.g. JUnit).

Scope

This software is intended for use in automated integration tests of Java software that uses Exasol. It sets up and runs a disposable Docker container and lets users access the interfaces of the Exasol instance inside that container with minimum effort.

Don't use testcontainers for production environments or with confidential data. To make testing as convenient as possible, the handling of the disposable containers is not up to the same security standards as a production system.

Features

  • Download, start and stop an Exasol docker container automatically
  • JUnit integration via annotations
  • JDBC connection to the database inside the container
  • BucketFS access
  • EXAoperation emulation
  • Optional container reuse
  • Detection for access via docker exec and fallback to SSH

Table of Contents

Information for Users

"Users" from the perspective of this project are software developers integrating the Exasol test container into their test environment, not database end users.

Information for Contributors

Requirement, design documents and coverage tags are written in OpenFastTrace format.