Instalar Catalyst CLI

# Instalar Catalyst CLI

### Introducción

Catalyst CLI contiene un conjunto de herramientas que te permiten inicializar proyectos, y desarrollar, probar y desplegar los componentes de tus aplicaciones y microservicios desde tu máquina local. El CLI incluye comandos y operaciones aplicables a la mayoría de los servicios de Catalyst, como Cloud Scale, Serverless o SmartBrowz. Puedes conocer los comandos disponibles del CLI y acceder a la ayuda detallada en la {{%link href="/es/cli/v1/cli-command-reference/" %}}**documentación del CLI**{{%/link%}}.

{{%note%}}{{%bold%}}Nota:{{%/bold%}} El CLI trabaja con el entorno de desarrollo de tu proyecto de Catalyst. Por lo tanto, las actividades que realizas mediante el CLI, como crear una función o desplegar un Client en la
{{%link href="/es/getting-started/navigating-in-the-console/" %}}consola remota{{%/link%}}, no se reflejan en el entorno de producción en vivo del proyecto. Para habilitarlas en el entorno de producción de tu aplicación, debes {{%link href="/es/deployment-and-billing/environments/initial-deployment/" %}}desplegar tu proyecto{{%/link%}} en el entorno de producción. {{%/note%}}

#### Sistemas operativos compatibles:

* {{%bold%}}Windows{{%/bold%}}
* {{%bold%}}macOS{{%/bold%}}
* {{%bold%}}Linux{{%/bold%}}

Puedes instalar Catalyst CLI en cualquiera de los sistemas operativos compatibles de la misma forma que se describe en esta página de ayuda. Catalyst CLI ofrece las mismas funcionalidades en todas las plataformas. Una vez que hayas instalado Catalyst CLI, podrás trabajar con tus proyectos de Catalyst y crear aplicaciones directamente desde la terminal de tu sistema.

### Requisitos previos

Antes de instalar Catalyst CLI, debes tener los siguientes requisitos previos instalados en tu sistema.

#### Node.js y Node Package Manager (NPM):

Catalyst CLI se puede instalar a través de NPM o del gestor de paquetes Yarn.

Por lo tanto, puedes instalar NPM en tu sistema para instalar el CLI directamente, o instalar el gestor de paquetes Yarn mediante NPM y luego instalar el CLI con él. Para verificar si ya tienes Node.js y NPM instalados, ejecuta los siguientes comandos en tu terminal, los cuales mostrarán las versiones instaladas, si están presentes:

{{%cli%}}node -v{{%/cli%}}

{{%cli%}}npm -v{{%/cli%}}

Si no los tienes instalados, puedes {{%link href="https://nodejs.org/es/download/" %}}descargar Node.js{{%/link%}} para tu plataforma desde su sitio web oficial, o usar un gestor de versiones de Node como NVM para instalar Node.js y NPM. NPM se incluye de forma automática con Node.js al instalarlo. Consulta la {{%link href="https://nodejs.org/es/docs/" %}}documentación de ayuda de Node.js{{%/link%}} o la {{%link href="https://docs.npmjs.com/getting-started/installing-node" %}}documentación de NPM{{%/link%}} para obtener más información.

{{%note%}}{{%bold%}}Nota:{{%/bold%}} Catalyst CLI solo funciona con {{%bold%}}Node.js v14 o posterior{{%/bold%}}. Asegúrate de instalar una versión adecuada.{{%/note%}}

#### Compatibilidad con lenguajes de programación:

Puedes desarrollar {{%link href="/es/serverless/help/functions/introduction/" %}}funciones del lado del servidor{{%/link%}} en los siguientes entornos de lenguaje en Catalyst:

1. Node.js
   2. Java
   3. Python

Antes de hacerlo, debes asegurarte de tener instalados todos los componentes necesarios de estos entornos de lenguaje en tu sistema local.

{{%note%}}{{%bold%}}Nota:{{%/bold%}} Solo necesitas instalar estos requisitos previos de lenguajes de programación si planeas inicializar Functions de Catalyst desde el CLI, y para los stacks que necesites.{{%/note%}}

Dado que ya instalaste Node.js en el paso anterior, los componentes necesarios para desarrollar funciones en Node.js ya estarán disponibles en tu sistema.

También puedes instalar manualmente un runtime compatible de Node.js y el paquete SDK correspondiente para desarrollar funciones en ese runtime.

{{%bold%}}Java:{{%/bold%}} Para desarrollar funciones en Java, instala el Java Development Kit (JDK) correspondiente en tu sistema para tu plataforma. Debes instalar:
* {{%link href="https://www.oracle.com/technetwork/java/javase/downloads/index.html" %}}La versión 8 del JDK de la plataforma Java Standard Edition (SE){{%/link%}}
* {{%link href="https://www.oracle.com/in/java/technologies/javase/jdk11-archive-downloads.html" %}}La versión 11 del JDK de la plataforma Java Standard Edition (SE){{%/link%}}
* {{%link href="https://www.oracle.com/java/technologies/downloads/#java17" %}}La versión 17 del JDK de la plataforma Java Standard Edition (SE){{%/link%}}

Consulta la {{%link href="https://docs.oracle.com/es/java/" %}}documentación del JDK{{%/link%}} para obtener más información.

{{%note%}}{{%bold%}}Nota:{{%/bold%}} Actualmente, Catalyst solo es compatible con las versiones {{%bold%}}8{{%/bold%}}, {{%bold%}}11{{%/bold%}} y {{%bold%}}17{{%/bold%}} del Java SE Development Kit. Si no tienes la versión exacta instalada en tu máquina, te recomendamos que instales el JDK exacto para un rendimiento óptimo.{{%/note%}}

{{%bold%}}Python:{{%/bold%}} Para desarrollar funciones en Python, instala **Python versión 3.9** desde su {{%link href="https://www.python.org/"%}}sitio web oficial{{%/link%}} para tu plataforma, junto con el gestor de paquetes de Python, Pip. El {{%link href="https://pip.pypa.io/es/stable/installation/#"%}}gestor de paquetes Pip{{%/link%}} se instalará automáticamente en tu sistema local si instalas Python desde su fuente oficial.

### Instalar el CLI

Debes instalar Catalyst CLI en tu sistema usando la terminal en modo administrador, ya que la ejecución de este comando requiere privilegios de administrador. Puedes ejecutar la terminal como administrador en tu entorno Windows, o ejecutar el comando de instalación usando {{%badge%}}{{%bold%}}sudo{{%/bold%}}{{%/badge%}} en una línea de comandos UNIX, como en sistemas macOS o Linux.

Ejecuta el siguiente comando en tu terminal para instalar Catalyst CLI:

{{%cli%}} npm install -g zcatalyst-cli{{%/cli%}}

Si lo instalas a través del {{%link href="https://yarnpkg.com/" %}}gestor de paquetes Yarn{{%/link%}}, ejecuta el siguiente comando en tu terminal:

{{%cli%}} yarn add zcatalyst-cli{{%/cli%}}

Esto iniciará el proceso de instalación y tu terminal mostrará el progreso.

Una vez completada la instalación, el CLI mostrará estos detalles.

Puedes verificar si el CLI se instaló correctamente ejecutando el siguiente comando:

{{%cli%}} catalyst --version{{%/cli%}}

Si no hubo problemas con la instalación, el comando devolverá la versión del CLI instalada en tu sistema.

A partir de ahora podrás acceder al comando {{%badge%}}catalyst{{%/badge%}} desde tu terminal.

Puedes consultar la {{%link href="/es/cli/v1/cli-command-reference/" %}}**documentación del CLI**{{%/link%}} en la página de recursos de Catalyst para obtener ayuda con los comandos del CLI.

### Actualizar Catalyst CLI a la última versión

Cuando haya disponible una versión más reciente de Catalyst CLI, tu terminal mostrará un mensaje de alerta después de ejecutar exitosamente un comando del CLI.

Para actualizar tu CLI, ejecuta el siguiente comando en tu terminal:

{{%cli%}} npm install -g zcatalyst-cli{{%/cli%}}

Esto iniciará el proceso de instalación de la última versión.

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

* En algunos casos, los valores del registro de tu sistema podrían no reflejar la última versión de Catalyst CLI, lo que podría provocar que tu sistema conserve la versión anterior del CLI. Para evitar esto, especifica el número de versión al ejecutar el comando. Por ejemplo, para actualizar a la versión 1.9.0, ejecuta {{%bold%}}$ {{%badge%}}npm install -g zcatalyst-cli@1.9.0{{%/badge%}}{{%/bold%}}

* Si no puedes actualizar Catalyst CLI, ejecuta el comando usando {{%badge%}}{{%bold%}}sudo{{%/bold%}}{{%/badge%}}.
{{%/note%}}

Introducción

Nota: El CLI trabaja con el entorno de desarrollo de tu proyecto de Catalyst. Por lo tanto, las actividades que realizas mediante el CLI, como crear una función o desplegar un Client en la consola remota, no se reflejan en el entorno de producción en vivo del proyecto. Para habilitarlas en el entorno de producción de tu aplicación, debes desplegar tu proyecto en el entorno de producción.

Sistemas operativos compatibles:

Windows
macOS
Linux

Requisitos previos

Antes de instalar Catalyst CLI, debes tener los siguientes requisitos previos instalados en tu sistema.

Node.js y Node Package Manager (NPM):

Catalyst CLI se puede instalar a través de NPM o del gestor de paquetes Yarn.

Por lo tanto, puedes instalar NPM en tu sistema para instalar el CLI directamente, o instalar el gestor de paquetes Yarn mediante NPM y luego instalar el CLI con él.

Para verificar si ya tienes Node.js y NPM instalados, ejecuta los siguientes comandos en tu terminal, los cuales mostrarán las versiones instaladas, si están presentes:

copy
$node -v

copy
$npm -v

Si no los tienes instalados, puedes descargar Node.js para tu plataforma desde su sitio web oficial, o usar un gestor de versiones de Node como NVM para instalar Node.js y NPM. NPM se incluye de forma automática con Node.js al instalarlo.

Consulta la documentación de ayuda de Node.js o la documentación de NPM para obtener más información.

Nota: Catalyst CLI solo funciona con Node.js v14 o posterior. Asegúrate de instalar una versión adecuada.

Compatibilidad con lenguajes de programación:

Puedes desarrollar funciones del lado del servidor en los siguientes entornos de lenguaje en Catalyst:

Node.js
Java
Python

Antes de hacerlo, debes asegurarte de tener instalados todos los componentes necesarios de estos entornos de lenguaje en tu sistema local.

Nota: Solo necesitas instalar estos requisitos previos de lenguajes de programación si planeas inicializar Functions de Catalyst desde el CLI, y para los stacks que necesites.

Dado que ya instalaste Node.js en el paso anterior, los componentes necesarios para desarrollar funciones en Node.js ya estarán disponibles en tu sistema.

También puedes instalar manualmente un runtime compatible de Node.js y el paquete SDK correspondiente para desarrollar funciones en ese runtime.

Java: Para desarrollar funciones en Java, instala el Java Development Kit (JDK) correspondiente en tu sistema para tu plataforma. Debes instalar:

Consulta la documentación del JDK para obtener más información.

Nota: Actualmente, Catalyst solo es compatible con las versiones 8, 11 y 17 del Java SE Development Kit. Si no tienes la versión exacta instalada en tu máquina, te recomendamos que instales el JDK exacto para un rendimiento óptimo.

Python: Para desarrollar funciones en Python, instala Python versión 3.9 desde su sitio web oficial para tu plataforma, junto con el gestor de paquetes de Python, Pip. El gestor de paquetes Pip se instalará automáticamente en tu sistema local si instalas Python desde su fuente oficial.

Instalar el CLI

Debes instalar Catalyst CLI en tu sistema usando la terminal en modo administrador, ya que la ejecución de este comando requiere privilegios de administrador. Puedes ejecutar la terminal como administrador en tu entorno Windows, o ejecutar el comando de instalación usando sudo en una línea de comandos UNIX, como en sistemas macOS o Linux.

Ejecuta el siguiente comando en tu terminal para instalar Catalyst CLI:

copy
$ npm install -g zcatalyst-cli

Si lo instalas a través del gestor de paquetes Yarn, ejecuta el siguiente comando en tu terminal:

copy
$ yarn add zcatalyst-cli

Esto iniciará el proceso de instalación y tu terminal mostrará el progreso.

Una vez completada la instalación, el CLI mostrará estos detalles.

Puedes verificar si el CLI se instaló correctamente ejecutando el siguiente comando:

copy
$ catalyst --version

Si no hubo problemas con la instalación, el comando devolverá la versión del CLI instalada en tu sistema.

A partir de ahora podrás acceder al comando catalyst desde tu terminal.

Puedes consultar la documentación del CLI en la página de recursos de Catalyst para obtener ayuda con los comandos del CLI.

Actualizar Catalyst CLI a la última versión

Cuando haya disponible una versión más reciente de Catalyst CLI, tu terminal mostrará un mensaje de alerta después de ejecutar exitosamente un comando del CLI.

Para actualizar tu CLI, ejecuta el siguiente comando en tu terminal:

copy
$ npm install -g zcatalyst-cli

Esto iniciará el proceso de instalación de la última versión.

Nota:

En algunos casos, los valores del registro de tu sistema podrían no reflejar la última versión de Catalyst CLI, lo que podría provocar que tu sistema conserve la versión anterior del CLI. Para evitar esto, especifica el número de versión al ejecutar el comando. Por ejemplo, para actualizar a la versión 1.9.0, ejecuta $ npm install -g zcatalyst-cli@1.9.0
Si no puedes actualizar Catalyst CLI, ejecuta el comando usando sudo.

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

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit