Testing the customizations

Complete this task to test your Order Hub customizations for containers.

Procedure

- For containers:

  1. When you run Order Hub in the DTK, it runs in two containers:
    1. The base container has the IBM modules that are part of Order Hub.
    2. The extension container is an empty image builds that the user interface connects to.
  2. To test a customized image in the DTK, an additional set of containers are deployed. A second base container is deployed with a different configuration that allows it to connect to the customized image. Your extension container is deployed and will be called by the user interface. The set of containers used for customization testing use different ports than the regular Order Hub containers. Both sets of containers can be run at the same time.
  3. To setup for customization testing in the DTK:
    1. Edit the devtoolkit_docker/compose/om-compose.properties file and set the variables ORDERHUB_EXT_CUSTOM_IMAGE and ORDERHUB_EXT_CUSTOM_TAG to the values used in build-customization.sh for image_name and image_tag.
      ORDERHUB_EXT_CUSTOM_IMAGE=om-orderhub-ext
      ORDERHUB_EXT_CUSTOM_TAG=mycompany-2022-05-30-1755
    2. Run the following script:
      ./om-compose.sh setup-orderhub-custom
    3. Go to the following URL:
      https://<HOST>:<OH_BASE_CUSTOM_HTTPS_PORT>/order-management/
      <HOST> is localhost, or the host on which the Order Hub containers are running. The default port is 7444 unless you set the OH_BASE_CUSTOM_HTTPS_PORT property in the devtoolkit_docker/compose/om-compose.properties file. For example,
      https://localhost:7444/order-management/
  4. When the customization container is updated:
    1. If necessary, update ORDERHUB_EXT_CUSTOM_IMAGE and ORDERHUB_EXT_CUSTOM_TAG in om-compose.properties
    2. Run ./om-compose.sh setup-orderhub-custom
    The following commands can be used to manage Order Hub containers:
    ./om-compose.sh <command> <option>
    command can be:
    start
    stop
    restart
    option can be:
    orderhub - to run the command on both Order Hub images
    customorderhub - to run the command on both Order Hub images used for customization testing.
    orderhubbase - to run the command on the base Order Hub image
    orderhubext - to run the command on the extension Order Hub image
    customorderhubbase - to run the command on the base Order Hub image used for customization testing.
    customorderhubext - to run the command on the extension Order Hub image used for customization testing.

What to do next

Deploying customizations. For more information, see Deploying the customizations.