[17.0.0.3 and later]

Liberty Helm chart

To deploy customized Liberty applications to IBM Cloud Private, use a Helm chart. With a Helm chart, set metadata and rules for how the Liberty image is deployed in the Kubernetes cluster.

Requirements

Updates to this topic are available in GitHub. See the Liberty Helm chart Readme file, for the latest configuration information.

The Helm chart expects the following directories to be linked in the Docker image:
/config
The Liberty configuration directory.
/logs
The logs directory.
/output
The output directory.
If a user uses our Dockerfile from the websphere-liberty Docker hub, then these links already exist, and no action is required. However, if you want to build your own dockerfile from scratch, then add the following lines to make the links:
ENV LOG_DIR /logs
ENV WLP_OUTPUT_DIR /opt/ibm/wlp/output
RUN mkdir /logs
&& ln -s $WLP_OUTPUT_DIR/defaultServer /output
&& ln -s /opt/ibm/wlp/usr/servers/defaultServer /config
[18.0.0.1 and later]

Transaction service

A persistent volume is required, if you plan to use the transaction service within Liberty. Configure the Liberty server.xml file to place the transaction log on this volume so that the log persists, if a failure occurs and the server must restart. Update this line in the server.xml file:
<transaction recoverOnStartup="true" waitForRecovery="true" />

Accessing Liberty

From a browser, use http://external_ip:nodeport to access the application.

Configuration parameters

The Helm chart has the values that you can override by using the install --set parameter or by using the user interface.
helm install --name liberty1 --namespace liberty-test1 liberty --debug

View the configuration parameters in the Liberty Helm chart Readme file. To deploy applications through the command line, see Deploying Liberty applications into IBM Cloud Private with a Liberty Helm chart.

After you configure the Helm chart, you can configure the Liberty server transaction log for availability. See Deploying applications in Liberty for more information about deploying the Liberty server.


Icon that indicates the type of topic Reference topic

File name: rwlp_icp_helm.html