Interfaz de Línea de Comandos de Jitterbit para recetas de Citizen Integrator para Jitterbit Design Studio
Introducción
La Interfaz de Línea de Comandos de Jitterbit (jbcli
) es una herramienta de línea de comandos para interactuar con las recetas de Citizen Integrator. Una vez
iniciado sesión en Harmony a través de jbcli
, se puede gestionar su propio repositorio de recetas descargando,
validando, subiendo, actualizando, generando, desplegando o eliminando metadatos de recetas y Jitterpaks de Design Studio.
Nota
Las recetas de Citizen Integrator se crean a partir de Design Studio proyectos. Para Integration Studio, en su lugar use recetas de integración o plantillas de procesos, disponibles a través de Jitterbit Marketplace.
Las secciones de esta página describen cómo instalar y usar el jbcli
.
Consejo
Muchas opciones administrativas proporcionadas a través de jbcli
ahora también están disponibles desde la interfaz web de Citizen Integrator. Consulte
Citizen Integrator - Mis recetas para
más detalles.
Instalar la Interfaz de Línea de Comandos de Jitterbit
Descargue e instale el entorno de ejecución de JavaScript Node.js v6.x o superior desde https://nodejs.org/en/download/.
-
Ingrese este comando en un símbolo del sistema para instalar
jbcli
utilizando el Administrador de Paquetes de Node.js (NPM):$ npm install -g jbcli
-
Use este comando para verificar que
jbcli
se haya instalado y esté funcionando correctamente:$ jbcli version 1.4.1
Usar comandos de jbcli
Para usar jbcli
, ejecute sus comandos desde un símbolo del sistema. Este es el formato general del comando, con texto entre ángulos
reemplazado por valores, y texto dentro de corchetes cuadrados siendo opcional, y el símbolo del sistema representado
por $
:
$ jbcli <entity> <action> [options]
Comprobar versión
Verifica qué versión de jbcli
estás ejecutando. Se devolverá el número de versión, siendo la versión actual de jbcli
1.4.1
.
$ jbcli version
<version>
Iniciar sesión
Inicia sesión en jbcli
con tus credenciales de Harmony. La opción host
requerida depende de la región (una de NA, EMEA o APAC) con la que esté asociada tu organización (ver Encontrar mi región). Un mensaje confirmará la autenticación exitosa.
Utiliza la opción --password <myHarmonyPassword>
para pasar tu contraseña en la línea de comandos:
$ jbcli login --email <username> --password <password> --host <host>
Usuario <username> autenticado exitosamente en <host>.
NA
$ jbcli login --email <username> --host https://citizen.jitterbit.net
Contraseña:
Usuario <username> autenticado exitosamente en https://citizen.jitterbit.net.
EMEA
$ jbcli login --email <username> --host https://citizen.jitterbit.eu
Contraseña:
Usuario <username> autenticado exitosamente en https://citizen.jitterbit.eu.
APAC
$ jbcli login --email <username> --host https://citizen.jitterbit.cc
Contraseña:
Usuario <username> autenticado exitosamente en https://citizen.jitterbit.cc.
Cerrar sesión
Cierra sesión de jbcli
. Un mensaje confirmará el cierre de sesión exitoso.
$ jbcli logout
Usuario <myHarmonyUsername> cerrado sesión.
Listar organizaciones de usuario
Lista las organizaciones de las que eres miembro. Se devolverán los IDs y nombres de las organizaciones disponibles para ti.
$ jbcli org list
[orgId1] orgName1
[orgId2] orgName2
...
Listar entornos de usuario
Lista los Entornos en la organización actual. Se devolverán los IDs y nombres de los entornos disponibles para ti.
$ jbcli env list
[envId1] envName1
[envId2] envName2
...
Obtener propiedades
Obtiene el valor asignado a una clave específica. Se devolverán la clave y su valor.
$ jbcli config get <key>
<key>: <assignment>
Este comando se puede utilizar para ver qué organización o entorno es el predeterminado.
-
Utiliza la clave
defaultOrgId
para ver qué organización es la predeterminada. Se devolverá el ID de la organización predeterminada.$ jbcli config get defaultOrgId defaultOrgId: orgId
-
Utiliza la clave
defaultEnvId
para ver qué entorno es el predeterminado. Se devolverá el ID del entorno predeterminado.$ jbcli config get defaultEnvId defaultEnvId: envId
Consejo
Para ver el nombre de la organización o entorno asociado a un ID, utiliza ya sea List user organizations o List user environments.
Set properties
Establece claves y valores. Se devolverán las claves y sus valores.
jbcli config set <key1>=<assignment1> <key2>=<assignment2> ...
<key1>=<assignment1> set
<key2>=<assignment2> set
...
Por ejemplo, este comando se puede utilizar para anular la organización o el entorno predeterminado. Ten en cuenta que las claves defaultOrgId
y defaultEnvId
son de solo lectura y no se pueden cambiar, ya que están definidas por la cuenta de Jitterbit de un usuario. Sin embargo, puedes establecer la organización o el entorno utilizados por los comandos jcli
y anular el defaultOrgId
y defaultEnvId
utilizados al interactuar con las recetas de Citizen Integrator a través del jbcli
.
-
Para establecer una organización, utiliza la clave
orgId
con el ID de la organización deseada obtenido de List user organizations. Se devolverá el ID de la organización establecida.$ jbcli config set orgId=<orgId> orgId:<orgId> set
-
Para establecer un entorno, utiliza la clave
envId
con el ID del entorno deseado obtenido de List user environments. Se devolverá el ID del entorno establecido.$ jbcli config set envId=<envId> envId:<envId> set
Si la organización y/o el entorno no se establecen a través de este comando, el orgId
y/o envId
se establecerán en el defaultOrgId
y defaultEnvId
.
List all recipes
Lista todas las recetas de Citizen Integrator que están disponibles para que las uses. Opcionalmente, puedes limitar la lista solo a aquellas recetas privadas de tu organización (mostradas entre corchetes). Se devolverán el ID, el nombre y el autor de cada receta.
Una receta consta de dos partes: un Jitterpak de Design Studio (JPK) y un archivo de metadatos JSON que proporciona los pasos que un usuario deberá seguir para configurar la receta utilizando Citizen Integrator. (Ver Citizen Integrator - Configurar receta.)
$ jbcli recipe list [--private]
[id1] name1 by author1 (organization1)
* [id2] name2 by author2 (organization2)
...
En la lista de recetas que se devuelve, las recetas que son públicas y están disponibles para todos los usuarios estarán precedidas por un asterisco (*). Las recetas que son privadas y están disponibles solo para aquellos dentro de su organización no tendrán un asterisco.
Obtener una receta específica y guardar el Jitterpak localmente
Devuelve los metadatos JSON para una receta específica de Citizen Integrator y (opcionalmente) guarda el Jitterpak adjunto en una ubicación especificada.
$ jbcli recipe get <id> [--savejpk <location>]
-- recipe JSON --
Jitterpak guardado en <location>.
Puedes guardar el Jitterpak adjunto de una receta localmente si deseas hacer referencia o usar un Jitterpak de una receta existente. Si ya has comenzado una receta y un Jitterpak, pero decides que deseas realizar una personalización avanzada dentro de Design Studio, utiliza esto para descargar el Jitterpak.
Para guardar los metadatos de la receta localmente, puedes copiarlos desde el símbolo del sistema y guardarlos como un archivo JSON. Si estás creando una nueva receta y deseas comenzar con una receta similar como ejemplo, puedes usar este comando para guardar los metadatos JSON de una receta.
Consejo
Los IDs de las recetas se pueden encontrar utilizando el comando Listar todas las recetas.
Validar una receta
Valida los metadatos JSON para una receta local de Citizen Integrator. Debes usar este comando antes de subir una receta para asegurarte de que sea válida.
jbcli recipe validate --recipe <recipeLocation>
La receta es válida.
Subir una nueva receta y Jitterpak
Sube una nueva receta de Citizen Integrator.
Puedes optar por subir un nuevo Jitterpak y, opcionalmente, los metadatos JSON (usando la opción --recipe
). Para que una receta específica funcione, necesitas tener tanto el Jitterpak como los metadatos JSON subidos, pero no es necesario que se suban al mismo tiempo. Por defecto, una receta subida es privada para tu organización.
jbcli recipe upload --jpk <jpkLocation> [--recipe <recipeLocation>]
Receta subida, asignada ID <id>, y se puede encontrar en <location>
Actualizar una receta existente y Jitterpak
Actualiza una receta existente de Citizen Integrator.
jbcli recipe update <id> --jpk <jpkLocation> [--recipe <recipeLocation>]
Receta con ID <id> actualizada.
Se puede optar por actualizar un Jitterpak existente y, opcionalmente, los metadatos JSON (usando la opción --recipe
). Para que una receta específica funcione, es necesario tener tanto el Jitterpak como los metadatos JSON subidos, pero no es necesario que se suban al mismo tiempo. Por defecto, una receta subida es privada para tu organización.
Las recetas proporcionadas por Jitterbit y disponibles para el público no pueden ser actualizadas o editadas excepto por Jitterbit. Si deseas editar una receta pública existente, recupera el JSON y Jitterpak, edita los archivos localmente, y vuelve a subirlos como tu propia nueva receta usando el comando Subir una nueva receta y Jitterpak.
Consejo
Se pueden encontrar IDs de Recetas específicas usando el comando Listar todas las recetas.
Eliminar una receta existente y Jitterpak
Elimina una receta existente de Citizen Integrator que aún no ha sido desplegada. Para eliminar múltiples recetas, agrega IDs de Receta adicionales separados por espacios. Tanto el Jitterpak como los metadatos JSON serán eliminados.
jbcli recipe delete <id> [<id> ...]
Receta con ID <id> [<id> ...] eliminada.
Las recetas proporcionadas por Jitterbit y disponibles para el público solo pueden ser eliminadas por Jitterbit. Solo se pueden eliminar aquellas recetas que has creado. Si eres el administrador de una organización, puedes eliminar cualquier receta que pertenezca a tu organización.
Consejo
Se pueden encontrar IDs de Recetas específicas usando el comando Listar todas las recetas.
Generar una receta y/o un archivo de configuración
Usado con un Jitterpak proporcionado para generar un esqueleto de receta de Citizen Integrator que se puede usar como plantilla de receta.
jbcli recipe generate --jpk <location> [--recipeonly | --cfgonly]
[Recipe saved to <location>.]
[Configure file saved to <location>.]
El comando resulta en la creación de dos archivos: <project-name>-recipe.json
y <project-name>-configure.json
. Para
generar solo uno de estos archivos, agrega la opción apropiada (--recipeonly
o --cfgonly
).
El archivo de receta es una plantilla de una receta que puedes abrir en un editor de texto para completar campos como la descripción.
El archivo de configuración es una plantilla del archivo que el comando Deploy a recipe espera, que contiene los valores reales de los campos que normalmente se exponen dentro de la interfaz web de Citizen Integrator. Se espera que completes el archivo de configuración con valores y luego uses el comando Deploy a recipe para desplegar la receta.
Deploy a recipe
Despliega una receta de Citizen Integrator. Debes proporcionar un archivo de receta y un archivo de configuración (ver Generate a recipe and/or a configure file). Se devolverá el ID de la receta desplegada.
Al desplegar una receta, se ejecutará cada paso de acción de la receta, similar al proceso de despliegue desde la interfaz web de Citizen Integrator.
jbcli recipe deploy <ID> --cfg <location>
Recipe deployed, ID <id>.
Consejo
El archivo de configuración se puede generar como se describe en Generate a recipe and/or a configure file. El ID específico de la receta se puede encontrar utilizando el comando List all recipes mencionado anteriormente.
List deployed recipes
Lista las recetas de Citizen Integrator desplegadas. Puedes mostrar todas las recetas desplegadas o (opcionalmente) limitar la lista a un entorno específico pasando el ID del entorno. Se devolverán el ID, el nombre y el autor de cada receta desplegada.
jbcli deployed-recipe list [--environment <envID>]
[id1] name1 by author1
[id2] name2 by author2
...
Listar Entornos de Usuario
Consejo
Para ver los IDs de los entornos disponibles, utiliza Listar entornos de usuario.
Desimplementar y eliminar una receta desplegada
Desimplemente y elimina una receta de Citizen Integrator desplegada. Para desimplementar y eliminar múltiples recetas, agrega IDs de receta adicionales separados por espacios. Tanto el Jitterpak como los metadatos JSON serán eliminados.
jbcli deployed-recipe delete <id> [<id>...]
Receta desplegada con ID <id> [<id>...] eliminada.
Las recetas proporcionadas por Jitterbit y disponibles para el público solo pueden ser eliminadas por Jitterbit. Solo puedes eliminar aquellas recetas que has creado. Si eres el administrador de una organización, puedes eliminar cualquier receta que pertenezca a tu organización.
Consejo
Los IDs de receta específicos se pueden encontrar utilizando el comando Listar todas las recetas.