# Despliegue su primera aplicación

<TLDR>
En su proyecto abra **Despliegue**. Si aún no está configurado, pídale a la IA que lo configure. Elija una dirección gratuita, seleccione **Desplegar** y ábrala cuando esté en vivo. **Revertir** vuelve a cualquier despliegue anterior; **Agregar dominio** agrega su propio nombre.
</TLDR>

## Qué va a construir [#qué-va-a-construir]

Una aplicación en vivo en su propia dirección gratuita, construida con el código de su <Term id="project">proyecto</Term>. La <Term id="deploy">desplegará</Term>, la revisará y verá cómo revertir, desconectarla y agregar un dominio.

## Antes de empezar [#antes-de-empezar]

- Un proyecto con una aplicación. Vea [Su primer proyecto](/docs/es/guides/first-project).
- <Term id="credits">Créditos</Term>: una aplicación en vivo se paga con créditos mientras se ejecuta. Vea [Créditos](/docs/es/workspace/credits).
- Opcional: el proyecto enlazado a un repositorio de GitHub, para que cada push publique una versión nueva.

<Callout type="warn" title="Desplegar requiere Pro">
La prueba gratis construye y ejecuta todo en <Term id="studio">Studios</Term>; desplegar aplicaciones viene con Pro. Vea [Facturación](/docs/es/workspace/billing).
</Callout>

## Pasos [#pasos]

<Steps>
<Step>
### Abra Despliegue [#abra-despliegue]
Abra su proyecto y su pestaña **Despliegue**, o vaya a <AppLink to="deploy" />.

<Screenshot src="/docs/_media/dashboard-project-page-not-running.png" alt="La pestaña Despliegue de un proyecto antes de configurarlo, con el aviso de que aún no está configurado" />
</Step>
<Step>
### Configure el proyecto para desplegar [#configure-el-proyecto-para-desplegar]
Si ve que el proyecto aún no está configurado para desplegar, describa qué debe ejecutar la aplicación y pida la configuración. La IA lee su repositorio y configura cada parte de la forma más barata. Luego cada parte aparece en la configuración del despliegue.
</Step>
<Step>
### Elija cómo se ejecuta [#elija-cómo-se-ejecuta]
Para cada parte, elija una configuración de ejecución:

- **Duerme en reposo**: arranca con una visita y no cuesta nada en reposo. La primera visita tras un rato quieto tarda unos segundos.
- **Siempre activo, más barato**: sigue en ejecución a menor precio y puede reiniciarse de vez en cuando.
- **Siempre activo**: sigue en ejecución y nunca se interrumpe.

Cada una muestra lo máximo que puede costar por hora a plena carga. Vea [Configuración de ejecución](/docs/es/deploy/run-settings).
</Step>
<Step>
### Elija la dirección gratuita de su aplicación [#elija-la-dirección-gratuita-de-su-aplicación]
Elija un nombre de 3 a 30 letras minúsculas, dígitos y guiones sencillos. Es gratis y sigue funcionando después de agregar su propio dominio.
</Step>
<Step>
### Despliegue [#despliegue]
<ForEveryone>
Seleccione **Desplegar**. Se construye con el último commit y muestra cada paso hasta quedar en vivo.
</ForEveryone>

<ForDevelopers>
Desde una terminal en el proyecto, o desde cualquier lugar con su clave de API configurada:

```bash
klarety deploy --project <project-id>
```

Despliega la rama de GitHub enlazada, o el commit actual si no hay ninguna, e imprime el `deploy_id`. Dentro de un Studio no hace falta `--project`. Desde Python:

```python
from klarety import Nexus

nx = Nexus.connect()
deploy_id = nx.projects.deploy("<project-id>")
```
</ForDevelopers>

Si el despliegue lo pidió una IA, espera a una persona: seleccione **Aprobar y desplegar**, o rechácelo. Vea [Aprobaciones](/docs/es/deploy/approvals).
</Step>
<Step>
### Abra su aplicación [#abra-su-aplicación]
Cuando el despliegue esté en vivo, el resumen del proyecto muestra su dirección. Ábrala.
</Step>
</Steps>

<Screenshot src="/docs/_media/project-deployed-filtered-live-domains-deployment-history.png" alt="La pestaña Despliegue con un despliegue en vivo, su dirección gratuita y la lista de despliegues" />

## Compruebe que funcionó [#compruebe-que-funcionó]

- Su dirección responde en el navegador.
- La lista de despliegues muestra el despliegue en vivo, con cuánto tardó.
- La **Actividad** del proyecto muestra el despliegue en vivo.

## Variaciones comunes [#variaciones-comunes]

- **Volver a publicar.** **Volver a publicar** construye la última versión y reemplaza la aplicación en vivo cuando está lista.
- **Revertir.** Elija **Revertir** en cualquier despliegue anterior. No se reconstruye nada, y puede volver igual.
- **Desconectarla.** **Desconectar** detiene la aplicación al instante, así no cuesta nada. Nombre, datos y despliegues se conservan; revierta o despliegue para traerla de vuelta.
- **Usar su propio dominio.** Seleccione **Agregar dominio** y elija comprar un dominio nuevo (se paga con créditos y se configura por usted), conectar un dominio externo (gratis, agregue dos registros DNS donde lo administra) o usar un dominio ya conectado. Vea [Dominios](/docs/es/deploy/domains).

<Callout type="warn" title="Comprar un dominio cuesta créditos">
Un dominio comprado se cobra en créditos de inmediato por un año y se renueva cada año mientras la renovación esté activa.
</Callout>

## Si algo sale mal [#si-algo-sale-mal]

Un despliegue fallido muestra qué pasó en palabras sencillas, con lo que imprimió su aplicación. **Arreglar con IA** hace que la IA del Studio encuentre y corrija la causa.

<Accordions>
<Accordion title="Su aplicación no empezó a responder en el puerto a tiempo">
Su aplicación debe escuchar en la variable `PORT` sobre `0.0.0.0`. Si tarda en arrancar, cargue las bibliotecas grandes en el primer uso y no al arrancar.
</Accordion>
<Accordion title="No se encontró una dependencia">
Revise su nombre y versión en el archivo de dependencias de su aplicación.
</Accordion>
<Accordion title="Su aplicación se quedó sin memoria">
Dele más memoria a esa parte de la aplicación, o haga que use menos al arrancar. Pídale a la IA que cambie la configuración del despliegue.
</Accordion>
<Accordion title="La nueva versión falló demasiadas solicitudes">
Klarety devuelve a los visitantes a la versión anterior. Lea los registros de su aplicación, corrija los errores y despliegue de nuevo. Vea [Registros](/docs/es/deploy/logs).
</Accordion>
<Accordion title="Despliegue pide Pro">
Desplegar aplicaciones viene con Pro. Empiece Pro desde <AppLink to="settings.billing" />.
</Accordion>
</Accordions>

## Siguientes pasos [#siguientes-pasos]

- [Desplegar una aplicación](/docs/es/deploy/deploy-an-app): cada opción de despliegue.
- [Dominios](/docs/es/deploy/domains): compre o conecte su propio dominio.
- [Configuración de ejecución](/docs/es/deploy/run-settings): costo y velocidad de cada parte de su aplicación.
- [Registros](/docs/es/deploy/logs): vea lo que imprime su aplicación en vivo.