132 lines
5.1 KiB
Markdown
132 lines
5.1 KiB
Markdown
# BSMSapp
|
|
|
|
Best Stock Management System application.
|
|
|
|
## Descripción de los módulos
|
|
|
|
### API Gateway
|
|
|
|
Construye una API REST que puede recibir requests POST, GET u OPTIONS. En el caso de GET, va directo a la lambda de lectura de la tabla (`lambdaDB`). Por otro lado, en el caso de un POST, se encola en el SQS para luego ir a otra lambda (`lambdaSQSDB`). Finalmente, el OPTIONS se utiliza para poder soportar y habilitar `CORS` y que, por ende, funcionen correctamente los llamados a la API desde el sitio estático.
|
|
|
|
### CloudFront
|
|
|
|
Funciona como CDN y realiza caché de la API y del S3 (que hostea el sitio estático).
|
|
|
|
### Dynamo DB
|
|
|
|
Guarda los datos de los stocks de los usuarios. Tiene una tabla compuesta por `id` (la partition key) y `stock`.
|
|
|
|
### Lambda
|
|
|
|
Definimos 2 lambdas. Una se encarga de realizar escrituras al `DynamoDB` (`lambdaSQSDB`) y la otra de realizar lecturas (`lambdaDB`).
|
|
|
|
### S3
|
|
|
|
Definimos 3 buckets. Uno para logs y dos para el frontend (el sitio estático en sí y uno `www` que se redirecciona al primero).
|
|
|
|
### SQS
|
|
|
|
Se encarga de encolar POSTs recibidos por la API. Luego, dispara la lambda correspondiente (en este caso `lambdaSQSDB`).
|
|
|
|
### VPC
|
|
|
|
Este módulo es [externo](https://registry.terraform.io/modules/terraform-aws-modules/vpc/aws/latest). Se define en este toda la parte de networking que se detalla en el diagrama de la arquitectura (el cual se encuentra al final de este documento).
|
|
|
|
### WAF
|
|
|
|
Protege la aplicación mediante 3 rules. Esto lo hace mediante la creación de un web ACL asociado a la distribución de CloudFront.
|
|
|
|
## Descripción y referencia de funciones y meta-argumentos
|
|
|
|
Se debe notar que los links solo hacen referencia a la primera aparición en cada archivo.
|
|
|
|
### Funciones
|
|
|
|
Junto a cada función se especifica para qué se usa.
|
|
|
|
- **file**: devuelve como string el contenido del archivo `index.html`. Esto es utilizado para luego poder modificarlo (pues actúa como un template ya que tiene la variable `ENDPOINT` parametrizada) y usarlo.
|
|
+ [organization/datasources.tf](terraform/organization/datasources.tf#L14)
|
|
|
|
- **flatten**: retorna una lista de una dimensión con los elementos de una lista de listas pues así lo espera el módulo.
|
|
+ [organization/vpc.tf](terraform/organization/vpc.tf#L78)
|
|
|
|
- **format**: arma el `path` para un filename dado.
|
|
+ [modules/s3/main.tf](terraform/modules/s3/main.tf#L39)
|
|
|
|
- **jsonencode**: arma un string con un objeto JSON.
|
|
+ [modules/apigw/main.tf](terraform/modules/apigw/main.tf#L89)
|
|
|
|
- **length**: calcula el largo de `custom_origin_config` para saber si debe hacer un `for_each` sobre sus elementos, es decir, para saber si se lo definieron en el archivo que usa el módulo en cuestión.
|
|
+ [modules/cloudfront/main.tf](terraform/modules/cloudfront/main.tf#L20)
|
|
|
|
- **lookup**: obtiene el valor de un mapa para una key.
|
|
+ [modules/cloudfront/main.tf](terraform/modules/cloudfront/main.tf#L16)
|
|
|
|
- **replace**: modifica el `path` para hacerlo válido.
|
|
+ [modules/s3/main.tf](terraform/modules/s3/main.tf#L38)
|
|
+ [organization/cloudfront.tf](terraform/organization/cloudfront.tf#L13)
|
|
|
|
- **sha1**: computa el `SHA1` del string de la configuración del apigw para saber si se necesita forzar el redeploy del módulo.
|
|
+ [modules/apigw/main.tf](terraform/modules/apigw/main.tf#L103)
|
|
|
|
- **trimsuffix**: remueve substring del final de un string.
|
|
+ [modules/s3/main.tf](terraform/modules/s3/main.tf#L19)
|
|
|
|
- **try**: en caso de que no haya objetos, se utiliza un objeto vacío.
|
|
+ [modules/s3/main.tf](terraform/modules/s3/main.tf#L35)
|
|
+ [organization/s3.tf](terraform/organization/s3.tf#L10)
|
|
|
|
|
|
### Meta-argumentos
|
|
|
|
- **count**
|
|
+ [modules/s3/main.tf](terraform/modules/s3/main.tf#L18)
|
|
|
|
- **depends_on**
|
|
+ [modules/apigw/main.tf](terraform/modules/apigw/main.tf#L78)
|
|
+ [organization/apigw.tf](terraform/organization/apigw.tf#L8)
|
|
+ [organization/cloudfront.tf](terraform/organization/cloudfront.tf#L3)
|
|
+ [organization/lambda.tf](terraform/organization/lambda.tf#L9)
|
|
+ [organization/sqs.tf](terraform/organization/sqs.tf#L8)
|
|
|
|
- **for_each**
|
|
+ [modules/cloudfront/main.tf](terraform/modules/cloudfront/main.tf#L12)
|
|
+ [modules/dynamodb/main.tf](terraform/modules/dynamodb/main.tf#L12)
|
|
+ [modules/lambda/main.tf](terraform/modules/lambda/main.tf#L15)
|
|
+ [modules/s3/main.tf](terraform/modules/s3/main.tf#L35)
|
|
+ [organization/lambda.tf](terraform/organization/lambda.tf#L2)
|
|
+ [organization/s3.tf](terraform/organization/s3.tf#L2)
|
|
|
|
- **lifecycle**
|
|
+ [modules/apigw/main.tf](terraform/modules/apigw/main.tf#L114)
|
|
|
|
## Diagrama de arquitectura deployada
|
|
|
|
Los servicios que deben ser corregidos (asociados a la entrega del TP3) son los numerados.
|
|
|
|
<img src="docs/architecture.png" alt="architecture" width="800"/>
|
|
|
|
## Demo
|
|
|
|
<img src="docs/demo.gif" alt="demo" width="800"/>
|
|
|
|
## Rúbrica
|
|
|
|
<table>
|
|
<tr>
|
|
<th>Alumno</th>
|
|
<th>Legajo</th>
|
|
<th>Participación</th>
|
|
</tr>
|
|
<tr>
|
|
<td>Bellver, Ezequiel</td>
|
|
<td>61268</td>
|
|
<td>50%</td>
|
|
</tr>
|
|
<tr>
|
|
<td>Lo Coco, Santiago</td>
|
|
<td>61301</td>
|
|
<td>50%</td>
|
|
</tr>
|
|
</table>
|