README

Back-end Delphi: Microsserviços com Horse, Docker e Kubernetes

Código-fonte do livro Back-end Delphi: Microsserviços com Horse, Docker e Kubernetes, de Vinicius Sanchez.

git clone https://github.com/viniciussanchez/livro-backend-delphi.git

Cada pasta corresponde a um capítulo e guarda o projeto exatamente como ele fica ao final daquele capítulo. Assim você pode começar de qualquer ponto do livro, ou comparar o seu código com o do capítulo.

Pré-requisitos

• Delphi 13 Florence
• Boss (gerenciador de dependências)
• Docker Desktop (a partir do capítulo 2, para o PostgreSQL; do 19 ao 21, com o Kubernetes ativado)
• Delphi Enterprise ou Architect para compilar para Linux (capítulo 17 em diante)

Como usar uma pasta de capítulo

cd cap03-primeiros-passos
boss install

Depois abra o .dproj no Delphi e rode o projeto.

A partir do capítulo 5, cada pasta tem vários serviços (event-api, customer-api, ticket-api) e uma pasta shared com as units comuns. Rode boss install dentro da pasta de cada serviço.

A partir do capítulo 11, os projetos já trazem no search path as pastas modules\gbswagger\Source\Core e modules\gbswagger\Source\Horse, que o Boss não acrescenta sozinho.

A partir do capítulo 14, cada serviço tem um .env.example. Copie para .env e ajuste; o .env nunca vai para o Git.

Para os capítulos com banco de dados:

docker compose up -d --wait

O FireDAC precisa da libpq.dll (64 bits) no PATH ou na pasta do executável. Veja o capítulo 5 para saber como obtê-la.

A partir do capítulo 17, os projetos também compilam para Linux64 (Release). No Linux, os serviços precisam dos pacotes libpq5 e libcurl4.

No capítulo 18, compile os quatro serviços para Linux64 em Release, crie o .env a partir do .env.example (na raiz de cap18-docker) e rode:

docker compose up -d --build --wait

Só o gateway fica exposto, em http://localhost:9000. Para abrir as portas internas durante o desenvolvimento, acrescente -f docker-compose.dev.yml.

Nos capítulos 19 a 21, com o Kubernetes do Docker Desktop ativado, gere as imagens com a etiqueta indicada em k8s/kustomization.yaml, crie o k8s/.env a partir do k8s/.env.example e rode:

kubectl apply -k k8s

No capítulo 22, o banco do sistema antigo é criado pelos scripts de legacy/sql, nesta ordem: 01-bilheteria.sql, 02-dados-de-exemplo.sql e 03-sincronizacao.sql (este último é a única mudança no sistema antigo). O serviço legacy-sync sobe na porta 9004.

Roteiros de teste

Do capítulo 3 em diante, cada pasta traz scripts\test-capNN.bat: o mesmo roteiro usado para conferir as seções "Testando" do livro. Ele sobe o que for preciso, roda os comandos e grava as respostas em scripts\test-capNN.log, para você comparar com o texto. Rode no Prompt de Comando (cmd), a partir da pasta do capítulo, depois de compilar os projetos.

Trocando de capítulo

Cada pasta tem o seu docker-compose.yml. Antes de subir o banco de outro capítulo, pare o do capítulo anterior, na pasta dele:

docker compose down

Sem isso, o Docker recusa o novo contêiner porque o nome eventos-postgres (ou a porta 5432) já está em uso.

Capítulos

Dependências utilizadas

• Horse
• Jhonson
• GBSwagger (a partir do capítulo 11)
• RESTRequest4Delphi (ticket-api a partir do capítulo 12, testes e legacy-sync)
• DUnitX (capítulo 15; já vem com o Delphi)

Licença

O código deste repositório é distribuído sob a licença MIT (arquivo LICENSE). O texto do livro não faz parte do repositório e tem todos os direitos reservados.