Informational variables

Table 1. Table Informational variables

Name

Value

Description

AB_PROMETHEUS_JMX_EXPORTER_CONFIG

/opt/jboss/container/prometheus/etc/jmx-exporter-config.yaml

Path to configuration to use for the Prometheus JMX Exporter

GECOS

JBoss user

-

HOME

/home/jboss

-

JAVA_DATA_DIR

/deployments/data

^ The location of the directory which should be used by the application for reading/writing application data. Users should override the default if their application should use a different directory, e.g. if a persistent volume is used to persist data across restarts.

JAVA_HOME

/usr/lib/jvm/java-17

-

JAVA_VENDOR

openjdk

-

JAVA_VERSION

17

-

JBOSS_CONTAINER_JAVA_JVM_MODULE

/opt/jboss/container/java/jvm

-

JBOSS_CONTAINER_JAVA_PROXY_MODULE

/opt/jboss/container/java/proxy

-

JBOSS_CONTAINER_JAVA_RUN_MODULE

/opt/jboss/container/java/run

-

JBOSS_CONTAINER_JAVA_S2I_MODULE

/opt/jboss/container/java/s2i

-

JBOSS_CONTAINER_MAVEN_38_MODULE

/opt/jboss/container/maven/38/

-

JBOSS_CONTAINER_MAVEN_DEFAULT_MODULE

/opt/jboss/container/maven/default/

-

JBOSS_CONTAINER_MAVEN_S2I_MODULE

/opt/jboss/container/maven/s2i

-

JBOSS_CONTAINER_OPENJDK_JDK_MODULE

/opt/jboss/container/openjdk/jdk

-

JBOSS_CONTAINER_PROMETHEUS_MODULE

/opt/jboss/container/prometheus

-

JBOSS_CONTAINER_S2I_CORE_MODULE

/opt/jboss/container/s2i/core/

-

JBOSS_CONTAINER_UTIL_LOGGING_MODULE

/opt/jboss/container/util/logging/

-

MAVEN_VERSION

3.8

-

S2I_SOURCE_DEPLOYMENTS_FILTER

*.jar quarkus-app

Space separated list of filters to be applied when copying deployments. Defaults to *.jar quarkus-app

UID

185

-

USER

jboss

-

Configuration variables

Table 2. Table Configuration variables

Name

Example

Description

AB_PROMETHEUS_ENABLE

True

Enable the use of the Prometheus agent

AB_PROMETHEUS_JMX_EXPORTER_PORT

9799

Port to use for the Prometheus JMX Exporter.

APP_DATADIR

-

Deprecated by S2I_SOURCE_DATA_DIR.

ARTIFACT_DIR

-

Deprecated by MAVEN_S2I_ARTIFACT_DIRS.

CUSTOM_INSTALL_DIRECTORIES

-

Deprecated by S2I_IMAGE_SOURCE_MOUNTS.

DATA_DIR

-

Deprecated by S2I_TARGET_DATA_DIR.

DEPLOYMENTS_DIR

-

Deprecated by S2I_TARGET_DEPLOYMENTS_DIR.

GC_ADAPTIVE_SIZE_POLICY_WEIGHT

90

The weighting given to the current GC time versus previous GC times.

GC_CONTAINER_OPTIONS

-XX:+UseG1GC

specify Java GC to use. The value of this variable should contain the necessary JRE command-line options to specify the required GC, which will override the default of -XX:+UseParallelGC.

GC_MAX_HEAP_FREE_RATIO

40

Maximum percentage of heap free after GC to avoid shrinking.

GC_MAX_METASPACE_SIZE

100

The maximum metaspace size.

GC_METASPACE_SIZE

20

The initial metaspace size.

GC_MIN_HEAP_FREE_RATIO

20

Minimum percentage of heap free after GC to avoid expansion.

GC_TIME_RATIO

4

Specifies the ratio of the time spent outside the garbage collection (for example, the time spent for application execution) to the time spent in the garbage collection.

HTTPS_PROXY

myuser@127.0.0.1:8080

The location of the https proxy. This takes precedence over http_proxy and HTTP_PROXY, and will be used for both Maven builds and Java runtime.

HTTP_PROXY

127.0.0.1:8080

The location of the http proxy. This will be used for both Maven builds and Java runtime.

JAVA_APP_DIR

myapplication/

^ The directory where the application resides. All paths in your application are relative to this directory.

JAVA_APP_NAME

-

To set the process or application name by the user.

JAVA_ARGS

-

Arguments passed to the java application.

JAVA_CLASSPATH

-

^ The classpath to use. If not given, the startup script checks for a file JAVA_APP_DIR/classpath and use its content literally as classpath. If this file doesn’t exists all jars in the app dir are added (classes:JAVA_APP_DIR/*).

JAVA_DEBUG

true

If set remote debugging will be switched on. Disabled by default.

JAVA_DEBUG_PORT

8787

Port used for remote debugging. Defaults to 5005.

JAVA_DIAGNOSTICS

true

Set this to get some diagnostics information to standard output when things are happening. Note: This option, if set to true, will set -XX:+UnlockDiagnosticVMOptions. Disabled by default.

JAVA_INITIAL_MEM_RATIO

25.0

Specify the initial heap memory. Corresponds to the JVM argument -XX:InitialRAMPercentage. By default this is not specified. The supplied value can be an integer or float, but only the whole number part is used. JAVA_INITIAL_MEM_RATIO is deprecated and will be removed in a future release. Users should specify -XX:InitialRAMPercentage directly in JAVA_OPTS instead.

JAVA_LIB_DIR

-

^ Directory holding the Java jar files as well an optional classpath file which holds the classpath. Either as a single line classpath (colon separated) or with jar files listed line-by-line. If not set JAVA_LIB_DIR is the same as JAVA_APP_DIR.

JAVA_MAIN_CLASS

com.example.MainClass

^ A main class to use as argument for java. When this environment variable is given, all jar files in JAVA_APP_DIR are added to the classpath as well as JAVA_LIB_DIR.

JAVA_MAX_INITIAL_MEM

4096m

This value is passed through to the -Xms Java option, setting both the minimum and initial heap size. By default this is unset. This is deprecated and will be removed in a future release. Users should specify -Xms directly in JAVA_OPTS instead.

JAVA_MAX_MEM_RATIO

90.0

Specify the maximum heap memory. Corresponds to the JVM argument -XX:MaxRAMPercentage. The default is 80.0 which means 80% of the available memory. You can disable this mechanism by setting the value to 0. The supplied value can be an integer or float, but only the whole number part is used.

JAVA_OPTIONS

-verbose:class

If defined and JAVA_OPTS is not defined, use this value to populate JAVA_OPTS, overriding any JVM tuning parameters generated by the container run scripts. Deprecated. Please use JAVA_OPTS instead.

JAVA_OPTS

-verbose:class

If set, this prevents all default and generated options (such as JVM and GC tuning, proxy settings, etc.) from being applied. Instead the user should specify exactly the java options they want in this variable.

JAVA_OPTS_APPEND

-Dsome.property=foo

User specified Java options to be appended to the generated options. This variable has no effect if JAVA_OPTS has been defined.

LOGGING_SCRIPT_DEBUG

True

Set to true to enable script debugging. Deprecates SCRIPT_DEBUG.

MAVEN_ARGS

-e -Popenshift -DskipTests -Dcom.redhat.xpaas.repo.redhatga -Dfabric8.skip=true

Arguments to use when calling Maven, replacing the default. To append additional arguments, see MAVEN_ARGS_APPEND.

MAVEN_ARGS_APPEND

-X -am -pl

Additional Maven arguments.

MAVEN_CLEAR_REPO

-

If set then the Maven repository is removed after the artifact is built. This is useful for keeping the created application image small, but prevents incremental builds. Will be overridden by S2I_ENABLE_INCREMENTAL_BUILDS. Defaults to false.

MAVEN_LOCAL_REPO

/home/jboss/.m2/repository

Directory to use as the local Maven repository.

MAVEN_MIRRORS

dev-one,qe-two

If set, multi-mirror support is enabled, and other MAVEN_MIRROR_* variables will be prefixed. For example: DEV_ONE_MAVEN_MIRROR_URL and QE_TWO_MAVEN_MIRROR_URL

MAVEN_MIRROR_OF

external:*

Repository IDs mirrored by the mirror specified in MAVEN_MIRROR_URL. For multi-mirror support, see MAVEN_MIRRORS. Defaults to "external:*".

MAVEN_MIRROR_URL

http://10.0.0.1:8080/repository/internal/

The base URL of a mirror used for retrieving artifacts. For multi-mirror support, see MAVEN_MIRRORS.

MAVEN_REPOS

DEV-ONE,QE-TWO

Enables multi-repo support. Specify a comma-delimited list of capitalized repository identifiers. The configuration for each repository will be determined by correspondingly prefixed MAVEN_REPO_* variables. Any dashes in repository names will be replaced with underscores. For example: Specifying DEV-ONE,QE-TWO configures two repositories and their URLs will be read from DEV_ONE_MAVEN_REPO_URL and QE_TWO_MAVEN_REPO_URL.

MAVEN_REPO_LOCAL

/home/jboss/.m2

^ DEPRECATED, use MAVEN_LOCAL_REPO Directory to use as the local Maven repository.

MAVEN_S2I_ARTIFACT_DIRS

target

Relative paths of source directories to scan for build output, which will be copied to $S2I_TARGET_DEPLOYMENTS_DIR. Paths should be delimited by a comma (,). Defaults to target

MAVEN_S2I_GOALS

package install

Space separated list of goals to be executed with maven build, e.g. mvn $MAVEN_S2I_GOALS. Defaults to package

MAVEN_SETTINGS_XML

/home/jboss/.m2/settings.xml

Location of custom Maven settings.xml file to use.

NO_PROXY

foo.example.com,bar.example.com

A comma separated lists of hosts, IP addresses or domains that can be accessed directly. This will be used for both Maven builds and Java runtime.

S2I_ARTIFACTS_DIR

${S2I_DESTINATION_DIR}/artifacts}

^ Location mount for artifacts persisted with save-artifacts script, which are used with incremental builds. This should not be overridden by end users.

S2I_DELETE_SOURCE

false

^ Delete source files at the end of build. Defaults to true.

S2I_DESTINATION_DIR

/tmp

^ Root directory for S2I mount, as specified by the io.openshift.s2i.destination label. This should not be overridden by end users.

S2I_ENABLE_INCREMENTAL_BUILDS

true

^ Do not remove intermediate build files so they can be saved for use with future builds. Defaults to true.

S2I_IMAGE_SOURCE_MOUNTS

extras/*

^ Comma separated list of relative paths in source directory which should be included in the image. List may include wildcards, which are expanded using find. By default, the contents of mounted directories are processed similarly to source folders, where the contents of $S2I_SOURCE_CONFIGURATION_DIR, $S2I_SOURCE_DATA_DIR, and $S2I_SOURCE_DEPLOYMENTS_DIR are copied to their respective target directories. Alternatively, if an install.sh file is located in the root of the mount point, it is executed instead. Deprecates CUSTOM_INSTALL_DIRECTORIES.

S2I_SOURCE_CONFIGURATION_DIR

configuration

^ Relative path to directory containing application configuration files to be copied over to the product configuration directory, see S2I_TARGET_CONFIGURATION_DIR. Defaults to configuration.

S2I_SOURCE_DATA_DIR

data

^ Relative path to directory containing application data files to be copied over to the product data directory, see S2I_TARGET_DATA_DIR. Defaults to data.

S2I_SOURCE_DEPLOYMENTS_DIR

deployments

^ Relative path to directory containing binary files to be copied over to the product deployment directory, see S2I_TARGET_DEPLOYMENTS_DIR. Defaults to deployments.

S2I_SOURCE_DIR

${S2I_DESTINATION_DIR}/src}

^ Location of mount for source code to be built. This should not be overridden by end users.

S2I_TARGET_CONFIGURATION_DIR

/opt/eap/standalone/configuration

^ Absolute path to which files located in $S2I_SOURCE_DIR/$S2I_SOURCE_CONFIGURATION_DIR are copied.

S2I_TARGET_DATA_DIR

/opt/eap/standalone/data

^ Absolute path to which files located in $S2I_SOURCE_DIR/$S2I_SOURCE_DATA_DIR are copied.

S2I_TARGET_DEPLOYMENTS_DIR

/deployments

^ Absolute path to which files located in $S2I_SOURCE_DIR/$S2I_SOURCE_DEPLOYMENTS_DIR are copied. Additionally, this is the directory to which build output is copied

http_proxy

http://127.0.0.1:8080

The location of the http proxy. This takes precedence over HTTP_PROXY and will be used for both Maven builds and Java runtime.

https_proxy

myuser:mypass@127.0.0.1:8080

The location of the https proxy. This takes precedence over HTTPS_PROXY, http_proxy, and HTTP_PROXY, and will be used for both Maven builds and Java runtime.

no_proxy

*.example.com

A comma separated lists of hosts, IP addresses or domains that can be accessed directly. This takes precedence over NO_PROXY and will be used for both Maven builds and Java runtime.

prefix_MAVEN_MIRROR_ID

internal-mirror

ID to be used for the specified mirror. If ommitted, a unique ID will be generated.

prefix_MAVEN_MIRROR_OF

-

Repository IDs mirrored by this entry. Defaults to external:*

prefix_MAVEN_MIRROR_URL

http://10.0.0.1:8080/repository/internal

The URL of the mirror.

prefix_MAVEN_REPO_DIRECTORY_PERMISSIONS

775

Maven repository directory permissions

prefix_MAVEN_REPO_FILE_PERMISSIONS

664

Maven repository file permissions

prefix_MAVEN_REPO_HOST

repo.example.com

Maven repository host (if not using fully defined url; will fallback to service)

prefix_MAVEN_REPO_ID

my-repo-id

Maven repository id

prefix_MAVEN_REPO_LAYOUT

default

Maven repository layout

prefix_MAVEN_REPO_NAME

my-repo-name

Maven repository name

prefix_MAVEN_REPO_PASSPHRASE

maven1!

Maven repository passphrase

prefix_MAVEN_REPO_PASSWORD

maven1!

Maven repository password

prefix_MAVEN_REPO_PATH

/maven2/

Maven repository path (if not using fully defined url; will fallback to service)

prefix_MAVEN_REPO_PORT

8080

Maven repository port (if not using fully defined url; will fallback to service)

prefix_MAVEN_REPO_PRIVATE_KEY

${user.home}/.ssh/id_dsa

Maven repository private key

prefix_MAVEN_REPO_PROTOCOL

http

Maven repository protocol (if not using fully defined url; will fallback to service)

prefix_MAVEN_REPO_RELEASES_CHECKSUM_POLICY

warn

Maven repository releases checksum policy

prefix_MAVEN_REPO_RELEASES_ENABLED

true

Maven repository releases enabled

prefix_MAVEN_REPO_RELEASES_UPDATE_POLICY

always

Maven repository releases update policy

prefix_MAVEN_REPO_SERVICE

buscentr-myapp

Maven repository service to lookup if prefix_MAVEN_REPO_URL not specified

prefix_MAVEN_REPO_SNAPSHOTS_CHECKSUM_POLICY

warn

Maven repository snapshots checksum policy

prefix_MAVEN_REPO_SNAPSHOTS_ENABLED

true

Maven repository snapshots enabled

prefix_MAVEN_REPO_SNAPSHOTS_UPDATE_POLICY

always

Maven repository snapshots update policy

prefix_MAVEN_REPO_URL

http://repo.example.com:8080/maven2/

Maven repository url (fully defined)

prefix_MAVEN_REPO_USERNAME

mavenUser

Maven repository username