bld.bat

Usage

bld.bat IacceptEULA win_x64 [app] [rmi] [dryrun]

Parameters

IacceptEULA

Indicates the acceptance of the End User License Agreement (EULA). This parameter is required.

win_x64

Create a Windows 64-bit image.

app

Build an application image based on the extend base image, including the AppContainerDirectory.

rmi

Indicates removal of the microfocus/extend images using 'docker rmi --force'.

dryrun

Echos the command to create an image, but does not actually create the image.

Examples

Example 1

Accept the EULA and create a Windows 64-bit image:

bld.bat IacceptEULA win_x64

Example 2

Accept the EULA and create a Windows 64-bit application image based on the base image, and that includes the AppContainerDirectory:

bld.bat IacceptEULA win_x64 app

Example 3

Remove any images in the microfocus/extend repository:

bld.bat IacceptEULA rmi

Example 4

See the value of Docker variables without executing the build:

bld.bat IacceptEULA win_x64 dryrun

For example this command returns:

bld.bat IacceptEULA win_x64 dryrun
DRYRUN: docker build
--tag microfocus/extend:win_10.5.0_x64
--build-arg BASEOSIMAGE=mcr.microsoft.com/windows/servercore:ltsc2019
--build-arg ACCEPT_CONTAINER_EULA=yes
--build-arg ADDLOCAL="AcuToWeb,VCRedist,AcuConnect64,Runtime64"
--build-arg MSI="extend(R) Version 10.5.0 x64.msi"
--build-arg EXTEND_VERSION="10.5.0"
--file Dockerfile_win_x64
.

See Docker Build Command later in this topic for more information.

bld_win_x64.env

bld.bat uses the following information from the bld_win_x64.env file:

# Version of extend
EXTEND_VERSION=10.5.0

# Name and version of the Windows operating system
BASEOSIMAGE=mcr.microsoft.com/windows/servercore:ltsc2019

#Name of the Dockerfile used to create the base image
DOCKERFILE=Dockerfile_win_x64

# Complete base image reference name
# like microfocus/extend:win_10.5.0_x64
BASEIMAGE=microfocus/extend:win_!EXTEND_VERSION!_x64

# Complete application image reference name
# like microfocus/extend-app:win_10.5.0_x64
APPIMAGE=microfocus/extend-app:win_!EXTEND_VERSION!_x64

# Name of the Windows extend installer program
MSI=extend(R) Version !EXTEND_VERSION! x64.msi

# List of products to be installed in the base image
ADDLOCAL=AcuToWeb,VCRedist,AcuConnect64,Runtime64

Docker Build Command

bld.bat then runs the docker build command using the following syntax:

docker build ^
	--tag %BASEIMAGE% ^
	--build-arg BASEOSIMAGE=%BASEOSIMAGE% ^
	--build-arg ACCEPT_CONTAINER_EULA=%EULAARG% ^
	--build-arg ADDLOCAL="%ADDLOCAL%" ^
	--build-arg MSI="%MSI%" ^
	--build-arg EXTEND_VERSION="%EXTEND_VERSION%" ^
	--file %DOCKERFILE% ^
	.

Where:

--tag

Sets a name for the base image that gets built.

--build-arg

Sets variables that get used in the Dockerfile specified by the --file option.

--file

Specifies the name of the Dockerfile that contains the base image creation commands.

.

Sets the current directory as the directory in which to look for file and subdirectories.