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 theauthTokenPropagationEnabled
andtransactionTokenEnabled
properties in thetcs-docker-swarm.yaml
file. This file is located in theinstallation_directory/otmm-<version>/otmm/docker-swarm
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 theYAML
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 theYAML
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 containstcs-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