> ## 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
> Orquestre o ciclo de vida completo das aplicações Lerian na infraestrutura do cliente com integração nativa de Helm Charts e Kubernetes.
O **Lifecycle Management** é construído sobre a [plataforma Distr](https://distr.sh/docs/getting-started/what-is-distr/) para orquestrar o ciclo de vida completo de aplicações Lerian em infraestrutura de propriedade do cliente. Seja rodando em nuvem privada, on-premises ou em configuração híbrida, esta ferramenta dá à sua equipe acesso direto aos nossos **Helm Charts** oficiais, permitindo deploys rápidos, seguros e autogerenciados.
Com integração nativa com Kubernetes e segurança de nível enterprise, esta ferramenta é a base para operações confiáveis, escaláveis e em conformidade em qualquer ambiente.
O Lifecycle Management é a base operacional do [modelo de deployment BYOC](/pt/deployment-models). Se você está usando o modelo **SaaS**, a Lerian cuida do deployment e das operações de ciclo de vida para você — esta ferramenta não é necessária.
## Por que usar o Lifecycle Management?
***
O Lifecycle Management é construído para suportar as realidades da infraestrutura moderna:
* **Bring Your Own Cluster (BYOC)**: Execute a Lerian em ambientes Kubernetes gerenciados pelo cliente.
* **Distribuição protegida por token**: Acesso seguro a repositórios Helm e imagens OCI.
* **Visibilidade operacional**: Monitore versões implantadas e saúde do sistema em tempo real.
* **Autonomia total**: Tenha controle total sobre instalações, upgrades e rollbacks.
### Principais funcionalidades
#### Deploy na sua infraestrutura
Instale serviços Lerian em ambientes que você controla totalmente, seja on-premises, em nuvem privada ou em configuração híbrida. O plugin é construído para atender padrões rigorosos de conformidade, proteção de dados e segurança.
#### Integrado com Kubernetes
Nossas aplicações são empacotadas como imagens OCI e Helm Charts, então você pode usar ferramentas padrão do Kubernetes para fazer deploy, configurar e operar seus serviços.
#### Seguro por padrão
Todo acesso a artefatos é protegido por token. Apenas usuários autenticados podem recuperar Helm Charts e imagens de container, garantindo integridade do deploy.
#### Visibilidade sem comprometimento
Nossa equipe de suporte pode monitorar remotamente seu deploy sem infringir sua autonomia. Nós rastreamos:
* Versões implantadas.
* Sinais de saúde e disponibilidade.
* Compatibilidade com releases suportados.
### Controle total do ciclo de vida
Gerencie todo o seu fluxo de trabalho de deploy usando o dashboard ou ferramentas nativas do Kubernetes:
* Instalar novos ambientes.
* Aplicar upgrades e patches.
* Fazer rollback para uma versão anterior.
* Fixar uma versão conforme necessário.
### Atualizações padronizadas e sem fricção
Nosso pipeline de atualização garante que você possa adotar as versões mais recentes rapidamente, com mínima interrupção ao seu ambiente de produção.
## Acessando o dashboard do Lifecycle
***
O dashboard do Lifecycle está disponível apenas para clientes **Enterprise BYOC**. Usuários Community gerenciam deploys diretamente usando Helm Charts e a documentação. Se você está no modelo SaaS, a Lerian cuida do deployment para você.
Antes de poder instalar aplicações Lerian, você precisará de acesso ao dashboard do Lifecycle. É aqui que você criará deploys, configurará agents e gerenciará seus ambientes.
Para começar:
Envie um **email corporativo** válido para a **Equipe de Implementação**, ou via email para [suporte@lerian.studio](mailto:suporte@lerian.studio).
Nós registraremos seu email e dispararemos um convite da plataforma.
Verifique sua caixa de entrada e siga o link do convite.
Crie sua senha para ativar sua conta.
Faça login em [https://lifecycle.lerian.studio/](https://lifecycle.lerian.studio/) e comece a gerenciar seus deploys.
Esses passos dão acesso ao dashboard. A instalação real do plugin começa quando você cria um deploy e instala o agent no seu cluster Kubernetes.
## Guia de instalação
***
Uma vez que você tenha acesso ao dashboard, siga estes passos para instalar e configurar o produto Lerian que você deseja implantar.
### 1. Acesse o dashboard do Lifecycle Management
Vá para [https://lifecycle.lerian.studio/login](https://lifecycle.lerian.studio/login) e faça login com suas credenciais.
### 2. Crie um novo deploy
Na barra de navegação, clique em *Deployments*.
* Se você ainda não tem deploys, a janela **Create New Deployment** aparece automaticamente.
* Caso contrário, clique em **+ New Agent.**
Selecione **Kubernetes via Helm Chart**.
Preencha o **Agent Name** e o **Kubernetes Namespace**.
Certifique-se de que **Enable cluster-scope permissions** não está habilitado.
Clique em Continue.
### 3. Instale o agent no seu cluster
Após selecionar o tipo de agent, a tela seguinte mostra um comando `kubectl` personalizado para seu deploy.
#### 3.1. Antes de executar o comando:
Verifique se o namespace existe:
```
kubectl get namespace
```
Se não existir, crie-o:
```
kubectl create namespace midaz
```
#### 3.2. Copie o comando Helm install da janela de instalação do novo Agent.
Ele tipicamente se parece com isso, mas com seu token e ambiente únicos:
```
kubectl apply -n midaz -f "https://app.distr.sh/api/v1/connect?targetId=115c891b-89da-46bb-ac22-b13f507dcf5d&targetSecret=40767acb4e78974d445df26db1b3c642"
```
Sempre copie o comando exatamente como mostrado na UI. Ele inclui valores específicos do deploy.
#### 3.3. Execute o comando no seu terminal.
Use um terminal conectado ao seu cluster Kubernetes e execute o seguinte comando:
```
kubectl apply -n midaz -f "https://app.distr.sh/api/v1/connect?targetId=115c891b-89da-46bb-ac22-b13f507dcf5d&targetSecret=40767acb4e78974d445df26db1b3c642"
```
#### 3.4. Confirme que o agent foi instalado
Para verificar se o agent foi instalado com sucesso:
```
kubectl get pods -n midaz
```
Você deve ver um pod chamado `distr-agent-xxxxx` com o status Running.
#### 3.5. Clique no botão Continue na janela Install a new Agent.
### 4. Configure sua aplicação
Selecione a aplicação que você deseja implantar e a versão.
Os Helm values serão exibidos automaticamente. Você pode usar a seção **Helm values** para aplicar configuração específica do ambiente, como:
* Contagem de réplicas.
* Secrets e variáveis de ambiente.
* Configurações de domínio e ingress.
**Nunca** use as informações padrão do Helm. São informações de exemplo e nunca devem ser usadas em ambiente de produção.
É recomendado que após definir seus secrets e variáveis para usar no Helm, **salve uma cópia dos seus secrets definidos no seu serviço de gerenciamento de secrets**.
### 5. Monitore seu deploy
Você pode acompanhar o status de duas formas:
* No seu cluster Kubernetes, usando kubectl ou seu dashboard preferido.
* No dashboard do Lifecycle, com uma visão centralizada do status do agent e versões implantadas.
Para configuração detalhada do Helm agent e capacidades avançadas, consulte a documentação oficial do Distr: [Onboarding a Helm App](https://distr.sh/docs/guides/onboarding-a-helm-app/#creating-a-new-deployment)