Build Containers View

InstallAnywhere 2020 » 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

Docker Configuration

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.

Docker Configuration Area Settings

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:

•

You click the Build Containers or Build Selected buttons at the bottom of the Build Containers view (on the Build page).

•

You build the project from the command line without specifying any container configurations, such as:

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.

Docker Engine

Use the Docker Engine area to specify details that are required to connect to the Docker engine on a remote machine.

Docker Engine Area Settings
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.

Select Base Image

Use the Select Base Image area to search for and pull an image from a Docker registry.

Select Base Image Area Settings
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.

Base Image Configuration

Use the Base Image Configuration area to specify details for the image configuration.

Base Image Configuration Area Settings
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.

Postbuild Events

Use the Postbuild Events area to specify which tasks you want InstallAnywhere to perform after a container is successfully built.

Postbuild Events Area Settings
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.

Build Containers View

InstallAnywhere 2020 Help Library

October 2019