Desplegar desde CLI

# Desplegar desde CLI

Catalyst Slate te permite desplegar aplicaciones usando el {{%link href="/es/getting-started/installing-catalyst-cli/" %}}Catalyst CLI{{%/link%}}. Puedes ejecutar comandos predefinidos de Catalyst en la terminal para inicializar Slate, configurar una plantilla de Slate, vincular o desvincular apps locales de Slate a y desde tu proyecto de Catalyst en la consola, y desplegar una app de Slate.

Esta sección proporciona instrucciones paso a paso para realizar estas operaciones.

### Inicializar Slate

**Requisito previo**: Necesitas iniciar sesión en el Catalyst CLI usando tu cuenta de Catalyst y luego proceder con la inicialización del proyecto y de Slate. Consulta {{%link href="/es/cli/v1/login/login-from-cli/" %}}esta documentación de ayuda del CLI{{%/link%}} para conocer los pasos de inicio de sesión.

Puedes inicializar un servicio Slate directamente en el directorio de tu app, o desde un directorio nuevo. Si seleccionaste Slate durante la {{%link href="/es/cli/v1/initialize-resources/initialize-new-project/" %}}inicialización del proyecto{{%/link%}}, puedes seguir los pasos listados a continuación:

También puedes usar el siguiente comando para inicializar el servicio Slate directamente:

{{%cli%}} catalyst init slate {{%/cli%}}

1. Selecciona el framework de client de la aplicación que deseas desplegar en Slate. Presiona Enter para confirmar.

{{%note%}}{{%bold%}}Nota:{{%/bold%}} Este proceso descarga automáticamente una plantilla boilerplate basada en el framework elegido en tu directorio de proyecto, permitiéndote personalizarla y desplegarla en Slate.{{%/note%}}

2. Proporciona un nombre para tu aplicación y presiona Enter. El CLI establecerá la configuración predeterminada para tu aplicación de Slate según el framework elegido.

Esta configuración incluye los comandos de instalación y compilación, así como la ruta de compilación del framework respectivo. Si deseas continuar con la configuración predeterminada, ingresa N. De lo contrario, ingresa Y para hacer las actualizaciones necesarias.

{{%note%}} {{%bold%}}Nota:{{%/bold%}}

* El comando de instalación instala las dependencias requeridas, típicamente usando un gestor de paquetes.

* El comando de compilación es el script que transforma tu código de desarrollo en código de producción.

* La ruta de compilación es el directorio donde se generan los archivos optimizados y listos para producción después de ejecutar el proceso de compilación.{{%/note%}}

Por defecto, estos comandos se ejecutan con el gestor de paquetes npm, es decir, **npm install** o **npm run build**. Si deseas cambiar el gestor de paquetes, puedes hacerlo ingresando N y proporcionando el comando requerido.

Una vez que confirmes la configuración, el código de la plantilla de Slate del framework elegido se descargará en el directorio del proyecto, y se agregará una entrada al archivo
{{%link href="/es/cli/v1/project-directory-structure/catalyst-json/" %}}catalyst.json{{%/link%}}, que sirve como conexión entre tu directorio de proyecto y el servicio Catalyst Slate.

Puedes proporcionar comandos específicos para ejecutar al servir la app localmente ingresándolos como comandos de desarrollo y presionando Enter.

<br>

### Crear una app de Slate adicional

Si tu directorio de proyecto ya está vinculado a un proyecto de Catalyst y Slate está inicializado, puedes agregar una nueva app de Slate a tu directorio de proyecto directamente usando los pasos a continuación. Esta operación agregará automáticamente el código de la plantilla de Slate basado en el framework frontend elegido a tu directorio de proyecto.

1. Ejecuta el siguiente comando en la terminal desde el directorio de proyecto del servicio Slate:

{{%cli%}} catalyst slate:create{{%/cli%}}

2. Selecciona el framework requerido para tu aplicación de Slate y proporciona un nombre para tu aplicación.

3. Según el framework elegido, los comandos de instalación y compilación, y la ruta de compilación del framework se detectarán automáticamente. Si deseas continuar con la configuración predeterminada, ingresa **N**. De lo contrario, ingresa **Y** para hacer las actualizaciones necesarias.

Puedes proporcionar comandos específicos para ejecutar al servir la app localmente ingresándolos como comandos de desarrollo y presionando Enter.

Después de que se actualicen todas las configuraciones, la app de Slate se creará en tu directorio de proyecto.

El archivo **{{%badge%}}catalyst.json{{%/badge%}}** se actualizará con los detalles de la app de Slate recién creada.

También puedes crear una aplicación de Slate proporcionando directamente un nombre para tu aplicación y el framework requerido. Ejecuta el siguiente comando en tu terminal:

{{%cli%}} catalyst slate:create --name &lt;name&gt; --framework &lt;framework_name&gt;{{%/cli%}}

<br>

### Vincular una app de Slate

Para desplegar un proyecto existente en Slate, debes vincular la ruta raíz del proyecto con el servicio Slate. Para esto, primero tendrás que inicializar el servicio Slate. Esta vinculación establece una conexión entre tu directorio de proyecto y el servicio Slate localmente, y para desplegar en la consola, debes usar el comando deploy.

Esta opción se puede usar cuando una aplicación de un framework compatible con Slate no se inicializó originalmente como un servicio Slate, pero más tarde prefieres desplegarla como un servicio Slate.

Para vincular el directorio con Slate:

1. Ejecuta el siguiente comando en la terminal desde el directorio de proyecto de la app:

{{%cli%}}catalyst slate:link{{%/cli%}}

2. Selecciona la ruta de origen que debe vincularse al servicio Slate y presiona **Enter**.

3. Proporciona un nombre para tu aplicación según sea necesario y presiona **Enter**.

El framework de la aplicación se detectará automáticamente y se listará junto con sus comandos de **instalación**, **compilación** y la **ruta de compilación**. De lo contrario, podrás seleccionar el framework manualmente desde la terminal.

4. Si deseas continuar con la configuración predeterminada, ingresa **N**. De lo contrario, ingresa **Y** para hacer las actualizaciones necesarias.

Puedes proporcionar comandos específicos para ejecutar al servir la app localmente ingresándolos como comandos de desarrollo y presionando Enter.

Después de establecer las configuraciones, se realizará una entrada en el archivo {{%badge%}}catalyst.json{{%/badge%}} para establecer una conexión entre la ruta del directorio del proyecto y el servicio Slate.

<br>

### Desvincular una app de Slate

Puedes remover la conexión entre tu directorio de proyecto y el servicio Slate usando los pasos listados a continuación. Esta operación solo removerá la configuración de Slate en tu directorio de proyecto y no en la consola de Catalyst, si ya has desplegado la aplicación.

1. Ejecuta el siguiente comando en la terminal desde el directorio de proyecto de la app:

{{%cli%}}catalyst slate:unlink{{%/cli%}}

2. Navega usando las teclas de flecha para elegir la aplicación y haz clic en **Enter** para confirmar.

3. Ingresa **Yes** para remover la configuración de Slate de tu aplicación, su entrada en el archivo {{%badge%}}catalyst.json{{%/badge%}} y el código fuente de la aplicación. Ingresa **No** para remover solo la entrada en el archivo {{%badge%}}catalyst.json{{%/badge%}} conservando el código fuente de tu aplicación.

Para la misma operación, también puedes usar el siguiente comando proporcionando directamente el nombre de la aplicación:

{{%cli%}}catalyst slate:unlink --name &lt;&lt;app_name&gt;&gt;{{%/cli%}}

<br>

### Servir una app de Slate localmente

Puedes alojar la aplicación de Slate en tu proyecto de Catalyst localmente navegando a tu directorio de proyecto en local y ejecutando el siguiente comando:

{{%cli%}}catalyst serve --only slate{{%/cli%}}

Este comando catalyst serve lanza tu app de Slate localmente ejecutando el {{%badge%}}dev_command{{%/badge%}} definido en tu archivo {{%badge%}}cli-config.json{{%/badge%}}. Este {{%badge%}}dev_command{{%/badge%}} se configurará en el archivo cuando {{%link href="/es/slate/help/deploy-from-cli/#link-a-slate-app" %}}vincules{{%/link%}} o {{%link href="/es/slate/help/deploy-from-cli/#create-an-additional-slate-app" %}}crees una app de Slate{{%/link%}}.

Antes de ejecutar el comando catalyst serve, debes actualizar y asegurarte de que el {{%badge%}}dev_command{{%/badge%}} incluya el comando de inicio de tu aplicación con el {{%badge%}}ZC_SLATE_PORT{{%/badge%}}. Por ejemplo, si estás trabajando con una app de React, actualiza el comando a:

{{%badge%}}PORT=$ZC_SLATE_PORT npm start{{%/badge%}}

Tendrás que configurar tu comando de inicio aquí según el framework de tu aplicación. Puedes consultar la tabla a continuación para los comandos de inicio predeterminados de los frameworks compatibles con Catalyst Slate. Puedes modificar el comando de inicio según las necesidades de tu aplicación, si es necesario.

<table class="content-table">
	<thead>
		<tr>
			<th class="w25p">Framework</th>
			<th class="w75p">Comando de inicio predeterminado</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>Create React App</td>
			<td>{{%badge%}}PORT=$ZC_SLATE_PORT npm start{{%/badge%}}</td>
		</tr>
      <tr>
			<td>Solid JS(Vite)</td>
			<td>{{%badge%}}npm run dev -\- -\-port $ZC_SLATE_PORT{{%/badge%}}</td>
		</tr>
      <tr>
			<td>React + Vite</td>
			<td>{{%badge%}}npm run dev -\- -\-port $ZC_SLATE_PORT{{%/badge%}}</td>
		</tr>
    <tr>
			<td>Next.js</td>
			<td>{{%badge%}}npm run dev -\- -\-port $ZC_SLATE_PORT{{%/badge%}}</td>
		</tr>
    <tr>
			<td>Astro</td>
			<td>{{%badge%}}npm run dev -\- -\-port $ZC_SLATE_PORT{{%/badge%}}</td>
		</tr>
    <tr>
			<td>Angular</td>
			<td>{{%badge%}}npm start -\- -\-port $ZC_SLATE_PORT{{%/badge%}}</td>
		</tr>
    <tr>
			<td>Vue (Vite)</td>
			<td>{{%badge%}}npm run dev -\- -\-port $ZC_SLATE_PORT{{%/badge%}}</td>
		</tr>
    <tr>
			<td>Preact</td>
			<td>{{%badge%}}npm run dev -\- -\-port $ZC_SLATE_PORT{{%/badge%}}</td>
		</tr>
    <tr>
			<td>Svelte</td>
			<td>{{%badge%}}npm run dev -\- -\-port $ZC_SLATE_PORT{{%/badge%}}</td>
		</tr>
	</tbody>
</table>

Cuando sirves la app de Slate, el comando de inicio mencionado en el archivo cli-config.json ejecuta la aplicación en un servidor local y el CLI mostrará la URL desde la cual puedes acceder a tu aplicación de Slate.

Después de haber terminado de probar tu aplicación localmente, puedes proceder a desplegarla en la consola remota. Discutiremos los comandos de despliegue en la siguiente sección.

### Desplegar en Slate

Puedes desplegar tu aplicación web frontend en Catalyst Slate usando los pasos a continuación. Antes de desplegar cualquier aplicación en Slate, asegúrate de que el directorio del proyecto esté vinculado al servicio Slate. Para esto, puedes usar el comando {{%link href="/es/cli/v1/working-with-slate/link-slate-app" %}}{{%badge%}}catalyst slate:link{{%/badge%}}{{%/link%}}.

Ejecuta el siguiente comando en tu terminal desde el directorio de proyecto del servicio Slate:

{{%cli%}}catalyst deploy slate{{%/cli%}}

Esto despliega todos los componentes de Slate presentes en tu directorio de proyecto al {{%link href="/es/deployment-and-billing/environments/development-environment/" %}}entorno de desarrollo de Catalyst{{%/link%}}.

Puedes usar la siguiente opción para proporcionar un mensaje de despliegue para el despliegue de Slate.

{{%cli%}}catalyst deploy slate -m "deployment message"{{%/cli%}}

Para desplegar una app específica del directorio de proyecto a Slate, puedes usar el siguiente comando:

{{%cli%}}catalyst deploy --only slate:appname{{%/cli%}}

Si deseas desplegar la aplicación en el entorno de producción, usa el siguiente comando. Asegúrate de haber accedido al entorno de producción en la consola antes de iniciar un despliegue a producción.

{{%cli%}} catalyst deploy slate --production {{%/cli%}}

Catalyst Slate te permite desplegar aplicaciones usando el Catalyst CLI. Puedes ejecutar comandos predefinidos de Catalyst en la terminal para inicializar Slate, configurar una plantilla de Slate, vincular o desvincular apps locales de Slate a y desde tu proyecto de Catalyst en la consola, y desplegar una app de Slate.

Esta sección proporciona instrucciones paso a paso para realizar estas operaciones.

Inicializar Slate

Requisito previo: Necesitas iniciar sesión en el Catalyst CLI usando tu cuenta de Catalyst y luego proceder con la inicialización del proyecto y de Slate. Consulta esta documentación de ayuda del CLI para conocer los pasos de inicio de sesión.

Puedes inicializar un servicio Slate directamente en el directorio de tu app, o desde un directorio nuevo. Si seleccionaste Slate durante la inicialización del proyecto, puedes seguir los pasos listados a continuación:

También puedes usar el siguiente comando para inicializar el servicio Slate directamente:

copy
$ catalyst init slate 

Selecciona el framework de client de la aplicación que deseas desplegar en Slate. Presiona Enter para confirmar.

Nota: Este proceso descarga automáticamente una plantilla boilerplate basada en el framework elegido en tu directorio de proyecto, permitiéndote personalizarla y desplegarla en Slate.

Proporciona un nombre para tu aplicación y presiona Enter. El CLI establecerá la configuración predeterminada para tu aplicación de Slate según el framework elegido.

Nota:

El comando de instalación instala las dependencias requeridas, típicamente usando un gestor de paquetes.
El comando de compilación es el script que transforma tu código de desarrollo en código de producción.
La ruta de compilación es el directorio donde se generan los archivos optimizados y listos para producción después de ejecutar el proceso de compilación.

Por defecto, estos comandos se ejecutan con el gestor de paquetes npm, es decir, npm install o npm run build. Si deseas cambiar el gestor de paquetes, puedes hacerlo ingresando N y proporcionando el comando requerido.

Una vez que confirmes la configuración, el código de la plantilla de Slate del framework elegido se descargará en el directorio del proyecto, y se agregará una entrada al archivo catalyst.json, que sirve como conexión entre tu directorio de proyecto y el servicio Catalyst Slate.

Puedes proporcionar comandos específicos para ejecutar al servir la app localmente ingresándolos como comandos de desarrollo y presionando Enter.

Crear una app de Slate adicional

Ejecuta el siguiente comando en la terminal desde el directorio de proyecto del servicio Slate:

copy
$ catalyst slate:create

Selecciona el framework requerido para tu aplicación de Slate y proporciona un nombre para tu aplicación.

Según el framework elegido, los comandos de instalación y compilación, y la ruta de compilación del framework se detectarán automáticamente. Si deseas continuar con la configuración predeterminada, ingresa N. De lo contrario, ingresa Y para hacer las actualizaciones necesarias.

Puedes proporcionar comandos específicos para ejecutar al servir la app localmente ingresándolos como comandos de desarrollo y presionando Enter.

Después de que se actualicen todas las configuraciones, la app de Slate se creará en tu directorio de proyecto.

El archivo catalyst.json se actualizará con los detalles de la app de Slate recién creada.

También puedes crear una aplicación de Slate proporcionando directamente un nombre para tu aplicación y el framework requerido. Ejecuta el siguiente comando en tu terminal:

copy
$ catalyst slate:create --name <name> --framework <framework_name>

Vincular una app de Slate

Para vincular el directorio con Slate:

Ejecuta el siguiente comando en la terminal desde el directorio de proyecto de la app:

copy
$catalyst slate:link

Selecciona la ruta de origen que debe vincularse al servicio Slate y presiona Enter.

Proporciona un nombre para tu aplicación según sea necesario y presiona Enter.

El framework de la aplicación se detectará automáticamente y se listará junto con sus comandos de instalación, compilación y la ruta de compilación. De lo contrario, podrás seleccionar el framework manualmente desde la terminal.

Si deseas continuar con la configuración predeterminada, ingresa N. De lo contrario, ingresa Y para hacer las actualizaciones necesarias.

Puedes proporcionar comandos específicos para ejecutar al servir la app localmente ingresándolos como comandos de desarrollo y presionando Enter.

Después de establecer las configuraciones, se realizará una entrada en el archivo catalyst.json para establecer una conexión entre la ruta del directorio del proyecto y el servicio Slate.

Desvincular una app de Slate

Ejecuta el siguiente comando en la terminal desde el directorio de proyecto de la app:

copy
$catalyst slate:unlink

Navega usando las teclas de flecha para elegir la aplicación y haz clic en Enter para confirmar.

Ingresa Yes para remover la configuración de Slate de tu aplicación, su entrada en el archivo catalyst.json y el código fuente de la aplicación. Ingresa No para remover solo la entrada en el archivo catalyst.json conservando el código fuente de tu aplicación.

Para la misma operación, también puedes usar el siguiente comando proporcionando directamente el nombre de la aplicación:

copy
$catalyst slate:unlink --name <<app_name>>

Servir una app de Slate localmente

Puedes alojar la aplicación de Slate en tu proyecto de Catalyst localmente navegando a tu directorio de proyecto en local y ejecutando el siguiente comando:

copy
$catalyst serve --only slate

Este comando catalyst serve lanza tu app de Slate localmente ejecutando el dev_command definido en tu archivo cli-config.json. Este dev_command se configurará en el archivo cuando vincules o crees una app de Slate.

Antes de ejecutar el comando catalyst serve, debes actualizar y asegurarte de que el dev_command incluya el comando de inicio de tu aplicación con el ZC_SLATE_PORT. Por ejemplo, si estás trabajando con una app de React, actualiza el comando a:

PORT=$ZC_SLATE_PORT npm start

Framework	Comando de inicio predeterminado
Create React App	PORT=$ZC_SLATE_PORT npm start
Solid JS(Vite)	npm run dev -- --port $ZC_SLATE_PORT
React + Vite	npm run dev -- --port $ZC_SLATE_PORT
Next.js	npm run dev -- --port $ZC_SLATE_PORT
Astro	npm run dev -- --port $ZC_SLATE_PORT
Angular	npm start -- --port $ZC_SLATE_PORT
Vue (Vite)	npm run dev -- --port $ZC_SLATE_PORT
Preact	npm run dev -- --port $ZC_SLATE_PORT
Svelte	npm run dev -- --port $ZC_SLATE_PORT

Después de haber terminado de probar tu aplicación localmente, puedes proceder a desplegarla en la consola remota. Discutiremos los comandos de despliegue en la siguiente sección.

Desplegar en Slate

Ejecuta el siguiente comando en tu terminal desde el directorio de proyecto del servicio Slate:

copy
$catalyst deploy slate

Esto despliega todos los componentes de Slate presentes en tu directorio de proyecto al entorno de desarrollo de Catalyst.

Puedes usar la siguiente opción para proporcionar un mensaje de despliegue para el despliegue de Slate.

copy
$catalyst deploy slate -m "deployment message"

Para desplegar una app específica del directorio de proyecto a Slate, puedes usar el siguiente comando:

copy
$catalyst deploy --only slate:appname

copy
$ catalyst deploy slate --production 

Última actualización 2026-03-20 21:51:56 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Deploy from Private Git Repository Deploy from Public Git Repository Deploy Slate Templates