Kubernetes Dev Stack

Este repositório contém scripts, manifests e instruções para deploy e validação de múltiplos componentes em um ambiente Kubernetes para desenvolvimento e testes. Cada pasta representa um componente independente do stack. Siga as instruções de cada seção para realizar o deployment e validação.

Pré-requisitos

• Kubernetes (k3s, minikube, kind, ou cluster compatível)
• kubectl configurado
• Helm instalado
• Acesso administrativo ao cluster
• Bash/zsh

Componentes

Cada pasta abaixo representa um componente. Siga a ordem sugerida para evitar dependências não resolvidas.

---

1. Hyperledger Besu

Descrição

Scripts e manifests para deploy do Besu (Ethereum Client) com suporte a ingress, middlewares e serviços.

Deployment

cd besu
./besu-install-script.sh

• Para customizar valores, edite besu-install-values.yaml.
• Para deploy do genesis, use ./besu-genesis-deploy.sh.
• Para troubleshooting, consulte BESU_INGRESS_TROUBLESHOOTING.md e scripts de diagnose.

Validação

• Execute ./test-direct.sh para testar acesso direto.
• Execute ./test-external-access.sh para validar acesso externo.
• Use ./diagnose-besu-404.sh para investigar problemas de ingress.

---

2. Apache Kafka (Strinzi)

Descrição

Deploy do Apache Kafka usando Strimzi Operator.

Deployment

cd kafka
./deploy-kafka.sh

• Edite strimzi-values.yaml para customizações.
• O operador está em strimzi-kafka-operator/.

Validação

• Execute ./check-kafka.sh para validar o cluster.
• Use ./cleanup-kafka.sh para remover recursos.

---

3. MongoDB Community

Descrição

Deploy do MongoDB com suporte a operador e acesso externo.

Deployment

cd mongodb
./deploy-mongodb.sh

• Edite mongodb-values.yaml para customizações.
• O operador está em helm/.

Validação

• Execute ./test-mongodb.sh para validar o deployment.
• Use ./test-external-connection.sh para testar acesso externo.
• Scripts adicionais para debug: debug-mongodb.sh, test-nodeport-connection.sh.

---

4. LF Descentralized Trust Paladin

Descrição

Manifests de ingress, middlewares e valores para o serviço Paladin.

Deployment

O deploy do Paladin pode ser realizado de forma automatizada utilizando o script paladin-install.sh presente na pasta paladin. O script executa todos os passos necessários para instalação dos CRDs, cert-manager, operador Paladin e, opcionalmente, aplica os ingressos, ingressroutes de UI e middlewares.

Instalação padrão (hostNetwork, sem ingress):

cd paladin
chmod +x paladin-install.sh
./paladin-install.sh

Instalação com ingressos, ingressroutes de UI e middlewares:

cd paladin
chmod +x paladin-install.sh
./paladin-install.sh --with-ingress

O script irá:

• Instalar os CRDs do Paladin
• Instalar e verificar o cert-manager
• Instalar o operador Paladin
• (Opcional) Aplicar todos os ingressos, ingressroutes de UI e middlewares necessários

Para customizar a rede Paladin, edite o arquivo de valores: paladin/paladin-values.yaml

---

Validação

• Verifique os ingressroutes e middlewares aplicados:

  kubectl get ingressroutes
  kubectl get middleware

---

5. PostgreSQL

Descrição

Scripts e valores para deploy do PostgreSQL.

Deployment

cd postgres
./postgresql-deploy.sh

• Edite postgresql-values.yaml para customizações.

Validação

• Verifique os pods e serviços:

  kubectl get pods -n <namespace>
  kubectl get svc -n <namespace>

---

6. Redis

Descrição

Deploy do Redis via script e valores customizáveis.

Deployment

cd redis
./deploy-redis.sh

• Edite redis-values.yaml para customizações.

Validação

• Verifique os pods e serviços:

  kubectl get pods -n <namespace>
  kubectl get svc -n <namespace>

---

7. RedPanda

Descrição

Deploy do Redpanda (streaming platform) com suporte a TLS.

Deployment

cd redpanda
./deploy-redpanda.sh

• Edite redpanda-values.yaml ou redpanda-values-monitoring.yaml para customizações.

Validação

• Verifique os pods e serviços:

  kubectl get pods -n <namespace>
  kubectl get svc -n <namespace>

---

8. Hashicorp Vault

Descrição

Deploy e inicialização do HashiCorp Vault.

Deployment

cd vault
./deploy-vault.sh
./init-vault.sh

• Edite vault-values.yaml para customizações.
• Siga as instruções de unseal em vault-unseal.txt.

Validação

• Execute ./test-vault.sh para validar o funcionamento.
• Use ./check-vault.sh para status.

---

9. Hyperledger Firefly

Descrição

Scripts e arquivos de configuração para o Firefly.

Deployment

• Siga as instruções do arquivo bash.txt ou scripts presentes na pasta.

Validação

• Consulte logs e status dos pods:

  kubectl get pods -n <namespace>
  kubectl logs <pod>

---

10. Scripts Gerais

• install.sh: Instalação geral do stack.
• cleanup_history.sh: Limpeza de histórico de deploys.

---

Observações Gerais

• Sempre verifique os namespaces utilizados em cada componente.
• Consulte os arquivos README.md específicos de cada subdiretório, se existirem, para detalhes adicionais.
• Para troubleshooting, utilize os scripts de diagnose presentes em cada pasta.

---

Contato

Dúvidas ou problemas? Abra uma issue ou entre em contato com o mantenedor do repositório.