From 52c7907a1bc75be0675b1116cba3af6cf71e64d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=81lvaro=20Justen=20=28=40turicas=29?=
 <alvarojusten@gmail.com>
Date: Wed, 10 Jul 2024 01:09:03 -0300
Subject: [PATCH] =?UTF-8?q?Adiciona=20instru=C3=A7=C3=B5es=20para=20migrar?=
 =?UTF-8?q?=20vers=C3=A3o=20do=20BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/local.pt.md | 104 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 docs/local.pt.md

diff --git a/docs/local.pt.md b/docs/local.pt.md
new file mode 100644
index 00000000..9abd17bc
--- /dev/null
+++ b/docs/local.pt.md
@@ -0,0 +1,104 @@
+# Desenvolvimento local
+
+Esse documento contém algumas dicas para auxiliar no desenvolvimento local.
+
+## Migrando de banco de dados
+
+Se alguém fez uma atualização do postgres nesse repositório e você já tinha dados rodando na versão anterior, ainda não
+atualize o código, pois o novo `compose.yml` irá definir o serviço `db` com a nova versão e seus dados estarão na
+antiga, o que gerará um conflito. Antes de atualizar o código, pare todos os containers e crie pastas para o banco
+antigo:
+
+```shell
+docker compose down
+cp -r docker/conf/db docker/conf/olddb
+cp -r docker/env/db docker/env/olddb
+mv docker/data/db docker/data/olddb
+mkdir docker/data/db
+```
+
+Abra o `compose.yml`, copie a definição do serviço `db` e cole-o em outro arquivo temporário. Por exemplo, se a versão
+antiga era `postgres:15-bullseye`, adicione o seguinte:
+
+```yaml
+  olddb:
+    image: "postgres:15-bullseye"
+    env_file:
+      - "docker/env/olddb"
+      - "docker/env/olddb.local"
+    user: "${UID:-1000}:${GID:-1000}"
+    shm_size: "4g"
+    command: -c "config_file=/etc/postgresql/postgresql.conf"
+    volumes:
+      - ${PWD}/docker/data/olddb:/var/lib/postgresql/data
+      - ${PWD}/docker/conf/olddb/postgresql.dev.conf:/etc/postgresql/postgresql.conf
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 3s
+      retries: 5
+```
+
+Com o serviço de banco antigo definido, faça a atualização de código:
+
+```shell
+git pull
+```
+
+Edite o seu arquivo `compose.yml` atualizado e inclua o serviço `db` que você copiou na etapa anterior, mas dê o nome
+de `olddb` e nele troque as seguintes referências:
+- `docker/conf/db` para `docker/conf/olddb`
+- `docker/data/db` para `docker/data/olddb`
+- `docker/env/db` para `docker/env/olddb`
+
+Execute apenas os containers dos bancos de dados e verifique se eles estão rodando corretamente pelos logs:
+
+```shell
+docker compose up -d olddb db
+docker compose logs -ft
+```
+
+> ATENÇÃO: não use `make start`, senão a aplicação Web irá iniciar e executar as migrações (precisamos que o novo banco
+> esteja vazio).
+
+Agora, execute o `bash` no container `web`:
+
+```shell
+docker compose run -it --rm web bash
+```
+
+E dentro do container, execute:
+
+```shell
+export NEW_DB_URL=$DATABASE_URL
+export OLD_DB_URL=$(echo $DATABASE_URL | sed 's/@db:/@olddb:/')
+echo 'select version()' | psql $OLD_DB_URL
+echo 'select version()' | psql $NEW_DB_URL
+```
+
+Se os comandos acima não deram erro (e o `psql` conseguiu conectar corretamente em ambos os bancos), execute:
+
+```shell
+time pg_dump -F c -d $OLD_DB_URL | pg_restore -d $NEW_DB_URL
+```
+
+Após o término, você pode executar `psql $NEW_DB_URL` e verificar se as tabelas existem (`\d`) e se possuem dados
+(`SELECT COUNT(*) FROM x`). Depois disso, saia do bash do container `web` e inicie todos os containers:
+
+```shell
+make start
+```
+
+Para ter certeza de que o banco antigo não irá mais interferir, pare-o com:
+
+```shell
+docker compose stop olddb
+```
+
+Agora teste a aplicação e verifique se os dados estão aparecendo corretamente. Em caso positivo, apague o serviço
+`olddb` do `compose.yml` e delete os arquivos:
+
+```shell
+rm -rf docker/conf/olddb docker/data/olddb docker/env/olddb
+```
+
+Pronto!