3.1.0

Integration-Test-Docker-Environment 3.1.0, released 2024-06-26

Summary

Updated dependency constraints and supported Exasol versions.

Supported Exasol Versions

• 7.1: up to 7.1.26
• 8: from 8.17.0 up to 8.27.0

Dependencies

• Updated docker dependency constrains to >= 4.0.0, != 7.0.0, for further details see:
  • docker/docker-py#3240
  • docker/docker-py#3223

Changes

• Moved pytest dependency to development dependencies
• Add explicit dependency and version constraint (<= 0.20.1) for docutils
• #396: Added new docker-db versions

3.0.0

Integration-Test-Docker-Environment 3.0.0, released 2024-02-22

Summary

Removed pytest-itde plugin.

Supported Exasol Versions

• 7.1: up to 7.1.17
• 8: 8.18.1

Breaking Changes

• Removed pytest-itde plugin See also

  Users which do rely on the plugin should consider moving to the standalone pytest-itde plugin.
  The related project can be found here

2.1.0

Integration-Test-Docker-Environment 2.1.0, released 2024-02-22

Summary

This release addresses dependencies updates and dependency issues.

Supported Exasol Versions

• 7.1: up to 7.1.17
• 8: 8.18.1

Dependencies

• Constrain docker dependency to >= 4.0.0, < 7.0.0, for further details see docker/docker-py#3223

Internal

• #184: Streamlined error messages
  • Added exasol-error-reporting library

2.0.0

Integration-Test-Docker-Environment 2.0.0, released 2023-08-07

Summary

Version 2.0.0 of ITDE comes with breaking changes as the public API class DatabaseInfo has been changed. Former separate attributes database_port_forwardand bucketfs_port_forward have been replaced by a single attribute port set to an instance of PortForwarding with attributes database, bucketfs, and ssh.

Previous versions of the ITDE used docker_exec to access the Docker Container, e.g. to analyze the content of logfiles or execute some shell commands. In future versions of the Exasol Docker-DB the format of the Docker Containers might change so that docker_exec is no longer possible. Instead ITDE will then need to use SSH access.

The current release therefore enhances ITDE to enable to access the Docker Container via SSH. The user can select the docker access method with command line option --db-os-access and can specify a port number to which ITDE forwards the SSH port of the Docker Container, see User Guide.

Additionally the directory for storing the randomly generated SSH keys has been moved to ~/.cache/exasol/itde/. By that ITDE can restrict file permissions allowing access only by the current user.

This release also removes versions 7.0.x of the Exasol database from the regular CI builds as version 8.x is already available and ITDE only supports the latest two minor versions.

Supported Exasol Versions

• 7.1: up to 7.1.17
• 8: 8.18.1

If you need further versions, please open an issue.

Internal

Changes

• #329: Added CLI option --ssh-port-forward to forward SSH port
• #343: Added SshInfo to DatabaseInfo containing user, port and path to SSH key file
• #308: Unified ports for database, BucketFS, and SSH
• #322: Added additional tests for environment variable LOG_ENV_VARIABLE_NAME
• #359: Fixed custom logging path not working if dir does not exist.
• #304: Create SSH access replacements for calls to docker.exec_run()
• #368: Removed versions 7.0.x of Exasol database
• #305: Replaced calls to DockerContainer.exec_run() to support SSH access alternatively

1.7.1: Fixed UDFs for Exasol Docker-DB 8.18.1

Integration-Test-Docker-Environment 1.7.1, released 2023-06-19

Summary

This release fixes the not working UDFs in Exasol Docker-DB 8.18.1.

Supported Exasol Versions

• 7.0: up to 7.0.20, except 7.0.5
• 7.1: up to 7.1.17
• 8: 8.18.1

If you need further versions, please open an issue.

Internal

Changes

• #351: Added test for UDF with builtin Script-Language Container and fixed it for Docker-DB 8.18.1

1.7.0: Support for Exasol 8.18.1 and ssh access preperations

Integration-Test-Docker-Environment 1.7.0, released 2023-06-15

Summary

This release added support for the Exasol Docker-DB 8.18.1. Furthermore, it adds the first features for accessing
the Docker-DB container via SSH instead of docker exec. This is in preparation for later Exasol Docker-DB releases,
for which you can't access the operating system of the database with docker exec. However, the SSH access itself
is not yet operational. Finally, this release fixes a bug in the reporting of task failures. The TaskRuntimeError
didn't show the actual task failures if not caught explicitly.

Supported Exasol Versions

• 7.0: up to 7.0.20, except 7.0.5
• 7.1: up to 7.1.17
• 8: 8.18.1

If you need further versions, please open an issue.

Internal

Changes

• #301: Added commandline option --db-os-access
• #302: Added support to create an SSH key for accessing Docker Container
• #241: Renamed environment variable for test execution from GOOGLE_CLOUD_BUILD to RUN_SLC_TESTS_WITHIN_CONTAINER
• #190: Added support for the Exasol 8.0 Docker-DB prerelease version
• #326: Changed folder for SSH keys to ~/.cache/exasol/itde/
• #303: Added authorized_keys to Docker Container for SSH access
• #337: Added Docker-DB 8.18.1
• #350: TaskRuntimeError will be raised as chained exception with all task failures.

1.6.0: Bug Fixes

Integration-Test-Docker-Environment 1.6.0, released 2023-05-12

Summary

This release fixes several bugs regarding logging, reusing of an environment and rebuilding the test container.

Supported Exasol Versions

• 7.0: up to 7.0.20, except 7.0.5
• 7.1: up to 7.1.17

If you need further versions, please open an issue.

Internal

• #297: Update release_config.yml
• #311: Add vagrant setup

Changes

• #294: Fixed that the client logging config gets overwritten
• #295: Fixed that the test_container_content parameter pollutes the logs
• #300: Fixed BucketFS uploads during reusing of an environment
• #310: Fixed that using run_task with log_level duplicates log entries
• #291: Fixed that test container gets rebuild when force_rebuild is true
• #316: Removed setup.py and updated poetry(1.4.0) in actions

1.5.0: Added pytest plugin and fixed itde cli command

Integration-Test-Docker-Environment 1.5.0, released 2023-03-21

Summary

Added pytest plugin and fixed itde cli command

Supported Exasol Versions

• 7.0: up to 7.0.20, except 7.0.5
• 7.1: up to 7.1.17

If you need further versions, please open an issue.

Feature

• Added pytest plugin and fixtures

  • Show settings related to itde plugin

    pytest --help | grep "itde\|exasol\|bucketfs"

  • Show fixtures related to itde

    pytest --fixtures | grep pytest_itde -A 3

  • Use itde to setup a test db etc. for a test

    # In order to use itde, just request it as fixture
    # ATTENTION: initial startup may be up to ~1-2 minutes
    # (Somtimes even longer if images must be fetched for the first time)
    def test_smoke_test_plugin(itde):
        db = itde.exasol_config,
        bucketfs = itde.bucketfs_config,
        itde_cfg = itde.itde_config,
        ctrl_connection = itde.connection,
        assert True

Changes

• Fixed itde cli command and subcommands

  • Provide all available subcommands in help

  • Provide examples and basic doc string for commands

  • Fix subcommand imports

  • Example Usage:

      $ itde spawn-test-environment --environment-name test \\
      --database-port-forward 8888 --bucketfs-port-forward 6666 \\
      --docker-db-image-version 7.1.9 --db-mem-size 4GB

Internal

• Updated dependencies

1.4.0

Integration-Test-Docker-Environment 1.4.0, released 2023-03-15

Summary

Added support for automated GitHub & PYPI releases

Supported Exasol Versions

• 7.0: up to 7.0.20, except 7.0.5
• 7.1: up to 7.1.17

If you need further versions, please open an issue.

Internal

• Added support for automated releases to GitHub & PYPI #51

1.3.0: Support for Exasol up to 7.1.17 and 7.0.20

Integration-Test-Docker-Environment 1.3.0, released 2023-02-17

Summary

In version 1.3.0 of the ITDE we added new supported versions up to 7.0.20 and 7.1.17 respectively.

Supported Exasol Versions

• 7.0: up to 7.0.20, except 7.0.5
• 7.1: up to 7.1.17

If you need further versions, please open an issue.

Tested Docker Runtimes

• Docker Default Runtime

Refactoring:

• Removed docker health checks from ITDE starter script
• Fixed broken/outdated import path
• Added itde cli entry point to project configuration