Building custom Docker images

You can use DataStax source code to build a custom Docker image for your environment.

Build an image

DataStax provides a code repository on Github for building custom Docker images. To build an image, do the following steps:

Clone the DataStax Docker Github repository.
Make any desired configuration changes.
Run the ./gradlew command.

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

End User License Agreement (EULA). By downloading this DataStax product, you agree to the terms of the EULA.

To build a product image for a specific version, invoke a Grade task that follows this pattern:

gradlew command
Example

./gradlew build<product><version>Image

./gradlew buildServer6.0.6Image

Build all images

To build all images, run the following command, entering your DataStax Academy credentials for username and password.

./gradlew buildImages

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

Build 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.