B Install on Docker Swarm

You can install Transaction Manager for Microservices (MicroTx) in Docker Swarm or in a Kubernetes cluster.

Follow the instructions in this section to install MicroTx in Docker Swarm and run sample applications. You can create a similar configuration to install MicroTx in other supported environments. If you want to install MicroTx on a Kubernetes cluster, skip this section and see Install on a Kubernetes Cluster.

Note:

The instructions provided in this section are specific to test or development environments. Do not use these instructions to set up and use Transaction Manager for Microservices in production environments.

• Set Up Docker Swarm
  
• Create a Registry
  Because a swarm consists of multiple Docker Engines, a registry is required to distribute images to all of them.
• Push Image to a Docker Registry
  The installation bundle that you have downloaded to your local system contains a Docker image of MicroTx. Push this image to the registry that you have created in Docker.
• Create Encryption Key and Key Pair
  Perform this task only if you want to enable the authTokenPropagationEnabled and transactionTokenEnabled properties in the tcs-docker-swarm.yaml file. This file is located in the installation_directory/otmm-<version>/samples/docker folder.
• Create a Docker Secret for Oracle Database Credentials
  MicroTx supports using Oracle Database as a persistent store to keep track of the transaction information. You must provide the Oracle Database credentials in the YAML file. MicroTx uses the credentials to establish a connection to the database after the service is installed.
• Update YAML files with etcd Details
  You must provide etcd credentials and etcd endpoints in the YAML files for the transaction coordinator. MicroTx uses this information to establish a connection to etcd after the service is installed.
• Configure the tcs-docker-swarm.yaml File
  The installation bundle contains tcs-docker-swarm.yaml file, the manifest file of the application, which contains the deployment configuration details for MicroTx.
• Configure Secure Connection for Your Apps
  
• Access MicroTx in Docker Swarm