Preparar o ambiente¶
Comece pelo Primeiro deploy local para uma execução completa com JSON Handler. Instale apenas as ferramentas necessárias ao caminho escolhido.
| Objetivo | Ferramentas / fonte da versão |
|---|---|
| Obter código | Git e acesso aos repositórios Azure DevOps do projeto |
| Java/Quarkus | JDK 21 e Maven Wrapper do serviço; a versão Maven está em .mvn/wrapper/maven-wrapper.properties |
| Go | Versão go e, quando presente, toolchain do go.mod do serviço |
| Construir/rodar imagem | Docker com daemon ativo e containers Linux |
| Implantar localmente | Kind, kubectl e Helm; Helmfile para o conjunto integrado |
| Alterar o portal | Python e dependências fixadas do MkDocs |
Há repositórios independentes em services/ e infra/; não existe build na raiz do workspace. Use o inventário para localizar o serviço e suas dependências.
Acesso ao código e dependências¶
O tutorial mostra o clone de JSON Handler (develop) e Infra Local (main). Em checkouts existentes, confira branch, alterações locais e upstream antes de git pull --ff-only. Uma falha de autenticação deve ser resolvida no acesso Git, sem descartar trabalho para forçar o pull.
Os serviços não têm todos as mesmas necessidades de acesso. Alguns POMs usam bibliotecas internas e os Dockerfiles de pipeline usam imagens privadas. A configuração Maven existente pode referenciar credenciais por variável de ambiente: obtenha acesso pelo processo do time e não copie segredos para o MkDocs. O build JVM do JSON Handler usa dependências públicas; o build local comprovado aproveitou o cache Maven disponível nesta máquina.
Conferir ferramentas e diretórios¶
No PowerShell:
git --version
java -version
# Dentro do repositório Java selecionado:
./mvnw.cmd --version
docker info
kind get clusters
kubectl config current-context
helm version --short
helmfile version
Para Go, execute go version e leia o go.mod antes de baixar dependências. Não use a indicação antiga de Go 1.21 do README Router: seu go.mod declara 1.25.0. Discovery declara go 1.23.0 e toolchain go1.26.1. Não há uma única versão inferida para toda a plataforma.
Se java -version ou o Wrapper mostrar Java 17, ajuste JAVA_HOME para seu JDK 21 e atualize o PATH da sessão. Os diretórios de instalação variam por máquina; não use o caminho pessoal de outro desenvolvedor.
Preparar dependências locais¶
JSON Handler não requer banco ou mensageria para o primeiro exercício. Outros serviços precisam de MongoDB, Redis/Valkey, identidade ou APIs externas. Consulte a matriz de dependências e a configuração do serviço antes de inicializá-lo.
Os nós e serviços do ambiente experimental estão descritos em Infraestrutura local. Os procedimentos para utilizá-los estão em Kind. Não substitua URLs de serviços por valores de produção para viabilizar testes locais.