├── src
    ├── __init__.py
    ├── app
    │   ├── __init__.py
    │   ├── costs_manager.py
    │   └── main.py
    ├── requirements.txt
    ├── Dockerfile
    └── docker-compose.yml
├── tests
    ├── __init__.py
    ├── unit
    │   ├── __init__.py
    │   ├── test_costs_manager.py
    │   └── test_main.py
    └── integration
    │   ├── __init__.py
    │   └── locustfile.py
├── cdk
    ├── .npmignore
    ├── .gitignore
    ├── jest.config.js
    ├── cdk.json
    ├── package.json
    ├── tsconfig.json
    ├── bin
    │   └── cdk.ts
    └── lib
    │   └── cdk-stack.ts
├── assets
    ├── SantiagoGarciaArangoCDK.png
    ├── aws-cdk-ecs-api-architecture.png
    └── aws-cdk-ecs-api-architecture.drawio
├── commands_python.sh
├── pyproject.toml
├── commands_cdk.sh
├── .gitignore
├── README.md
└── LICENSE


/src/__init__.py:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/tests/__init__.py:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/src/app/__init__.py:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/tests/unit/__init__.py:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/tests/integration/__init__.py:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/src/requirements.txt:
--------------------------------------------------------------------------------
1 | fastapi[all]
2 | boto3
3 | 


--------------------------------------------------------------------------------
/cdk/.npmignore:
--------------------------------------------------------------------------------
1 | *.ts
2 | !*.d.ts
3 | 
4 | # CDK asset staging directory
5 | .cdk.staging
6 | cdk.out
7 | 


--------------------------------------------------------------------------------
/assets/SantiagoGarciaArangoCDK.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/san99tiago/aws-cdk-ecs-api/HEAD/assets/SantiagoGarciaArangoCDK.png


--------------------------------------------------------------------------------
/assets/aws-cdk-ecs-api-architecture.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/san99tiago/aws-cdk-ecs-api/HEAD/assets/aws-cdk-ecs-api-architecture.png


--------------------------------------------------------------------------------
/cdk/.gitignore:
--------------------------------------------------------------------------------
1 | *.js
2 | !jest.config.js
3 | *.d.ts
4 | node_modules
5 | 
6 | # CDK asset staging directory
7 | .cdk.staging
8 | cdk.out
9 | 


--------------------------------------------------------------------------------
/cdk/jest.config.js:
--------------------------------------------------------------------------------
1 | module.exports = {
2 |   testEnvironment: 'node',
3 |   roots: ['<rootDir>/test'],
4 |   testMatch: ['**/*.test.ts'],
5 |   transform: {
6 |     '^.+\\.tsx?$': 'ts-jest'
7 |   }
8 | };
9 | 


--------------------------------------------------------------------------------
/src/Dockerfile:
--------------------------------------------------------------------------------
 1 | FROM python:3.9
 2 | 
 3 | LABEL maintainer="Santiago Garcia Arango [san99tiago]"
 4 | 
 5 | WORKDIR /code
 6 | 
 7 | COPY ./requirements.txt /code/requirements.txt
 8 | 
 9 | RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
10 | 
11 | COPY ./app /code/app
12 | 
13 | CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "80"]
14 | 


--------------------------------------------------------------------------------
/cdk/cdk.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "app": "npx ts-node --prefer-ts-exts bin/cdk.ts",
 3 |   "watch": {
 4 |     "include": ["**"],
 5 |     "exclude": [
 6 |       "README.md",
 7 |       "cdk*.json",
 8 |       "**/*.d.ts",
 9 |       "**/*.js",
10 |       "tsconfig.json",
11 |       "package*.json",
12 |       "yarn.lock",
13 |       "node_modules",
14 |       "test"
15 |     ]
16 |   }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/docker-compose.yml:
--------------------------------------------------------------------------------
 1 | # Run with:
 2 | # --> docker-compose up --build
 3 | 
 4 | version: "3.8"
 5 | 
 6 | services:
 7 |   fastapi:
 8 |     container_name: fastapi_app
 9 |     build: .
10 |     ports:
11 |       - "8080:80"
12 |     networks:
13 |       - docker_apis_and_apps
14 | 
15 | networks:
16 |   docker_apis_and_apps:
17 |     driver: bridge
18 |     name: docker_apis_and_apps
19 | 


--------------------------------------------------------------------------------
/src/app/costs_manager.py:
--------------------------------------------------------------------------------
 1 | import datetime
 2 | import boto3
 3 | 
 4 | ce = boto3.client("ce")
 5 | 
 6 | 
 7 | def get_costs_ongoing_month():
 8 |     today = datetime.date.today()
 9 |     start = today.replace(day=1).strftime("%Y-%m-%d")
10 |     end = today.strftime("%Y-%m-%d")
11 |     response = ce.get_cost_and_usage(
12 |         TimePeriod={
13 |             "Start": start,
14 |             "End": end,
15 |         },
16 |         Granularity="DAILY",
17 |         Metrics=["NetUnblendedCost"],
18 |         GroupBy=[{"Type": "DIMENSION", "Key": "LINKED_ACCOUNT"}],
19 |     )
20 |     return response["ResultsByTime"]
21 | 


--------------------------------------------------------------------------------
/cdk/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "ecs-api",
 3 |   "version": "1.0.0",
 4 |   "bin": {
 5 |     "cdk": "bin/cdk.js"
 6 |   },
 7 |   "scripts": {
 8 |     "build": "tsc",
 9 |     "watch": "tsc -w",
10 |     "cdk": "cdk"
11 |   },
12 |   "devDependencies": {
13 |     "@types/jest": "^27.5.0",
14 |     "@types/node": "10.17.27",
15 |     "@types/prettier": "2.6.0",
16 |     "jest": "^27.5.1",
17 |     "ts-jest": "^27.1.4",
18 |     "aws-cdk": "2.25.0",
19 |     "ts-node": "^10.7.0",
20 |     "typescript": "~3.9.7"
21 |   },
22 |   "dependencies": {
23 |     "aws-cdk-lib": "2.25.0",
24 |     "constructs": "^10.0.0",
25 |     "source-map-support": "^0.5.21"
26 |   }
27 | }
28 | 


--------------------------------------------------------------------------------
/cdk/tsconfig.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "compilerOptions": {
 3 |     "target": "ES2018",
 4 |     "module": "commonjs",
 5 |     "lib": [
 6 |       "es2018"
 7 |     ],
 8 |     "declaration": true,
 9 |     "strict": true,
10 |     "noImplicitAny": true,
11 |     "strictNullChecks": true,
12 |     "noImplicitThis": true,
13 |     "alwaysStrict": true,
14 |     "noUnusedLocals": false,
15 |     "noUnusedParameters": false,
16 |     "noImplicitReturns": true,
17 |     "noFallthroughCasesInSwitch": false,
18 |     "inlineSourceMap": true,
19 |     "inlineSources": true,
20 |     "experimentalDecorators": true,
21 |     "strictPropertyInitialization": false,
22 |     "typeRoots": [
23 |       "./node_modules/@types"
24 |     ]
25 |   },
26 |   "exclude": [
27 |     "node_modules",
28 |     "cdk.out"
29 |   ]
30 | }
31 | 


--------------------------------------------------------------------------------
/tests/integration/locustfile.py:
--------------------------------------------------------------------------------
 1 | # LOAD BALANCER TESTS TO VALIDATE ECS SERVICE SCALING UP AND DOWN THE ECS TASKS
 2 | # Usage:
 3 | # 1) Install required library for load testing (locust):
 4 | #    --> "pip install -r requirements.txt"
 5 | # 2) Run the Locust app as follows:
 6 | #    --> "python -m locust"
 7 | # 3) Go to Locust Web Portal
 8 | #    --> http://0.0.0.0:8089 (open local window)
 9 | # 4) Run the Locust testing tool with the necessary test requirements
10 | #    --> Users, SpawnRate, Host, etc...
11 | # 5) Wait for the magic of the ASG alarms being activated and the ECS services
12 | #    updating the total value of tasks based on load
13 | 
14 | 
15 | from locust import HttpUser, task
16 | 
17 | 
18 | class ApiConsumerUser(HttpUser):
19 |     @task
20 |     def default(self):
21 |         self.client.get("/")
22 |         self.client.get("/status")
23 | 


--------------------------------------------------------------------------------
/tests/unit/test_costs_manager.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | from src.app.costs_manager import get_costs_ongoing_month
 3 | 
 4 | 
 5 | def test_get_costs_ongoing_month(mocker):
 6 |     mocker.patch(
 7 |         "src.app.costs_manager.ce.get_cost_and_usage",
 8 |         return_value={
 9 |             "ResultsByTime": [
10 |                 {
11 |                     "TimePeriod": {"Start": "2023-05-01", "End": "2023-05-02"},
12 |                     "Groups": [
13 |                         {
14 |                             "Keys": ["123456789012"],
15 |                             "Metrics": {
16 |                                 "NetUnblendedCost": {"Amount": "-1.23", "Unit": "USD"}
17 |                             },
18 |                         }
19 |                     ],
20 |                     "Total": {},
21 |                     "Estimated": True,
22 |                 }
23 |             ]
24 |         },
25 |     )
26 |     costs = get_costs_ongoing_month()
27 |     assert len(costs) == 1
28 |     assert costs[0]["TimePeriod"]["Start"] == "2023-05-01"
29 |     assert costs[0]["Groups"][0]["Keys"][0] == "123456789012"
30 |     assert costs[0]["Groups"][0]["Metrics"]["NetUnblendedCost"]["Amount"] == "-1.23"
31 | 


--------------------------------------------------------------------------------
/src/app/main.py:
--------------------------------------------------------------------------------
 1 | # SAMPLE PYTHON FAST-API APP FOR ECS DOCKER IMAGE TESTS
 2 | # - Santiago Garcia Arango
 3 | # - Fredy Andres Montano
 4 | 
 5 | import os
 6 | from fastapi import FastAPI, Response, status
 7 | 
 8 | from .costs_manager import get_costs_ongoing_month
 9 | 
10 | app = FastAPI(
11 |     description="Simple FastAPI to demo AWS integrations",
12 |     version="0.1.0",
13 | )
14 | 
15 | os_env_json = {}
16 | for key, value in os.environ.items():
17 |     os_env_json[key] = value
18 | 
19 | 
20 | @app.get("/")
21 | def get_root() -> dict:
22 |     return {
23 |         "Message": "Hello from Santi. This is a simple API to return current cost of AWS of the ongoing month",
24 |         "OS Details": os_env_json,
25 |     }
26 | 
27 | 
28 | @app.get("/status")
29 | def get_status() -> dict:
30 |     return {"Status": "Healthy"}
31 | 
32 | 
33 | @app.get("/costs", status_code=status.HTTP_200_OK)
34 | def get_costs_month(response: Response) -> dict:
35 |     try:
36 |         costs = get_costs_ongoing_month()
37 |     except Exception as e:
38 |         response.status_code = status.HTTP_500_INTERNAL_SERVER_ERROR
39 |         return {
40 |             "Message": "There was a handled exception in the processing of the request",
41 |             "Details": str(e),
42 |         }
43 |     return {
44 |         "Message": "This response corresponds to the monthly costs of this AWS account so far",
45 |         "Costs": costs,
46 |     }
47 | 


--------------------------------------------------------------------------------
/cdk/bin/cdk.ts:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env node
 2 | import 'source-map-support/register';
 3 | import * as cdk from 'aws-cdk-lib';
 4 | import { CdkEcsApi } from '../lib/cdk-stack';
 5 | 
 6 | // Ensure environment variable called "DEPLOYMENT_ENVIRONMENT" is defined
 7 | if (process.env.DEPLOYMENT_ENVIRONMENT == undefined) {
 8 |   console.error("ERROR: you MUST provide <DEPLOYMENT_ENVIRONMENT> as an environment variable");
 9 |   process.exit(1);
10 | }
11 | 
12 | const DEPLOYMENT_ENVIRONMENT = process.env.DEPLOYMENT_ENVIRONMENT;
13 | const MAIN_RESOURCES_NAME = "ecs-api";
14 | 
15 | 
16 | const app = new cdk.App();
17 | const myCdkStack = new CdkEcsApi(
18 |   app,
19 |   MAIN_RESOURCES_NAME,
20 |   DEPLOYMENT_ENVIRONMENT,
21 |   MAIN_RESOURCES_NAME,
22 |   {
23 |     stackName: `cdk-${MAIN_RESOURCES_NAME}-${DEPLOYMENT_ENVIRONMENT}`,
24 |     env: { account: process.env.CDK_DEFAULT_ACCOUNT, region: process.env.CDK_DEFAULT_REGION },
25 |     description: `Stack with the infrastructure for ${MAIN_RESOURCES_NAME} in ${DEPLOYMENT_ENVIRONMENT} environment`
26 |   }
27 | );
28 | 
29 | cdk.Tags.of(myCdkStack).add('Environment', DEPLOYMENT_ENVIRONMENT);
30 | cdk.Tags.of(myCdkStack).add('MainResourcesName', MAIN_RESOURCES_NAME);
31 | cdk.Tags.of(myCdkStack).add('RepositoryUrl', 'https://github.com/san99tiago/aws-cdk-ecs-api')
32 | cdk.Tags.of(myCdkStack).add('Source', 'aws-cdk-ecs-api')
33 | cdk.Tags.of(myCdkStack).add('Owner', 'Santiago Garcia Arango - Andres Montano');
34 | cdk.Tags.of(myCdkStack).add('Usage', 'Simple API deployed on top of Docker container with ECS');
35 | 


--------------------------------------------------------------------------------
/commands_python.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | ################################################################################
 4 | # ------------------------------------------------------------------------------
 5 | # | PYTHON COMMANDS (FOR EXPLAINING ITS USAGE)
 6 | # ------------------------------------------------------------------------------
 7 | ################################################################################
 8 | 
 9 | # Install Python
10 | # -->  https://www.python.org/downloads/
11 | 
12 | # Verify that Python is installed correctly
13 | python --version
14 | 
15 | # Install Poetry for managing Python dependencies
16 | pip install poetry
17 | 
18 | # Configure Poetry to create virtual environments in the same folder
19 | poetry config virtualenvs.in-project true
20 | 
21 | # Install Python dependencies using Poetry
22 | poetry install
23 | 
24 | # Initialize interactive shell with Poetry
25 | poetry shell
26 | 
27 | # Add/remove Python main code dependency
28 | poetry add dependency_name
29 | poetry remove dependency_name
30 | 
31 | # Add/remove Python specific group dependency (for testing or other purpose)
32 | poetry add dependency_name --group test-unit
33 | poetry remove dependency_name --group test-unit
34 | 
35 | # Run poetry tasks for testing the source code (unit/integration tests)
36 | # --> Search inside "pyproject.toml" the poe tasks for details
37 | poe test-unit
38 | poe test-unit-html
39 | poe test-integration-load-manual
40 | poe test-integration-load-auto
41 | 
42 | # Finish/Exit the interactive shell with Poetry
43 | deactivate
44 | 


--------------------------------------------------------------------------------
/tests/unit/test_main.py:
--------------------------------------------------------------------------------
 1 | import pytest
 2 | from fastapi.testclient import TestClient
 3 | from src.app.main import app
 4 | 
 5 | 
 6 | @pytest.fixture
 7 | def client():
 8 |     return TestClient(app)
 9 | 
10 | 
11 | def test_get_root(client):
12 |     response = client.get("/")
13 |     assert response.status_code == 200
14 |     assert b"Hello from Santi" in response.content
15 | 
16 | 
17 | def test_get_status(client):
18 |     response = client.get("/status")
19 |     assert response.status_code == 200
20 |     assert b"Healthy" in response.content
21 | 
22 | 
23 | def test_get_costs_month_success(client, mocker):
24 |     mocker.patch(
25 |         "src.app.main.get_costs_ongoing_month",
26 |         return_value=[
27 |             {
28 |                 "TimePeriod": {"Start": "2023-05-01", "End": "2023-05-02"},
29 |                 # More fields here...
30 |             }
31 |         ],
32 |     )
33 |     response = client.get("/costs")
34 |     assert response.status_code == 200
35 |     assert b"This response corresponds to the monthly costs" in response.content
36 |     assert b"TimePeriod" in response.content
37 | 
38 | 
39 | def test_get_costs_month_failure(client, mocker):
40 |     mocker.patch(
41 |         "src.app.main.get_costs_ongoing_month", side_effect=Exception("Some Exception")
42 |     )
43 |     response = client.get("/costs")
44 |     assert response.status_code == 500
45 |     assert (
46 |         b"There was a handled exception in the processing of the request"
47 |         in response.content
48 |     )
49 |     assert b"Some Exception" in response.content
50 | 


--------------------------------------------------------------------------------
/pyproject.toml:
--------------------------------------------------------------------------------
 1 | [tool.poetry]
 2 | name = "aws-cdk-ecs-api"
 3 | version = "0.1.0"
 4 | description = "AWS FastAPI CDK deployment on top of ALB and ECS with Docker containers implementing ECS as the orchestration tool for an AWS-managed infrastructure"
 5 | authors = ["Santiago Garcia Arango <san99tiago>"]
 6 | license = "Apache License 2.0"
 7 | readme = "README.md"
 8 | packages = [{include = "src"}]
 9 | 
10 | [tool.poetry.dependencies]
11 | python = "^3.9"
12 | fastapi = {extras = ["all"], version = "^0.95.1"}
13 | uvicorn = {extras = ["standard"], version = "^0.22.0"}
14 | boto3 = "^1.26.133"
15 | 
16 | [tool.poetry.group.test-unit.dependencies]
17 | pytest-mock = "^3.10.0"
18 | pytest = "^7.3.1"
19 | 
20 | [tool.poetry.group.test-integration.dependencies]
21 | locust = "^2.15.1"
22 | 
23 | [tool.poetry.group.dev.dependencies]
24 | poethepoet = "^0.20.0"
25 | coverage = "^7.2.5"
26 | 
27 | [build-system]
28 | requires = ["poetry-core"]
29 | build-backend = "poetry.core.masonry.api"
30 | 
31 | [tool.poe.tasks]
32 | test-unit = "coverage run -m pytest tests/unit"
33 | test-unit-html = "coverage html"
34 | test-integration-load-manual = "locust -f tests/integration/locustfile.py"
35 | test-integration-load-auto = "locust -f tests/integration/locustfile.py --headless --host https://ecs-api.dev.san99tiago.com --users 20 --spawn-rate 1 --run-time 1m --csv=load_test_results"
36 | 
37 | [tool.pytest.ini_options]
38 | minversion = "7.0"
39 | addopts = "--junitxml=junit.xml"
40 | testpaths = [
41 |     "tests/unit",
42 |     "tests/integration",
43 | ]
44 | 
45 | [tool.coverage.run]
46 | branch = true
47 | source = ["src"]
48 | omit = [
49 |     "**/__init__.py"
50 | ]
51 | 
52 | [tool.coverage.report]
53 | show_missing = false
54 | exclude_lines =[
55 |     'pragma: no cover',
56 |     'def __repr__',
57 |     'if __name__ == .__main__.:',
58 | ]
59 | 


--------------------------------------------------------------------------------
/commands_cdk.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | ################################################################################
 4 | # ------------------------------------------------------------------------------
 5 | # |CDK COMMANDS (FOR EXPLAINING ITS USAGE)
 6 | # ------------------------------------------------------------------------------
 7 | ################################################################################
 8 | 
 9 | 
10 | ################################################################################
11 | # PART 1: Configure NodeJs and CDK libraries
12 | ################################################################################
13 | 
14 | # Install NodeJs
15 | # -->  https://nodejs.org/en/download/
16 | 
17 | # Verify that NodeJs/npm is installed correctly
18 | node --version
19 | npm --version
20 | 
21 | # Install AWS-CDK (on NodeJs)
22 | sudo npm install -g aws-cdk
23 | 
24 | # Verify correct install of AWS-CDK
25 | npm list --global | grep aws-cdk
26 | 
27 | 
28 | ################################################################################
29 | # PART 2: Initial Project Setup (Only run these at the beginning)
30 | ################################################################################
31 | 
32 | # Configure AWS credentials (follow steps, or use your preferred method)
33 | aws configure
34 | 
35 | # Bootstrap CDK (provision initial resources to work with CDK.. S3, roles, etc)
36 | #! Change "ACCOUNT-NUMBER-1" and "REGION-1" to your needed values
37 | cdk bootstrap aws://ACCOUNT-NUMBER-1/REGION-1
38 | 
39 | # Create the CDK project's folder
40 | mkdir cdk
41 | cd cdk || echo "Make sure that the folder exists"
42 | 
43 | # Initialize project
44 | cdk init --language python
45 | 
46 | # Install Node/TypeScript modules
47 | npm install .
48 | 
49 | 
50 | ################################################################################
51 | # PART 3: Main CDK commands (most used)
52 | ################################################################################
53 | 
54 | # Move to "cdk" folder (where the CDK config and deployment files are located)
55 | cd ./cdk || exit
56 | cdk deploy
57 | 
58 | # CDK commands
59 | cdk synthesize
60 | cdk diff
61 | cdk deploy
62 | cdk destroy
63 | 
64 | 
65 | ################################################################################
66 | # PART 4: Other CDK usefull commands
67 | ################################################################################
68 | 
69 | # Help
70 | cdk --help
71 | cdk command --help
72 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
  1 | ################################################################################
  2 | # OWN IGNORES
  3 | ################################################################################
  4 | # Temp files
  5 | temp.*
  6 | .DS_Store
  7 | 
  8 | # Poetry lock file (not all projects ignore it, but for this scenario, better)
  9 | poetry.lock
 10 | 
 11 | # CDK context
 12 | cdk.context.json
 13 | 
 14 | # Coverage reports
 15 | junit.xml
 16 | 
 17 | # Load test files (CSV files of load testing)
 18 | load_test_results*.csv
 19 | 
 20 | 
 21 | ################################################################################
 22 | # PYTHON GITIGNORE
 23 | # https://github.com/github/gitignore/blob/main/Python.gitignore
 24 | ################################################################################
 25 | # Byte-compiled / optimized / DLL files
 26 | __pycache__/
 27 | *.py[cod]
 28 | *$py.class
 29 | 
 30 | # C extensions
 31 | *.so
 32 | 
 33 | # Distribution / packaging
 34 | .Python
 35 | build/
 36 | develop-eggs/
 37 | dist/
 38 | downloads/
 39 | eggs/
 40 | .eggs/
 41 | # lib/
 42 | lib64/
 43 | parts/
 44 | sdist/
 45 | var/
 46 | wheels/
 47 | share/python-wheels/
 48 | *.egg-info/
 49 | .installed.cfg
 50 | *.egg
 51 | MANIFEST
 52 | 
 53 | # PyInstaller
 54 | #  Usually these files are written by a python script from a template
 55 | #  before PyInstaller builds the exe, so as to inject date/other infos into it.
 56 | *.manifest
 57 | *.spec
 58 | 
 59 | # Installer logs
 60 | pip-log.txt
 61 | pip-delete-this-directory.txt
 62 | 
 63 | # Unit test / coverage reports
 64 | htmlcov/
 65 | .tox/
 66 | .nox/
 67 | .coverage
 68 | .coverage.*
 69 | .cache
 70 | nosetests.xml
 71 | coverage.xml
 72 | *.cover
 73 | *.py,cover
 74 | .hypothesis/
 75 | .pytest_cache/
 76 | cover/
 77 | 
 78 | # Translations
 79 | *.mo
 80 | *.pot
 81 | 
 82 | # Django stuff:
 83 | *.log
 84 | local_settings.py
 85 | db.sqlite3
 86 | db.sqlite3-journal
 87 | 
 88 | # Flask stuff:
 89 | instance/
 90 | .webassets-cache
 91 | 
 92 | # Scrapy stuff:
 93 | .scrapy
 94 | 
 95 | # Sphinx documentation
 96 | docs/_build/
 97 | 
 98 | # PyBuilder
 99 | .pybuilder/
100 | target/
101 | 
102 | # Jupyter Notebook
103 | .ipynb_checkpoints
104 | 
105 | # IPython
106 | profile_default/
107 | ipython_config.py
108 | 
109 | # pyenv
110 | #   For a library or package, you might want to ignore these files since the code is
111 | #   intended to run in multiple environments; otherwise, check them in:
112 | # .python-version
113 | 
114 | # pipenv
115 | #   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
116 | #   However, in case of collaboration, if having platform-specific dependencies or dependencies
117 | #   having no cross-platform support, pipenv may install dependencies that don't work, or not
118 | #   install all needed dependencies.
119 | #Pipfile.lock
120 | 
121 | # poetry
122 | #   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
123 | #   This is especially recommended for binary packages to ensure reproducibility, and is more
124 | #   commonly ignored for libraries.
125 | #   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
126 | #poetry.lock
127 | 
128 | # pdm
129 | #   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
130 | #pdm.lock
131 | #   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
132 | #   in version control.
133 | #   https://pdm.fming.dev/#use-with-ide
134 | .pdm.toml
135 | 
136 | # PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
137 | __pypackages__/
138 | 
139 | # Celery stuff
140 | celerybeat-schedule
141 | celerybeat.pid
142 | 
143 | # SageMath parsed files
144 | *.sage.py
145 | 
146 | # Environments
147 | .env
148 | .venv
149 | env/
150 | venv/
151 | ENV/
152 | env.bak/
153 | venv.bak/
154 | 
155 | # Spyder project settings
156 | .spyderproject
157 | .spyproject
158 | 
159 | # Rope project settings
160 | .ropeproject
161 | 
162 | # mkdocs documentation
163 | /site
164 | 
165 | # mypy
166 | .mypy_cache/
167 | .dmypy.json
168 | dmypy.json
169 | 
170 | # Pyre type checker
171 | .pyre/
172 | 
173 | # pytype static type analyzer
174 | .pytype/
175 | 
176 | # Cython debug symbols
177 | cython_debug/
178 | 
179 | # PyCharm
180 | #  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
181 | #  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
182 | #  and can be added to the global gitignore or merged into this file.  For a more nuclear
183 | #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
184 | #.idea/


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # :trident: AWS-CDK-ECS-API :trident:
  2 | 
  3 | AWS FastAPI CDK deployment on top of ALB and ECS with Docker containers implementing ECS as the orchestration tool for an AWS-managed infrastructure.
  4 | 
  5 | ## Summary/Overview :memo:
  6 | 
  7 | - Deployed on AWS with Infrastructure as Code on [CDK-TypeScript](https://aws.amazon.com/cdk/).
  8 | - API developed with [FastAPI](https://fastapi.tiangolo.com/lo/).
  9 | - Unit and Integration Tests for the source code with [PyTest](https://docs.pytest.org/en/latest).
 10 | - Containerized solution with [Docker](https://www.docker.com) orchestrated by [Amazon ECS](https://aws.amazon.com/ecs/) (Fargate).
 11 | - Load Balancing managed with [ELB - Application Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/introduction.html) with listener ECS Service as target group.
 12 | - Public DNS records on top of [Route 53](https://aws.amazon.com/route53/) with Certificates on [AWS Certificate Manager](https://aws.amazon.com/certificate-manager/).
 13 | 
 14 | ## AWS Architecture Diagram :trophy:
 15 | 
 16 | The AWS infrastructure solution is deployed with CDK-TypeScript with the resources defined on the `cdk` folder:
 17 | 
 18 | <img src="assets/aws-cdk-ecs-api-architecture.png" width=80%> <br>
 19 | 
 20 | ## Folders Explained :scroll:
 21 | 
 22 | This repository consists of multiple folders/files, which are explained as follows:
 23 | 
 24 | - Infrastructure as Code ([`./cdk/`](./cdk/)).
 25 | - Source Code ([`./src/app/`](./src/app/)).
 26 | - Tests ([`./tests/`](./tests/))
 27 | - Docker containerization ([`./src/Dockerfile`](./src/Dockerfile)).
 28 | 
 29 | ## Usage :white_check_mark:
 30 | 
 31 | Follow these steps to configure the project locally:
 32 | 
 33 | ### Clone the repository
 34 | 
 35 | First, clone the repository:
 36 | 
 37 | ```bash
 38 | git clone https://github.com/san99tiago/aws-cdk-ecs-api
 39 | cd aws-cdk-ecs-api
 40 | ```
 41 | 
 42 | ### Configure Python
 43 | 
 44 | Review the step by step commands for the source code (Python) development and testing at:
 45 | 
 46 | - [`./commands_python.sh`](./commands_python.sh)
 47 | 
 48 | > Note: python dependencies for this project are managed by [Poetry](https://python-poetry.org). Review [`./pyproject.toml`](pyproject.toml) for details.
 49 | 
 50 | ### Configure CDK
 51 | 
 52 | Review the step by step commands for configuring the CDK at:
 53 | 
 54 | - [`./commands_cdk.sh`](./commands_cdk.sh)
 55 | 
 56 | > Note: for deploying or destroying the solution, see ("part 3") inside [`./commands_cdk.sh`](./commands_cdk.sh).
 57 | 
 58 | ## Dependencies :100:
 59 | 
 60 | ### Software
 61 | 
 62 | - [Visual Studio Code](https://code.visualstudio.com/) <br>
 63 |   Visual Studio Code is my main code editor for high-level programming. This is not absolutely necessary, but from my experience, it gives us a great performance and we can link it with Git and GitHub easily. <br>
 64 | 
 65 | - [NodeJs](https://nodejs.org/en/) <br>
 66 |   NodeJs is a JavaScript runtime built on Chrome's V8 JavaScript engine programming language. The community is amazing and lets us handle async functionalities in elegant ways. <br>
 67 | 
 68 | - [Python](https://www.python.org/) <br>
 69 |   Python is an amazing dynamic programming language that let us work fast, with easy and powerful integration of different software solutions. <br>
 70 | 
 71 | ### Tools
 72 | 
 73 | - [CDK CLI (Toolkit)](https://docs.aws.amazon.com/cdk/v2/guide/cli.html) <br>
 74 |   To work with the CDK, it is important to install the main toolkit as a NodeJs global dependency. Please refer to the official AWS [Getting started with the AWS CDK](https://docs.aws.amazon.com/cdk/v2/guide/getting_started.html)<br>
 75 | 
 76 | - [AWS CLI](https://aws.amazon.com/cli/) <br>
 77 |   The AWS Command Line Interface (AWS CLI) is a unified tool to manage your AWS services. We will use it for connecting to our AWS account from the terminal (authentication and authorization towards AWS). <br>
 78 | 
 79 | ## Special thanks :beers:
 80 | 
 81 | - I am grateful to the talented individuals who have dedicated their time and effort to develop the exceptional open-source projects that have been used in the creation of this solution. <br>
 82 | 
 83 | ## Author :musical_keyboard:
 84 | 
 85 | **Santiago Garcia Arango**
 86 | 
 87 | <table border="1">
 88 |     <tr>
 89 |         <td>
 90 |             <p align="center"><img src="assets/SantiagoGarciaArangoCDK.png" width=70%></p>
 91 |         </td>
 92 |         <td>
 93 |             <p align="center">As a curious DevOps Engineer, I am deeply passionate about implementing cutting-edge cloud-based solutions on AWS.<br> I firmly believe that today's greatest challenges must be solved by the expertise of individuals who are truly passionate about their work.
 94 |             </p>
 95 |         </td>
 96 |     </tr>
 97 | </table>
 98 | 
 99 | ## LICENSE
100 | 
101 | Copyright 2023 Santiago Garcia Arango
102 | 


--------------------------------------------------------------------------------
/cdk/lib/cdk-stack.ts:
--------------------------------------------------------------------------------
  1 | import { CfnOutput, Stack, StackProps } from 'aws-cdk-lib';
  2 | import { Construct } from 'constructs';
  3 | import * as iam from 'aws-cdk-lib/aws-iam';
  4 | import * as ssm from 'aws-cdk-lib/aws-ssm';
  5 | import * as ec2 from 'aws-cdk-lib/aws-ec2';
  6 | import * as ecs from 'aws-cdk-lib/aws-ecs';
  7 | import * as route53 from 'aws-cdk-lib/aws-route53';
  8 | import * as route53targets from 'aws-cdk-lib/aws-route53-targets';
  9 | import * as elasticloadbalancing from 'aws-cdk-lib/aws-elasticloadbalancingv2'
 10 | import * as acm from 'aws-cdk-lib/aws-certificatemanager';
 11 | import * as cloudwatch from 'aws-cdk-lib/aws-cloudwatch';
 12 | 
 13 | 
 14 | export class CdkEcsApi extends Stack {
 15 |   constructor(
 16 |     scope: Construct,
 17 |     id: string,
 18 |     deploymentEnvironment: string,
 19 |     mainResourcesName: string,
 20 |     props?: StackProps
 21 |   ) {
 22 |     super(scope, id, props);
 23 | 
 24 |     // Main variables based on environment variables and fixed values
 25 |     const ecsClusterName = deploymentEnvironment == 'prod' ? mainResourcesName : `${deploymentEnvironment}-${mainResourcesName}`;
 26 |     const hostedZoneName = deploymentEnvironment == 'prod' ? "san99tiago.com" : `${deploymentEnvironment}.san99tiago.com`;  // Example: "availia.io"
 27 |     const domainName = `ecs-api.${hostedZoneName}`;
 28 |     const applicationPort = 80;
 29 | 
 30 |     // Obtain extra IDs/variables from SSM Parameters
 31 |     const vpcId = ssm.StringParameter.valueFromLookup(this, `/${mainResourcesName}/${deploymentEnvironment}/vpc-id`);
 32 | 
 33 |     // TODO: uncomment if ALB already exists, otherwise, it's created bellow
 34 |     // const loadBalancerArn = ssm.StringParameter.valueFromLookup(this, `/${mainResourcesName}/${deploymentEnvironment}/alb-arn`);;
 35 | 
 36 |     // Obtain resource from existing VPC
 37 |     const vpc = ec2.Vpc.fromLookup(this, "VPC", {
 38 |       region: 'us-east-1',
 39 |       vpcId: vpcId,
 40 |     });
 41 | 
 42 |     // Obtain account R53 Hosted Zone for specific domain (previously created in account)
 43 |     const hostedZone = route53.HostedZone.fromLookup(this, 'HostedZone', {
 44 |       domainName: hostedZoneName
 45 |     });
 46 | 
 47 |     // Add SSL certificate
 48 |     // ! IMPORTANT: this is currently automatic, but if the R53 Hosted Zone is
 49 |     // ! ... in another account, this has to be done manually by DNS validation
 50 |     const certificate = new acm.DnsValidatedCertificate(this, 'Certificate', {
 51 |       domainName: domainName,
 52 |       hostedZone: hostedZone,
 53 |       subjectAlternativeNames: [`www.${domainName}`],  // To also allow the common 'www' prefix
 54 |       region: 'us-east-1',
 55 |     });
 56 |     certificate.metricDaysToExpiry().createAlarm(this, 'AlarmCertificateExpiration', {
 57 |       comparisonOperator: cloudwatch.ComparisonOperator.LESS_THAN_THRESHOLD,
 58 |       evaluationPeriods: 1,
 59 |       threshold: 45, // Automatic rotation happens between 60 and 45 days before expiry
 60 |     });
 61 | 
 62 |     // TODO: uncomment if ALB already exists, otherwise, it's created bellow
 63 |     // // Get Application load balancer (ALB) resource (previously created in account)
 64 |     // const alb = elasticloadbalancing.ApplicationLoadBalancer.fromLookup(this, 'ALB', {
 65 |     //   loadBalancerArn: loadBalancerArn
 66 |     // });
 67 | 
 68 |     // Create Application load balancer (ALB) resource (previously created in account)
 69 |     const alb = new elasticloadbalancing.ApplicationLoadBalancer(this, 'ALB', {
 70 |       vpc: vpc,
 71 |       vpcSubnets: { subnets: vpc.publicSubnets },
 72 |       internetFacing: true,
 73 |     });
 74 | 
 75 |     // ALB Security Group to provide a secure connection to the ALB on 443
 76 |     const albSG = new ec2.SecurityGroup(this, "SG-ALB", {
 77 |       vpc: vpc,
 78 |       allowAllOutbound: true,
 79 |     });
 80 | 
 81 |     albSG.addIngressRule(
 82 |       ec2.Peer.anyIpv4(),
 83 |       ec2.Port.tcp(443),
 84 |       "Allow HTTPS traffic"
 85 |     );
 86 | 
 87 |     alb.connections.addSecurityGroup(albSG);
 88 | 
 89 |     // Create ECS Cluster for service/tasks deployments
 90 |     const cluster = new ecs.Cluster(this, "ECS-Cluster", {
 91 |       clusterName: ecsClusterName,
 92 |       vpc: vpc,
 93 |     });
 94 | 
 95 |     // Role assumed by the task and its containers
 96 |     const taskRole = new iam.Role(this, "ECS-TaskRole", {
 97 |       assumedBy: new iam.ServicePrincipal("ecs-tasks.amazonaws.com"),
 98 |       description: "Role that the task definitions will use to run the code",
 99 |     });
100 | 
101 |     // TODO: Update role based on Containers needs (e.g. cost-explorer actions)
102 |     taskRole.attachInlinePolicy(
103 |       new iam.Policy(this, "ECS-TaskPolicy", {
104 |         statements: [
105 |           new iam.PolicyStatement({
106 |             effect: iam.Effect.ALLOW,
107 |             actions: ["ce:GetCostAndUsage", "ce:GetDimensionValues"],
108 |             resources: ["*"],
109 |           }),
110 |         ],
111 |       })
112 |     );
113 | 
114 |     // Task definition for ECS container
115 |     const taskDefinition = new ecs.TaskDefinition(this, "ECS-TaskDefinition", {
116 |       family: `${mainResourcesName}-task`,
117 |       compatibility: ecs.Compatibility.EC2_AND_FARGATE,
118 |       cpu: "256",
119 |       memoryMiB: "512",
120 |       networkMode: ecs.NetworkMode.AWS_VPC,
121 |       taskRole: taskRole,
122 |     });
123 | 
124 |     // The Docker container for the task definition
125 |     const container = taskDefinition.addContainer("ECS-Container", {
126 |       image: ecs.ContainerImage.fromAsset("../src/"),  // build and upload an image directly from a Dockerfile in "src" directory.
127 |       memoryLimitMiB: 512,
128 |       environment: {
129 |         EXAMPLE_KEY: "EXAMPLE_VALUE",
130 |         OWNERS: "SantiagoGarcia_AndresMontano",
131 |         ENVIRONMENT: deploymentEnvironment,
132 |       },
133 |       // Store logs in CloudWatch Logs
134 |       logging: ecs.LogDriver.awsLogs({ streamPrefix: mainResourcesName }),
135 |     });
136 | 
137 |     // Docker container port mappings within the container
138 |     container.addPortMappings(
139 |       {
140 |         containerPort: applicationPort
141 |       }
142 |     );
143 | 
144 |     // Security groups to allow connections from the application load balancer to the containers
145 |     const ecsSG = new ec2.SecurityGroup(this, "SG-ECS", {
146 |       vpc: vpc,
147 |       allowAllOutbound: true,
148 |     });
149 |     ecsSG.connections.allowFrom(
150 |       albSG,
151 |       ec2.Port.tcp(applicationPort),
152 |       "ALB to ECS containers"
153 |     );
154 | 
155 |     // The ECS Service used for deploying tasks 
156 |     const service = new ecs.FargateService(this, "ECS-Service", {
157 |       cluster,
158 |       desiredCount: 1,
159 |       taskDefinition,
160 |       securityGroups: [ecsSG],
161 |       assignPublicIp: true,
162 |     });
163 | 
164 |     // Target group to make resources containers discoverable by the ALB
165 |     const targetGroupHttp = new elasticloadbalancing.ApplicationTargetGroup(
166 |       this,
167 |       "ALB-TargetGroup",
168 |       {
169 |         port: applicationPort,
170 |         vpc: vpc,
171 |         protocol: elasticloadbalancing.ApplicationProtocol.HTTP,
172 |         targetType: elasticloadbalancing.TargetType.IP,
173 |       }
174 |     );
175 | 
176 |     // Health check for containers to check they were deployed correctly
177 |     targetGroupHttp.configureHealthCheck({
178 |       path: "/status",
179 |       protocol: elasticloadbalancing.Protocol.HTTP,
180 |     });
181 | 
182 |     // Only allow HTTPS connections
183 |     const listener = alb.addListener("ALB-Listener", {
184 |       open: true,
185 |       port: 443,
186 |       certificates: [certificate],
187 |     });
188 | 
189 |     listener.addTargetGroups("ALB-Listener-TargetGroup", {
190 |       targetGroups: [targetGroupHttp],
191 |     });
192 | 
193 |     // Add the ECS service to the target group of the ALB
194 |     service.attachToApplicationTargetGroup(targetGroupHttp);
195 | 
196 |     // ASG automatic configuration based on memory and CPU usage
197 |     const scalableTaget = service.autoScaleTaskCount({
198 |       minCapacity: 1,
199 |       maxCapacity: 2,
200 |     });
201 | 
202 |     scalableTaget.scaleOnMemoryUtilization("ECS-ScaleUpMem", {
203 |       targetUtilizationPercent: 70,
204 |     });
205 | 
206 |     scalableTaget.scaleOnCpuUtilization("ECS-ScaleUpCPU", {
207 |       targetUtilizationPercent: 70,
208 |     });
209 | 
210 |     // After ALB is configured, add an "A Record" in the R53 HZ for the domain
211 |     const hostedZoneARecod = new route53.ARecord(this, 'ARecord', {
212 |       comment: `A type Record target for ${mainResourcesName} solution in ${deploymentEnvironment} env`,
213 |       target: route53.RecordTarget.fromAlias(new route53targets.LoadBalancerTarget(alb)),
214 |       recordName: domainName,
215 |       zone: hostedZone,
216 |     });
217 | 
218 |     // CloudFormation outputs for the deployment
219 |     new CfnOutput(this, 'AlbDns', {
220 |       value: alb.loadBalancerDnsName,
221 |       description: 'API ALB DNS',
222 |     });
223 | 
224 |     new CfnOutput(this, 'MainDns', {
225 |       value: domainName,
226 |       description: 'API public DNS',
227 |     });
228 | 
229 |   }
230 | }
231 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
  1 |                                  Apache License
  2 |                            Version 2.0, January 2004
  3 |                         http://www.apache.org/licenses/
  4 | 
  5 |    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
  6 | 
  7 |    1. Definitions.
  8 | 
  9 |       "License" shall mean the terms and conditions for use, reproduction,
 10 |       and distribution as defined by Sections 1 through 9 of this document.
 11 | 
 12 |       "Licensor" shall mean the copyright owner or entity authorized by
 13 |       the copyright owner that is granting the License.
 14 | 
 15 |       "Legal Entity" shall mean the union of the acting entity and all
 16 |       other entities that control, are controlled by, or are under common
 17 |       control with that entity. For the purposes of this definition,
 18 |       "control" means (i) the power, direct or indirect, to cause the
 19 |       direction or management of such entity, whether by contract or
 20 |       otherwise, or (ii) ownership of fifty percent (50%) or more of the
 21 |       outstanding shares, or (iii) beneficial ownership of such entity.
 22 | 
 23 |       "You" (or "Your") shall mean an individual or Legal Entity
 24 |       exercising permissions granted by this License.
 25 | 
 26 |       "Source" form shall mean the preferred form for making modifications,
 27 |       including but not limited to software source code, documentation
 28 |       source, and configuration files.
 29 | 
 30 |       "Object" form shall mean any form resulting from mechanical
 31 |       transformation or translation of a Source form, including but
 32 |       not limited to compiled object code, generated documentation,
 33 |       and conversions to other media types.
 34 | 
 35 |       "Work" shall mean the work of authorship, whether in Source or
 36 |       Object form, made available under the License, as indicated by a
 37 |       copyright notice that is included in or attached to the work
 38 |       (an example is provided in the Appendix below).
 39 | 
 40 |       "Derivative Works" shall mean any work, whether in Source or Object
 41 |       form, that is based on (or derived from) the Work and for which the
 42 |       editorial revisions, annotations, elaborations, or other modifications
 43 |       represent, as a whole, an original work of authorship. For the purposes
 44 |       of this License, Derivative Works shall not include works that remain
 45 |       separable from, or merely link (or bind by name) to the interfaces of,
 46 |       the Work and Derivative Works thereof.
 47 | 
 48 |       "Contribution" shall mean any work of authorship, including
 49 |       the original version of the Work and any modifications or additions
 50 |       to that Work or Derivative Works thereof, that is intentionally
 51 |       submitted to Licensor for inclusion in the Work by the copyright owner
 52 |       or by an individual or Legal Entity authorized to submit on behalf of
 53 |       the copyright owner. For the purposes of this definition, "submitted"
 54 |       means any form of electronic, verbal, or written communication sent
 55 |       to the Licensor or its representatives, including but not limited to
 56 |       communication on electronic mailing lists, source code control systems,
 57 |       and issue tracking systems that are managed by, or on behalf of, the
 58 |       Licensor for the purpose of discussing and improving the Work, but
 59 |       excluding communication that is conspicuously marked or otherwise
 60 |       designated in writing by the copyright owner as "Not a Contribution."
 61 | 
 62 |       "Contributor" shall mean Licensor and any individual or Legal Entity
 63 |       on behalf of whom a Contribution has been received by Licensor and
 64 |       subsequently incorporated within the Work.
 65 | 
 66 |    2. Grant of Copyright License. Subject to the terms and conditions of
 67 |       this License, each Contributor hereby grants to You a perpetual,
 68 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 69 |       copyright license to reproduce, prepare Derivative Works of,
 70 |       publicly display, publicly perform, sublicense, and distribute the
 71 |       Work and such Derivative Works in Source or Object form.
 72 | 
 73 |    3. Grant of Patent License. Subject to the terms and conditions of
 74 |       this License, each Contributor hereby grants to You a perpetual,
 75 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 76 |       (except as stated in this section) patent license to make, have made,
 77 |       use, offer to sell, sell, import, and otherwise transfer the Work,
 78 |       where such license applies only to those patent claims licensable
 79 |       by such Contributor that are necessarily infringed by their
 80 |       Contribution(s) alone or by combination of their Contribution(s)
 81 |       with the Work to which such Contribution(s) was submitted. If You
 82 |       institute patent litigation against any entity (including a
 83 |       cross-claim or counterclaim in a lawsuit) alleging that the Work
 84 |       or a Contribution incorporated within the Work constitutes direct
 85 |       or contributory patent infringement, then any patent licenses
 86 |       granted to You under this License for that Work shall terminate
 87 |       as of the date such litigation is filed.
 88 | 
 89 |    4. Redistribution. You may reproduce and distribute copies of the
 90 |       Work or Derivative Works thereof in any medium, with or without
 91 |       modifications, and in Source or Object form, provided that You
 92 |       meet the following conditions:
 93 | 
 94 |       (a) You must give any other recipients of the Work or
 95 |           Derivative Works a copy of this License; and
 96 | 
 97 |       (b) You must cause any modified files to carry prominent notices
 98 |           stating that You changed the files; and
 99 | 
100 |       (c) You must retain, in the Source form of any Derivative Works
101 |           that You distribute, all copyright, patent, trademark, and
102 |           attribution notices from the Source form of the Work,
103 |           excluding those notices that do not pertain to any part of
104 |           the Derivative Works; and
105 | 
106 |       (d) If the Work includes a "NOTICE" text file as part of its
107 |           distribution, then any Derivative Works that You distribute must
108 |           include a readable copy of the attribution notices contained
109 |           within such NOTICE file, excluding those notices that do not
110 |           pertain to any part of the Derivative Works, in at least one
111 |           of the following places: within a NOTICE text file distributed
112 |           as part of the Derivative Works; within the Source form or
113 |           documentation, if provided along with the Derivative Works; or,
114 |           within a display generated by the Derivative Works, if and
115 |           wherever such third-party notices normally appear. The contents
116 |           of the NOTICE file are for informational purposes only and
117 |           do not modify the License. You may add Your own attribution
118 |           notices within Derivative Works that You distribute, alongside
119 |           or as an addendum to the NOTICE text from the Work, provided
120 |           that such additional attribution notices cannot be construed
121 |           as modifying the License.
122 | 
123 |       You may add Your own copyright statement to Your modifications and
124 |       may provide additional or different license terms and conditions
125 |       for use, reproduction, or distribution of Your modifications, or
126 |       for any such Derivative Works as a whole, provided Your use,
127 |       reproduction, and distribution of the Work otherwise complies with
128 |       the conditions stated in this License.
129 | 
130 |    5. Submission of Contributions. Unless You explicitly state otherwise,
131 |       any Contribution intentionally submitted for inclusion in the Work
132 |       by You to the Licensor shall be under the terms and conditions of
133 |       this License, without any additional terms or conditions.
134 |       Notwithstanding the above, nothing herein shall supersede or modify
135 |       the terms of any separate license agreement you may have executed
136 |       with Licensor regarding such Contributions.
137 | 
138 |    6. Trademarks. This License does not grant permission to use the trade
139 |       names, trademarks, service marks, or product names of the Licensor,
140 |       except as required for reasonable and customary use in describing the
141 |       origin of the Work and reproducing the content of the NOTICE file.
142 | 
143 |    7. Disclaimer of Warranty. Unless required by applicable law or
144 |       agreed to in writing, Licensor provides the Work (and each
145 |       Contributor provides its Contributions) on an "AS IS" BASIS,
146 |       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 |       implied, including, without limitation, any warranties or conditions
148 |       of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 |       PARTICULAR PURPOSE. You are solely responsible for determining the
150 |       appropriateness of using or redistributing the Work and assume any
151 |       risks associated with Your exercise of permissions under this License.
152 | 
153 |    8. Limitation of Liability. In no event and under no legal theory,
154 |       whether in tort (including negligence), contract, or otherwise,
155 |       unless required by applicable law (such as deliberate and grossly
156 |       negligent acts) or agreed to in writing, shall any Contributor be
157 |       liable to You for damages, including any direct, indirect, special,
158 |       incidental, or consequential damages of any character arising as a
159 |       result of this License or out of the use or inability to use the
160 |       Work (including but not limited to damages for loss of goodwill,
161 |       work stoppage, computer failure or malfunction, or any and all
162 |       other commercial damages or losses), even if such Contributor
163 |       has been advised of the possibility of such damages.
164 | 
165 |    9. Accepting Warranty or Additional Liability. While redistributing
166 |       the Work or Derivative Works thereof, You may choose to offer,
167 |       and charge a fee for, acceptance of support, warranty, indemnity,
168 |       or other liability obligations and/or rights consistent with this
169 |       License. However, in accepting such obligations, You may act only
170 |       on Your own behalf and on Your sole responsibility, not on behalf
171 |       of any other Contributor, and only if You agree to indemnify,
172 |       defend, and hold each Contributor harmless for any liability
173 |       incurred by, or claims asserted against, such Contributor by reason
174 |       of your accepting any such warranty or additional liability.
175 | 
176 |    END OF TERMS AND CONDITIONS
177 | 
178 |    APPENDIX: How to apply the Apache License to your work.
179 | 
180 |       To apply the Apache License to your work, attach the following
181 |       boilerplate notice, with the fields enclosed by brackets "[]"
182 |       replaced with your own identifying information. (Don't include
183 |       the brackets!)  The text should be enclosed in the appropriate
184 |       comment syntax for the file format. We also recommend that a
185 |       file or class name and description of purpose be included on the
186 |       same "printed page" as the copyright notice for easier
187 |       identification within third-party archives.
188 | 
189 |    Copyright [yyyy] [name of copyright owner]
190 | 
191 |    Licensed under the Apache License, Version 2.0 (the "License");
192 |    you may not use this file except in compliance with the License.
193 |    You may obtain a copy of the License at
194 | 
195 |        http://www.apache.org/licenses/LICENSE-2.0
196 | 
197 |    Unless required by applicable law or agreed to in writing, software
198 |    distributed under the License is distributed on an "AS IS" BASIS,
199 |    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 |    See the License for the specific language governing permissions and
201 |    limitations under the License.
202 | 


--------------------------------------------------------------------------------
/assets/aws-cdk-ecs-api-architecture.drawio:
--------------------------------------------------------------------------------
  1 | <mxfile host="app.diagrams.net" modified="2023-05-22T06:50:20.987Z" agent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36" etag="Q1KV9aCt9LNl7GEAXXbK" version="21.3.2" type="device">
  2 |   <diagram name="Page-1" id="JlSzHq7Eo1urmRr3XqGo">
  3 |     <mxGraphModel dx="933" dy="519" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="1100" math="0" shadow="0">
  4 |       <root>
  5 |         <mxCell id="0" />
  6 |         <mxCell id="1" parent="0" />
  7 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-1" value="&lt;font style=&quot;font-size: 14px;&quot;&gt;AWS&lt;br&gt;&lt;/font&gt;" style="points=[[0,0],[0.25,0],[0.5,0],[0.75,0],[1,0],[1,0.25],[1,0.5],[1,0.75],[1,1],[0.75,1],[0.5,1],[0.25,1],[0,1],[0,0.75],[0,0.5],[0,0.25]];outlineConnect=0;html=1;whiteSpace=wrap;fontSize=12;fontStyle=0;container=1;pointerEvents=0;collapsible=0;recursiveResize=0;shape=mxgraph.aws4.group;grIcon=mxgraph.aws4.group_aws_cloud_alt;strokeColor=#82b366;fillColor=#d5e8d4;verticalAlign=top;align=left;spacingLeft=30;dashed=0;" vertex="1" parent="1">
  8 |           <mxGeometry x="40" y="40" width="350" height="426.5" as="geometry" />
  9 |         </mxCell>
 10 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-3" value="ACM" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=16;fontStyle=1" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 11 |           <mxGeometry x="267" y="146" width="60" height="20" as="geometry" />
 12 |         </mxCell>
 13 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-4" value="" style="sketch=0;points=[[0,0,0],[0.25,0,0],[0.5,0,0],[0.75,0,0],[1,0,0],[0,1,0],[0.25,1,0],[0.5,1,0],[0.75,1,0],[1,1,0],[0,0.25,0],[0,0.5,0],[0,0.75,0],[1,0.25,0],[1,0.5,0],[1,0.75,0]];outlineConnect=0;fontColor=#232F3E;gradientColor=#F54749;gradientDirection=north;fillColor=#C7131F;strokeColor=#ffffff;dashed=0;verticalLabelPosition=bottom;verticalAlign=top;align=center;html=1;fontSize=12;fontStyle=0;aspect=fixed;shape=mxgraph.aws4.resourceIcon;resIcon=mxgraph.aws4.certificate_manager_3;" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 14 |           <mxGeometry x="258" y="168.25" width="78" height="78" as="geometry" />
 15 |         </mxCell>
 16 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-17" value="ECR" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=16;fontStyle=1" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 17 |           <mxGeometry x="268" y="280.57" width="51" height="27.5" as="geometry" />
 18 |         </mxCell>
 19 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-19" value="" style="sketch=0;points=[[0,0,0],[0.25,0,0],[0.5,0,0],[0.75,0,0],[1,0,0],[0,1,0],[0.25,1,0],[0.5,1,0],[0.75,1,0],[1,1,0],[0,0.25,0],[0,0.5,0],[0,0.75,0],[1,0.25,0],[1,0.5,0],[1,0.75,0]];outlineConnect=0;fontColor=#232F3E;gradientColor=#F78E04;gradientDirection=north;fillColor=#D05C17;strokeColor=#ffffff;dashed=0;verticalLabelPosition=bottom;verticalAlign=top;align=center;html=1;fontSize=12;fontStyle=0;aspect=fixed;shape=mxgraph.aws4.resourceIcon;resIcon=mxgraph.aws4.ecr;" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 20 |           <mxGeometry x="254.5" y="308.07" width="78" height="78" as="geometry" />
 21 |         </mxCell>
 22 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-50" value="VPC" style="sketch=0;outlineConnect=0;html=1;whiteSpace=wrap;fontSize=12;fontStyle=0;shape=mxgraph.aws4.group;grIcon=mxgraph.aws4.group_vpc;strokeColor=#d79b00;fillColor=#ffe6cc;verticalAlign=top;align=left;spacingLeft=30;dashed=0;" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 23 |           <mxGeometry x="20" y="146" width="220" height="267.5" as="geometry" />
 24 |         </mxCell>
 25 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-10" value="" style="sketch=0;points=[[0,0,0],[0.25,0,0],[0.5,0,0],[0.75,0,0],[1,0,0],[0,1,0],[0.25,1,0],[0.5,1,0],[0.75,1,0],[1,1,0],[0,0.25,0],[0,0.5,0],[0,0.75,0],[1,0.25,0],[1,0.5,0],[1,0.75,0]];outlineConnect=0;fontColor=#232F3E;gradientColor=#945DF2;gradientDirection=north;fillColor=#5A30B5;strokeColor=#ffffff;dashed=0;verticalLabelPosition=bottom;verticalAlign=top;align=center;html=1;fontSize=12;fontStyle=0;aspect=fixed;shape=mxgraph.aws4.resourceIcon;resIcon=mxgraph.aws4.route_53;" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 26 |           <mxGeometry x="110" y="40.5" width="78" height="78" as="geometry" />
 27 |         </mxCell>
 28 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-11" value="Route 53" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=16;fontStyle=1" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 29 |           <mxGeometry x="187" y="64.5" width="80" height="30" as="geometry" />
 30 |         </mxCell>
 31 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-48" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0.601;entryY=-0.002;entryDx=0;entryDy=0;exitX=0.5;exitY=1;exitDx=0;exitDy=0;exitPerimeter=0;entryPerimeter=0;" edge="1" parent="2JIjCf7IxPsp1DNlf6xB-1" source="2JIjCf7IxPsp1DNlf6xB-42" target="2JIjCf7IxPsp1DNlf6xB-39">
 32 |           <mxGeometry relative="1" as="geometry">
 33 |             <Array as="points">
 34 |               <mxPoint x="150" y="253" />
 35 |               <mxPoint x="150" y="253" />
 36 |             </Array>
 37 |           </mxGeometry>
 38 |         </mxCell>
 39 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-42" value="" style="outlineConnect=0;dashed=0;verticalLabelPosition=bottom;verticalAlign=top;align=center;html=1;shape=mxgraph.aws3.application_load_balancer;fillColor=#F58534;gradientColor=none;" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 40 |           <mxGeometry x="110" y="168.5" width="80" height="77.5" as="geometry" />
 41 |         </mxCell>
 42 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-44" value="ALB" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=16;fontStyle=1" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 43 |           <mxGeometry x="66.5" y="196.13" width="43.5" height="22.25" as="geometry" />
 44 |         </mxCell>
 45 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-39" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#dae8fc;strokeColor=#6c8ebf;" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 46 |           <mxGeometry x="30" y="272.5" width="200" height="130" as="geometry" />
 47 |         </mxCell>
 48 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-23" value="ECS Cluster" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=16;fontStyle=1" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 49 |           <mxGeometry x="38" y="278.07" width="108" height="30" as="geometry" />
 50 |         </mxCell>
 51 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-32" value="" style="sketch=0;points=[[0,0,0],[0.25,0,0],[0.5,0,0],[0.75,0,0],[1,0,0],[0,1,0],[0.25,1,0],[0.5,1,0],[0.75,1,0],[1,1,0],[0,0.25,0],[0,0.5,0],[0,0.75,0],[1,0.25,0],[1,0.5,0],[1,0.75,0]];outlineConnect=0;fontColor=#232F3E;gradientColor=#F78E04;gradientDirection=north;fillColor=#D05C17;strokeColor=#ffffff;dashed=0;verticalLabelPosition=bottom;verticalAlign=top;align=center;html=1;fontSize=12;fontStyle=0;aspect=fixed;shape=mxgraph.aws4.resourceIcon;resIcon=mxgraph.aws4.ecs;" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 52 |           <mxGeometry x="53" y="308.07" width="78" height="78" as="geometry" />
 53 |         </mxCell>
 54 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-35" value="Tasks" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=16;fontStyle=1" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 55 |           <mxGeometry x="150" y="278.07" width="60" height="30" as="geometry" />
 56 |         </mxCell>
 57 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-41" value="" style="group" vertex="1" connectable="0" parent="2JIjCf7IxPsp1DNlf6xB-1">
 58 |           <mxGeometry x="150" y="307.07" width="59" height="80" as="geometry" />
 59 |         </mxCell>
 60 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-40" value="" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#d5e8d4;strokeColor=#82b366;" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-41">
 61 |           <mxGeometry width="59" height="80" as="geometry" />
 62 |         </mxCell>
 63 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-33" value="" style="sketch=0;outlineConnect=0;fontColor=#232F3E;gradientColor=none;fillColor=#D45B07;strokeColor=none;dashed=0;verticalLabelPosition=bottom;verticalAlign=top;align=center;html=1;fontSize=12;fontStyle=0;aspect=fixed;pointerEvents=1;shape=mxgraph.aws4.container_1;" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-41">
 64 |           <mxGeometry x="9.271428571428572" y="7.923407065037966" width="40.457142857142856" height="26.12857142857143" as="geometry" />
 65 |         </mxCell>
 66 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-34" value="" style="sketch=0;outlineConnect=0;fontColor=#232F3E;gradientColor=none;fillColor=#D45B07;strokeColor=none;dashed=0;verticalLabelPosition=bottom;verticalAlign=top;align=center;html=1;fontSize=12;fontStyle=0;aspect=fixed;pointerEvents=1;shape=mxgraph.aws4.container_1;" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-41">
 67 |           <mxGeometry x="9.271428571428572" y="42.258171013535815" width="40.457142857142856" height="26.12857142857143" as="geometry" />
 68 |         </mxCell>
 69 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-47" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=1;entryY=0.5;entryDx=0;entryDy=0;exitX=0;exitY=0.5;exitDx=0;exitDy=0;exitPerimeter=0;" edge="1" parent="2JIjCf7IxPsp1DNlf6xB-1" source="2JIjCf7IxPsp1DNlf6xB-19" target="2JIjCf7IxPsp1DNlf6xB-40">
 70 |           <mxGeometry relative="1" as="geometry">
 71 |             <Array as="points">
 72 |               <mxPoint x="238" y="348" />
 73 |               <mxPoint x="238" y="347" />
 74 |             </Array>
 75 |           </mxGeometry>
 76 |         </mxCell>
 77 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-46" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=0.5;entryY=0;entryDx=0;entryDy=0;entryPerimeter=0;" edge="1" parent="2JIjCf7IxPsp1DNlf6xB-1" source="2JIjCf7IxPsp1DNlf6xB-10" target="2JIjCf7IxPsp1DNlf6xB-42">
 78 |           <mxGeometry relative="1" as="geometry">
 79 |             <Array as="points">
 80 |               <mxPoint x="150" y="169" />
 81 |             </Array>
 82 |           </mxGeometry>
 83 |         </mxCell>
 84 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-53" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=1;entryY=0.5;entryDx=0;entryDy=0;entryPerimeter=0;" edge="1" parent="2JIjCf7IxPsp1DNlf6xB-1" source="2JIjCf7IxPsp1DNlf6xB-4" target="2JIjCf7IxPsp1DNlf6xB-42">
 85 |           <mxGeometry relative="1" as="geometry" />
 86 |         </mxCell>
 87 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-8" value="ecs-api.san99tiago.com" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=15;fontStyle=1;fontColor=#0000FF;" vertex="1" parent="2JIjCf7IxPsp1DNlf6xB-1">
 88 |           <mxGeometry x="81" y="3.5" width="180" height="37" as="geometry" />
 89 |         </mxCell>
 90 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-13" value="" style="fontColor=#0066CC;verticalAlign=top;verticalLabelPosition=bottom;labelPosition=center;align=center;html=1;outlineConnect=0;fillColor=#CCCCCC;strokeColor=#6881B3;gradientColor=none;gradientDirection=north;strokeWidth=2;shape=mxgraph.networks.terminal;" vertex="1" parent="1">
 91 |           <mxGeometry x="400" y="248.5" width="80" height="65" as="geometry" />
 92 |         </mxCell>
 93 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-14" value="" style="dashed=0;outlineConnect=0;html=1;align=center;labelPosition=center;verticalLabelPosition=bottom;verticalAlign=top;shape=mxgraph.weblogos.github" vertex="1" parent="1">
 94 |           <mxGeometry x="485" y="242.5" width="75" height="75" as="geometry" />
 95 |         </mxCell>
 96 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-25" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;entryX=1;entryY=0.5;entryDx=0;entryDy=0;entryPerimeter=0;" edge="1" parent="1" source="2JIjCf7IxPsp1DNlf6xB-15" target="2JIjCf7IxPsp1DNlf6xB-19">
 97 |           <mxGeometry relative="1" as="geometry">
 98 |             <Array as="points">
 99 |               <mxPoint x="480" y="387.5" />
100 |             </Array>
101 |           </mxGeometry>
102 |         </mxCell>
103 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-15" value="Repository&lt;br&gt;aws-cdk-ecs-api" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=16;fontStyle=1" vertex="1" parent="1">
104 |           <mxGeometry x="416.87" y="326.5" width="133.75" height="42" as="geometry" />
105 |         </mxCell>
106 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-20" value="" style="sketch=0;aspect=fixed;html=1;points=[];align=center;image;fontSize=12;image=img/lib/mscae/Docker.svg;" vertex="1" parent="1">
107 |           <mxGeometry x="470" y="160.19" width="84.61" height="69.37" as="geometry" />
108 |         </mxCell>
109 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-28" value="" style="shape=image;verticalLabelPosition=bottom;labelBackgroundColor=default;verticalAlign=top;aspect=fixed;imageAspect=0;image=https://fastapi.tiangolo.com/img/logo-margin/logo-teal.png;" vertex="1" parent="1">
110 |           <mxGeometry x="415.47" y="116.5" width="135.15" height="48.75" as="geometry" />
111 |         </mxCell>
112 |         <mxCell id="2JIjCf7IxPsp1DNlf6xB-21" value="" style="shape=image;imageAspect=0;aspect=fixed;verticalLabelPosition=bottom;verticalAlign=top;image=data:image/png,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;" vertex="1" parent="1">
113 |           <mxGeometry x="400" y="159.87" width="70" height="70" as="geometry" />
114 |         </mxCell>
115 |       </root>
116 |     </mxGraphModel>
117 |   </diagram>
118 | </mxfile>
119 | 


--------------------------------------------------------------------------------