Building custom Docker images

Use DataStax source code to customize a Docker image for your environment.

Use DataStax source code to build a custom Docker image for your environment.

To build an image:

DataStax provides a code repository on Github for building custom Docker images.

By default, Gradle downloads the DataStax tarballs from the DataStax Downloads page.

Important: End User License Agreement (EULA). By downloading this DataStax product, you agree to the terms of the EULA.
To build all images, run the following command, entering DataStax Academy credentials for username and password.
./gradlew buildImages
To build a product image for a specific version, invoke a Grade task that follows this pattern:
./gradlew build<product><version>Image
For example:
./gradlew buildServer6.0.6Image
To build more than one image with specific versions:
./gradlew buildServer6.0.6Image buildOpscenter6.5.0Image
To get the list of all available tasks, run:
./gradlew tasks

Multiple product versions

To support multiple product versions without duplicating files, Docker build contexts are generated from source folders that contain FreeMarker templates (files with .ftl extensions). The following conventions are used:

  • Docker build contexts are generated from self-describing product folders. For example, server, opscenter, and studio.
  • All files without the .ftl extension are copied to the build context.
  • Files with .ftl extensions are processed as FreeMarker templates:
    • Template directives are written using angle bracket syntax.
    • Square bracket syntax is used for interpolations.
    • The processed files are copied to the build context without .ftl extension. For example, Dockerfile.ftl is copied as Dockerfile.
  • FreeMarker templates use the version variable:
    • version.major returns product version major number
    • version.minor returns product version minor number
    • version.bugfix returns product version bugfix number
    • The following version functions are available:
      • version.lowerThan('x.y.z') returns true if version is semantically lower than x.y.z
      • version.greaterEqualThan('x.y.z') returns true if version is semantically greater than or equal to x.y.z.
To customize the products or to use multiple product versions, modify the templates in their corresponding product folder.