> ## 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.

# Resumen

> Orquesta el ciclo de vida completo de las aplicaciones Lerian en la infraestructura del cliente con integración nativa de Helm Charts y Kubernetes.

El herramienta **Lifecycle Management** está construida sobre la [plataforma Distr](https://distr.sh/docs/getting-started/what-is-distr/) para orquestar el ciclo de vida completo de aplicaciones Lerian en infraestructura propiedad del cliente. Ya sea que estés ejecutando en una nube privada, on-premises o una configuración híbrida, este plugin le da a tu equipo acceso directo a nuestros **Helm Charts** oficiales, permitiendo despliegues rápidos, seguros y autogestionados.

Con integración nativa de Kubernetes y seguridad de nivel empresarial, esta herramienta es la base para operaciones confiables, escalables y conformes en cualquier entorno.

<Note>
  Lifecycle Management es la base operativa del [modelo de despliegue BYOC](/es/deployment-models). Si estás usando el modelo **SaaS**, Lerian se encarga del despliegue y las operaciones de ciclo de vida por ti — esta herramienta no es necesaria.
</Note>

## ¿Por qué usar Lifecycle Management?

***

Lifecycle Management está construido para soportar las realidades de la infraestructura moderna:

* **Trae Tu Propio Cluster (BYOC)**: Ejecuta Lerian en entornos Kubernetes gestionados por el cliente.
* **Distribución protegida por token**: Acceso seguro a repositorios Helm e imágenes OCI.
* **Visibilidad operacional**: Monitorea versiones desplegadas y salud del sistema en tiempo real.
* **Autonomía total**: Toma control completo sobre instalaciones, actualizaciones y reversiones.

### Características clave

#### Despliega en tu infraestructura

Instala servicios Lerian en entornos que controlas completamente, ya sea on-premises, en una nube privada o en una configuración híbrida. El plugin está construido para cumplir con estrictos estándares de cumplimiento, protección de datos y seguridad.

#### Integrado con Kubernetes

Nuestras aplicaciones están empaquetadas como imágenes OCI y Helm Charts, para que puedas usar herramientas estándar de Kubernetes para desplegar, configurar y operar tus servicios.

#### Seguro por defecto

Todo acceso a artefactos está protegido por token. Solo usuarios autenticados pueden recuperar Helm Charts e imágenes de contenedores, asegurando la integridad del despliegue.

#### Visibilidad sin comprometer

Nuestro equipo de soporte puede monitorear remotamente tu despliegue sin infringir en tu autonomía. Rastreamos:

* Versiones desplegadas.
* Señales de salud y disponibilidad.
* Compatibilidad con lanzamientos soportados.

### Control total del ciclo de vida

Gestiona todo tu flujo de trabajo de despliegue usando el dashboard o herramientas nativas de Kubernetes:

* Instala nuevos entornos.
* Aplica actualizaciones y parches.
* Revierte a una versión anterior.
* Fija una versión según sea necesario.

### Actualizaciones estandarizadas y sin fricciones

Nuestro pipeline de actualizaciones asegura que puedas adoptar las últimas versiones rápidamente, con mínima disrupción a tu entorno de producción.

## Acceder al dashboard de Lifecycle

***

<Note>
  El dashboard de Lifecycle está disponible solo para clientes **Enterprise BYOC**. Los usuarios Community gestionan despliegues directamente usando Helm Charts y la documentación. Si estás en el modelo SaaS, Lerian se encarga del despliegue por ti.
</Note>

Antes de poder instalar aplicaciones Lerian, necesitarás acceso al dashboard de Lifecycle. Aquí es donde crearás despliegues, configurarás agentes y gestionarás tus entornos.

Para comenzar:

<Steps>
  <Step>
    Envía un **correo electrónico corporativo** válido al **Equipo de Implementación**, o vía correo electrónico a [suporte@lerian.studio](mailto:suporte@lerian.studio).
  </Step>

  <Step>
    Registraremos tu correo electrónico y activaremos una invitación desde la plataforma.
  </Step>

  <Step>
    Revisa tu bandeja de entrada y sigue el enlace de invitación.
  </Step>

  <Step>
    Crea tu contraseña para activar tu cuenta.
  </Step>

  <Step>
    Inicia sesión en [https://lifecycle.lerian.studio/](https://lifecycle.lerian.studio/) y comienza a gestionar tus despliegues.
  </Step>
</Steps>

<Note>
  Estos pasos te dan acceso al dashboard. La instalación real del plugin comienza cuando creas un despliegue e instalas el agente en tu cluster de Kubernetes.
</Note>

## Guía de instalación

***

Una vez que tengas acceso al dashboard, sigue estos pasos para instalar y configurar el producto Lerian que deseas desplegar.

### 1. Acceder al dashboard de Lifecycle Management

Ve a [https://lifecycle.lerian.studio/login](https://lifecycle.lerian.studio/login) e inicia sesión con tus credenciales.

### 2. Crear un nuevo despliegue

<Steps>
  <Step>
    En la barra de navegación, haz clic en **Deployments**.

    * Si aún no tienes ningún despliegue, la ventana **Install a new Agent** aparece automáticamente.
    * De lo contrario, haz clic en **+ New Agent.**
  </Step>

  <Step>
    Selecciona **Kubernetes via Helm Chart**.
  </Step>

  <Step>
    Completa el **Agent Name** y el **Kubernetes Namespace**.
  </Step>

  <Step>
    Asegúrate de que **Enable cluster-scope permissions** no esté habilitado.
  </Step>

  <Step>
    Haz clic en **Continue**.
  </Step>
</Steps>

### 3. Instalar el agente en tu cluster

Después de seleccionar el tipo de agente, la siguiente pantalla muestra un comando `kubectl` personalizado para tu despliegue.

#### 3.1. Antes de ejecutar el comando:

Verifica si el namespace existe:

```
kubectl get namespace
```

Si no existe, créalo:

```
kubectl create namespace midaz
```

#### 3.2. Copia el comando de instalación de Helm desde la ventana install new Agent.

Típicamente se ve así, pero con tu token y entorno únicos:

```
kubectl apply -n midaz -f "https://app.distr.sh/api/v1/connect?targetId=115c891b-89da-46bb-ac22-b13f507dcf5d&targetSecret=40767acb4e78974d445df26db1b3c642"
```

<Danger>
  Siempre copia el comando exactamente como se muestra en la interfaz. Incluye valores específicos del despliegue.
</Danger>

#### 3.3. Ejecuta el comando en tu terminal.

Usa una terminal conectada a tu cluster de Kubernetes y ejecuta el siguiente comando:

```
kubectl apply -n midaz -f "https://app.distr.sh/api/v1/connect?targetId=115c891b-89da-46bb-ac22-b13f507dcf5d&targetSecret=40767acb4e78974d445df26db1b3c642"
```

#### 3.4. Confirma que el agente fue instalado

Para verificar que el agente se instaló exitosamente:

```
kubectl get pods -n midaz
```

Deberías ver un pod llamado `distr-agent-xxxxx` con el estado Running.

#### 3.5. Haz clic en el botón Continue en la ventana Install a new Agent.

### 4. Configurar tu aplicación

<Steps>
  <Step>
    Selecciona la aplicación que deseas desplegar y la versión.
  </Step>

  <Step>
    Los valores de Helm se mostrarán automáticamente. Puedes usar la sección **Helm values** para aplicar configuración específica del entorno, como:

    * Conteos de réplicas.
    * Secretos y variables de entorno.
    * Configuración de dominio e ingress.
  </Step>
</Steps>

<Danger>
  **Nunca** uses la información predeterminada de Helm. Es información de ejemplo y nunca debe usarse en un entorno de producción.
</Danger>

Se recomienda que después de definir tus secretos y variables para usar en Helm, **guardes una copia de tus secretos definidos en tu servicio de gestor de secretos**.

### 5. Monitorear tu despliegue

Puedes rastrear el estado de dos formas:

* En tu cluster de Kubernetes, usando kubectl o tu dashboard preferido.
* En el dashboard de Lifecycle, con una vista centralizada del estado del agente y versiones desplegadas.

<Note>
  Para configuración detallada del agente Helm y capacidades avanzadas, consulta la documentación oficial de Distr: [Onboarding a Helm App](https://distr.sh/docs/guides/onboarding-a-helm-app/#creating-a-new-deployment)
</Note>
