Commerce Container

A specific project build for running commerce in a container and be compatible with Jumpmind's Helm chart.

Jumpmind Docker Registry Authentication

Jumpmind provides pre-compiled artifacts for both linux/arm64/v8 and linux/amd64 platforms for all the components of commerce (Point-of-Sale, Unified Promotion Engine, Central Promote, and Electronic Journal). In order access these images you will be required to authenticate with Jumpmind's container registry. Note that you should only be required to configure the authentication with Docker once and Docker should be able to remember for the remainder of your machine's lifetime.

You can authenticate with the registry by using the provided credentials (checked in next to this README.md file) on Linux or macOS like this:

cat .jumpmind-registry-credentials | docker login -u _json_key_base64 --password-stdin https://us-east5-docker.pkg.dev

or on Windows like this:

docker login -u _json_key_base64 --password-stdin https://us-east5-docker.pkg.dev < .jumpmind-registry-credentials

After authenticating docker, you should receive a "Login Succeeded!" message. If you receive an error, please check your authentication command again and contact Jumpmind regarding issues authenticating with the provided credentials.

Once authenticated, you may now refer to the "Jumpmind Provided Container Images" section for details on how to pull each Jumpmind component locally.

Jumpmind Helm OCI Registry Authentication

In addition to pre-compiled containers for Jumpmind Commerce, Jumpmind also provides a Helm chart that orchestrates the deployment of various Jumpmind Commerce products. In order pull the chart using the Helm CLI, you need to authenticate the CLI with the registry. You may re-use the same credentials that were used for authenticating the Docker Registry.

cat .jumpmind-registery-credentials | helm registry login -u _json_key_base64 --password-stdin https://us-east5-docker.pkg.dev

or on Windows like this:

helm login -u _json_key_base64 --password-stdin https://us-east5-docker.pkg.dev < .jumpmind-registry-credentials

After authenticating helm you should receive a "Login Succeeded" message. If you receive an error, please check your authentication command again and contact Jumpmind regarding issues authenticating with the provided credentials.

Once authenticated, you may refer to the "Jumpmind Provided Helm Charts" sections fro details on how to pull each chart locally.

Jumpmind Provided Container Images

Jumpmind provides pre-compiled artifacts for both linux/arm64/v8 and linux/amd64 platforms for all the components of commerce. All components, besides Point-of-Sale, can be used out of the box with the Jumpmind provided Helm Chart with no modifications.

You may pull any image you need with the following command replacing <component> with the desired component (refer to table below for details on available components):

docker pull us-east5-docker.pkg.dev/jumpmind-customer-<customer-name>/commerce-container/<component>:<version-tag>

By default, docker will pull the image that is compatible with your platform. You may explicitly pull a desired architecture image using the --platform argument:

docker pull --platform linux/arm64 us-east5-docker.pkg.dev/jumpmind-customer-<customer-name>/commerce-container/<component>:<version-tag>

Available Container Images

Available containers in your customer repository are dependant on subscription

Component	For Out-of-Box Use
pos
central	:white_check_mark:
jmc-electronic-journal	:white_check_mark:
unified-promo-engine	:white_check_mark:
symds	:white_check_mark:
inventory	:white_check_mark:
shopkeeper	:white_check_mark:
clienteling	:white_check_mark:
state-relay	:white_check_mark:
vertex-integration	:white_check_mark:

Jumpmind Provided Helm Charts

In order to pull the Jumpmind commerce charts, you first need to be authenticated. Refer to the Jumpmind Helm OCI Registry Authentication section first.

Once authenticated you can pull any of the provided images using the helm pull command. This command will pull the chart and dump it into a tarball in your working directory. The tarball will be in the format of <chart-name>-<chart-version>.tar.gz (eg. commerce-24.1.0-pre-release.tar.gz).

The full command to pull is the following, where <chart-name> and <version> should be replaced with the desired chart and respective version referenced from the table below:

helm pull --version <version> oci://us-east5-docker.pkg.dev/jumpmind-customer-<customer-name>/commerce-charts/<chart-name>

Available Helm Charts

Component
commerce
jmc-electronic-journal