OpenLiberty / OpenLiberty/ci.docker

Document the approach to copy ear/war contents instead of using autoExpand

Open
#467 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

zenhub-dev
Dominant language
Shell
Stars
48
Forks
60
Avg merge
3h 2m
Merged PRs (30d)
3

Description

Document that customers should copy the expanded ear/war at image build time instead of using autoExpand

When <applicationManager autoExpand="true" /> is set in Liberty server configuration and RUN configure.sh is called, the application will be expanded as part of the server start and stop process to generate shared class cache (SCC) to speed up startup time. This will result in the application image containing the app content twice - one as war, the other as expanded directory. This won't be a concern for applications are small in size. But it can significantly increase the image size when the application size is big.

Sample:

FROM icr.io/appcafe/open-liberty:kernel-slim-java11-openj9-ubi
COPY --chown=1001:0 src/main/liberty/config /config
RUN features.sh
COPY --chown=1001:0 target/app-name/ /config/apps/app-name.war/
RUN configure.sh

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the Dockerfile example in the issue and locate the existing documentation for Liberty application expansion and autoExpand. Document the image-build approach of copying the expanded EAR/WAR contents instead, including why autoExpand can duplicate application content; done when customers can follow the guidance without relying on autoExpand.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker
Domain
devops, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.