Infraestrutura

Instalação do Kmind no Kubernetes

Instale via Argo CD ou Helm CLI. Solicite ao time Kmind TENANT, CLUSTER_NAME e TOKEN antes de iniciar.

1. Pre-requisitos

Acesso administrativo ao cluster e kubectl configurado.
Helm 3 ou Argo CD configurado.
Acesso HTTPS de saida a partir do cluster.

kubectl get nodes

2. Informações fornecidas pelo Kmind

TENANT=ACME
CLUSTER_NAME=acme-prd
TOKEN=xxxxxxxxxxxxxxxx

Nunca publique o token em repositorios ou canais publicos.

Opção 1 - Instalação via Argo CD

Crie uma Application com o chart kmind-client, repositorio https://easytecs.github.io/helm-charts e targetRevision 0.6.8. Configure os mesmos valores de tenant, cluster, token, Promtail e Victoria Metrics apresentados na opcao Helm.

kubectl apply -f kmind-client.yaml
kubectl get application kmind-client -n argocd
kubectl get pods -n kmind-client

O estado esperado e Synced e Healthy.

Opção 2 - Instalação via Helm

1. Adicione o repositorio

helm repo add easytecs https://easytecs.github.io/helm-charts
helm repo update
helm search repo easytecs/kmind-client --versions

2. Crie kmind-values.yaml

kmind:
  host:
    name: https://activator.kmind.com.br
  tenant:
    name: TENANT
  cluster:
    name: CLUSTER_NAME
    token: TOKEN_INFORMADO_PELO_KMIND

promtail:
  config:
    clients:
      - url: https://log.kmind.com.br/loki/api/v1/push
        tenant_id: '1'
        headers:
          X-Scope-OrgID: '1'

victoria-metrics-agent:
  remoteWrite:
    - url: https://metrics.kmind.com.br/insert/1/prometheus/api/v1/write
      label: tenant=TENANT,cluster=CLUSTER_NAME

3. Instale o chart

helm upgrade --install kmind-client easytecs/kmind-client --namespace kmind-client --create-namespace --version 0.6.8 -f kmind-values.yaml

4. Validação e diagnóstico

kubectl get pods -n kmind-client
kubectl get pods -n kmind-client -w
helm status kmind-client -n kmind-client
kubectl get events -n kmind-client --sort-by=.metadata.creationTimestamp
kubectl logs -n kmind-client NOME_DO_POD

O release deve apresentar STATUS: deployed.

5. Requisitos de rede

Libere HTTPS para activator.kmind.com.br, log.kmind.com.br e metrics.kmind.com.br.

kubectl run kmind-network-test --rm -it --restart=Never --image=curlimages/curl --namespace kmind-client -- sh
curl -I https://activator.kmind.com.br
curl -I https://log.kmind.com.br
curl -I https://metrics.kmind.com.br

6. Atualização e remoção

helm repo update
helm upgrade kmind-client easytecs/kmind-client --namespace kmind-client --version NOVA_VERSAO -f kmind-values.yaml
helm uninstall kmind-client -n kmind-client
kubectl delete namespace kmind-client

Critério de conclusão

Namespace e pods kmind-client ativos.
Release deployed ou Application Healthy.
Cluster aparece na plataforma e o Kmind recebe dados.