Setting up

Prerequisites (Docker)

Warning

DSS is not responsible for setting up your Docker daemon

The prerequisites for running workloads in Docker are:

  • You need to have an existing Docker daemon. The “docker” command on the DSS machine must be fully functional and usable by the user running DSS. That includes the permission to build images, and thus access to a Docker socket

For Docker execution, you may need or not to push images to an image registry. Pushing images to an image registry is required if you plan to run workloads on multiple Docker daemons, or if you plan to build images on a Docker daemon and to run workloads on another Docker daemon

If you plan to push images to an image registry:

  • The local “docker” command must have permission to push images to your image registry
  • All other docker daemons need to have permission to pull images from your image registry

Prerequisites (Kubernetes)

Warning

DSS is not responsible for starting and managing your Kubernetes cluster, which must already exist.

The prerequisites for running workloads in Kubernetes are:

  • You need to have an existing Kubernetes cluster. The “kubectl” command on the DSS machine node must be fully functional and usable by the user running DSS.
  • The local “docker” command must be usable by the user running DSS. That includes the permission to build images, and thus access to a Docker socket
  • You need to have an image registry, accessible by your Kubernetes cluster
  • The local “docker” command must have permission to push images to your image registry

Other prerequisites

  • Your DSS machine must have direct outgoing Internet access in order to install packages
  • Your containers must have direct outgoing Internet access in order to install packages

Limitations

  • The MacOS installation of DSS does not support execution on Docker or Kubernetes

Build the base image

Before you can deploy to Docker or Kubernetes, at least one “base image” must be constructed.

Warning

After each upgrade of DSS, you must rebuild all base images

From the DSS Datadir, run

./bin/dssadmin build-container-exec-base-image

Run things in Docker or Kubernetes

Container execution configuration can be specified:

  • In the project settings. In that case, it will apply by default to all project “things”
  • In the recipe advanced settings
  • In the “Execution environment” tab of in-memory machine learning settings screen