4.1 Push Images to a Remote Docker Repository

The installation bundle that you have downloaded to your local system contains a Docker image of MicroTx and the MicroTx console.

Load these image to your local repository, and then push the images to a remote Docker repository. Kubernetes pulls these images from the remote repository to install MicroTx and the MicroTx console. Use the console to manage the transactions.

If you are using Oracle Cloud Infrastructure Registry, see Push an Image to Oracle Cloud Infrastructure Registry. If you are using other Kubernetes platforms, use the instructions provided in this section.

Before you begin, complete the following tasks:

• Identify a remote private repository to which you want to upload the container image. You can create a new remote Docker repository or use an existing one. Use a private repository to limit access. When you use a remote Docker repository, you have to push images to the remote Docker repository only once, while you can pull an image multiple times onto any Kubernetes cluster that you create.
• Create a Kubernetes secret to access the remote Docker repository. See Create a Kubernetes Secret to Access Docker Registry.

Perform the following steps to push the Docker images of MicroTx and console to a remote Docker repository:

1. Provide credentials to log in to the remote private repository to which you want to push the image.

   docker login <repo>

   Provide the login credentials based on the Kubernetes platform that you are using.

2. Load the images to the local Docker repository.
   1. Load the MicroTx image to the local Docker repository. The MicroTx image is located at installation_directory/otmm-RELEASE/otmm/image/tmm-RELEASE.tgz.

      cd installation_directory/otmm-RELEASE/otmm
      docker load < image/tmm-RELEASE.tgz

      The following message is displayed when the image is loaded.

      Loaded image: tmm:RELEASE

   2. Load the console image to the local Docker repository. The console image is located at installation_directory/otmm-RELEASE/console/image/Console-RELEASE.tgz.

      cd installation_directory/otmm-RELEASE/console
      docker load < image/Console-RELEASE.tgz

      The following message is displayed when the image is loaded.

      Loaded image: Console:RELEASE

3. Use the following commands to specify a unique tag for the images that you want to push to the remote Docker repository.

   Syntax

   docker tag local_image_tag remote_image_tag

   Where,

   • local_image_tag is the tag with which the image is identified in your local repository.
   • remote_image_tag is the tag with which you want to identify the image in the remote Docker repository.

   Sample Commands

   docker tag tmm:RELEASE <region-key>.ocir.io/otmmrepo/tmm:RELEASE
   docker tag console:RELEASE <region-key>.ocir.io/otmmrepo/console:RELEASE

   Where, <region-key>.ocir.io/otmmrepo is the remote Docker registry to which you want to push the image files, tmm:RELEASE and console:RELEASE. Provide the registry details based on your environment.

4. Push the Docker images from your local repository to the remote Docker repository.

   Syntax

   docker push remote_image_tag

   Sample Commands

   docker push <region-key>.ocir.io/otmmrepo/tmm:RELEASE
   docker push <region-key>.ocir.io/otmmrepo/console:RELEASE

Note down the tag of the Docker image in the remote Docker repository. You'll need to enter this tag while pulling the image from the remote Docker repository.