Bienvenido a la Documentación de Clarive¶
██████░██░ █████░ ██████░ ██░ ██░ ██░ ███████░ ██░░░░░░██░ ██░░░██░ ██░░░██░ ██░ ██░ ██░ ██░░░░░ ██░ ██░ ███████░ ███████░ ██░ ██░ ██░ █████░ ██░ ██░ ██░░░██░ ██░░░█░░ ██░ ██░ ██░ ██░░░░ ░██████░███████░██░ ██░ ██░ ██░ ██░ ████░ ███████░ ░░░░░░ ░░░░░░ ░░░ ░░░ ░░ ░░░ ░░ ░░░ ░░░░░░░ ®
Esta es la documentación del producto para la versión de Clarive 7.18
Adiciones y Cambios Recientes¶
Guía de Instalación¶
- Guía rápida de instalación
- Arquitectura y requerimientos
- Guía de Configuración de Nginx
- MongoDB
- Ficheros de configuración de Clarive
- Directorios de instalación
- Actualizando desde versiones anteriores
- Sesiones y Cookies
- Variables de Entorno
- SAML2
Primeros Pasos¶
- Login
- Búsquedas avanzadas
- Despliegue de tópicos
- Ejecutar Clarive en Docker
- Favoritos
- Monitor
- Notificaciones de Slack
- Preferencias de usuario
- Tabla de tópicos
- Tablas de Recursos
- Uso de tableros Kanban en Clarive
- Uso del botón Crear
Conceptos de Clarive¶
- Alcance
- Análisis de Calidad de Regla
- Análisis de Causa Raíz
- Análisis de rendimiento de la regla
- Clave API
- Dashboards
- Dispatcher
- Entornos
- Estados y transiciones
- Flujo de trabajo
- Grafo de Recursos
- Gráfico CI
- Gráfico ciclo de vida
- Gráfico linea de tiempo
- MID
- Operación
- Pase
- Proyecto
- Re-ejecución de un pase
- Recurso
- Regla
- REPL
- Roles
- Rollback
- Semáforos
- Servicio Web
- Stash
- Tabla de Configuración
- Tablero Kanban
- Test Sets de Reglas
- Tópico
- Variable
- Worker
- YAML
Guía de implementación¶
- Primeros Pasos
- Modelando Entornos
- Carga y descubrimiento de entornos
- Despliegue
- Pasos manuales en despliegues
- Escalamiento de la implementación
- Releases y despliegues concurrentes
- Rollback y gestión de errores
- Lanzando una release
- Gestión de Calendarios - ¿Cuando puedo ejecutar un pase?
- Automatización del pipeline de Releases
- Análisis para la preparación de una Release
- Gestión de artefactos
- Seguimiento de recursos y despliegues de elementos
- Despliegues y Releases multi-plataforma
- Entrega de aplicaciones móviles
- Usando las APIs de Clarive
- Automatización de entrega en Mainframe
Administración¶
- Claves API
- Notificaciones
- Diseñador de Reglas
- Calendarios
- Modal Novedades
- Monitorizar los pases
- Configuración del Demonio de Trabajos
- Configuracion del Daemon de Purga
- Tokens de Acceso Personal
- Reports
- Papelera
- Teclas de Atajo del Diseñador de Reglas
- Administración de estados
- Autentificación LDAP
- Categorías
- Demonios
- Dispatcher
- Etiquetas
- Gestor de Repositorios de Artefactos
- Grupos de usuarios
- Instantáneas
- Mensajes del sistema
- Notificaciones Slack
- Planificador
- Proveedores de Almacenamiento
- Roles
- Script de Migración de Assets
- System Statistics
- Usuarios
- Worker
- Semaphores
- Configuración del Agente SSH
- Docker
- Tipos MIME de artefactos
- Usuario de Push en Commits Git
Reglas¶
- Conceptos de Rules
- Crear Rules
- Rules Event
- Rules Pipeline
- Rules Webservice
- Rules Independent
- Rules Form
- Rules Workflow
- Rules Dashboard
- Rules Report
- Rules Blueprint
- Paleta de Rules
- Escribir Rules de Autenticación Personalizadas
- Menú de reglas
Paleta¶
Control¶
- APPLY naturaleza
- APPLY proyecto
- CALL regla
- CATCH declaración
- CODE
- DELETE clave hash
- DELETE última acción capturada
- DO
- DO-WHILE condition
- ELSE
- ELSIF condición THEN
- EVAL
- EVAL JavaScript
- FAIL
- FOR eval
- FOR proyecto con cambios DO
- FOREACH CI
- FOREACH fichero/elemento
- IF ANY bl THEN
- IF ANY naturaleza THEN
- IF condición THEN
- IF EXISTS naturaleza THEN
- IF ROLLBACK
- IF var condition THEN
- IF variable en LIST THEN
- IF variable no es igual a valor THEN
- IF variable THEN
- IF última acción capturada THEN
- JOB STEP
- LOG Mensaje
- MERGE valor INTO stash
- PUSH VAR
- RETRY
- Servidor CODE
- SET EXPR
- SET VAR
- SET VAR a CI
- STASH LOCAL
- TRY declaración
- WAIT por hijo
- WHILE condition
Servicios de job¶
- Añadir elementos de job al stash
- Añadir una revisión git a tópicos de tipo Cambio
- Borrar tópico
- Cambiar estado de tópico
- Cargar elementos de Naturaleza
- Cargar elementos de pase al stash
- Cargar ficheros/elementos al stash
- Checkout a una revisión de git
- Checkout Job Items
- Crear nuevo tópico
- Ejecutar un script local
- Ejecutar un script remoto
- Eliminar directorio local
- Eliminar fichero local
- Enviar un fichero remotamente
- Escribir un fichero en local
- Escribir un fichero en remote
- Evaluación remota
- Hacer checkout del entorno del pase
- Hacer checkout del entorno del pase ... todos los repos
- Inicializar directorio home
- Invocar métodos de CIs
- Mostrar elementos
- Obtener fichero remoto
- Pausar por un número de segundos
- Pausar un job
- Petición web
- Reemplazar cadenas de texto
- Relacionar una revisión de Git con los cambios en el título
- Renombrar elementos y ficheros del entorno
- Rollback de todas las transacciones
- Servicios de Windows
- Sincronizar un directorio remoto
- Solicitar aprobación
Servicios genéricos¶
- Borrar ficheros adjuntos
- Cargar Tópicos Relacionados
- Cargar Usuario
- Crear CI
- Crear etiquetas de sistema
- Crear un Pase de una Revisión de Git
- Crear una etiqueta en un repositorio Git
- Crear una rama en un repositorio Git
- Eliminar una referencia en un repositorio Git
- Enviar una notificación
- Gestionar Roles de Grupos de Usuarios
- Gestionar Roles de Usuarios
- Mergear una rama en un repositorio Git
- Obtener Fecha
- Obtener los tópicos que coincidan con los criterios de búsqueda
- Publicar ficheros en el repositorio de artefactos
- Rebase una rama en un repositorio Git
- Tomar instantánea del sistema
- Zip ruta local
- Configuración de SLA
- Asignar configuración de SLA a tópicos
Dashlets¶
- Lista de tópicos
- Cadena de Proyecto
- Calendario
- Gráfico circular de tópicos
- Gráfico de Jobs
- Gráfico de un CI
- HTML
- Infrastructure Pipeline
- Lista de entornos
- Lista de jobs
- Línea de tendencia de tópicos
- Línea temporal de jobs
- Marco de Internet
- Medidor de tópicos
- Mensajes e-mail
- Roadmap de tópicos
- Swarm
- Timeline de tópicos
- Timeline de tópicos
- Timeline NG de tópicos
- Últimos trabajos por aplicación
Campos¶
- Adjuntar ficheros
- Barra de progreso
- Botones
- Cambios de estado
- Campo de fecha
- Campo de texto
- Campo de tiempo
- Campo numérico
- Casilla de verificación
- Cuadro de revisiones
- Cálculo númerico
- Descargar todos los ficheros
- Descripción
- Desplegable
- Desplegable de CIs
- Desplegable de Entornos
- Desplegable de proyectos
- Desplegable de releases
- Desplegable de usuarios
- Editor de grids
- Editor HTML
- Editor Markdown
- Estado
- Grid de CIs
- Grid de tópicos
- Gráfico de estado de tópicos
- Hitos
- Incluir en
- Lista de CIs
- Milestones
- Nemónico
- Planificador
- Selector de tópicos
- Separador de campos
- Título
Flujo de Trabajo¶
- Cambiar Estado del Tópico
- Cambiar Estado del Tópico Si Coincide
- IF Estado Origen ES
- IF Projecto ES
- IF Rol ES
Paleta de Reglas¶
control¶
- APPLY NATURE
- APPLY PROJECT
- CALL rule
- CATCH statement
- CODE
- DELETE hashkey
- DELETE last trap action
- DO
- DO-WHILE condition
- ELSE
- ELSIF condition THEN
- EVAL
- EVAL JavaScript
- FAIL
- FOR eval
- FOR projects with changes DO
- FOREACH CI
- FOREACH file/item
- IF ANY bl THEN
- IF ANY nature THEN
- IF condition THEN
- IF EXISTS nature THEN
- IF last trap action THEN
- IF ROLLBACK
- IF var condition THEN
- IF var in LIST THEN
- IF var ne value THEN
- IF var THEN
- JOB STEP
- LOG Message
- MERGE value INTO stash
- PUSH VAR
- RETRY
- Server CODE
- SET EXPR
- SET VAR
- SET VAR to CI
- STASH LOCAL
- TRY statement
- WAIT for children
- WHILE condition
dashlets¶
- Burndown de período de topics
- Burndown de topic
- Burndown de topics NG
- Calendario
- Distribución diaria de trabajos
- Gráfico de Recursos
- Gráfico de trabajos
- Gráficos de topics
- HTML
- Indicador de topics
- Listar entornos
- Listar topics
- Listar trabajos
- Línea de tiempo de topics
- Marco de Internet
- Mensajes de email
- Pipeline de Infraestructura
- Pipeline de Proyecto
- Roadmap de topic
- Swarm
- Últimos trabajos por app
fieldlets¶
- Adjuntar archivos
- Barra de progreso
- Cambios de estado
- Campo de fecha
- Campo de hora
- Campo de texto
- Campo numérico
- Campo numérico calculado
- Checkbox
- Combo
- Combo de entornos
- Combo de proyectos
- Combo de recursos
- Combo de releases
- Combo de usuarios
- Cuadro de revisión
- Cuadrícula de recursos
- Cuadrícula de topics
- Descargar todos los archivos
- Descripción
- Editor de cuadrícula
- Editor HTML
- Editor pagedown
- Estado
- Gráfico circular de estados
- Hitos
- Incluir en
- Lista de recursos
- Moniker
- Pills
- Planificador
- Planificador de entornos
- Selector de topics
- Separador
- Título
- Valoración con estrellas
job¶
- Cambiar Estado del Topic
- Checkout a git revision
- Checkout Job Environment
- Checkout Job Environment (all repos)
- Checkout Job Items
- Create a new topic
- Delete Local Directory
- Delete Local File
- Eval Remote
- Fill job elements
- Footprint elements
- Git Timesync
- Init Job Home
- Invoke Resource methods
- Link a git revision to the changesets in title
- Link a git revision to the changesets in title
- Load files/items into stash
- Load Job Items into Stash
- Load Nature Items
- Pause a Job
- Rename Environment Items and Files
- Replace Strings
- Request Approval
- Retrieve a remote file
- Rollback All Transactions
- Run a Remote Script
- Run command or local script
- Ship File Remotely
- Sleep for a number of seconds
- Sync a Remote Directory
- Topic Delete
- Web Request
- Windows service
- Write local file
- Write remote file
- List Windows Services
services¶
- Cargar Topic Relacionado
- Cargar Usuario
- Comprimir ruta local
- Crear CI
- Crear tags del sistema
- Crear trabajo de revisión Git
- Crear un tag en un repositorio Git
- Crear una rama en un repositorio Git
- Eliminar Archivos Adjuntos
- Eliminar una referencia en un repositorio Git
- Enviar una notificación
- Fusionar una rama en un repositorio Git
- Gestionar Roles de Grupos de Usuarios
- Gestionar Roles de Usuarios
- Guardar mis estadísticas
- Obtener Fecha
- Obtener topics que cumplen condiciones
- Publicar archivo local en log
- Publicar archivos en el repositorio de artefactos
- Rebasar una rama en un repositorio Git
- Respuesta de Webservice
- Tomar Snapshot del Sistema
- Configuración SLA
- Asignar configuración SLA a topics
workflow¶
Rulebook¶
- Introducción a los Rulebooks
- Variables y Plantillas
- Variables Almacenadas
- Control de Flujo del Rulebook
- Definir Ops Personalizados
- Crear y Actualizar Topics
- Docker
- Ejecutar Comandos Shell
- Envío y recuperación de archivos
- Datos de Contexto
- Escribir YAML Sensato
- Manejo de Errores
- Reglas de Pipeline
- Reglas de Eventos
- Campos de Formulario Personalizados
- Reglas Webhook
- Escribir módulos de importación
- Escribir módulos de importación con Python
- Escribir módulos de importación con Ruby
- Escribir módulos de importación con NodeJS
- Publicar archivos en artifacts
- El Recetario de Reglas
- API de Rulebook
Como hacer¶
- Configurar demonio Pubsub
- Configurar Máscara de Pase
- Crear Análisis de causa raíz
- Crear Calendario
- Crear Informe
- Crear Plantilla de Proyecto
- Editar Calendario
- Filtros en fieldlets
- Grid Personalizado para Recursos
- Hacer público un informe estático
- Historial de commits por rama
- Personalizar la Interfaz de Usuario
- Publicar archivos en artefactos
Interfaz de Línea de Comandos de Clarive¶
- Referencia de Comandos Clarive
- Opciones comunes en la linea de comandos
- Utilizando la línea de comandos
- cla config - Herramienta de configuración
- cla critic - Análisis de calidad en reglas
- cla db - Utilidades de la base de datos
- cla db-dump - Utilidad de respaldo de base de datos
- cla disp - Gestión del Dispatcher
- cla disp-start - Iniciar el servidor Dispatcher
- cla docs - Generador de la ayuda y documentación
- cla help - Ayuda de los comandos
- cla i18n - Ejecuta generador de traducciones
- cla lic - Verificación de la licencia
- cla migra - Migraciones
- cla nginx - Control del servidor Nginx
- cla passwd - Encriptación contraseñas
- cla patch - parches para aplicar/rollback
- cla plugin - ayuda para plugins
- cla poll - Monitorización
- cla profile - Perfil Clarive
- cla prove - Ejecuta los tests internos
- cla proxy - Cliente proxy
- cla ps - Monitor de procesos
- cla pubsub - Administración de demonio Pubsub
- cla queue - Herramientas para la gestión de colas
- cla start - Inicia todos los procesos del servidor
- cla stop - Detiene todos los procesos
- cla trans - Herramienta de conversión
- cla version - Versión de Clarive
- cla web - Administración de servidores Web
- cla web-start - Iniciar el servidor web
- cla ws - Invocar servicios web
Desarrollo¶
- Introducción
- REPL
- Requiriendo módulos
- Parsing de Variables
- Extendiendo cla con comandos
- Extendiendo el sistema JS a través de módulos
- Un rápido vistazo a JavaScript
- Clarive JavaScript DSL
- Transpiladores, Babel y TypeScript
- API de Topic Grid
- Guía Rápida de Perl a JavaScript/ES6/TypeScript
The JS API¶
- Cla.ui - Configuración de formularios
- cla/base64 - Codificador base64
- cla/ci - Clases CI
- cla/config - Usar variables de configuración
- cla/db - MongoDB namespace
- cla/digest - Codificador de strings
- cla/fs - Acceso al sistema de ficheros locales
- cla/log - Clases de log
- cla/lwp - LWP User Agent
- cla/path - Manipulación de rutas
- cla/process - Información del proceso
- cla/reg - Manipulación del registro
- cla/rule - Ejecución de reglas
- cla/sem - Control de semáforos
- cla/t - Testing
- cla/util - Utilidades generales
- cla/web - Herramientas Web
- cla/ws - Webservice namespace
- cla/xml - Gestión de archivos xml locales
- cla/zip - Gestión de archivos zip locales
- stash - Almacenamiento del Stash
Plugins¶
Plugins, Features y Extensiones¶
Notas de Versión¶
- 7.0
- 7.0.1
- 7.0.2
- 7.0.3
- 7.0.4
- 7.0.5
- 7.0.6
- 7.0.7
- 7.0.8
- 7.0.9
- 7.0.10
- 7.0.11
- 7.0.12
- 7.0.13
- 7.0.14
- 7.2.0
- 7.2.2
- 7.2.4
- 7.2.5
- 7.2.6
- 7.2.7
- 7.2.8
- 7.2.9
- 7.2.10
- 7.2.11
- 7.4.0
- 7.4.1
- 7.4.2
- 7.4.3
- 7.4.4
- 7.4.5
- 7.4.6
- 7.4.7
- 7.4.7.1
- 7.4.7.2
- 7.4.7.3
- 7.4.7.4
- 7.4.7.5
- 7.4.7.6
- 7.4.7.7
- 7.6
- 7.6.0.1
- 7.6.0.2
- 7.6.0.3
- 7.6.0.4
- 7.6.0.5
- 7.6.0.6
- 7.6.1
- 7.6.1.1
- 7.6.1.2
- 7.6.1.3
- 7.6.2
- 7.6.2.1
- 7.6.2.2
- 7.6.3
- 7.6.3.1
- 7.6.3.2
- 7.6.3.3
- 7.6.3.4
- 7.6.3.5
- 7.6.3.6
- 7.6.3.7
- 7.6.3.8
- 7.6.3.9
- 7.6.3.10
- 7.6.3.11
- 7.6.3.12
- 7.6.4
- 7.6.4.2
- 7.6.4.3
- 7.6.4.4
- 7.6.4.5
- 7.6.4.6
- 7.6.5
- 7.6.5.1
- 7.6.5.2
- 7.6.5.3
- 7.6.5.4
- 7.6.5.5
- 7.6.5.6
- 7.6.5.7
- 7.6.5.8
- 7.6.5.9
- 7.6.5.10
- 7.6.6
- 7.6.6.1
- 7.6.6.2
- 7.6.6.3
- 7.8
- 7.8.1
- 7.8.2
- 7.8.2.1
- 7.8.2.2
- 7.8.2.3
- 7.8.2.4
- 7.8.2.5
- 7.8.2.6
- 7.8.2.7
- 7.8.2.8
- 7.8.2.9
- 7.8.2.10
- 7.8.3
- 7.8.4
- 7.8.4.1
- 7.8.4.2
- 7.8.4.3
- 7.8.4.4
- 7.8.4.5
- 7.8.6
- 7.8.6.1
- 7.8.6.2
- 7.8.6.3
- 7.8.6.4
- 7.8.6.5
- 7.8.6.6
- 7.8.8.0
- 7.8.8.1
- 7.8.8.2
- 7.8.9
- 7.8.9.1
- 7.8.9.2
- 7.8.9.3
- 7.10
- 7.10.1
- 7.10.2
- 7.10.3
- 7.10.4
- 7.10.5
- 7.10.6
- 7.10.7
- 7.10.8
- 7.10.9
- 7.10.10
- 7.12.0
- 7.12.1
- 7.12.2
- 7.12.3
- 7.12.4
- 7.12.5
- 7.12.6
- 7.12.7
- 7.12.8
- 7.12.9
- 7.12.10
- 7.12.11
- 7.12.12
- 7.12.13
- 7.14
- 7.14.1
- 7.14.2
- 7.14.3
- 7.14.4
- 7.14.5
- 7.14.6
- 7.14.7
- 7.14.8
- 7.14.9
- 7.14.9.1
- 7.14.10
- 7.14.11
- 7.14.12
- 7.16
- 7.16.1
- 7.16.2
- 7.16.2.1
- 7.16.3
- 7.18