// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. // SPDX-License-Identifier: CC-BY-SA-4.0 # Introduction This document describes the steps to install the demonstration of Saga - Orchestration pattern. - [Introduction](#introduction) - [Pre-requisites](#pre-requisites) - [Clean-up](#clean-up) ## Pre-requisites An AWS account with full admininstrator access - _not_ the root account - should be used. ## Clean-up 1. Launch a EC2 instance with the Amazon Linux 2 AMI with the following guidelines. 1. Instance type could be as small as `t2.micro`. 2. **Strongly recommend** to use Spot instance to reduce costs. 3. Launch in the same region where the cluster is to be launched. 4. Launch the instance with public IP address with port `22` opened for `ssh` access. 2. Once the instance is launched, connect to it with `ssh` and run the following commands. ```bash sudo yum update -y && sudo yum install -y git git clone https://github.com/aws-samples/amazon-eks-saga-choreography ``` 3. Configure `aws` CLI with `aws configure` for an IAM user that has administrator access. 4. Define the following environment variables. ```bash export REGION_ID= export ACCOUNT_ID= # Do not change this. export GIT_URL=https://github.com/aws-samples ``` 5. Run the following commands to remove the installation. ```bash cd amazon-eks-saga-choreography/scripts ./cleanup.sh ``` 6. Terminate EC2 instance. You can also browse the instructions for each repository as listed below. | Repository | Remarks | | ---------------------------------------------------------------------------------------------------- | ----------------------------------------- | | [`eks-saga-aws`](https://github.com/aws-samples/amazon-eks-saga-choreography-aws) | AWS IAM, SQS, SNS and Amazon ECR objects. | | [`eks-saga-db`](https://github.com/aws-samples/amazon-eks-saga-choreography-db) | AWS RDS (MySQL) database. | | [`eks-saga-cluster`](https://github.com/aws-samples/amazon-eks-saga-choreography-cluster) | Amazon EKS cluster. | | [`eks-saga-orders`](https://github.com/aws-samples/amazon-eks-saga-choreography-orders) | Orders microservice. | | [`eks-saga-ordersrb`](https://github.com/aws-samples/amazon-eks-saga-choreography-orders-rb) | Orders rollback microservice. | | [`eks-saga-inventory`](https://github.com/aws-samples/amazon-eks-saga-choreography-inventory) | Inventory microservice. | | [`eks-saga-audit`](https://github.com/aws-samples/amazon-eks-saga-choreography-audit) | Audit microservice. | | [`eks-saga-trail`](https://github.com/aws-samples/amazon-eks-saga-choreography-trail) | Trail microservice. |