aws-cdk-ecs-api

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

aws-cdk-ecs-api

★ 10 Open GitHub ↗

AWS FastAPI deployment on top of ALB and ECS with Docker containers implementing ECS as the orchestration tool for an AWS-managed infrastructure. IaC with CDK.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# :trident: AWS-CDK-ECS-API :trident:

AWS FastAPI CDK deployment on top of ALB and ECS with Docker containers implementing ECS as the orchestration tool for an AWS-managed infrastructure.

## Summary/Overview :memo:

- Deployed on AWS with Infrastructure as Code on [CDK-TypeScript](https://aws.amazon.com/cdk/).
- API developed with [FastAPI](https://fastapi.tiangolo.com/lo/).
- Unit and Integration Tests for the source code with [PyTest](https://docs.pytest.org/en/latest).
- Containerized solution with [Docker](https://www.docker.com) orchestrated by [Amazon ECS](https://aws.amazon.com/ecs/) (Fargate).
- 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.
- 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/).

## AWS Architecture Diagram :trophy:

The AWS infrastructure solution is deployed with CDK-TypeScript with the resources defined on the `cdk` folder:

## Folders Explained :scroll:

This repository consists of multiple folders/files, which are explained as follows:

- Infrastructure as Code ([`./cdk/`](./cdk/)).
- Source Code ([`./src/app/`](./src/app/)).
- Tests ([`./tests/`](./tests/))
- Docker containerization ([`./src/Dockerfile`](./src/Dockerfile)).

## Usage :white_check_mark:

Follow these steps to configure the project locally:

### Clone the repository

First, clone the repository:

```bash
git clone https://github.com/san99tiago/aws-cdk-ecs-api
cd aws-cdk-ecs-api
```

### Configure Python

Review the step by step commands for the source code (Python) development and testing at:

- [`./commands_python.sh`](./commands_python.sh)

> Note: python dependencies for this project are managed by [Poetry](https://python-poetry.org). Review [`./pyproject.toml`](pyproject.toml) for details.

### Configure CDK

Review the step by step commands for configuring the CDK at:

- [`./commands_cdk.sh`](./commands_cdk.sh)

> Note: for deploying or destroying the solution, see ("part 3") inside [`./commands_cdk.sh`](./commands_cdk.sh).

## Dependencies :100:

### Software

- [Visual Studio Code](https://code.visualstudio.com/) 
 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.

- [NodeJs](https://nodejs.org/en/) 
 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.

- [Python](https://www.python.org/) 
 Python is an amazing dynamic programming language that let us work fast, with easy and powerful integration of different software solutions.

### Tools

- [CDK CLI (Toolkit)](https://docs.aws.amazon.com/cdk/v2/guide/cli.html) 
 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)

- [AWS CLI](https://aws.amazon.com/cli/) 
 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).

## Special thanks :beers:

- 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.

## Author :musical_keyboard:

**Santiago Garcia Arango**

<table border="1">
 <tr>
 <td>
 <img src="assets/SantiagoGarciaArangoCDK.png" width=70%>
 </td>
 <td>
 As a curious DevOps Engineer, I am deeply passionate about implementing cutting-edge cloud-based solutions on AWS. I firmly believe that today's greatest challenges must be solved by the expertise of individuals who are truly passionate about their work.
 
 </td>
 </tr>
</table>

## LICENSE

aws-cdk-ecs-api

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README