aztk/docs/12-docker-image.md

Docker

Azure Distributed Data Engineering Toolkit runs Spark on Docker.

Supported Azure Distributed Data Engineering Toolkit images are hosted publicly on Docker Hub.

Versioning with Docker

The default image that this package uses is a the aztk-base Docker image that comes with Spark v2.2.0.

You can use several versions of the aztk-base image:

• Spark 2.2.0 - aztk/base:spark2.2.0 (default)
• Spark 2.1.0 - aztk/base:spark2.1.0
• Spark 1.6.3 - aztk/base:spark1.6.3

To enable GPUs you may use any of the following images, which are based upong the aztk-base images. Each of these images are contain CUDA-8.0 and cuDNN-6.0. By default, these images are used if the VM type used has a GPU.

• Spark 2.2.0 - aztk/gpu:spark2.2.0 (default)
• Spark2.1.0 - aztk/gpu:spark2.1.0
• Spark 1.6.3 - aztk/gpu:spark1.6.3

We also provide two other image types tailored for the Python and R users: aztk-r and aztk-python. You can choose between the following:

• Anaconda3-5.0.0 (Python 3.6.2) / Spark 2.2.0 - aztk/python:spark2.2.0-python3.6.2-base
• Anaconda3-5.0.0 (Python 3.6.2) / Spark 2.1.0 - aztk/python:spark2.1.0-python3.6.2-base
• Anaconda3-5.0.0 (Python 3.6.2) / Spark 1.6.3 - aztk/python:spark1.6.3-python3.6.2-base
• R 3.4.1 / Spark v2.2.0 - aztk/r-base:spark2.2.0-r3.4.1-base
• R 3.4.1 / Spark v2.1.0 - aztk/r-base:spark2.1.0-r3.4.1-base
• R 3.4.1 / Spark v1.6.3 - aztk/r-base:spark1.6.3-r3.4.1-base

Please note that each of these images also have GPU enabled versions. To use these versions, replace the "-base" part of the Docker image tag with "-gpu":

• Anaconda3-5.0.0 (Python 3.6.2) / Spark 2.2.0 (GPU) - aztk/python:spark2.2.0-python3.6.2-gpu
• Anaconda3-5.0.0 (Python 3.6.2) / Spark 2.1.0 (GPU) - aztk/python:spark2.1.0-python3.6.2-gpu
• Anaconda3-5.0.0 (Python 3.6.2) / Spark 1.6.3 (GPU) - aztk/python:spark1.6.3-python3.6.2-gpu

Today, these supported images are hosted on Docker Hub under the repo "base/gpu/python/r-base:".

To select an image other than the default, you can set your Docker image at cluster creation time with the optional --docker-repo parameter:

aztk spark cluster create ... --docker-repo <name_of_docker_image_repo>

For example, if I wanted to use Spark v1.6.3, I could run the following cluster create command:

aztk spark cluster create ... --docker-repo aztk/base:spark1.6.3

Using a custom Docker Image

What if I wanted to use my own Docker image?

You can build your own Docker image on top or beneath one of our supported base images OR you can modify the supported Dockerfile and build your own image that way.

Please refer to '../docker-image' for more information on building your own image.

Once you have your Docker image built and hosted publicly, you can then use the --docker-repo parameter in your aztk spark cluster create command to point to it.

Using a custom Docker Image that is Privately Hosted

To use a private docker image you will need to provide a docker username and password that have access to the repository you want to use.

In .aztk/secrets.yaml setup your docker config

docker:
    username: <myusername>
    password: <mypassword>

If your private repository is not on docker hub (Azure container registry for example) you can provide the endpoint here too

docker:
    username: <myusername>
    password: <mypassword>
    endpoint: <https://my-custom-docker-endpoint.com>