Create an instance image

To create an instance image, perform the following steps:

  1. Unpack the KCM installation package on the Docker host in an empty directory.

  2. Copy the template Docker file InstallServer\Dockerfiles\example-instance next to the InstallServer folder in the otherwise empty directory.

    The template contains multiple variables that need to be populated with correct data before this Docker file can be used. See the comments in the file for instructions and suggestions. In particular take notice of the parameters of AddKCM.exe, AddInstance.exe, and the entry point with StartInstance.exe.

    The parameters in the ENTRYPOINT instruction in the Docker file are a partial list of parameters that are fixed on the image. When a container is started, additional parameters can be supplied. These will be appended to this list.

    If a parameter references a file, then this file should be accessible from the container when it is started. For example, you can add a COPY instruction to the Docker file to embed the file on the image.

  3. From the folder where you copied the docker file, run the docker command docker build -t <image-name> -f <docker-file> . If any error occurs during the Docker build command, then the Docker build needs to be re-started from the beginning.

The template Docker file uses the AddKCM.exe to install KCM on Docker. This is similar to a non-Docker installation, except that for a Docker installation the value of the Deploy!Docker parameter of AddKCM.exe must be set to True.

For a detailed description of these parameters, see the Parameters section of this guide.