Create an instance image
To create an instance image, perform the following steps:
-
Unpack the KCM installation package on the Docker host.
-
Copy the template Docker file InstallServer\Dockerfiles\example-instance to the extracted InstallServer folder and rename it.
-
Find the "FROM" instruction in the Docker file and edit the name of the prerequisite image.
-
Find the "RUN" instruction in the Docker file and edit the parameters of AddInstance.exe.
-
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.
-
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.