Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can merge IncrediBuild Docker image with another Docker image. When the merged image will run, the launched container will include the settings of both images, according to their order in the new merged image. For the merge, you can use an existing Docker image you have, or you can pull a new image to merge it with IncrediBuild image.To merge Docker images, you can create a new Dockerfile that will include the Dockerfiles of the images you want to merge. You can also add the layers of one image to the Dockerfile of another image. After you have a merged add external tools and applications to IncrediBuild image, by creating a new image that will integrate the original IncrediBuild image with additional instructions for the external tools. When a container will be launched based on the new image, it will contain an IncrediBuild Agent together with the tools you added.    

To add external tools to IncrediBuild container, you need to create a new Dockerfile that will be based on IncrediBuild image. Then, you need to add to this Dockerfile the instruction layers that will import the tools you want to include in the container. After you integrated the additional instructions with IncrediBuild image in the new Dockerfile, you build it to create a new image. Then, you run the new image to launch a container, which will contain the settings of all included imagesthe instructions that are specified in the image.

Note: Nano Server Core operating system cannot function as the base operating system for IncrediBuild image, since it does not support 32-bit applications. Therefore, you cannot use an image that includes integrate this operating system with IncrediBuild image or use instructions that are based on it for running IncrediBuild Docker containers.

> To merge IncrediBuild Docker image with another Docker image:>  To integrate an external tool with IncrediBuild image: 

  1. Create a new empty Dockerfile, or open the Dockerfile of one of the images you want to merge.

  2. Use the Docker FROM instruction, to add IncrediBuild image to the Dockerfile.
    For example:

    Code Block
    FROM: incredibuild/9.5.6
  3. Add to the required images Dockerfile the required instructions for importing the additional tool to the Dockerfileimage.
    Note: You should take into consideration that the order of the instructions you enter into the Dockerfile is significant, since the Docker daemon runs the instructions one after the other, committing the result of each instruction to the following image, if necessary. For more information on building a Dockerfile, see: https://docs.docker.com/engine/reference/builder/
    For example:

    Code Block
    FROM: incredibuild/9.5.6
    FROM: mcr.microsoft.com/windows/servercore:ltsc2016
    [Optional] You can add additional instructions to the new Dockerfile.
    For example, you can use the Docker COPY instruction, to add a script or a process to the new image.
    
    RUN mkdir C:\\BuildToolsWORKDIR
    C:\\BuildToolsCOPY C:\\Host\\BuildToolsDirectory
    # (Import build tools and necessary binaries)
    …
  4. Build a Docker image from the new Dockerfile using the docker build command.
    Note: For more information on the docker build command, see:
    https://docs.docker.com/engine/reference/commandline/build/

  5. Run a container based on the new merged image, using the docker run command with the required IncrediBuild options.

...