Referência de componentes do Midaz

O Helm chart do Midaz faz o deploy de dois componentes de serviço: Ledger (o serviço core unificado, habilitado por padrão) e CRM (opcional). Cada componente tem seu próprio deployment, serviço, ingress e configuração de autoscaling.

Decisão rápida: Precisa de CRM? → defina crm.enabled: true.

Ledger

O serviço ledger combina os módulos onboarding e transaction em um único deployment. Ele é o único serviço core e vem habilitado por padrão.

Parâmetro	Descrição	Valor Padrão
`ledger.enabled`	Habilita ou desabilita o serviço ledger.	`true`
`ledger.name`	Nome do serviço.	`"ledger"`
`ledger.replicaCount`	Número de réplicas para o serviço Ledger.	`2`
`ledger.revisionHistoryLimit`	Número de ReplicaSets antigos mantidos para rollback do deployment.	`10`
`ledger.image.repository`	Repositório da imagem de container do serviço Ledger.	`"lerianstudio/midaz-ledger"`
`ledger.image.pullPolicy`	Política de pull da imagem.	`"IfNotPresent"`
`ledger.image.tag`	Tag da imagem usada para o deployment.	appVersion do chart (ex.: `"3.8.0"`); vazia usa Chart.AppVersion
`ledger.imagePullSecrets`	Secrets para pull de imagens de um registro privado.	`[]`
`ledger.nameOverride`	Sobrescreve o nome padrão gerado pelo Helm.	`""`
`ledger.fullnameOverride`	Sobrescreve o nome completo gerado pelo Helm.	`""`
`ledger.podAnnotations`	Annotations do pod para metadados adicionais.	`{}`
`ledger.podSecurityContext`	Contexto de segurança aplicado no nível do pod.	`{}`
`ledger.securityContext.*`	Define configurações de contexto de segurança para o container.	See `values.yaml`
`ledger.pdb.enabled`	Especifica se o PodDisruptionBudget está habilitado.	`true`
`ledger.pdb.minAvailable`	Número mínimo de pods disponíveis.	`1`
`ledger.pdb.maxUnavailable`	Número máximo de pods indisponíveis.	`1`
`ledger.pdb.annotations`	Annotations para o PodDisruptionBudget.	`{}`
`ledger.deploymentUpdate.*`	Estratégia de atualização do deployment.	See `values.yaml`
`ledger.service.type`	Tipo de serviço Kubernetes.	`"ClusterIP"`
`ledger.service.port`	Porta para a API HTTP.	`3002`
`ledger.service.annotations`	Annotations para o serviço.	`{}`
`ledger.ingress.enabled`	Especifica se o Ingress está habilitado.	`false`
`ledger.ingress.className`	Nome da classe do Ingress.	`""`
`ledger.ingress.annotations`	Annotations adicionais do ingress.	`{}`
`ledger.ingress.hosts`	Hosts configurados para Ingress e paths associados.	`[]`
`ledger.ingress.tls`	Configurações TLS para Ingress.	`[]`
`ledger.resources.*`	Requests/limits de recursos CPU/Memória.	See `values.yaml`
`ledger.livenessProbe.*`	Campos do liveness probe que sobrescrevem os padrões do chart: `path: /health`, `initialDelaySeconds: 0`, `periodSeconds: 10`, `timeoutSeconds: 1`, `successThreshold: 1`, `failureThreshold: 3`.	`{}`
`ledger.readinessProbe.*`	Campos do readiness probe que sobrescrevem os padrões do chart: `path: /readyz`, `initialDelaySeconds: 0`, `periodSeconds: 10`, `timeoutSeconds: 1`, `successThreshold: 1`, `failureThreshold: 3`.	`{}`
`ledger.initContainer.timeoutSeconds`	Segundos que o init container aguarda cada endpoint de banco de dados e de broker antes de o pod falhar na inicialização.	`300`
`ledger.autoscaling.enabled`	Especifica se o autoscaling está habilitado.	`true`
`ledger.autoscaling.minReplicas`	Número mínimo de réplicas para autoscaling.	`2`
`ledger.autoscaling.maxReplicas`	Número máximo de réplicas para autoscaling.	`9`
`ledger.autoscaling.targetCPUUtilizationPercentage`	Percentual alvo de utilização de CPU para autoscaling.	`80`
`ledger.autoscaling.targetMemoryUtilizationPercentage`	Percentual alvo de utilização de memória para autoscaling.	`80`
`ledger.nodeSelector`	Seletores de node para agendamento de pods.	`{}`
`ledger.tolerations`	Tolerations para agendamento de pods.	`{}`
`ledger.affinity`	Regras de afinidade para agendamento de pods.	`{}`
`ledger.configmap.*`	Variáveis de ambiente para o serviço.	See `values.yaml`
`ledger.secrets.*`	Secrets para o serviço.	See `values.yaml`
`ledger.useExistingSecret`	Usar um secret existente em vez de criar um novo.	`false`
`ledger.existingSecretName`	Nome do secret existente a ser usado.	`""`
`ledger.extraEnvVars`	Lista de variáveis de ambiente extras.	`[]`
`ledger.serviceAccount.create`	Especifica se a service account deve ser criada.	`true`
`ledger.serviceAccount.annotations`	Annotations para a service account.	`{}`
`ledger.serviceAccount.name`	Nome da service account. Se não definido, será gerado automaticamente.	`""`

Criando o secret do Ledger manualmente

Se você deseja usar um Kubernetes Secret existente para o serviço ledger, pode criá-lo manualmente:

kubectl create secret generic midaz-ledger \
  --from-literal=DB_ONBOARDING_PASSWORD='<your-db-onboarding-password>' \
  --from-literal=DB_ONBOARDING_REPLICA_PASSWORD='<your-db-onboarding-replica-password>' \
  --from-literal=MONGO_ONBOARDING_PASSWORD='<your-mongo-onboarding-password>' \
  --from-literal=DB_TRANSACTION_PASSWORD='<your-db-transaction-password>' \
  --from-literal=DB_TRANSACTION_REPLICA_PASSWORD='<your-db-transaction-replica-password>' \
  --from-literal=MONGO_TRANSACTION_PASSWORD='<your-mongo-transaction-password>' \
  --from-literal=REDIS_PASSWORD='<your-redis-password>' \
  --from-literal=RABBITMQ_DEFAULT_PASS='<your-rabbitmq-password>' \
  --from-literal=RABBITMQ_CONSUMER_PASS='<your-rabbitmq-consumer-password>' \
  -n midaz

O serviço ledger usa credenciais de banco de dados específicas por módulo (onboarding e transaction), pois combina ambos os módulos.

Depois configure o serviço ledger para usar este secret existente:

ledger:
  enabled: true
  useExistingSecret: true
  existingSecretName: "midaz-ledger"

CRM (Customer relationship management)

O serviço crm fornece APIs para gerenciar dados de holders e seus relacionamentos com contas do ledger. Anteriormente disponível como um chart separado (plugin-crm) implantado no namespace midaz-plugins, o CRM agora está integrado ao Helm chart principal do Midaz e é implantado no namespace midaz.

Se você está atualmente usando o plugin-crm no namespace midaz-plugins, recomendamos migrar para este novo workload integrado de CRM. Veja o guia Atualizando o Helm para os passos de migração.

Para mais detalhes sobre a funcionalidade do CRM, consulte a Documentação do CRM.

Habilitando o serviço CRM:

crm:
  enabled: true
  configmap:
    MONGO_HOST: "midaz-mongodb"  # Use your MongoDB host
    MONGO_NAME: "crm"
    MONGO_USER: "midaz"
  secrets:
    MONGO_PASSWORD: "lerian"

Parâmetro	Descrição	Valor Padrão
`crm.enabled`	Habilita ou desabilita o serviço CRM.	`false`
`crm.name`	Nome do serviço.	`"crm"`
`crm.replicaCount`	Número de réplicas para o serviço CRM.	`1`
`crm.revisionHistoryLimit`	Número de ReplicaSets antigos mantidos para rollback do deployment.	`10`
`crm.image.repository`	Repositório da imagem de container do serviço CRM.	`"lerianstudio/midaz-crm"`
`crm.image.pullPolicy`	Política de pull da imagem.	`"Always"`
`crm.image.tag`	Tag da imagem usada para o deployment.	appVersion do chart (ex.: `"3.8.0"`)
`crm.imagePullSecrets`	Secrets para pull de imagens de um registro privado.	`[]`
`crm.nameOverride`	Sobrescreve o nome padrão gerado pelo Helm.	`""`
`crm.fullnameOverride`	Sobrescreve o nome completo gerado pelo Helm.	`""`
`crm.podAnnotations`	Annotations do pod para metadados adicionais.	`{}`
`crm.podSecurityContext`	Contexto de segurança aplicado no nível do pod.	`{}`
`crm.securityContext.*`	Define configurações de contexto de segurança para o container.	See `values.yaml`
`crm.pdb.enabled`	Especifica se o PodDisruptionBudget está habilitado.	`true`
`crm.pdb.minAvailable`	Número mínimo de pods disponíveis.	`1`
`crm.pdb.maxUnavailable`	Número máximo de pods indisponíveis.	`1`
`crm.pdb.annotations`	Annotations para o PodDisruptionBudget.	`{}`
`crm.deploymentUpdate.type`	Tipo de estratégia de deployment.	`"RollingUpdate"`
`crm.deploymentUpdate.maxSurge`	Número máximo de pods que podem ser criados acima do número desejado.	`1`
`crm.deploymentUpdate.maxUnavailable`	Número máximo de pods que podem estar indisponíveis durante a atualização.	`1`
`crm.service.type`	Tipo de serviço Kubernetes.	`"ClusterIP"`
`crm.service.port`	Porta do serviço.	`4003`
`crm.service.annotations`	Anotações para o serviço.	`{}`
`crm.ingress.enabled`	Especifica se o Ingress está habilitado.	`false`
`crm.ingress.className`	Nome da classe do Ingress.	`""`
`crm.ingress.annotations`	Annotations adicionais do ingress.	`{}`
`crm.ingress.hosts`	Hosts configurados para Ingress e paths associados.	`[]`
`crm.ingress.tls`	Configurações TLS para Ingress.	`[]`
`crm.resources.*`	Requests/limits de recursos CPU/Memória.	See `values.yaml`
`crm.livenessProbe.*`	Campos do liveness probe que sobrescrevem os padrões do chart: `path: /health`, `initialDelaySeconds: 10`, `periodSeconds: 5`, `timeoutSeconds: 1`, `successThreshold: 1`, `failureThreshold: 3`.	`{}`
`crm.readinessProbe.*`	Campos do readiness probe que sobrescrevem os padrões do chart: `path: /readyz`, `initialDelaySeconds: 10`, `periodSeconds: 5`, `timeoutSeconds: 1`, `successThreshold: 1`, `failureThreshold: 3`.	`{}`
`crm.autoscaling.enabled`	Especifica se o autoscaling está habilitado.	`true`
`crm.autoscaling.minReplicas`	Número mínimo de réplicas para autoscaling.	`1`
`crm.autoscaling.maxReplicas`	Número máximo de réplicas para autoscaling.	`3`
`crm.autoscaling.targetCPUUtilizationPercentage`	Percentual alvo de utilização de CPU para autoscaling.	`80`
`crm.autoscaling.targetMemoryUtilizationPercentage`	Percentual alvo de utilização de memória para autoscaling.	`80`
`crm.nodeSelector`	Seletores de node para agendamento de pods.	`{}`
`crm.tolerations`	Tolerations para agendamento de pods.	`{}`
`crm.affinity`	Regras de afinidade para agendamento de pods.	`{}`
`crm.configmap.*`	Variáveis de ambiente para o serviço.	See `values.yaml`
`crm.secrets.*`	Secrets para o serviço.	See `values.yaml`
`crm.useExistingSecret`	Usar um secret existente em vez de criar um novo.	`false`
`crm.existingSecretName`	Nome do secret existente a ser usado.	`""`
`crm.extraEnvVars`	Lista de variáveis de ambiente extras.	`{}`

Criando o secret do CRM manualmente

Se você deseja usar um Kubernetes Secret existente para o serviço CRM:

kubectl create secret generic midaz-crm \
  --from-literal=LCRYPTO_HASH_SECRET_KEY='<your-hash-secret-key>' \
  --from-literal=LCRYPTO_ENCRYPT_SECRET_KEY='<your-encrypt-secret-key>' \
  --from-literal=MONGO_PASSWORD='<your-mongo-password>' \
  -n midaz

Depois configure o serviço CRM para usar este secret existente:

crm:
  enabled: true
  useExistingSecret: true
  existingSecretName: "midaz-crm"

Introdução

Midaz

Outros produtos

Referência de componentes do Midaz

Ledger

Criando o secret do Ledger manualmente

CRM (Customer relationship management)

Criando o secret do CRM manualmente

​Ledger

​Criando o secret do Ledger manualmente

​CRM (Customer relationship management)

​Criando o secret do CRM manualmente

Ledger

Criando o secret do Ledger manualmente

CRM (Customer relationship management)

Criando o secret do CRM manualmente