Customizing the Tooling Web Docker container
Customize the Tooling Web Docker container to update, modify, or extend business user tooling for any Angular-based tools, otherwise known as the Tooling single-page application (SPA), within Management Center for HCL Commerce.
Before you begin
- To customize the
tooling-web
container, you must first obtain the Tooling git bundle. See Downloading HCL Commerce software. - Review the Tooling-specific documentation within the README.md readme file.
Beginning in HCL Commerce 9.1.14.0, application container images are built to be run as a non-root user by default. This change has the potential to break your custom deployment. Therefore, you must review this change and its potential impacts. For more information, see HCL Commerce container users and privileges.
About this task
tooling-web
.When you modify
the default tooling-web
container, you must apply any future container updates
from HCL manually, or re-apply, and re-test your customizations on subsequent versions of the
container.
Procedure
-
In your HCL Commerce development environment, customize the Tooling SPA.
Be sure to start the server and test your changes locally.Important: Ensure that you save and make back ups of your customizations.
-
Build the custom Tooling Web Docker container image with your changes.
Changes that are made locally are created in the commerce-tooling/build/dist/ directory.
In your Dockerfile, copy over the customization and replace the default code within the /SETUP/app/tooling/ directory of the Tooling Web Docker container (
tooling-web
) Docker image.COPY -chown=comuser:comuser commerce-tooling/build/dist/ /SETUP/app/tooling/
For releases of HCL Commerce 9.1.0.0 to 9.1.13.0:COPY commerce-tooling/build/dist/ /SETUP/app/tooling/
- Deploy your custom Docker image to your Docker repository, and then to the environments where they will be used.
Results
tooling-web
container is updated and deployed
within your HCL Commerce environments. Business users that work on Angular-based
tooling in Management Center will observe and interact with the customizations made to the
Tooling SPA.