feat: Adicionar arquivos de configuração para o serviço Locust

Author: nataliagranato

Diff for: docs/LOCUST.md

@@ -0,0 +1,61 @@
+# Teste de carga com Locust
+
+O Locust é uma ferramenta de teste de carga que permite simular um grande número de usuários acessando um sistema ao mesmo tempo. Ele é muito utilizado para testar a escalabilidade de aplicações web.
+
+No caso da nossa aplicação, o Locust será utilizado para simular o acesso de um grande número de usuários ao sistema, a fim de verificar se o mesmo é capaz de suportar a carga gerada. Para isso, será necessário criar um script que simule o comportamento dos usuários ao acessar o sistema.
+
+Além disso conseguiremos verificar se o nosso cluster irá escalar a aplicação, visto que definimos no `values.yaml` a utilização de um `HorizontalPodAutoscaler`. O bloco que define o `HorizontalPodAutoscaler` é o seguinte:
+
+```yaml
+
+autoscaling:
+  enabled: true
+  minReplicas: 1
+  maxReplicas: 100
+  targetCPUUtilizationPercentage: 80
+  targetMemoryUtilizationPercentage: 80
+```
+
+O `HorizontalPodAutoscaler` irá escalar a aplicação de acordo com a utilização de CPU e memória. O `targetCPUUtilizationPercentage` e `targetMemoryUtilizationPercentage` definem o percentual de utilização de CPU e memória que irá disparar a escala da aplicação. Nesse caso o número máximo de réplicas é 100.
+
+## Instalação
+
+Para instalar o Locust, basta executar o seguinte comando:
+
+```bash
+cd locust
+kubectl apply -f deployment.yaml -n locust
+kubectl apply -f service.yaml -n locust
+kubectl apply -f configmap.yaml -n locust
+kubectl apply -f ingress.yaml -n locust
+```
+
+## Acesso
+
+Para acessar o locust e iniciar os testes de carga, basta acessar o endereço `https://locust.nataliagranato.xyz` no navegador. Ou use o port-forward:
+
+```bash
+kubectl port-forward svc/locust 8089:80 -n locust
+```
+
+Ao acessar a aplicação, será necessário informar o número de usuários a serem simulados, a taxa de usuários por segundo e o tempo de execução do teste. Após preencher essas informações, basta clicar no botão `Start` para iniciar o teste.
+
+Acompanhe o andamento do teste na aba `Charts`, onde é possível visualizar o número de usuários ativos, a taxa de requisições por segundo, o tempo de resposta e outros dados relevantes.
+
+Para validar se o teste está sendo executado com sucesso, verifique os logs do locust. Você verá algo como:
+
+```bash
+[2024-08-20 00:31:03,380] locust-66d9c889d9-s5v5g/INFO/locust.main: Starting web interface at http://0.0.0.0:8089
+
+[2024-08-20 00:31:03,394] locust-66d9c889d9-s5v5g/INFO/locust.main: Starting Locust 2.31.3
+
+[2024-08-20 00:31:11,772] locust-66d9c889d9-s5v5g/INFO/locust.runners: Ramping to 1000 users at a rate of 100.00 per second
+
+[2024-08-20 00:31:20,864] locust-66d9c889d9-s5v5g/INFO/locust.runners: All users spawned: {"Giropops": 1000} (1000 total users)
+```
+
+Esses logs indicam que o teste foi iniciado com sucesso na API `https://senhas.nataliagranato.xyz/api/senhas` e que os usuários estão sendo criados conforme o que eu solicitei.
+
+Ao final do teste, é possível visualizar um relatório com os resultados obtidos, incluindo o número total de requisições, o tempo médio de resposta, o tempo total de execução e outros dados importantes.
+
+Para visualizar o meu relatório inicial, acesse o link: [Relatório Inicial](https://locust.nataliagranato.xyz/stats/report?theme=dark)

Diff for: locust/configmap.yaml

@@ -0,0 +1,26 @@
+apiVersion: v1
+data:
+  locustfile.py: |-
+    from locust import HttpUser, task, between
+
+    class Giropops(HttpUser):
+        wait_time = between(1, 2)
+
+        @task(1)
+        def gerar_senha(self):
+            self.client.post(
+                "/api/gerar-senha",
+                json={
+                    "tamanho": 8,
+                    "incluir_numeros": True,
+                    "incluir_caracteres_especiais": True
+                }
+            )
+
+        @task(2)
+        def listar_senha(self):
+            self.client.get("/api/senhas")
+kind: ConfigMap
+metadata:
+  name: locust-scripts
+  namespace: locust

Diff for: locust/deployment.yaml

@@ -0,0 +1,45 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  labels:
+    app: locust
+  name: locust
+  namespace: locust
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: locust
+  template:
+    metadata:
+      labels:
+        app: locust
+    spec:
+      containers:
+      - image: locustio/locust:2.31.3
+        name: locust
+        env:
+        - name: LOCUST_LOCUSTFILE
+          value: "/usr/src/app/scripts/locustfile.py"
+        resources:
+          limits:
+            cpu: '2'
+            memory: 4Gi
+          requests:
+            cpu: '1'
+            memory: 2Gi
+        securityContext:
+          readOnlyRootFilesystem: true
+          runAsNonRoot: true
+          runAsUser: 1000
+        ports:
+        - containerPort: 8089
+        imagePullPolicy: Always
+        volumeMounts:
+        - name: locust-scripts
+          mountPath: /usr/src/app/scripts
+      volumes:
+      - name: locust-scripts
+        configMap:
+          name: locust-scripts
+          optional: true

Diff for: locust/ingress.yaml

@@ -0,0 +1,28 @@
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: locust
+  annotations:
+    cert-manager.io/cluster-issuer: letsencrypt-prod
+    kubernetes.io/ingress.class: nginx
+  labels:
+    app: locust
+  namespace: locust
+
+spec:
+  ingressClassName: nginx
+  rules:
+  - host: locust.nataliagranato.xyz
+    http:
+      paths:
+      - backend:
+          service:
+            name: locust
+            port:
+              number: 8089
+        path: /
+        pathType: Prefix
+  tls:
+  - hosts:
+    - locust.nataliagranato.xyz
+    secretName: locust.nataliagranato.xyz

Diff for: locust/report/failures_1724114366.1516452.csv

@@ -0,0 +1,5 @@
+Method,Name,Error,Occurrences
+GET,/api/senhas/api/senhas,"gaierror(-3, 'Temporary failure in name resolution')",1
+GET,/api/senhas/api/senhas,"SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: self-signed certificate (_ssl.c:1006)'))",60103
+POST,/api/senhas/api/gerar-senha,"SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: self-signed certificate (_ssl.c:1006)'))",30033
+POST,/api/senhas/api/gerar-senha,"gaierror(-3, 'Temporary failure in name resolution')",1

Diff for: locust/report/report_1724114389.0576763.html

@@ -0,0 +1,4 @@
+Type,Name,Request Count,Failure Count,Median Response Time,Average Response Time,Min Response Time,Max Response Time,Average Content Size,Requests/s,Failures/s,50%,66%,75%,80%,90%,95%,98%,99%,99.9%,99.99%,100%
+POST,/api/senhas/api/gerar-senha,30034,30034,180.0,1724.99289370333,7.566047832369804,13242.266472429037,0.0,100.01489098343275,100.01489098343275,180,3000,3600,4000,5100,5800,6500,6700,7600,10000,13000
+GET,/api/senhas/api/senhas,60104,60104,190.0,1752.4794916131204,7.740609347820282,13398.4948489815,0.0,200.14966396977567,200.14966396977567,190,3000,3600,4000,5100,5800,6500,6800,7900,10000,13000
+,Aggregated,90138,90138,190.0,1743.3209515786957,7.566047832369804,13398.4948489815,0.0,300.16455495320844,300.16455495320844,190,3000,3600,4000,5100,5800,6500,6700,7800,10000,13000

Diff for: locust/report/requests_1724114365.324016.csv

@@ -0,0 +1,13 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: locust
+  namespace: locust
+spec:
+  selector:
+    app: locust
+  ports:
+  - protocol: TCP
+    port: 80
+    targetPort: 8089
+  type: ClusterIP