# Herramientas ## Herramientas Maven de Catalyst -------------------------------------------------------------------------------- title: "Introducción" description: "Catalyst Maven Tools es un conjunto de funcionalidades que incluyen arquetipos Maven de Catalyst para crear funciones serverless Basic I/O y Advanced I/O, el Catalyst Java SDK como dependencia Maven y un plugin Maven de Catalyst para ejecutar varios comandos en tu función directamente desde tu IDE." last_updated: "2026-07-02T09:34:15.970Z" source: "https://docs.catalyst.zoho.com/es/tools/maven-tools/introduction/" service: "Serverless" -------------------------------------------------------------------------------- # Catalyst Maven Tools ### Introducción Catalyst ofrece a los desarrolladores de aplicaciones Java la flexibilidad y conveniencia de trabajar en su IDE preferido durante todo el ciclo de vida del desarrollo de aplicaciones. Esto incluye las etapas desde la inicialización de una función Serverless de Java hasta la construcción de su código, pruebas y despliegue en el proyecto remoto de Catalyst. Este soporte se proporciona en forma de varias funcionalidades para la herramienta de automatización de compilación Apache Maven, ampliamente utilizada para proyectos Java. Maven sigue un Modelo de Objetos de Proyecto (POM) y puede manejar la gestión de proyectos incluyendo la gestión de compilación y dependencias, mantenimiento del proyecto, despliegue basado en pruebas, y proporciona una amplia gama de plugins que asisten en la programación Java. <br> Catalyst ofrece las siguientes herramientas Maven para el desarrollo de aplicaciones Java: * Arquetipos Maven de Catalyst: Catalyst proporciona dos arquetipos Maven para crear funciones serverless Basic I/O y Advanced I/O respectivamente dentro de un IDE Java directamente, sin necesidad de inicializarlas en el CLI. * Catalyst Java SDK como dependencia Maven: El paquete del Java SDK proporcionado por Catalyst se puede incluir como una dependencia en un archivo de configuración Maven, sin necesidad de descargarlo o instalarlo manualmente. * Plugins Maven de Catalyst: Catalyst también ofrece un plugin en el framework Maven que te permite empaquetar, servir y desplegar una función Java con los arquetipos desde tu IDE, en lugar del CLI. <br> Puedes usar las herramientas Maven de Catalyst en cualquiera de los IDEs Java con los que trabajes, como Eclipse, IntelliJ IDEA, NetBeans o Visual Studio Code. Puedes encontrar los detalles de los entornos de desarrollo Java que incluyen integración con Maven en su documentación oficial. El soporte Maven de Catalyst facilita el desarrollo de aplicaciones Java con menos carga de trabajo y funcionalidad mejorada. Puedes ahorrarte el esfuerzo de manejar manualmente las dependencias Java o el versionado del paquete SDK. Este soporte asegura que realices todas tus operaciones incluyendo la configuración del entorno de tu aplicación, código, pruebas, despliegue y gestión dentro de una sola interfaz sin tener que cambiar al CLI para acciones básicas. Nota: Los arquetipos Maven, la dependencia y el plugin que proporciona Catalyst no incluyen todas las operaciones de Catalyst que puedes ejecutar desde un entorno local. Puedes utilizar el Catalyst CLI para las demás operaciones en paralelo con las herramientas Maven. <br> ### Requisitos previos Para trabajar con las herramientas Maven de Catalyst, necesitas asegurarte de que Maven esté instalado en tu IDE Java. * Eclipse: Eclipse ejecuta una versión embebida de Maven y proporciona soporte integrado para Maven. M2Eclipse proporciona una integración estrecha con Maven con una serie de funcionalidades integradas. Puedes instalarlo como software nuevo o buscar Maven en el Eclipse Marketplace. * IntelliJ IDEA: IntelliJ IDEA ofrece una integración completamente funcional con Maven que te permite crear un proyecto Maven directamente o agregar soporte Maven a un proyecto existente. * NetBeans: Apache NetBeans tiene soporte integrado para Maven y proporciona varias utilidades para compilar y generar artefactos NetBeans usando Maven. * Visual Studio Code: VS Code proporciona una extensión Maven completamente integrada que te permite realizar operaciones Maven después de instalarla. <br> Nota: Si usas VS Code, necesitarás configurar la ruta del ejecutable de Maven si lo estás instalando por primera vez. Esto se puede configurar en la configuración de VS Code como se muestra a continuación. <br> <br /> -------------------------------------------------------------------------------- title: "Arquetipos Maven de Catalyst" description: "Catalyst proporciona arquetipos Maven predefinidos para crear funciones Serverless de los tipos Basic I/O y Advanced I/O en tu IDE directamente, listados desde el Repositorio Central de Maven." last_updated: "2026-07-02T09:34:15.970Z" source: "https://docs.catalyst.zoho.com/es/tools/maven-tools/maven-archetypes/" service: "Serverless" -------------------------------------------------------------------------------- # Arquetipos Maven ### Introducción Un arquetipo Maven es un toolkit que define la plantilla de un proyecto Maven. Los arquetipos Maven proporcionan a los desarrolladores Java los medios para generar versiones parametrizadas de la plantilla del proyecto de manera estandarizada. Catalyst proporciona arquetipos Maven predefinidos para crear funciones Serverless de los tipos Basic I/O y Advanced I/O. Estos arquetipos se listarán desde el Repositorio Central de Maven. Con estos arquetipos, simplemente puedes proporcionar valores de entrada con los detalles de la función, y estos crearán e inicializarán la función en la estructura estándar e incluirán las dependencias requeridas en el directorio del proyecto Maven. Puedes agregar múltiples funciones de esta manera en directorios POM individuales. Debes recordar los siguientes puntos sobre la creación de funciones con los arquetipos Maven: * Cuando inicializas una función desde el CLI, se te requerirá inicializar el proyecto primero o agregar la función en un directorio de proyecto de Catalyst existente. En el caso de Maven, no podrás inicializar un proyecto por separado. Puedes crear la función directamente. * La función que crees con un arquetipo se creará en la carpeta de destino que selecciones, como se explica en la siguiente sección. * Puedes asociar una función que crees con el arquetipo a un proyecto existente de tu cuenta remota configurando su Project ID en el archivo de configuración Maven pom.xml que se discute en una sección posterior. También necesitarás agregar el Org ID de tu organización de Catalyst en este archivo. * No podrás crear funciones de ningún otro tipo además de Basic I/O y Advanced I/O, ni de ningún otro stack, ni el componente client a través de las herramientas Maven. Necesitarás utilizar el CLI para inicializar estos recursos en tu entorno local. <br> ### Crear una función Basic I/O o Advanced I/O con los arquetipos En este documento de ayuda, cubrimos los pasos para trabajar con las herramientas Maven de Catalyst usando el ejemplo del IDE VS Code. Algunos detalles pueden variar según el IDE que uses. Puedes crear una función Basic I/O o Advanced I/O de la siguiente manera: 1. Crea un nuevo proyecto Maven en tu IDE. Dependiendo del IDE que uses, los pasos pueden variar. También puedes convertir un proyecto existente a Maven, según tu IDE. Para VS Code, haz clic en el ícono **+** bajo Maven para crear un nuevo proyecto Maven. <br /> 2. Escribe "com.zoho.catalyst" en la barra de búsqueda de arquetipos. Selecciona uno de los siguientes según el tipo de función que desees crear: * catalyst-archetype-basicio: Para crear una función Basic I/O * catalyst-archetype-advancedio: Para crear una función Advanced I/O con Catalyst SDK * catalyst-archetype-advancedio-basic: Para crear una función Advanced I/O sin Catalyst SDK <br /> Nota: Si los arquetipos de Catalyst no aparecen en los resultados o si deseas obtener las definiciones más recientes de los arquetipos, es posible que necesites actualizar el catálogo de arquetipos Maven en tu IDE para acceder a los arquetipos publicados más recientes. Dependiendo de tu IDE, puedes buscar los pasos para actualizar el catálogo y realizar las acciones necesarias. En VS Code, abre la paleta de comandos y selecciona Maven: Update Maven Archetype Catalog. 3. Selecciona la versión del arquetipo que elijas. Se recomienda seleccionar la versión más reciente. <br /> 4. Ingresa un group ID para el proyecto. Este ID identifica de forma única tu proyecto Maven. Puedes presionar **Enter** para completarlo con el valor predeterminado. <br /> 5. Ingresa un artifact ID para el proyecto. Este es el nombre del JAR sin versión. Puedes presionar **Enter** para completarlo con el valor predeterminado. <br /> 6. Selecciona una carpeta de destino para guardar tu proyecto Maven. 7. Se te solicitarán algunas entradas en la terminal. Presiona **Enter** después de cada entrada. También puedes presionar directamente **Enter** sin ingresar un valor para enviar el valor predeterminado. * Versión del SNAPSHOT del archivo JAR de salida * Nombre del paquete Maven * El appName o el nombre de referencia de Catalyst de la función Java * Nombre de la clase principal de la función * El project ID del proyecto con el que se asociará esta función * El org ID de tu organización de Catalyst a la que pertenece el proyecto <br /> Nota: Los valores de project ID y org ID se almacenarán en el archivo de configuración pom.xml. Puedes optar por configurarlos directamente en pom.xml más adelante y presionar Enter para omitir la entrada de estos valores ahora. 8. Confirma la configuración de propiedades de tu proyecto Maven ingresando "**Y**" y presionando **Enter**. <br /> La función se creará en tu proyecto Maven con la estructura de directorios como se muestra a continuación. <br /> Cuando inicializas una función Java desde el CLI, la función se crea con el archivo de configuración de proyecto catalyst.json en la raíz del proyecto, los archivos JAR del Catalyst Java SDK en la raíz de la función, así como con otras dependencias del proyecto. Crear una función usando un arquetipo Maven de Catalyst no incluirá los archivos del Java SDK ni ninguna de las dependencias del proyecto en estos directorios. El directorio de la función contendrá en cambio los directorios de origen y destino por separado, y además incluirá pom.xml específico del entorno Maven. El archivo principal de la función Java también se creará con el código predeterminado según el tipo de función, y el archivo catalyst-config.json se creará y configurará automáticamente. -------------------------------------------------------------------------------- title: "Dependencia del Java SDK" description: "El Catalyst Java SDK se gestiona automáticamente como una dependencia Maven cuando creas un Basic I/O y Advanced I/O con el arquetipo Maven de Catalyst en tu IDE." last_updated: "2026-07-02T09:34:15.970Z" source: "https://docs.catalyst.zoho.com/es/tools/maven-tools/java-sdk-dependency/" service: "Serverless" -------------------------------------------------------------------------------- # Dependencia del Catalyst Java SDK El paquete catalyst-java-sdk normalmente se descarga durante la inicialización de una función Java desde el CLI y se guarda en el directorio de la función. También puedes acceder al paquete SDK desde la sección de Developer Tools en la configuración de la consola de Catalyst en cualquier momento e incluirlo dentro de la carpeta de tu función Java. Con la opción de agregar el Catalyst Java SDK como dependencia Maven, Catalyst asegura lo siguiente: * El paquete Java SDK se incorpora automáticamente para cada función Java que crees a través de los arquetipos de Catalyst. * El SDK se agrega como una dependencia Maven en el archivo de configuración pom.xml dentro del paquete de la función. * El versionado del paquete Java SDK se maneja automáticamente. Catalyst se asegura de que se aplique la última versión del paquete SDK cuando una función Java se sirve o despliega. * La función se empaqueta automáticamente con el paquete SDK cuando la empaquetas, sirves o despliegas. Por lo tanto, la dependencia Maven del Java SDK te evita ser responsable de gestionar el toolkit del SDK y asegura que no necesites descargar el SDK para cada función que crees. Encontrarás el paquete Java SDK listado bajo las dependencias Maven en tu IDE. <br /> -------------------------------------------------------------------------------- title: "pom.xml" description: "Las definiciones de las dependencias del Catalyst Java SDK y del plugin Maven de Catalyst se encuentran en pom.xml, que es un archivo de configuración Maven en un proyecto Maven." last_updated: "2026-07-02T09:34:15.970Z" source: "https://docs.catalyst.zoho.com/es/tools/maven-tools/pom-xml/" service: "Serverless" -------------------------------------------------------------------------------- # El archivo de configuración pom.xml pom.xml es un archivo de configuración Maven en el directorio de tu proyecto Maven que contiene información sobre el proyecto y los detalles de configuración utilizados por Maven para compilar el proyecto. Por ejemplo, especifica el group ID y el artifact ID del proyecto Maven, las propiedades del proyecto, las dependencias y plugins utilizados, su información de ejecución, etc. Nota: pom.xml se crea automáticamente cuando creas el proyecto Maven o conviertes un proyecto existente a Maven. Dependiendo de tu IDE, es posible que necesites generar este archivo si no se agrega en el proyecto. Puedes encontrar el Catalyst Java SDK agregado automáticamente como dependencia en pom.xml después de crear una función Java. &lt;dependencies&gt; &lt;dependency&gt; &lt;groupId&gt;com.zoho.catalyst&lt;/groupId&gt; &lt;artifactId&gt;java-sdk&lt;/artifactId&gt; &lt;version&gt;1.15.0&lt;/version&gt; &lt;/dependency&gt; &lt;/dependencies&gt; Puedes encontrar las dependencias Java obtenidas del repositorio de Zoho publicado en el Repositorio Central de Maven. &lt;repositories&gt; &lt;repository&gt; &lt;id&gt;java-sdk&lt;/id&gt; &lt;url&gt;https://maven.zohodl.com&lt;/url&gt; &lt;/repository&gt; &lt;/repositories&gt; Las definiciones de compilación en pom.xml incluyen información sobre el artefacto del plugin Maven de Catalyst y los comandos individuales disponibles en el plugin. &lt;build&gt; &lt;plugins&gt; &lt;plugin&gt; &lt;groupId&gt;com.zoho.catalyst&lt;/groupId&gt; &lt;artifactId&gt;catalyst-maven-plugin&lt;/artifactId&gt; &lt;version&gt;0.0.2&lt;/version&gt; &lt;executions&gt; &lt;execution&gt; &lt;id&gt;catalyst-package&lt;/id&gt; &lt;phase&gt;package&lt;/phase&gt; &lt;goals&gt; &lt;goal&gt;package&lt;/goal&gt; &lt;/goals&gt; &lt;/execution&gt; &lt;execution&gt; &lt;id&gt;catalyst-deploy&lt;/id&gt; &lt;phase&gt;deploy&lt;/phase&gt; &lt;goals&gt; &lt;goal&gt;deploy&lt;/goal&gt; &lt;/goals&gt; &lt;/execution&gt; &lt;/executions&gt; &lt;configuration&gt; &lt;org&gt;901738101&lt;/org&gt; &lt;project&gt;3376000001796044&lt;/project&gt; &lt;/configuration&gt; &lt;/plugin&gt; &lt;/plugins&gt; &lt;/build&gt; Como se mencionó anteriormente, puedes configurar el project ID de tu proyecto de Catalyst y el org ID de la organización a la que pertenece el proyecto en la sección _&lt;configuration&gt;&lt;/configuration&gt;_ bajo las definiciones de compilación, si no lo configuraste durante la creación de la función. -------------------------------------------------------------------------------- title: "Plugin Maven de Catalyst" description: "Catalyst proporciona un plugin Maven que te permite empaquetar, servir y desplegar fácilmente las funciones que creas con los arquetipos Maven de Catalyst." last_updated: "2026-07-02T09:34:15.970Z" source: "https://docs.catalyst.zoho.com/es/tools/maven-tools/maven-plugin/" service: "Serverless" -------------------------------------------------------------------------------- # El plugin Maven de Catalyst ### Introducción El plugin catalyst estará disponible bajo los plugins Maven después de inicializar una función Basic I/O o Advanced I/O desde el arquetipo. Puedes encontrar los comandos individuales que se muestran a continuación bajo este plugin, que te permitirán realizar varias operaciones en tus funciones de Catalyst y artefactos Maven. <br /> Las ejecuciones de los comandos serve y deploy se realizan después de autenticar tu solicitud. Actualmente, Catalyst proporciona autenticación propietaria para el plugin Maven que es independiente de la autenticación del Catalyst CLI. Tu IDE te solicitará la generación del token de autenticación cuando ejecutes estos comandos, y los tokens que se creen se guardarán en tu sistema local. Los comandos package y help no requieren autenticación. <br> ### Package El comando package de Catalyst es exclusivo del plugin Maven y no está disponible en el CLI. Esto te permite empaquetar el directorio de tu función Java como un paquete ejecutable. Nota: Puedes empaquetar una función manualmente antes de servirla o desplegarla. Sin embargo, si sirves o despliegas una función directamente sin ejecutar el comando package primero, Catalyst empaquetará automáticamente la función antes de servirla o desplegarla. #### Empaquetar una función con el plugin Maven de Catalyst Puedes empaquetar una función Java Basic I/O o Advanced I/O como se describe a continuación. En este ejemplo, hemos ejecutado este comando a través del IDE VS Code. Haz clic en el comando **package** bajo **Plugins > catalyst** en las herramientas Maven. <br /> Puedes hacer seguimiento del progreso de la ejecución en la terminal de tu IDE. La función se compilará al formato de archivo JAR como un SNAPSHOT de Maven. Puedes encontrar el paquete desplegable completo catalyst-archive.zip agregado en la carpeta target del directorio de tu proyecto Maven. <br /> El directorio target contendrá todos los archivos compilados, bibliotecas y otras dependencias Maven, junto con el archivo de compilación y el JAR SNAPSHOT de la función principal. <br /> catalyst-archive contiene los archivos de biblioteca desplegables incluyendo el Java SDK, los archivos fuente compilados, catalyst-config.json y pom.xml. <br /> La función ahora se puede servir localmente o desplegar en el proyecto remoto. <br> ### Serve El comando serve del plugin Maven de Catalyst es similar al comando del CLI, catalyst serve. Te permite servir y probar tu función a través de un localhost en tu sistema, antes de desplegarla en el proyecto remoto. Puedes servir tanto funciones Basic I/O como Advanced I/O y obtener sus endpoints locales para probar. Además, puedes aprovechar el depurador de tu IDE y adjuntarlo a la sesión de serve en vivo para una experiencia de pruebas mejorada. Catalyst también te permite realizar una recarga en caliente de la función que sirves. Esto te permite hacer cambios en el código de tu función y ver las actualizaciones reflejadas en vivo, sin tener que recompilar o reservir el código. Nota: * El project ID y el org ID asociados con la función deben configurarse en pom.xml antes de servir la función. * Tu función necesitará estar empaquetada antes de servirla. Puedes [empaquetarla](#package) desde el plugin, o servirla directamente, lo que ejecutará automáticamente el comando package. * El directorio del proyecto Maven debe estar en la estructura estándar con todos los archivos de dependencia Maven y Catalyst requeridos para un serve exitoso. <br> #### Servir una función con el plugin Maven de Catalyst Puedes servir una función Java Basic I/O o Advanced I/O como se describe a continuación. En este ejemplo, hemos ejecutado este comando a través del IDE VS Code. 1. Haz clic en el comando **serve** bajo **Plugins > catalyst** en las herramientas Maven. <br /> La terminal de tu IDE mostrará el progreso de la sesión de serve. <br /> 2. Catalyst te solicitará autenticar tu solicitud de serve si no se detecta un token de autenticación válido. Abre la URL mostrada en la terminal en una ventana del navegador. <br /> 3. Haz clic en **Accept** en la ventana de tu navegador. Esto autenticará tu cuenta de Catalyst y proporcionará los permisos solicitados al Catalyst CLI. <br /> Ahora puedes cerrar la ventana y dirigirte a tu IDE. 4. Catalyst iniciará un servidor local en el puerto predeterminado 3010. Accede a la URL local de la función servida desde la terminal. <br /> Nota: Dependiendo de tu IDE, es posible que se abra automáticamente una consola de depuración para que pruebes tus recursos alojados. También puedes adjuntar un depurador por tu cuenta a la sesión de serve, si esto no ocurre automáticamente. La terminal mostrará un log en vivo de las acciones realizadas. Dependiendo de tu IDE, puedes finalizar la sesión de serve terminando la ejecución del comando. <br> ### Deploy El comando deploy del plugin Maven de Catalyst es similar al comando del CLI, catalyst deploy. Te permite desplegar tu función en el proyecto remoto después de terminar las pruebas. Puedes desplegar tanto funciones Basic I/O como Advanced I/O y obtener su endpoint de URL desplegada. Nota: * El project ID y el org ID asociados con la función deben configurarse en pom.xml antes de desplegar la función. * Tu función necesitará estar empaquetada antes de desplegarla. Puedes [empaquetarla](#package) desde el plugin, o desplegarla directamente, lo que ejecutará automáticamente el comando package. * El directorio del proyecto Maven debe estar en la estructura estándar con todos los archivos de dependencia Maven y Catalyst requeridos para un despliegue exitoso. <br> #### Desplegar una función con el plugin Maven de Catalyst Puedes desplegar una función Java Basic I/O o Advanced I/O como se describe a continuación. En este ejemplo, hemos ejecutado este comando a través del IDE VS Code. 1. Haz clic en el comando **deploy** bajo **Plugins > catalyst** en las herramientas Maven. <br /> La terminal de tu IDE mostrará el progreso de la ejecución del comando. <br /> 2. Catalyst te solicitará autenticar tu solicitud de despliegue si no se detecta un token de autenticación válido. Abre la URL mostrada en la terminal en una ventana del navegador. <br /> 3. Haz clic en **Accept** en la ventana de tu navegador. Esto autenticará tu cuenta de Catalyst y proporcionará los permisos solicitados al Catalyst CLI. <br /> Ahora puedes cerrar la ventana y dirigirte a tu IDE. 4. La terminal mostrará la URL desplegada de tu función a la que puedes acceder. <br /> Nota: La parte /server/ en la URL de una aplicación de Catalyst indica una función. La URL de una función Basic I/O contiene un /execute después del nombre de la función, mientras que la URL de una función Advanced I/O no contiene esa palabra clave. Ahora podrás acceder a la función en tu proyecto en la consola remota. <br> ### Help El plugin Maven proporciona un comando help que muestra información de ayuda de todos los comandos del plugin cuando lo ejecutas. <br /> Puedes ver los detalles en la terminal de tu IDE. <br /> ## Tunelización de Catalyst -------------------------------------------------------------------------------- title: "Introducción" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas de funciones a tu sistema local usando una URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.974Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/introduction/" service: "All Services" -------------------------------------------------------------------------------- # Catalyst Tunneling ## Introducción Catalyst Tunneling te permite depurar localmente funciones **Catalyst Serverless** non-HTTPS (funciones Event y funciones Cron), así como las funciones Integration. La depuración local es una parte fundamental de la ingeniería de aplicaciones. Si bien existen medios claros y sin restricciones para depurar funciones Basic I/O y Advanced I/O en Catalyst, depurar funciones backend non-HTTPS como las funciones Event y Cron, o las funciones backend HTTPS como las funciones Integration, puede resultar difícil o restrictivo. Las funciones Cron, Event e Integration solo se ejecutan mediante invocación automática de backend. No se activan directamente por una URL de endpoint como las funciones Advanced y Basic I/O. En cambio, estas funciones se ejecutan debido a un evento en tiempo de ejecución, o en un horario o intervalo de tiempo particular como proceso de backend. Depurar estas funciones en el entorno de desarrollo sin un disparador exacto es inconcluyente. Tunneling es una funcionalidad de Catalyst que resuelve este problema. Sin Catalyst Tunneling para depurar funciones Integration y non-HTTPS en el entorno de desarrollo, necesitarías iniciar un shell de funciones en el Catalyst CLI y probar las funciones proporcionando entradas de ejemplo. Solo para las funciones Event, además podrías generar un payload de ejemplo como entrada y verificar la salida. Sin embargo, estos métodos no te permiten examinar la lógica del código ni te proporcionan suficiente asistencia de depuración para probar la función. Tunneling funciona bajo el principio de hacer proxy inverso de las funciones de Catalyst, pasando de ejecutarse en la nube a ejecutarse en un servidor web local. Esto te permite depurar las funciones en tu IDE local. Puedes usar un proveedor de proxy inverso de tu elección y proporcionar una URL de Tunneling para que estas funciones sean depuradas. Luego activas la URL y, usando Catalyst Tunneling, puedes enrutar las llamadas realizadas a estas funciones a tu sistema local, depurándolas fácilmente. Nota: Tunneling está disponible para depurar funciones de Catalyst de todos los runtimes soportados: Java, Node.js y Python. <br /> Con Catalyst Tunneling en combinación con un servicio de proxy inverso de terceros de tu elección, puedes depurar funciones de forma efectiva usando la consola de Catalyst, el Catalyst CLI y cualquier IDE de tu elección. Nota: Tunneling solo está disponible en el entorno de desarrollo de Catalyst. -------------------------------------------------------------------------------- title: "Beneficios" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas de funciones a tu sistema local usando una URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.974Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/benefits/" service: "All Services" -------------------------------------------------------------------------------- # Beneficios * **Experiencia de depuración eficiente**: Sin Catalyst Tunneling, depurar funciones non-HTTPS como Cron y Event o funciones Integration en el entorno de desarrollo era una tarea inconcluyente. No tenías la libertad de establecer tus puntos de interrupción preferidos en tu archivo de código y depurarlos como lo harías con las funciones Basic I/O y Advanced I/O. Ahora, usando Tunneling, puedes activar funciones Cron, Event e Integration a voluntad y examinar cada línea de código con total facilidad. * **Sin limitación de proveedores de proxy inverso**: Catalyst Tunneling se puede usar con cualquier proveedor de proxy inverso de tu elección. Si bien no hay limitación sobre qué proveedor de proxy inverso puedes usar, te recomendamos que utilices los servicios de proveedores de proxy inverso de confianza. Puedes encontrar pasos detallados sobre cómo configurar la URL de Tunneling usando algunos de los proveedores de proxy inverso más populares en esta sección. * **Sin restricciones de IDE**: Si tu IDE te permite configurar un depurador, con Catalyst Tunneling puedes usarlo directamente para depurar tus funciones non-HTTPS e Integration. Esta documentación de ayuda también contiene pasos específicos sobre configurar los depuradores de algunos de los IDEs más utilizados. * **Gestionar Tunneling desde la consola**: Puedes habilitar, deshabilitar y seleccionar múltiples funciones para tunneling directamente en la consola. La consola de Catalyst también deshabilitará automáticamente el tunneling después de 24 horas si no desactivas el proceso de tunneling. También tienes la opción de actualizar tu selección de funciones non-HTTPS e Integration que necesitas tunelizar. <br /> -------------------------------------------------------------------------------- title: "Conceptos clave" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas de funciones a tu sistema local usando una URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.974Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/key-concepts/" service: "All Services" -------------------------------------------------------------------------------- # Conceptos clave Antes de implementar Tunneling en tus funciones, hay algunos conceptos clave con los que necesitas familiarizarte: * **Servicio de proxy inverso de terceros**: Los proveedores de proxy inverso generarán URLs de acceso público a tu solicitud que harán proxy de todas las solicitudes a tu servidor web local, y te permitirán conectar tu localhost con internet. Puedes elegir cualquier proveedor de proxy inverso de tu preferencia. En esta sección de la documentación de ayuda, repasaremos los pasos detallados para generar la URL de Tunneling para tus funciones con los siguientes proveedores de proxy inverso: - Ngrok - Localtunnel - Serveo - Localhost.run - Pagekite Nota: En esta documentación de ayuda, solo repasaremos los pasos para usar los proveedores de proxy inverso para generar una URL de Tunneling. Puedes obtener más información sobre estos proveedores de proxy inverso y los servicios que ofrecen visitando sus respectivas documentaciones de ayuda. * **URL de Tunneling**: Esta es una URL generada por un proveedor de proxy inverso. Esta URL enruta todas las llamadas realizadas a tus funciones non-HTTPS y función Integration a tu sistema local. El servidor web local maneja el alojamiento de la aplicación al que se puede acceder con esta URL. Esencialmente, esta URL permite que tu sistema local actúe como el servidor en el que tus funciones Cron, Event e Integration pueden ejecutarse. Si tu proveedor de proxy inverso no genera la URL de Tunneling correctamente, el *Execution History* de la función se listará con el estado "**URL Not Found**" cuando se tunelice, y encontrarás un error. * **Funciones tunelizadas**: Estas son funciones non-HTTPS e Integration que has seleccionado para tunelizar. Las funciones Cron, Event e Integration se activan solo durante el tiempo de ejecución como un proceso de backend y típicamente se ejecutan en la nube de Catalyst. Sin embargo, cuando estas funciones están tunelizadas, sus ejecuciones se enrutan a tu sistema local. Como resultado, los logs en vivo de las ejecuciones de estas funciones solo estarán disponibles en el CLI y no en el componente Catalyst Logs, ni en ningún otro lugar de la consola. El otro conjunto de logs que contendrá información sobre Tunneling son los Audit Logs, donde se mostrará información como cuándo y por quién se habilitó el tunneling. * **Catalyst Function Shell**: Catalyst te permite iniciar un shell de funciones en el Catalyst CLI, donde puedes depurar funciones. Funciona de manera similar a un shell de Node, pero está potenciado por las funcionalidades del Catalyst CLI. Usaremos este shell para ejecutar los comandos de Tunneling. Puedes encontrar una lista de los comandos de shell de Catalyst para Tunneling en esta sección. * **Condiciones para habilitar Tunneling:** Tunneling solo es posible en el entorno de desarrollo de Catalyst. Para tunelizar tus funciones, primero debes hacerlas disponibles en la consola de Catalyst, ya sea creándolas y codificándolas en la consola desde la sección de Catalyst Serverless, o desplegándolas en la consola después de codificarlas en tu entorno local. * **Application Performance Monitoring no estará disponible para las funciones mientras estén siendo tunelizadas**: Cuando una función está siendo tunelizada, las llamadas realizadas a la función se enrutan a tu sistema local. Esto impide que el componente Application Performance Monitoring (APM) monitoree el rendimiento de tu función. Sin embargo, si finalizas el tunneling, puedes usar APM para monitorear el rendimiento de la función. -------------------------------------------------------------------------------- title: "Arquitectura" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas de funciones a tu sistema local usando una URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.974Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/architecture/" service: "All Services" -------------------------------------------------------------------------------- # Arquitectura El siguiente diagrama ilustra las operaciones de backend involucradas en la depuración de las funciones non-HTTPS e Integration de Catalyst usando **Catalyst Tunneling**: <br /> Nota: Catalyst Tunneling solo está disponible en el entorno de desarrollo. Los pasos a continuación describen el flujo de trabajo involucrado en la depuración de tus funciones non-HTTPS e Integration usando Catalyst Tunneling: 1. En la consola de Catalyst, seleccionaremos las funciones non-HTTPS o Integration para tunneling, proporcionaremos la URL de Tunneling que generamos usando un servicio de proxy inverso de terceros y habilitaremos Tunneling. 2. Luego procederemos a iniciar un shell de funciones y comenzaremos a realizar operaciones de depuración usando Catalyst Tunneling. 3. Ahora, cada vez que actives la función usando la URL de Tunneling, las llamadas realizadas se enrutarán a tu sistema local y los logs estarán presentes en el Catalyst CLI. Esencialmente, tu sistema local actúa como el servidor en el que se ejecutan las funciones habilitadas para tunneling.<br /><br />Esto te permite establecer puntos de interrupción en tu archivo de código y depurar tu función con facilidad. Nota: * Después de tunelizar una función, los logs de su ejecución solo estarán disponibles en el Catalyst CLI, y la información fundamental como cuándo y por quién se habilitó el tunneling estará disponible en la sección de Audit Logs presente en la consola. * Si bien puedes seleccionar múltiples funciones para tunelizar, solo cuando se complete la depuración de la primera función podrás comenzar a depurar la siguiente función. A partir de la actualización actual, solo es posible este tipo de depuración sincrónica de funciones. * Los pasos para configurar el depurador de algunos de los IDEs más populares, como Visual Studio Code, IntelliJ y otros, para depurar funciones se encuentran en esta sección. -------------------------------------------------------------------------------- title: "Gestionar Tunneling en la consola" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas de funciones a tu sistema local usando una URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.974Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/manage-tunneling/" service: "All Services" -------------------------------------------------------------------------------- # Gestionar Tunneling en la consola En esta sección de ayuda, aprenderemos cómo gestionar las operaciones de Tunneling en la consola. ### Editar Tunneling Puedes actualizar las funciones a tunelizar agregándolas o eliminándolas, o la URL de Tunneling que configuraste. Para editar el túnel: 1. Haz clic en la opción **Edit Tunnel** <br /> 2. Realiza los cambios necesarios y haz clic en **Update**. <br /> El túnel ha sido editado. <br /> ### Deshabilitar Tunneling Para deshabilitar el tunneling de tus funciones: 1. Haz clic en el botón **Disable**. <br /> 2. Haz clic en **Yes, Proceed** para deshabilitar el tunneling. <br /> El tunneling se deshabilitará. <br /> Si no deshabilitas manualmente el tunneling de tus funciones, Catalyst lo deshabilitará automáticamente en **24 horas** y recibirás una notificación por correo electrónico informándote al respecto. <br /> Puedes habilitar el tunneling nuevamente haciendo clic en **Enable**. Nota: También puedes usar el siguiente comando del Catalyst CLI para habilitar Tunneling: catalyst functions: shell --tunnel tunnel-port-number --enable-tunnel tunneling-URL <br> Puedes obtener más información sobre los comandos del CLI involucrados en Tunneling en esta sección de ayuda. Este comando opcional solo te permitirá habilitar el tunneling. No podrás editar ni realizar ninguna otra operación que de otro modo está disponible en la consola. Para deshabilitar el tunneling, simplemente sal de la terminal. <br> Si deseas tunelizar tus funciones con una nueva URL de Tunneling, reemplaza &lt;tunneling-URL&gt; con tu URL recién generada. ### Implementación > Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso. -------------------------------------------------------------------------------- title: "Requisitos previos" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.975Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/implementation/prerequisites/" service: "All Services" -------------------------------------------------------------------------------- # Requisitos previos Se deben cumplir las siguientes condiciones para poder depurar tus funciones non-HTTPS e Integration: 1. Si tu proveedor de proxy inverso requiere ciertos pasos específicos, como la instalación de su CLI, complétalos antes de comenzar con la implementación. Por ejemplo, si tu proveedor de proxy inverso es Ngrok, necesitas instalar su CLI. <br /> Nota: Puedes encontrar los pasos detallados para generar la URL de Tunneling para algunos de los proveedores de proxy inverso más comunes como: * Ngrok * Localtunnel * Serveo * Localhost.run * Pagekite<br /> 2. Despliega las funciones que deseas tunelizar en la consola de Catalyst en el entorno de desarrollo desde tu entorno de proyecto local con el CLI. <br /> Para depurar tus funciones non-HTTPS e Integration usando Catalyst Tunneling, necesitas implementar los siguientes pasos: 1. Generar la URL de Tunneling 2. Configurar Tunneling en la consola 3. Iniciar el shell de Catalyst Functions y comenzar el Tunneling 4. Configurar el depurador del IDE para comenzar a depurar tus funciones 5. Depurar las funciones tunelizadas Las siguientes secciones de ayuda contienen instrucciones detalladas para completar los pasos mencionados anteriormente. -------------------------------------------------------------------------------- title: "Generar la URL de Tunneling" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.975Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/implementation/generate-tunneling-url/" service: "All Services" -------------------------------------------------------------------------------- # Generar la URL de Tunneling Se requiere la URL de Tunneling porque necesitas asociarla con tus funciones habilitadas para tunneling cuando habilitas Tunneling. Cuando se activen tus funciones tunelizadas, las llamadas realizadas a esta URL se enrutarán a tu sistema local. Dependiendo del proveedor de proxy inverso que hayas elegido, los pasos para generar la URL de Tunneling varían. Para los propósitos de esta documentación, cubriremos los pasos para generar la URL de Tunneling con algunos de los proveedores de proxy inverso más populares y utilizados. ### Ngrok * Inicia sesión en **Ngrok** a través de su CLI y configura la autenticación de dos factores (2FA) para Ngrok en tu sistema. Nota: Los pasos para establecer 2FA para Ngrok se proporcionan en su documentación oficial de ayuda. * Para generar una *URL de Tunneling*, usa el siguiente comando CLI: ngrok http tunnel-port-number * Copia la URL de Tunneling generada por Ngrok y procede a la consola de Catalyst para tunelizar las funciones usando Catalyst. Nota: * El tunnel-port-number que uses aquí deberá ser el mismo que utilices para iniciar tu shell de funciones. * Puedes encontrar más información sobre Ngrok en su documentación oficial de ayuda. ### Localtunnel * Instala **Localtunnel** en tu sistema local ejecutando el siguiente comando de terminal: npm install -g localtunnel <br /> * Ejecuta el siguiente comando en el CLI de Localtunnel para generar una URL de tunneling: lt --port tunnel-port-number * Copia la URL de Tunneling generada por Localtunnel y procede a la consola de Catalyst para tunelizar las funciones usando Catalyst. Nota: * El tunnel-port-number que uses aquí deberá ser el mismo que utilices para iniciar tu shell de funciones. * Puedes encontrar más información sobre Localtunnel en su documentación oficial de ayuda. ### Serveo * Ejecuta el siguiente comando en una nueva ventana de terminal para generar una URL de tunneling usando **Serveo**. ssh -R 80:localhost:tunnel-port_number serveo.net * Copia la URL de Tunneling generada por Serveo y procede a la consola de Catalyst para tunelizar las funciones usando Catalyst. Nota: * El tunnel-port-number que uses aquí deberá ser el mismo que utilices para iniciar tu shell de funciones. * No necesitas comandos CLI adicionales para generar la URL de Tunneling usando Serveo. Puedes encontrar más información sobre Serveo en su documentación oficial de ayuda. ### Localhost.run * Ejecuta el siguiente comando en una nueva ventana de terminal para generar una URL de tunneling usando **Localhost.run**: ssh -R 80:localhost:tunnel-port-number nokey@localhost.run * Copia la URL de Tunneling generada por Localhost.run y procede a tunelizar las funciones usando Catalyst. Nota: * El tunnel-port-number que uses aquí deberá ser el mismo que utilices para iniciar tu shell de funciones. * No necesitas comandos CLI adicionales para generar la URL de Tunneling usando Localhost.run. Puedes encontrar más información sobre Localhost.run en su documentación oficial de ayuda. ### Pagekite * Ejecuta los siguientes comandos en una nueva ventana de terminal para generar una URL de tunneling usando **Pagekite**. ssh -R 80:localhost:tunnel-port-number nokey@localhost.run Este comando enviará una solicitud curl al sitio web de Pagekite y te pedirá que descargues el archivo pagekite.py en tu sistema local. Nota: Puedes usar Pagekite para hacer proxy inverso de funciones de cualquier stack de programación. Sin embargo, para usar los servicios de Pagekite, debes asegurarte de tener Python 3 instalado en tu sistema. * Ahora ejecuta el siguiente comando en tu terminal de Pagekite para generar la URL de Tunneling: python3 pagekite.py tunnel-port-number yourname.pagekite.me Asegúrate de proporcionar un nombre único para tu URL de Tunneling cuando se te solicite. Nota: * El tunnel-port-number que uses aquí deberá ser el mismo que utilices para iniciar tu shell de funciones. * Puedes encontrar más información sobre Pagekite en su documentación oficial de ayuda. -------------------------------------------------------------------------------- title: "Configurar Tunneling en la consola de Catalyst" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.975Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/implementation/config-tunneling-console/" service: "All Services" -------------------------------------------------------------------------------- # Configurar Tunneling en la consola de Catalyst Para acceder a Tunneling en la consola de Catalyst: 1. Abre tu proyecto de Catalyst en la consola y haz clic en el ícono de **settings**. <br /> 2. Navega a *Project Settings* y haz clic en **Tunneling**. <br /> 3. Haz clic en **Create Tunnel Route**. <br /> 4. Selecciona las funciones non-HTTPS e Integration que deseas tunelizar desde el menú desplegable. <br /> 5. Pega la *URL de Tunneling* generada en el paso anterior en el campo de entrada **Tunneling URL**. <br /> Nota: * Las funciones que selecciones y la URL de Tunneling que utilices se mostrarán en el diagrama de flujo de tunneling. * Para que las funciones estén disponibles en la consola, necesitas haber desplegado las funciones en la consola de Catalyst en el entorno de desarrollo de tu proyecto desde tu sistema local. * Actualmente solo se puede realizar depuración sincrónica de funciones. La siguiente función solo se tunelizará cuando se complete el tunneling de la función actual. 6. Haz clic en **Enable**. <br /> Ahora podrás ver la lista de funciones para las que habilitaste el tunneling, así como otros detalles generales, como cuándo y por quién se habilitó el tunneling. Nota: * El tiempo de espera de ejecución para funciones Integration es de 30 segundos y para funciones Cron y Event es de 15 minutos. * Algunos de los proveedores de proxy inverso que elijas para tunelizar tus funciones podrían emitir un mensaje de tiempo de espera agotado en una duración menor a la establecida por Catalyst. En estos casos, el mensaje de tiempo de espera agotado también aparecerá en el historial de ejecución de las funciones de Catalyst. * Algunos de los proveedores de proxy inverso que elijas para tunelizar tus funciones podrían emitir un mensaje de tiempo de espera agotado en una duración menor a la establecida por Catalyst. En estos casos, el mensaje de tiempo de espera agotado también aparecerá en el historial de ejecución de las funciones de Catalyst. Si deseas depurar tus funciones tunelizadas, necesitarás configurar ajustes adicionales y usar un comando CLI diferente. Los pasos detallados sobre cómo depurar tus funciones tunelizadas desde tu IDE se encuentran en esta sección. -------------------------------------------------------------------------------- title: "Iniciar el shell de Catalyst Functions y comenzar el Tunneling" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.975Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/implementation/launch-tunneling/" service: "All Services" -------------------------------------------------------------------------------- # Iniciar el shell de Catalyst Functions y comenzar el Tunneling Inicia el shell de Catalyst Functions usando el siguiente comando CLI con la opción --tunnel y especifica el número de puerto en el que generaste la URL de Tunneling. catalyst functions:shell --tunnel tunnel-port-number Este comando iniciará el tunneling de tus funciones. <br /> Si activas la función, todas las llamadas realizadas se enrutarán localmente y podrás ver sus logs de ejecución en el Catalyst CLI. <br /> Si intentas ver el *Execution History* de la función tunelizada presente en la sección del componente, se indicará claramente que la función ha sido tunelizada. <br /> Si además haces clic en el ícono de **view-logs**, podrás ver detalles como cuándo y por quién se habilitó y deshabilitó el tunneling. <br /> Nota: Los logs solo serán visibles en el Catalyst CLI porque la función non-HTTPS o Integration se está ejecutando en la máquina local y no en la nube de Catalyst. La misma información se puede encontrar en los Audit Logs. <br /> Ahora, ejecuta el siguiente comando CLI para tunelizar y depurar tus funciones: catalyst functions:shell --tunnel tunnel-port-number --debug port-number <br /> Nota: Asegúrate de proporcionar números de puerto diferentes para tunneling y depuración. Si tunelizas tu función y eliges depurar, debes implementar configuraciones adicionales del IDE. Puedes encontrar los pasos para configurar el depurador de tu IDE para depurar funciones tunelizadas en esta sección. #### Stack de funciones > Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso. -------------------------------------------------------------------------------- title: "Java" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.975Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/implementation/ide-config/java/" service: "All Services" -------------------------------------------------------------------------------- # Configurar el IDE para depurar funciones Java Para los propósitos de esta documentación, vamos a ilustrar cómo configurar las preferencias de depuración de funciones Java non-HTTPS e Integration en los IDEs Visual Studio Code, IntelliJ IDEA y Eclipse. Nota: Este paso solo es aplicable si deseas depurar tus funciones tunelizadas y si has usado el siguiente comando CLI: catalyst functions:shell --tunnel tunnel-port-number --debug port-number<br /> Si solo deseas tunelizar tus funciones y has usado el siguiente comando CLI, no se requiere configuración del IDE. catalyst functions:shell --tunnel tunnel-port-number<br /> Este comando solo tunelizará tus funciones y publicará los logs de las funciones en el Catalyst CLI. ### Configurar el depurador del IDE Visual Studio Code 1. Asegúrate de tener todas las funciones que necesitas depurar en la máquina local y abre el proyecto correspondiente en VS Code. <br /> 2. Haz clic en el botón **Run/Debug** presente en la barra de menú y crea un archivo launch.json haciendo clic en la opción "**create a launch.json file**". <br /> Así es como aparece el archivo launch.json antes de comenzar las configuraciones. <br /> 3. Copia el siguiente fragmento JSON y pégalo como valor en la clave JSON "**configurations**". "configurations": [{ "type": "java", "name": "java_cron", // el nombre puede ser cualquiera, pero usar el mismo nombre de la función será útil durante la depuración "request": "attach", "hostName": "localhost", "port": 9001,// El número de puerto de depuración que especificaste en catalyst functions:shell --tunnel 8001 --debug 9001. El número de puerto puede ser cualquier número que no esté siendo usado por otros procesos "projectName": "java_cron"// El nombre de la función }], 4. Guarda este archivo, aplica los breakpoints en las líneas de código requeridas y procede al siguiente paso. <br /> ### Configurar el depurador del IDE IntelliJ IDEA 1. Importa el directorio de tu proyecto en el IDE IntelliJ y configura el JDK de runtime para que coincida con tu versión de Java. <br /> Nota: Puedes descubrir cómo configurar tu JDK en IntelliJ IDEA visitando su documentación oficial de ayuda. 2. Haz clic en **Run>Edit Configurations**. <br /> 3. Haz clic en el **ícono +**, selecciona la opción **Remote JVM Debug** del menú emergente y haz clic en **OK**. <br /> 4. Asegúrate de establecer los siguientes valores en el menú emergente: - Name: Establécelo como el nombre de tu proyecto o cualquier otro nombre de tu preferencia. - En la pestaña *Configurations*: - Debugger mode: **Attach to remote JVM** - Host: **localhost** - Port: Establece el mismo valor de puerto que configuraste para la depuración en el Catalyst CLI. - Use module classpath: Selecciona la ruta del directorio de tu proyecto. - Haz clic en **OK**. <br /> 5. Establece los puntos de depuración requeridos en tu código y procede al siguiente paso. <br /> ### Configurar el depurador del IDE Eclipse 1. Importa el directorio de tu proyecto en el *IDE Eclipse*. <br /> 2. Asegúrate de que tu stack de Java y el JDK estén en la misma versión haciendo clic derecho en la lista de tu proyecto y seleccionando **Build Path > Configure Build Path**. <br /> 3. Selecciona **Project Natures**. Busca "**Java**", selecciona "**java**" de la lista y haz clic en **OK**. <br /> 4. Asegúrate de que **Java Compiler** esté seleccionado y haz clic en **Apply and Close** para agregar el compilador de Java a tu proyecto. <br /> 5. A continuación, haz clic derecho en el directorio de tu proyecto y haz clic en **Debug As > Debug Configuration**. <br /> 6. Busca *Remote Java Applications*, haz clic derecho en el resultado de búsqueda y selecciona **New Configurations**. <br /> Se te dirigirá a un menú emergente de **Debug Configurations**. 7. Asegúrate de haber configurado el depurador con los siguientes valores: - Pestaña *Connect*: - Selecciona el directorio de tu proyecto - Establece Connection Type como "**Standard (Socket Attach)**" - Establece *Connection Properties* como: - Host: **localhost** - Port: Ingresa el número de puerto que configuraste para la depuración en el Catalyst CLI <br /> - Pestaña *Source*: - Haz clic en el botón **Add** y selecciona el directorio de la función <br /> Una vez que hayas aplicado las configuraciones requeridas, haz clic en **Debug**. 8. Abre el archivo de tu función, establece los puntos de depuración requeridos en tu código y procede al siguiente paso. <br /> -------------------------------------------------------------------------------- title: "Node.js" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.975Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/implementation/ide-config/nodejs/" service: "All Services" -------------------------------------------------------------------------------- # Configurar el IDE para depurar funciones Node.js Para los propósitos de esta documentación, vamos a ilustrar cómo configurar las preferencias de depuración de funciones Node.js non-HTTPS e Integration en Visual Studio Code. Nota: Este paso solo es aplicable si deseas depurar tus funciones tunelizadas y si has usado el siguiente comando CLI: catalyst functions:shell --tunnel tunnel-port-number --debug port-number<br /> Si solo deseas tunelizar tus funciones y has usado el siguiente comando CLI, no se requiere configuración del IDE. catalyst functions:shell --tunnel tunnel-port-number<br /> Este comando solo tunelizará tus funciones y publicará los logs de las funciones en el Catalyst CLI. Configura el depurador de tu IDE VS Code de la siguiente manera: 1. Asegúrate de tener todas las funciones que necesitas depurar en la máquina local y abre el proyecto correspondiente en VS Code. <br /> 2. Haz clic en el botón **Run/Debug** presente en la barra de menú y crea un archivo launch.json haciendo clic en la opción "**create a launch.json file**". <br /> Así es como aparece el archivo launch.json antes de comenzar las configuraciones. <br /> 3. Copia el siguiente fragmento JSON y pégalo como valor en la clave JSON "**configurations**". "configurations": [{ "name": "cron_fun", // el nombre puede ser cualquiera, pero usar el mismo nombre de la función será útil durante la depuración "type": "node", "request": "attach", "address": "localhost", "port": 9001, // El número de puerto de depuración que especificaste en catalyst functions:shell --tunnel 8001 --debug 9001. El número de puerto puede ser cualquier número que no esté siendo usado por otros procesos "localRoot": "/Users/jack/tun_cli/functions/cron_fun" // Ruta exacta donde se encuentra la carpeta de la función }], 4. Guarda este archivo, aplica los breakpoints en las líneas de código requeridas y procede al siguiente paso. <br /> -------------------------------------------------------------------------------- title: "Python" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.975Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/implementation/ide-config/python/" service: "All Services" -------------------------------------------------------------------------------- # Configurar el IDE para depurar funciones Python Para los propósitos de esta documentación, vamos a ilustrar cómo configurar las preferencias de depuración de funciones Python non-HTTPS e Integration en Visual Studio Code. Nota: Este paso solo es aplicable si deseas depurar tus funciones tunelizadas y si has usado el siguiente comando CLI: catalyst functions:shell --tunnel tunnel-port-number --debug port-number<br /> Si solo deseas tunelizar tus funciones y has usado el siguiente comando CLI, no se requiere configuración del IDE. catalyst functions:shell --tunnel tunnel-port-number<br /> Este comando solo tunelizará tus funciones y publicará los logs de las funciones en el Catalyst CLI. Configura el depurador de tu IDE VS Code de la siguiente manera: 1. Asegúrate de tener todas las funciones que necesitas depurar en la máquina local y abre el proyecto correspondiente en VS Code. <br /> 2. Haz clic en el botón **Run/Debug** presente en la barra de menú y crea un archivo launch.json haciendo clic en la opción "**create a launch.json file**". <br /> Así es como aparece el archivo launch.json antes de comenzar las configuraciones. <br /> 3. Copia el siguiente fragmento JSON y pégalo como valor en la clave JSON "**configurations**". "configurations":[{ "name": "Python: Current File", "type": "debugpy", "request": "attach", "connect": { "host": "127.0.0.1", "port": 9001 // el número de puerto de depuración que especificaste en catalyst functions:shell --tunnel 8001 --debug 9001. }, "justMyCode": true }], 4. Instala la extensión de VS Code **Python Debugger** para poder depurar funciones Python en el IDE Visual Studio Code. <br /> 5. Instala debugpy en el directorio fuente de la función Python usando el siguiente comando: python3.9 -m pip install debugpy -t ./ <br /> 6. Copia las siguientes líneas de código y pégalas al inicio de tu código de función: import debugpy debugpy.listen(9001) # especifica el puerto para la depuración print("Waiting for debugger to attach") debugpy.wait_for_client() print("debugger attached") 7. Usa la función debugpy.breakpoint() en cualquier parte del archivo principal de código Python para introducir un breakpoint. <br /> #### Stack de funciones > Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso. -------------------------------------------------------------------------------- title: "Java" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.976Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/implementation/debug-tunneled-func/java/" service: "All Services" -------------------------------------------------------------------------------- # Depurar funciones Java tunelizadas Activa las funciones tunelizadas en Catalyst web y confirma que el depurador se ha conectado verificando en el Catalyst CLI un mensaje similar al que se muestra en la imagen a continuación: <br /> Dependiendo del IDE que estés usando, los siguientes pasos pueden variar. ### Depurar funciones Java tunelizadas en el IDE Visual Studio Code 1. Haz clic en el ícono de **Run/Debug** y selecciona las funciones que deseas depurar. <br /> 2. Haz clic en el botón **Play**. <br /> Ahora puedes depurar fácilmente tus funciones non-HTTPS e Integration. <br /> ### Depurar funciones Java tunelizadas en el IDE IntelliJ IDEA 1. Asegúrate de haber establecido los breakpoints requeridos en tu código y haz clic en el botón **Run/Debug configurations**. <br /> 2. Selecciona el *archivo de depurador* que configuraste en el paso anterior desde el menú desplegable. <br /> 3. Una vez que la función se active en Catalyst web y la solicitud de tunneling se inicie en el Catalyst CLI, haz clic en el botón **Debug** y comienza a depurar. <br /> Una vez que hayas completado la depuración de tu código, asegúrate de *detener/terminar* la sesión de depuración en tu IDE haciendo clic en el **ícono de detener**. Esto es para garantizar que el puerto no esté ocupado cuando procedas a tu siguiente sesión de depuración. <br /> ### Depurar funciones Java tunelizadas en el IDE Eclipse 1. Asegúrate de haber establecido los breakpoints requeridos en tu código y haz clic en el **ícono del depurador**. <br /> 2. Selecciona el *archivo de depurador* que configuraste en el paso anterior. <br /> 3. Una vez que actives la función habilitada para tunneling en Catalyst web, haz clic en el botón Debug en tu IDE y depura tu función según sea necesario. <br /> Una vez que hayas completado la depuración de tu código, asegúrate de terminar la sesión de depuración en tu IDE haciendo clic en el **ícono de terminar**. Esto es para garantizar que el puerto no esté ocupado cuando procedas a tu siguiente sesión de depuración. <br /> -------------------------------------------------------------------------------- title: "Node.js" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.976Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/implementation/debug-tunneled-func/nodejs/" service: "All Services" -------------------------------------------------------------------------------- # Depurar funciones Node.js tunelizadas Activa las funciones tunelizadas en Catalyst web y confirma que el depurador se ha conectado verificando en el Catalyst CLI un mensaje similar al que se muestra en la imagen a continuación: <br /> Para los propósitos de esta documentación, vamos a ilustrar la depuración de funciones Node.js tunelizadas usando el IDE Visual Studio Code. Dependiendo del IDE que estés usando, los siguientes pasos pueden variar. 1. Haz clic en el ícono de **Run/Debug** y selecciona las funciones que deseas depurar. <br /> 2. Haz clic en el botón **Play**. <br /> Ahora puedes depurar fácilmente tus funciones non-HTTPS e Integration. <br /> -------------------------------------------------------------------------------- title: "Python" description: "Catalyst Tunneling te permite depurar funciones Non-HTTPS e Integration enrutando las llamadas a funciones hacia tu sistema local mediante la URL de tunneling de un proveedor de proxy inverso." last_updated: "2026-07-02T09:34:15.976Z" source: "https://docs.catalyst.zoho.com/es/tools/tunneling/implementation/debug-tunneled-func/python/" service: "All Services" -------------------------------------------------------------------------------- # Depurar funciones Python tunelizadas Para los propósitos de esta documentación, vamos a ilustrar la depuración de funciones Python tunelizadas usando el IDE Visual Studio Code. Dependiendo del IDE que estés usando, los siguientes pasos pueden variar. 1. Haz clic en el ícono de **Run/Debug** y selecciona las funciones que deseas depurar. <br /> 2. Haz clic en el botón **Play**. <br /> Ahora puedes depurar fácilmente tus funciones non-HTTPS e Integration. <br /> Solo para funciones Python, asegúrate de desconectar el depurador haciendo clic en el botón que se muestra en la imagen a continuación. <br /> Si no desconectas tu depurador, no será posible realizar otras solicitudes de tunneling.