https://github.com/leogregianin/kubernetes-workshop

Encurtador de URL com Django, Django REST Framework, Docker e Kubernetes
https://github.com/leogregianin/kubernetes-workshop

Last synced: about 2 months ago
JSON representation

Encurtador de URL com Django, Django REST Framework, Docker e Kubernetes

• Host: GitHub
• URL: https://github.com/leogregianin/kubernetes-workshop
• Owner: leogregianin
• License: mit
• Created: 2023-12-18T21:03:33.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-04-17T02:40:58.000Z (about 1 year ago)
• Last Synced: 2025-04-12T03:14:40.834Z (about 2 months ago)
• Language: Python
• Size: 717 KB
• Stars: 3
• Watchers: 2
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# kubernetes-workshop

Esta é uma aplicação ponta a ponta, ou seja, desde o desenvolvimento até a produção.

**URL shorter**, ou, **Encurtador de URL** é uma aplicação que recebe uma URL e retorna um *hash* da URL original tornando uma URL curta, que ao ser acessada redireciona para a URL original e grava a quantidade de acessos a URL curta e a URL original.

Por exemplo, a URL de um dos meus artigos no Medium é essa: `https://dev.to/leogregianin/python-e-facil-go-e-simples-simples-e-diferente-de-facil-5b9o` e poderia ficar somente `http://encurtador_de_url.com/abc123`.

O objetivo é mostrar como é possível criar uma aplicação utilizando as melhores práticas de desenvolvimento e deploy.

Utiliza as tecnologias **Django** para backend e frontend, **Django Rest Framework** para API, **Postgres** como banco de dados e **Docker** e **Kubernetes** para containerização e orquestração do deploy.

URL shorter é uma aplicação pequena e é utilizada para fins didáticos de como construir uma aplicação e escalar ela utilizando Kubernetes.

Existem diversos *trade-offs* ao utilizar **Kubernetes**, os benefícios e desvantagens podem ser vistos na imagem abaixo e mais detalhes nos próximos artigos escritos no [dev.to](https://dev.to/leogregianin) e [Medium](https://medium.com/@leogregianin).

![Kubernetes](docs/k8s_benefits.jpg)

## Requisitos técnicos

### Rodar a aplicação:

    $ mv .env.example .env

    $ docker compose up -d

![docker compose up](docs/docker_compose_up.png)

### Rodar comandos no container:

    $ make docker-makemigrations

    $ make docker-migrate

    $ make docker-createsuperuser

    $ make docker-collectstatic

![docker makemigrations](docs/docker_makemigrations.png)

![docker migrate](docs/docker_migrate.png)

### Criar imagem para DockerHub:

    $ docker build -t urlshorter .

    $ docker images urlshorter

    $ docker tag urlshorter:latest leogregianin/urlshorter:0.0.1

    $ docker push leogregianin/urlshorter:0.0.1

![docker build](docs/docker_build.png)

### Cria cluster e control panel

    $ kind create cluster --name wslkind

![kind control panel](docs/kind-control-panel.png)

### Deploy com Kubernetes:

    $ kubectl apply -f infra/deployment.yaml

    $ kubectl get deploy

    $ kubectl apply -f infra/service.yaml

    $ kubectl get svc

    $ kubectl get pods

![k8s one pod](docs/k8s-pod_one.png)

### Escalar a aplicação:

    $ kubectl scale deployment/urlshorter-deployment --replicas=12

    $ kubectl get pods

![k8s scale](docs/k8s-replicas.png)

### App

![app](docs/app.png)