# Runtimes personalizados -------------------------------------------------------------------------------- title: "Servicios de registro de contenedores" description: "Catalyst AppSail es una plataforma completamente gestionada de Catalyst Serverless que te permite desarrollar y desplegar servicios web en runtimes gestionados de Java, Node.js y Python, o de runtimes personalizados como imágenes OCI en la nube con facilidad." last_updated: "2026-07-30T07:10:05.823Z" source: "https://docs.catalyst.zoho.com/es/serverless/help/appsail/custom-runtimes/container-registry-services/" service: "Serverless" -------------------------------------------------------------------------------- # Servicios de registro de contenedores ### Docker Hub Catalyst facilita una integración sencilla con Docker Hub, uno de los servicios de registro de contenedores líderes. Después de configurar la integración, puedes desplegar fácilmente imágenes de tu cuenta de Docker Hub en AppSail desde la consola. También puedes gestionar tu conexión de Docker Hub desde la consola. #### Integrar Docker Hub con Catalyst Realiza una configuración única para integrar tu cuenta de Docker Hub con Catalyst de la siguiente manera: 1. Navega a **Settings** en la consola, luego selecciona **Integrations** en *General Settings*. Haz clic en **Docker Hub** de la lista. <br /> 2. Haz clic en **Add Docker Account** para agregar una nueva conexión. <br /> 3. Proporciona un nombre para la conexión. Luego, agrega el nombre de usuario de tu cuenta de Docker Hub (Docker ID) y el token de acceso personal. Puedes crear y obtener tokens de acceso desde Docker Home como se explica en esta página de ayuda. <br /> 4. Haz clic en **Add**. Tu conexión se creará y se listará en la página de *Docker Hub Integrations*. Ahora puedes usar esta conexión para desplegar una imagen Docker desde Docker Hub en AppSail. <br /> <br> #### Editar conexión de Docker Hub Puedes editar una conexión individual de Docker Hub como se describe a continuación. 1. Haz clic en el ícono de puntos suspensivos de la conexión que deseas editar, luego haz clic en **Edit**. <br /> 2. Edita la información requerida. Puedes actualizar el nombre de la conexión, el nombre de usuario de tu cuenta o el token de acceso personal. Haz clic en **Save**. <br /> <br> #### Eliminar conexión de Docker Hub Puedes eliminar una conexión individual de Docker Hub como se describe a continuación. 1. Haz clic en el ícono de puntos suspensivos de la conexión que deseas eliminar, luego haz clic en **Delete**. <br /> 2. Haz clic en **Delete** en la ventana emergente de confirmación. <br /> <br> ### Amazon Elastic Container Registry Catalyst facilita una integración sencilla con AWS que te permite acceder al Amazon Elastic Container Registry. Después de configurar la integración, puedes desplegar fácilmente imágenes de tu Amazon ECR en AppSail desde la consola. También puedes gestionar tu conexión de AWS desde la consola. #### Integrar AWS con Catalyst Realiza una configuración única para integrar tu cuenta de AWS con Catalyst de la siguiente manera: 1. Navega a **Settings** en la consola, luego selecciona **Integrations** en *General Settings*. Haz clic en **AWS** de la lista. <br /> 2. Haz clic en **Add AWS** para agregar una nueva conexión. <br /> 3. Proporciona un nombre para la conexión. Luego, agrega el Access Key ID y el Access Key Secret de tu cuenta de AWS. Puedes crear y gestionar credenciales de clave de acceso en AWS como se explica en esta página de ayuda. <br /> 4. Haz clic en **Add**. Tu conexión se creará y se listará en la página de *AWS Integrations*. Ahora puedes usar esta conexión para desplegar una imagen OCI desde AWS ECR en AppSail. <br /> <br> #### Editar conexión de AWS Puedes editar una conexión individual de AWS como se describe a continuación. 1. Haz clic en el ícono de puntos suspensivos de la conexión que deseas editar, luego haz clic en **Edit**. <br /> 2. Edita la información requerida. Puedes actualizar el nombre de la conexión, tu Access Key ID y Access Key Secret. Haz clic en **Save**. <br /> <br> #### Eliminar conexión de AWS Puedes eliminar una conexión individual de AWS como se describe a continuación. 1. Haz clic en el ícono de puntos suspensivos de la conexión que deseas eliminar, luego haz clic en **Delete**. <br /> 2. Haz clic en **Delete** en la ventana emergente de confirmación. <br /> <br> ### Google Artifact Registry Catalyst facilita una integración sencilla con Google Artifact Registry. Después de configurar la integración, puedes desplegar fácilmente imágenes de tu cuenta de GCP en AppSail desde la consola. También puedes gestionar tu conexión de GCP desde la consola. #### Integrar Google Cloud Platform con Catalyst Realiza una configuración única para integrar tu cuenta de GCP con Catalyst de la siguiente manera: 1. Navega a **Settings** en la consola, luego selecciona **Integrations** en *General Settings*. Haz clic en **Google Cloud Platform** de la lista. <br /> 2. Haz clic en **Add GCP Account** para agregar una nueva conexión. <br /> 3. Proporciona un nombre para la conexión. Luego, sube el archivo JSON de credenciales de cuenta de servicio de tu cuenta de GCP que contendrá tu información de credenciales. Puedes obtener una clave de cuenta de servicio y descargarla como un archivo JSON desde la consola de Google Cloud como se explica en esta página de ayuda. <br /> 4. Haz clic en **Add**. Tu conexión se creará y se listará en la página de *GCP Integrations*. Ahora puedes usar esta conexión para desplegar una imagen OCI desde GCP Artifact Registry en AppSail. <br /> <br> #### Editar conexión de GCP Puedes editar una conexión individual de GCP como se describe a continuación. 1. Haz clic en el ícono de puntos suspensivos de la conexión que deseas editar, luego haz clic en **Edit**. <br /> 2. Edita la información requerida. Puedes actualizar el nombre de la conexión o subir un nuevo archivo JSON de credenciales de cuenta de servicio. Haz clic en **Save**. <br /> <br> #### Eliminar conexión de GCP Puedes eliminar una conexión individual de GCP como se describe a continuación. 1. Haz clic en el ícono de puntos suspensivos de la conexión que deseas eliminar, luego haz clic en **Delete**. <br /> 2. Haz clic en **Delete** en la ventana emergente de confirmación. <br /> <br> -------------------------------------------------------------------------------- title: "Desplegar desde la CLI" description: "Catalyst AppSail es una plataforma completamente gestionada de Catalyst Serverless que te permite desarrollar y desplegar servicios web en runtimes gestionados de Java, Node.js y Python, o de runtimes personalizados como imágenes OCI en la nube con facilidad." last_updated: "2026-07-30T07:10:05.824Z" source: "https://docs.catalyst.zoho.com/es/serverless/help/appsail/custom-runtimes/deploy-from-cli/" service: "Serverless" -------------------------------------------------------------------------------- # Desplegar AppSail como un runtime personalizado desde la CLI ### Inicializar o agregar un servicio de AppSail Puedes inicializar un servicio de AppSail para una aplicación de runtime personalizado directamente en el directorio de tu aplicación, o desde un nuevo directorio usando la CLI de Catalyst. También puedes agregar un servicio de AppSail a un directorio de proyecto de Catalyst existente, donde se han inicializado otros recursos. Puedes [desplegar el servicio de AppSail](#deploy-an-appsail-service) después de inicializarlo o agregarlo. Para inicializar un servicio de AppSail en un nuevo directorio, crea una carpeta para tu proyecto en tu máquina local y navega a ella desde tu terminal. Inicializa un proyecto ejecutando el siguiente comando desde ese directorio: catalyst init Puedes agregar un servicio de AppSail en un directorio de proyecto de Catalyst existente ejecutando este comando de CLI: catalyst appsail:add <br> Catalyst admite dos protocolos para aplicaciones de runtime personalizado que puedes usar para asociar la imagen de tu aplicación con AppSail. Cada protocolo tiene un esquema distinto para identificación y funcionamiento. * Protocolo Docker Image: Usa esto para asociar una imagen preconstruida de tu aplicación presente en el registro docker local. La imagen debe estar construida y etiquetada para apuntar al registro local. Ejemplo: *docker://localhost/expres-hw:latest* * Protocolo Docker Archive: Usa esto para apuntar a un archivo de archivado (.tar o .tar.gz) de una imagen preconstruida de tu aplicación en el directorio de tu sistema. Ejemplo: *docker-archive://test.tar* Nota: El archivo .tar se puede generar típicamente con el comando docker save. No necesitas proporcionar ningún otro detalle excepto el nombre del AppSail para imágenes de contenedor. La ruta fuente o de compilación de la aplicación, el stack y el comando de inicio no necesitan ser configurados para imágenes OCI, ya que ya están definidos en las imágenes. Los pasos para inicializar o agregar el servicio de AppSail serán los mismos como se describe a continuación: 1. La CLI te pedirá que selecciones el tipo de runtime como Catalyst-Managed Runtime o **Docker Image** cuando AppSail se inicializa. Selecciona la segunda opción. 2. Selecciona el protocolo como **Docker Image** o **Docker Archive**. 3. Protocolo Docker Image: Si seleccionas **Docker Image**, la CLI listará todas las imágenes disponibles con etiquetas en el registro docker local. Selecciona la imagen que necesites. Protocolo Docker Archive: Si seleccionas **Docker Archive**, la CLI te pedirá que ingreses la ruta absoluta al archivo TAR de la imagen de tu aplicación en tu sistema local. Nota: Cuando la configuración de AppSail se almacena en el archivo catalyst.json, la ruta se almacenará relativa a la ubicación de ese archivo. 4. Proporciona un nombre para el servicio de AppSail. Puedes nombrarlo como prefieras. AppSail ahora está inicializado en tu directorio local, y la imagen de la aplicación ahora está asociada con el servicio de AppSail. Las configuraciones se actualizarán en el archivo catalyst.json de manera correspondiente. Nota: El archivo app-config.json no se creará cuando inicialices AppSail con una imagen de contenedor. Todas las especificaciones de la aplicación se almacenarán en el archivo catalyst.json. Puedes agregar ciertas configuraciones personalizadas de tu aplicación en este archivo. Consulta aquí para más detalles. Ahora puedes codificar tu lógica de negocio en tu aplicación, luego servir el servicio de AppSail a través de un localhost para depurar y probarlo, o desplegarlo en la consola remota directamente. ### Desplegar un servicio de AppSail Catalyst te permite desplegar servicios de AppSail de dos maneras diferentes: * Despliegue regular: La ejecución del despliegue regular se aplica cuando ya has inicializado un recurso de AppSail ya sea durante la inicialización del proyecto o al agregarlo en un directorio de proyecto existente. * Despliegue independiente: Puedes hacer un despliegue independiente de una aplicación directamente sin inicializarla como un servicio de AppSail previamente. La imagen OCI de tu aplicación que está asociada con AppSail se despliega, junto con el archivo de configuración de tu proyecto. Nota: Catalyst solo admite el despliegue de imágenes compatibles con OCI construidas para la plataforma Linux AMD64 (x86-64). <br> ### Despliegue regular Si la aplicación de AppSail ya está inicializada en el directorio del proyecto, la CLI desplegará automáticamente la aplicación junto con el resto de los recursos del proyecto cuando ejecutes el comando catalyst deploy. La CLI mostrará la URL del endpoint de la aplicación después de que se despliegue, con la que puedes abrirla. <br> Si tienes múltiples aplicaciones de AppSail en el directorio de tu proyecto, puedes acceder a todas sus URLs de endpoint desde la CLI. También puedes ejecutar el siguiente comando para desplegar solo el servicio de AppSail desde el directorio fuente de tu aplicación. catalyst deploy appsail El proceso de despliegue es el mismo. <br> <br> ### Despliegue independiente Debes ejecutar el comando de despliegue independiente desde la raíz del directorio del proyecto de Catalyst. Es decir, catalyst.json y otros archivos de dependencia del proyecto deben estar presentes en el directorio. Nota: Si ejecutas el comando de despliegue independiente sin ninguna de las [opciones específicas para desplegar imágenes de contenedor](#standalone-deploy-appsail-options), la CLI te pedirá entradas relacionadas solo con aplicaciones de runtime gestionado por Catalyst de manera predeterminada. Puedes usar el comando de despliegue independiente con estas opciones para desplegar aplicaciones como imágenes de contenedor: --name &lt;name&gt;, --source &lt;image&gt;, --command &lt;command&gt;, --port &lt;port&gt;. Las dos primeras son obligatorias, mientras que las dos últimas son opcionales y se pueden usar para anular cualquier comando de inicio o puerto ya configurado en la definición de la imagen de contenedor. Las opciones se explican en detalle a continuación. <br> Puedes hacer el despliegue independiente de una aplicación de AppSail de la siguiente manera: 1. Navega al directorio donde están presentes los archivos desplegables de la aplicación y ejecuta el siguiente comando: catalyst deploy appsail 2. Ingresa un nombre para tu aplicación. Puedes nombrar el archivo principal de la compilación de tu aplicación como prefieras. <br> Nota: Sin embargo, cuando compilas tu aplicación como un archivo Java WAR, necesitarás nombrar el archivo principal root.war o agregar controladores específicos según tu código. 3. Selecciona la ruta de compilación para tu aplicación de la lista y presiona **Enter**. <br> 4. Selecciona un stack para tu aplicación y presiona **Enter**. <br> Si seleccionas Java, la CLI te pedirá adicionalmente que elijas entre Java SE o Java WAR como el formato desplegable de tu aplicación. <br> Si seleccionas cualquier otro stack, esto se omitirá. 5. Adicionalmente debes especificar el comando de inicio para tu aplicación según el stack, framework y servidor web utilizado. Esta información se desplegará directamente y estará disponible en la sección Configurations de tu consola después del despliegue de la aplicación. <br> Tu aplicación ahora está directamente desplegada en el proyecto remoto asociado sin requerir que la inicialices como un recurso de AppSail. Ahora puedes acceder a ella con su URL de endpoint mostrada en la CLI. <br> <br> ### Opciones de despliegue independiente de AppSail El comando independiente catalyst deploy appsail admite las siguientes opciones. Algunas de estas son aplicables tanto a aplicaciones de runtime gestionado por Catalyst como a imágenes de contenedor, mientras que algunas son específicas solo para una de ellas. --name &lt;name&gt; Usa esto para especificar el nombre de tu aplicación. Esto es aplicable tanto a aplicaciones de runtime gestionado por Catalyst como a imágenes de contenedor. Ejemplo: --name DemoApp --command &lt;command&gt; Usa esto para especificar el comando de inicio para tu aplicación. Esto es aplicable tanto a aplicaciones de runtime gestionado por Catalyst como a imágenes de contenedor. Esto anulará cualquier valor ya configurado en la definición de la imagen de contenedor. Ejemplo: --command npm start --source &lt;image&gt; Usa esto para especificar la fuente de la imagen docker a desplegar. Esto es aplicable solo a aplicaciones de imagen de contenedor. Debes comenzar con '*docker://*' para el protocolo Docker image y '*docker-archive://*' para el protocolo Docker archive. Consulta aquí para más detalles. Ejemplo: --source docker://example-voting-app-worker:latest --port &lt;port&gt; Usa esto para especificar el puerto para el AppSail. Esto es aplicable solo a aplicaciones de imagen de contenedor. Esto anulará cualquier valor ya configurado en la definición de la imagen de contenedor. Ejemplo: --port 8000 -------------------------------------------------------------------------------- title: "Desplegar desde la consola" description: "Catalyst AppSail es una plataforma completamente gestionada de Catalyst Serverless que te permite desarrollar y desplegar servicios web en runtimes gestionados de Java, Node.js y Python, o de runtimes personalizados como imágenes OCI en la nube con facilidad." last_updated: "2026-07-30T07:10:05.828Z" source: "https://docs.catalyst.zoho.com/es/serverless/help/appsail/custom-runtimes/deploy-from-console/" service: "Serverless" -------------------------------------------------------------------------------- # Desplegar AppSail como un runtime personalizado desde la consola AppSail te permite desplegar una aplicación como una imagen de contenedor desde la consola de Catalyst directamente. Los pasos proporcionados aquí son comunes para todos los servicios de registro de contenedores. 1. Navega al servicio **Serverless** en tu proyecto de Catalyst en el que deseas desplegar tu aplicación, luego haz clic en **AppSail** en *Compute*. <br /> Al hacer clic en **Deploy from CLI**, una ventana emergente te mostrará las instrucciones para desplegar un servicio de AppSail desde la CLI. Consulta la sección de ayuda de la CLI para pasos detallados. 2. Haz clic en **Deploy from Console** para desplegar tu aplicación directamente aquí. 3. Selecciona el tipo de despliegue como **Docker Image** y proporciona un nombre para tu servicio de AppSail. Selecciona el tipo de despliegue como Docker Image y selecciona el servicio de registro de contenedores de la lista: Docker Hub, AWS ECR o Google Artifact Registry. Ingresa lo siguiente según el servicio que elijas: * Docker Hub: Image URL * Amazon ECR: Image URI * GCP Artifact Registry: Image Path Consulta los enlaces de ayuda para detalles sobre cómo obtenerlos. <br /> 4. Debes seleccionar las credenciales del servicio de registro de contenedores que usarás para el despliegue de tu imagen OCI. El menú desplegable listará todas las credenciales que has configurado con el servicio de contenedores. Puedes seleccionar una credencial existente o hacer clic en el botón **Create Integration** a continuación para agregar una nueva credencial. Esto te redirigirá a Integration Settings. <br /> Nota: Los pasos para agregar y gestionar integraciones de Catalyst para Docker Hub, AWS o Google Cloud Platform se cubren en sus respectivas secciones de ayuda. <br /> 5. Puedes configurar ajustes avanzados para tu aplicación. i. Proporciona un comando de inicio para tu aplicación según el runtime de tu aplicación. Nota: Si ya has definido el comando de inicio en tu imagen de contenedor, el comando que proporciones en Catalyst tendrá prioridad. ii. Configura un puerto personalizado para la ejecución de tu aplicación, si es necesario. Los puertos dentro del rango de 0 a 1024 están reservados, con la excepción de los puertos 80 y 443. Puedes usar cualquier otro puerto fuera de este rango. El puerto 9000 se usará de manera predeterminada. Nota: Si no has configurado el puerto en tu código, asegúrate de configurar el mismo puerto para escuchar al iniciar el servidor en el comando de inicio de tu aplicación. iii. Configura la memoria requerida para la ejecución de tu aplicación, según tus requisitos. Puedes seleccionar 128, 256, 512, 1024 o 2048 MB. Información: También puedes configurar el tamaño del disco para la ejecución de tu aplicación después de desplegar la aplicación desde la sección de configuración. iv. Configura variables de entorno para tu servicio de AppSail según sea necesario. <br /> Puedes agregar múltiples variables de entorno haciendo clic en el ícono **+**, y eliminarlas haciendo clic en el ícono **—**. Información: La variable de entorno se agregará al entorno de Catalyst (desarrollo o producción) en el que estás trabajando actualmente. Puedes cambiar el entorno desde el menú desplegable en la parte superior de la consola y agregar variables según sea necesario. 6. Después de configurar los detalles, haz clic en **Deploy**. Tu aplicación se desplegará en la consola. Ahora podrás ver y gestionar tu aplicación desde la consola. <br /> Consulta aquí para ayuda sobre la gestión de tu servicio de AppSail.