Inicio rápido de la app

Inicio rápido de apps

Este inicio rápido despliega una app en Lizard (lizard.build) en unos minutos. Instala Lizard CLI: el instalador inicia tu sesión y te ofrece la prueba de Pro de 7 días. Luego ejecuta lizard add -r owner/repo para un repositorio de GitHub o lizard up para una carpeta local. Lizard compila la app en sus servidores, sin Docker local, y le da una URL HTTPS en onlizard.com. Tu cuenta se crea la primera vez que inicias sesión.

1. Instala la CLI

En macOS o Linux, ejecuta el script de instalación:

curl -fsSL https://lizard.build/install.sh | bash

Instala el binario lizard en ~/.lizard/bin, añade esa carpeta a tu PATH en ~/.zshrc o ~/.bashrc, y enlaza lizard en una carpeta que ya está en tu PATH, así que funciona al momento en esta terminal. Desde entonces el binario se actualiza solo, salvo en CI. Si el script avisa de que quizá no se encuentre lizard, abre una terminal nueva. Comprueba la versión:

lizard --version

En Windows, ejecuta esto en PowerShell:

irm https://lizard.build/api/cli/install.ps1 | iex

Los dos scripts de instalación terminan ejecutando lizard login, que hace por ti los pasos 2 y 3: inicia tu sesión y te ofrece la prueba de Pro. Define LIZARD_NO_LOGIN=1 para saltarlo; en CI los scripts lo saltan solos.

O instala desde npm (requiere Node.js 20 o posterior). Una instalación con npm no inicia sesión, así que sigue con el paso 2:

npm install -g @lizard-build/cli

No uses npx. Usa siempre el binario lizard instalado globalmente. Ejecutar npx @lizard-build/cli descarga una copia temporal cuya versión puede diferir de la plataforma. Para actualizar más adelante una instalación de npm, ejecuta npm install -g @lizard-build/cli@latest.

¿Errores de permisos (EACCES)? No uses sudo. Usa el script de instalación de arriba, que no necesita permisos de administrador, o haz que npm apunte a un prefijo propiedad de tu usuario:

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
npm install -g @lizard-build/cli

2. Inicia sesión

Sáltate este paso si el script de instalación ya inició tu sesión. Si no, ejecuta:

lizard login

Te pregunta si inicias sesión con GitHub o con Google, abre esa página en tu navegador y espera a que lo apruebes. Si ya tienes cuenta, elige el método con el que te registraste: el otro abre una segunda cuenta vacía, salvo que ambos compartan un email verificado. --github o --google se salta la pregunta. En una máquina que ya tiene la sesión iniciada, lizard login solo muestra la cuenta, así que puedes ejecutarlo otra vez sin riesgo.

También puedes saltarte lizard login: cualquier comando que ejecutes en una terminal inicia la sesión de la misma forma primero y luego sigue.

En CI u otros entornos no interactivos, autentícate con un token en su lugar:

export LIZARD_TOKEN=liz_xxx
# or
lizard login --token liz_xxx

Las claves de API empiezan por liz_. Crea una con lizard keys create <name>. LIZARD_API_KEY funciona en lugar de LIZARD_TOKEN. lizard login --token-stdin lee la clave desde una tubería (pipe), así no queda en el historial de tu shell.

Comprueba quién eres en cualquier momento:

lizard whoami

3. Empieza la prueba de Pro

Una cuenta nueva no tiene plan, y los despliegues necesitan uno. Nada más iniciar sesión, lizard login te ofrece la prueba de Pro de 7 días. Si aceptas, abre Stripe Checkout, donde añades una tarjeta. La prueba incluye $5 de uso y no se cobra nada hasta que termina. A una cuenta que ya tuvo su prueba se le ofrece Pro por $19 al mes.

Si dijiste que no, empiézala más tarde:

lizard billing start

Mientras no haya un plan, crear cualquier cosa devuelve HTTP 402 con un enlace de Checkout. Consulta Facturación y lizard billing.

4. Despliega

Elige la ruta que coincida con dónde vive tu código.

Opción A — Desplegar un repositorio de GitHub (recomendado)

Si tu código está en GitHub, crea un servicio directamente desde el repositorio. Lizard lo clona, detecta el stack y empieza la primera compilación:

lizard add -r your-org/your-app

El comando termina en cuanto existe el servicio; la compilación sigue. El paso 5 muestra cómo seguirla y encontrar la URL.

Para un repositorio privado, y para que los pushes a la rama seguida vuelvan a desplegar la app, conecta primero la Lizard GitHub App con lizard git:

lizard git connect

Opción B — Desplegar código local

Desde dentro del directorio de tu proyecto, sube y despliega la carpeta actual (respeta .gitignore):

lizard up

La primera vez pide un nombre para el servicio; por defecto, el de la carpeta. Luego sigue la compilación e imprime la URL, como https://your-app-x1y2z.onlizard.com, cuando la app ya está en marcha.

Si la carpeta aún no está vinculada a un proyecto, lizard add y lizard up usan tu proyecto por defecto y lo indican. Es el proyecto más antiguo de tu espacio de trabajo personal; una cuenta nueva recibe uno al registrarse. lizard up además vincula la carpeta a él, así que el siguiente lizard up actualiza el mismo servicio. Para desplegar en otro proyecto, ejecuta primero lizard init --name my-project. Hazlo también en CI, para que el despliegue llegue adonde esperas.

Lizard detecta la mayoría de los stacks por sí solo. Para el comando de compilación, el comando de inicio y el puerto exactos de tu framework, consulta la guía de Next.js, React, Vue, Astro, SvelteKit, Node.js, Django, FastAPI, Rails o Go. Una app con su propio Dockerfile sigue Desplegar con un Dockerfile.

5. Observa cómo compila y se ejecuta

lizard ps               # services in the project, with status + URL
lizard logs             # stream runtime logs (Ctrl+C to stop)
lizard logs --tail 100  # print the last 100 lines and exit
lizard logs --build     # the most recent build's logs
lizard open             # open the project in the dashboard

lizard open muestra el mismo proyecto en el panel. Para métricas, costos e historial de despliegues, consulta Observabilidad.

6. Añade una base de datos (opcional)

Aprovisiona Managed Postgres. Cada servicio del proyecto recibe su DATABASE_URL pública en el siguiente despliegue; para conectarte por la red privada, haz referencia a él desde tu servicio:

lizard add postgres
lizard secrets set DATABASE_URL='${{postgres.DATABASE_PRIVATE_URL}}' --service your-app
lizard redeploy --service your-app

La referencia ${{postgres.DATABASE_PRIVATE_URL}} se resuelve en el momento del despliegue y se conecta por la red privada del proyecto. Coincide con el nombre actual del addon, así que actualiza la referencia si le cambias el nombre al addon. Las credenciales no rotan solas; un servicio recoge los valores nuevos en su siguiente despliegue. Consulta Managed Addons.

Siguientes pasos

Costes de hosting

Pro cuesta $19 al mes con $19 de uso incluidos. Pro 5x ($99) y Pro 20x ($499) incluyen uso igual a su precio y suben tus límites. Pro 5x y Pro 20x no tienen límite de inicios de sandbox. El uso por encima de eso es pay as you go a las tarifas publicadas. Solo Pro tiene prueba: 7 días con $5 de uso; añades una tarjeta para empezarla. Consulta Facturación y los precios, y revisa tus límites antes de desplegar.

IntroducciónInstalar Lizard Studio

Actualizado