Command: buildImage
Topic content
Description
create orchestra image from standard Orchestra artifact (Orchestra-cd, Juno or Standalone). This feature requires a base image for the build process.
The base image can either be specified by its name or by using an image file stored on your local machine. If you do not specify the base image, the default image that will be used is registry.access.redhat.com/ubi8/ubi:latest. Docker engine is required to pull the specified image.
The compressed file with suffix .zip, .tar and .gz is supported.
If -javaPath is not used, make sure that the base image contain supported java for orchestra.
|
If using base image by name, the docker engine must be running. |
Required parameters
Parameter |
Description |
-orchestraPath <file or directory> |
the compressed file or directory of the base orchestra artifact (orchestra-cd or juno-cd) that is used to create the container |
-targetPath <directory> |
the directory of output image |
-targetImage <image> |
the name of output image the name of output image can be input in the format <image name>[:<tag>] •<image name> the name of image. •<tag> the image tag |
-baseImage <image or file> |
the name of base image or local image file that has to be used. the name of base image can be input in the format <image name>:<tag>. The docker engine is required if use this option: •<image name> the name of image. •<tag> the image tag |
Optional parameters
Parameter |
Description |
-javaPath <file or directory> |
the compressed file or directory of java for Linux |
-copyLib <files or directories> |
the files or files in directories to be added to the library directory of orchestra (use | to separate multiple path). This switch can be used multiple times. |
-copy <file or directory>|<target path> |
the file or files in directory to be added to the specific directory of image. This switch can be used multiple times. •<file or directory> the file or directory to be copied •<target path> the target file or directory inside image |
-remove <files or directories> |
the relative path of files or directories of base orchestra directory to be excluded from output image (use | to separate multiple path). This switch can be used multiple times. The base orchestra directory of orchestra-cd is <orchestra cd artifact>/Application/orchestra The base orchestra directory of Juno/Standalone is the same directory of orchestra Juno/Standalone artifact |
-tomcatPath <file or directory> |
the compressed file or directory of tomcat for Linux (required if orchestra artifact is) |
-loggingPropertiesPath <file> |
the file of external logging.properties |
-showStackTrace |
use this switch to show stack trace on the console. |
Batch mode
The batch mode is started, if the start script is launched with additional arguments.
|
Execution will be stopped if any required parameter is missing. |
Example |
Here we are executing the build image in batch mode.
./imagecomplier.sh
> buildImage -orchestraPath <orchestra or juno directory> -javaPath <java directory> -tomcatPath <tomcat directory> -targetPath <output directory> -targetImage <name>[:<tag>] -copy <source file or directory>|<target> -copy <source file or directory>|<target> -copyLib <source file or directory> -copyLib <source file or directory>|<source file or directory> -remove <relative path of file or directory> -remove <relative path of file or directory>|<relative path of file or directory> -baseImage <image or file> |