Build Containers View
InstallAnywhere 2020 SP2 » Advanced Designer » Build
Use the Build Containers view on the Build page to specify options for building Docker containers.
The settings in the Build Containers view are organized into the following main categories:
| • | Docker Configuration |
| • | Docker Engine |
| • | Select Base Image |
| • | Base Image Configuration |
| • | Postbuild Events |
Use the Docker Configuration area to indicate whether you want to enable Docker containers to be built from your project. If you enable Docker containers to be built, you can also configure basic information about the container.
|
Setting |
Description |
||||||
|
Build Docker Container |
Specify whether you want to enable Docker containers to be built from your project. If you enable Docker containers to be built, the other settings in this view are enabled. The default value is No. |
||||||
|
Choose Container Configuration |
Container configurations enable you to generate multiple Docker containers with different settings from the same project. Select the container configuration that you want to build. To add a new container configuration, click the Add button in this setting, and then specify a name for it. To make a copy of a container configuration that you can customize separately, click the Copy button in this setting, and then specify a name for it. To rename a container configuration, click the Rename button in this setting, and then specify a new name for it. To delete the selected container configuration, click the Delete button in this setting. |
||||||
|
Add to Project Build |
Specify whether you want to add the selected container to the project builds. If a container configuration is added to a project build, that container configuration is built each time that one of the following occurs:
build.exe MyProduct.iap_xml -dockerContainerMode |
||||||
|
Build Output Location |
After a Docker container has been successfully built, this read-only setting shows the path to the folder that contains the built container. To open this folder, click the button in this setting. |
||||||
|
Container Name |
Specify a Docker container name for the selected container configuration. |
||||||
|
Container Version |
Specify the version number of the Docker container for the selected container configuration. |
||||||
|
Container GUID |
Specify the GUID of the Docker container for the selected container configuration. To generate a new GUID, click the Generate Container GUID button in this setting. |
Use the Docker Engine area to specify details that are required to connect to the Docker engine on a remote machine.
|
Setting |
Description |
|
Docker Engine Host IP |
Specify the IP address of the machine that has the Docker engine that InstallAnywhere should use for Docker container builds. For a Windows-based machine, enter the IP address of the Linux virtual machine that is running on the Windows-based machine. |
|
Docker Engine Host Port |
Specify the port for the Docker engine on the machine that InstallAnywhere should use for Docker container builds. For a Windows-based machine, enter the port on the Linux virtual machine that is running on the Windows-based machine. |
|
User Name |
Specify the user name for connections to the machine that InstallAnywhere should use for Docker container builds. Important:The Docker engine login credentials must be a user whose entry is available in the machine's sudoers file. |
|
Password |
Specify the password for the account for connections to the machine that InstallAnywhere should use for Docker container builds. |
|
Test Connection |
To test the connection to the machine that InstallAnywhere should use for Docker container builds, click the Test Connection and Proceed button in this setting. |
Use the Select Base Image area to search for and pull an image from a Docker registry.
|
Setting |
Description |
|
Image |
Select the base image that you want to use for the Docker container. To search for an image from a Docker registry and pull it to your Docker engine, click the Search and Pull button in this setting; this opens the Search and Pull an Image from Docker Registry dialog box. This dialog box enables you to search for a Docker image and then pull it to your Docker engine machine for Docker container builds. The image source can be in a repository in Docker Hub or on a private Docker registry server. To refresh the list of images in this setting with the images that were pulled to the Docker engine, click the Refresh Images button in this setting. To view information about the selected image, click the Image Info button in this setting. The Image Details dialog box opens, displaying information such as the ID and size of the selected image. |
Use the Base Image Configuration area to specify details for the image configuration.
|
Setting |
Description |
|
Setups to Install |
To specify the setups that you want to be installed on the selected container configuration, click the Add/Remove button in this setting. The Add Installer dialog box opens, enabling you to specify the required details. Note:All installers that are specified must be capable of unattended silent installations; otherwise, the Docker container build might stop at the point these installers prompt for user interaction. |
|
Edit Dockerfile (for advanced users) |
The Dockerfile is a text file that contains all of the commands that will be used to build your Docker container. InstallAnywhere edits this file as you configure your Docker container configuration in the Build Containers view on the Build page. This file is also available for edit for advanced users through the Edit Dockerfile dialog box in InstallAnywhere. For example, advanced users may want to edit the Dockerfile to run a series of apt-get commands or perform network configuration tasks. To view or edit the Dockerfile for the selected container configuration, click the View/Edit button in this dialog box. |
Use the Postbuild Events area to specify which tasks you want InstallAnywhere to perform after a container is successfully built.
|
Setting |
Description |
|
Export to Build Machine |
Specify whether you want to export the Docker container to your InstallAnywhere build machine after the container is built. For more information, see Specifying Postbuild Events for Successful Docker Container Builds. |
|
Start Container |
Specify whether you want to automatically start the Docker container on the Docker host after the container is built. For more information, see Specifying Postbuild Events for Successful Docker Container Builds. |
|
Run Command |
This setting is available if you select Yes for the Start Container setting. Specify the command that you want to be used to start your Docker container. The default command is a basic sample run command that you can customize or rewrite as needed: docker run -d ContainerName:ContainerNumber For more information, see Specifying Postbuild Events for Successful Docker Container Builds. |
See Also