> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral

> A Lerian instala e opera produtos Lerian no seu cluster Kubernetes pelo agente BYOC da Lerian, que abre a partir do seu cluster todas as conexões com a Lerian.

O **Lifecycle Management** funciona pelo agente BYOC da Lerian. Você instala o agente no seu cluster Kubernetes. Depois, a Lerian instala, faz upgrade, faz rollback e remove produtos Lerian no seu cluster pelo agente.

O agente instala e opera aplicações. Ele não cria infraestrutura de nuvem e não guarda nenhuma credencial de nuvem.

> [!NOTE]
>
> O Lifecycle Management está disponível no [modelo de deploy BYOC](https://docs.lerian.studio/pt/start-here/evaluate-and-deploy/deployment-models.md). No Lerian Cloud, a Lerian executa o deploy e as operações de ciclo de vida para você, e você não precisa do agente.

## Como o agente se conecta à Lerian

***

* Você instala um agente em cada cluster.
* O agente abre todas as conexões com a Lerian. O seu cluster não precisa de nenhum acesso de entrada vindo da Lerian.
* O agente se conecta à Lerian por HTTPS.
* Cada agente tem a sua própria credencial. A Lerian identifica a sua empresa por essa credencial, e não pelos dados que o agente envia.
* Dentro do cluster, o agente disponibiliza um endpoint de saúde e de métricas.

## O que a Lerian faz pelo agente

***

A seu pedido, a Lerian executa estas operações no seu cluster pelo agente:

* Instalar um produto Lerian.
* Fazer upgrade de um produto.
* Fazer rollback de um produto para uma versão anterior.
* Remover um produto.
* Verificar se o cluster atende às necessidades de um produto antes da instalação.

Se um upgrade falha, o agente faz o rollback do produto para a última versão que funcionava. O agente não faz rollback depois que uma mudança de esquema do banco de dados rodou. Nesse caso, o produto fica no upgrade que falhou.

O agente baixa o chart de um produto de um registro permitido, pelo digest de conteúdo exato que a Lerian indica. Ele recusa um chart que não tem digest.

O agente também informa à Lerian a saúde dos produtos que a Lerian pede para ele observar.

A Lerian também atualiza o próprio agente. Primeiro, o agente roda o novo build uma vez no seu cluster, como teste. Ele se substitui apenas quando esse teste passa.

## O que você controla

***

* **Namespaces**: você cria os namespaces onde o agente pode instalar produtos e os lista quando instala o agente. Para adicionar um namespace depois, faça upgrade do chart do agente.
* **Registros**: você define os registros dos quais o agente pode baixar charts de produtos e a própria imagem.
* **Credencial de registro privado**: se o seu registro precisa de uma credencial, o agente a envia apenas para esse registro.
* **Seu gerenciador de segredos**: o agente pode usar o seu próprio gerenciador de segredos pelo External Secrets.
* **Rede**: você pode limitar o tráfego de saída do agente e definir um proxy e as suas próprias autoridades certificadoras.
* **Remoção**: você pode desinstalar o agente.

Para cada uma dessas configurações, veja o [README do chart do agente](https://github.com/LerianStudio/helm/tree/main/charts/agent).

## O que a Lerian vê

***

O agente envia à Lerian informações sobre o seu cluster e os seus produtos. Por exemplo:

* **Em intervalos regulares**: o status do agente e a saúde de cada produto que ele observa.
* **Quando um produto parece não estar saudável**: a última saída dos containers parados dele e os eventos de aviso sobre o produto.
* **A pedido de um operador da Lerian**: o status do produto, uma prévia do upgrade, os valores de configuração calculados, o uso de recursos em tempo real e o resultado da verificação do cluster.

Para o inventário completo, com o momento em que cada item sai e o lugar onde chega, veja a seção "What leaves your cluster" no [README do chart do agente](https://github.com/LerianStudio/helm/tree/main/charts/agent).

## Segurança

***

* O agente roda como um usuário não root, com um sistema de arquivos somente leitura e sem privilégios adicionais.
* Em todo o cluster, o agente lê informações como nós, pods e serviços. Ele também pode criar namespaces e gerenciar storage classes.
* Nos namespaces que você lista, o agente instala produtos e grava os Secrets deles.
* Instale o agente em um namespace dedicado.

## Primeiros passos

***

**1. Peça ao suporte da Lerian**

Peça ao suporte da Lerian a credencial do agente e o endereço do plano de controle da Lerian.

**2. Crie os namespaces**

Crie os namespaces onde a Lerian instala produtos. Cada namespace deve existir antes de você instalar o agente.

**3. Instale o agente**

Instale o agente com o chart do agente, como descreve o [README do chart do agente](https://github.com/LerianStudio/helm/tree/main/charts/agent). Use a credencial, o endereço e os namespaces dos passos anteriores.

## Gerenciar os produtos instalados

***

Para instalar, fazer upgrade, fazer rollback ou remover um produto, envie uma solicitação por [Lerian Clients](https://docs.lerian.studio/pt/products/midaz/lerian-support-portal.md). A Lerian executa a operação no seu cluster pelo agente.

Para remover o próprio agente, desinstale o chart dele. Veja o [README do chart do agente](https://github.com/LerianStudio/helm/tree/main/charts/agent).

## Relacionados

***

> [card] [README do chart do agente](https://github.com/LerianStudio/helm/tree/main/charts/agent)
>
> Instale, configure e desinstale o agente BYOC da Lerian.

> [card] [Modelos de deploy](https://docs.lerian.studio/pt/start-here/evaluate-and-deploy/deployment-models.md)
>
> Compare o Lerian Cloud e o BYOC.

> [card] [Lerian Clients](https://docs.lerian.studio/pt/products/midaz/lerian-support-portal.md)
>
> Envie solicitações ao suporte da Lerian.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.