Create an instance image

To create an instance image, perform the following steps:

  1. Unpack the KCM installation package on the Docker host.

  2. Copy the template Docker file InstallServer\Dockerfiles\example-instance to the extracted InstallServer folder and rename it.

  3. Find the "FROM" instruction in the Docker file and edit the name of the prerequisite image.

  4. Find the "RUN" instruction in the Docker file and edit the parameters of AddInstance.exe.

  5. Find the "ENTRYPOINT" instruction in the Docker file and edit, add, or remove the parameters of StartInstance.exe. This is a partial list of parameters, which are fixed on the image. The remaining parameters will be supplied and appended to this list when a container is started.

    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.

  6. From the InstallServer folder, 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 AddInstance.exe to install the KCM Instance on Docker. This is similar to a non-Docker installation, except that for a Docker installation the value of the Deploy!Docker parameter of AddInstance.exe must be set to True.

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