- Alcance técnico y arquitectura
- Instalación — requisitos previos, instalación manual y guiada
- Configuración — puerta de enlace, autenticación, back-end, configuración del sistema en la aplicación
- Uso — administración, entornos, instantáneas, diferencias, despliegues, historias de usuario
- Actualización y migración
- Notas de la versión
- Preguntas frecuentes
Vídeo (en inglés, 1:45): la instalación guiada con install3c.bat en nueve pasos, desde los requisitos previos hasta el primer inicio de sesión.
Arquitectura y alcance técnico
El 3C Release Manager es una aplicación web de 3 niveles desplegada en una pila tecnológica basada en Java con integraciones externas seguras con Automic. Comprender la arquitectura ayuda con el dimensionamiento, la solución de problemas y la planificación de la integración.
Resumen de la arquitectura
Capa de acceso de usuario
- Los usuarios finales acceden al sistema a través de HTTPS.
- El tráfico está cifrado de extremo a extremo usando TLS.
- Las solicitudes se dirigen al front end web alojado dentro del entorno del 3C Release Manager.
Capa de aplicación
La aplicación principal se despliega en un servidor de aplicaciones Tomcat y consta de dos componentes principales:
Front End
- Implementado utilizando Angular.
- Servido por Tomcat como parte de la aplicación 3C Release Manager.
- Responsable de la representación de la interfaz de usuario, la lógica del lado del cliente y la comunicación con el backend a través de API REST.
Back End
- Implementado con Spring (Spring Boot / Spring Framework).
- Expone una API RESTful consumida por el frontend Angular y sistemas externos (Automic).
- Maneja la lógica de negocio, la autenticación/autorización y el acceso a la base de datos.
- La comunicación entre el front end y el back end se realiza a través de REST.
Capa de datos
- Utiliza PostgreSQL como base de datos relacional.
- El backend se conecta a la base de datos utilizando JDBC.
- La base de datos almacena todos los datos persistentes de la aplicación 3C Release Manager.
Integración de sistemas
- El sistema se integra con Automic.
- Se admiten varias instancias de Automic (sistema / clientes).
- La comunicación utiliza una API de Java.
- La seguridad del transporte se aplica mediante TLS.
- Las conexiones se inician desde el backend del 3C Release Manager hacia los clientes de Automic.
Seguridad y comunicación: resumen general
HTTPS/TLS se utiliza para todas las comunicaciones externas: Usuario → Front End y Backend → Automic. La comunicación interna utiliza REST entre frontend y backend, y JDBC entre backend y base de datos.
Resumen de la arquitectura lógica
- Nivel de presentación: Front end de Angular
- Nivel de aplicación: Backend basado en Spring en Tomcat
- Nivel de datos: Base de datos PostgreSQL
- Nivel de integración: Integración segura de API Java con Automic
Requisitos y compatibilidad
Los requisitos técnicos mínimos para desplegar y operar la aplicación 3C Release Manager.
Sistema operativo
El 3C Release Manager es independiente de la plataforma y se puede implementar en:
- Microsoft Windows (64 bits)
- Linux (64 bits): cualquier distribución moderna con soporte del fabricante (por ejemplo, RHEL, Rocky Linux, Ubuntu LTS)
El sistema operativo debe admitir: Java 21, PostgreSQL 15, Apache Tomcat 10 y comunicación de red protegida por TLS.
Entorno de ejecución de Java (JRE)
- Versión mínima: Java 21
- Edición: Open Edition (OpenJDK)
El JRE es necesario para ejecutar el servidor de aplicaciones Apache Tomcat, ejecutar la aplicación backend del 3C Release Manager (basada en Spring) y dar soporte a la comunicación segura TLS con sistemas externos (Automic).
Servidor de aplicaciones
- Versión mínima: Apache Tomcat 10
Se necesita Tomcat para alojar la aplicación del 3C Release Manager, servir el front end basado en Angular, ejecutar los componentes de backend en Java y proporcionar puntos finales REST para la comunicación interna y externa. Tomcat debe configurarse con compatibilidad con Java 21, HTTPS/TLS habilitado y los ajustes adecuados de memoria y subprocesos para su uso en producción.
Base de datos
- Versión mínima: PostgreSQL 15
PostgreSQL se utiliza como almacén de datos persistente de 3C. Requisitos: conectividad JDBC desde el backend del 3C Release Manager, almacenamiento y rendimiento suficientes para los datos de la aplicación, configuración de acceso segura (autenticación, restricciones de red).
Integración de sistemas externos (Automic)
- Versión mínima: Automic Automation Engine V21
Automic está integrado con 3C a través de la API de Java y la comunicación segura TLS. Requisitos: una o más instancias de Automic (V21 o superior), uno o más clientes de Automic configurados por instancia, conectividad de red entre el backend de 3C y las instancias de Automic, certificados compatibles para la comunicación TLS.
Red y seguridad
HTTPS/TLS debe estar habilitado para el acceso de los usuarios al front end del 3C Release Manager y para la comunicación del backend con Automic.
Puertos abiertos requeridos:
- Puerto HTTPS de Tomcat (normalmente 443 o personalizado)
- Puerto de PostgreSQL (por defecto 5432)
- Puertos de comunicación de Automic definidos en la instalación de Automic
Instalación
El 3C Release Manager se ofrece en dos variantes de instalación: manual (control total, adecuada para entornos aislados o con seguridad reforzada) y guiada (script de instalación interactivo install3c.bat, más rápida para configuraciones estándar). Ambas producen el mismo resultado.
¿Prefiere verlo primero? La instalación guiada también está disponible en un vídeo de menos de dos minutos.
Comprobaciones previas a la instalación
Antes de proceder con la instalación del 3C Release Manager, asegúrese de que todos los requisitos previos necesarios estén instalados, accesibles y en pleno funcionamiento.
Disponibilidad de PostgreSQL
- PostgreSQL está instalado en el servidor de base de datos designado.
- El psql está disponible como cliente de línea de comandos y es ejecutable.
- Se puede establecer una conexión al servidor PostgreSQL utilizando psql.
- El servicio de PostgreSQL se está ejecutando y escuchando en el puerto configurado (por defecto: 5432).
- Verificación desde la línea de comandos: psql –version
Disponibilidad de Java Runtime / Development Kit
- Está instalada la versión 17 de JRE o JDK (Open Edition).
- El java está disponible como comando en el PATH del sistema.
- Java se ejecuta correctamente e indica la versión correcta.
- El JAVA_HOME está configurado correctamente como variable de entorno (recomendado).
- Verificación desde la línea de comandos: java -version
Disponibilidad de Apache Tomcat
- Apache Tomcat versión 10 está instalado.
- Tomcat se está ejecutando sin errores.
- El servicio Tomcat es accesible a través de una URL HTTP desde un navegador o la línea de comandos.
- El puerto HTTP/HTTPS configurado está abierto y accesible.
- Verificación desde el navegador: http://<tomcat_host>:<port>
Instalación — manual
Realice los siguientes pasos para instalar el 3C Release Manager manualmente. Los ejemplos usan valores genéricos; asegúrese de reemplazarlos por los valores correctos para el entorno de destino.
- Descargue el paquete de instalación más reciente del 3C Release Manager desde la fuente oficial de distribución.
- Verifique la integridad del paquete según los estándares internos (por ejemplo, suma de comprobación, firma).
Crear un usuario de base de datos dedicado. Cree un usuario dedicado de PostgreSQL para el 3C Release Manager (ejemplo: db3cuser) con privilegios restringidos y las siguientes propiedades: NOSUPERUSER, INHERIT, NOCREATEDB, NOCREATEROLE, NOCREATEREPLICATION.
Crear base de datos dedicada. Cree la base de datos del 3C Release Manager con las siguientes propiedades: Codificación UTF8, Propietario db3cuser, Tablespace pg_default, Límite de conexiones -1 (ilimitado), Plantilla template0, Intercalación C, CTYPE C.
Despliegue los componentes de la aplicación del 3C Release Manager copiando los siguientes archivos WAR en <TOMCAT_HOME>/webapps/:
- threec.war
- threec-auth.war
- threec-backend.war
- threec-frontend.war
Tomcat desplegará automáticamente las aplicaciones durante el inicio.
Cree los directorios de configuración de la aplicación necesarios si aún no existen y, a continuación, copie los archivos de configuración de registro:
| Archivo fuente | Ubicación de destino |
|---|---|
| logback-threec.xml | <TOMCAT_HOME>/appconf/threec/logback.xml |
| logback-threec-auth.xml | <TOMCAT_HOME>/appconf/threec-auth/logback.xml |
| logback-threec-backend.xml | <TOMCAT_HOME>/appconf/threec-backend/logback.xml |
Puerta de enlace. Ajustar <TOMCAT_HOME>/appconf/threec/application-prod.properties
| Parámetro | Valor |
|---|---|
| logging.config | <TOMCAT_HOME>/appconf/threec/logback.xml |
| spring.cloud.gateway.mvc.routes[0].uri | http://<TOMCAT_HOST>:<PORT> |
| spring.cloud.gateway.mvc.routes[1].uri | http://<TOMCAT_HOST>:<PORT> |
| spring.cloud.gateway.mvc.routes[2].uri | http://<TOMCAT_HOST>:<PORT> |
| spring.cloud.gateway.mvc.routes[3].uri | http://<TOMCAT_HOST>:<PORT> |
| spring.cloud.gateway.mvc.routes[4].uri | http://<TOMCAT_HOST>:<PORT> |
Autenticación. Ajustar <TOMCAT_HOME>/appconf/threec-auth/application-prod.properties
| Parámetro | Valor |
|---|---|
| logging.config | <TOMCAT_HOME>/appconf/threec-auth/logback.xml |
| capture.authorization.gateway-uri | http://<TOMCAT_HOST>:<PORT> |
| spring.datasource.url | jdbc:postgresql://<PG_HOST>:<PORT>/<DBNAME> |
| spring.datasource.username | <DBUSER> |
| spring.datasource.password | <DBPASSWORD> |
Backend. Ajustar <TOMCAT_HOME>/appconf/threec-backend/application-prod.properties
| Parámetro | Valor |
|---|---|
| logging.config | <TOMCAT_HOME>/appconf/threec-backend/logback.xml |
| spring.datasource.url | jdbc:postgresql://<PG_HOST>:<PORT>/<DBNAME> |
| spring.datasource.username | <DBUSER> |
| spring.datasource.password | <DBPASSWORD> |
| spring.security.oauth2.resourceserver.jwt.jwk-set-uri | http://<TOMCAT_HOST>:<PORT>/threec-auth/oauth2/jwks |
Configure los archivos de contexto de Tomcat para que hagan referencia a las ubicaciones de configuración externas de Spring. Cree los siguientes archivos en <TOMCAT_HOME>/conf/Catalina/localhost/:
threec.xml
threec-auth.xml
threec-backend.xml
- Asegúrese de que los permisos de archivo permitan a Tomcat leer los archivos de configuración y de registro.
- Reinicie Apache Tomcat.
- Espere a que se inicialice la base de datos.
- Reinicie Apache Tomcat por segunda vez.
- Verifique que el despliegue se haya realizado correctamente mediante los registros de Tomcat y las URL de la aplicación.
Instalación — guiada
Realice los siguientes pasos para instalar el 3C Release Manager con el script de instalación específico. Los ejemplos usan valores genéricos; asegúrese de reemplazarlos por los valores correctos para el entorno de destino.
Introduzca los siguientes directorios, que deben estar disponibles:
- Directorio HOME de Tomcat (por ejemplo, c:/Automic/Tomcat-3C)
- Directorio HOME de Java (por ejemplo, c:/Program Files/Java/jdk-17)
- Directorio HOME de PostgreSQL (por ejemplo, c:/Program Files/PostgreSQL/17)
Introduzca la siguiente configuración de la base de datos:
- Nombre de la base de datos (por ejemplo, db3c)
- Nombre del servidor de base de datos (por ejemplo, localhost)
- Puerto del servidor de base de datos (por ejemplo, 5432)
- Nombre de usuario de la base de datos (por ejemplo, db3c)
- Contraseña de usuario de la base de datos (no la contraseña maestra de postgres)
- Asegúrese de que los permisos de archivo permitan a Tomcat leer los archivos de configuración y de registro.
- Reinicie Apache Tomcat.
- Verifique que el despliegue se haya realizado correctamente mediante los registros de Tomcat y las URL de la aplicación.
Verificación posterior a la instalación
Tras cualquiera de las dos variantes de instalación, confirme el despliegue comprobando en los registros de Tomcat si hay errores de inicio en alguna de las cuatro aplicaciones WAR, accediendo a la URL de la puerta de enlace (debería aparecer la pantalla de inicio de sesión de 3C) e iniciando sesión con el superusuario predeterminado (consulte Configuración → valores predeterminados) — cambie la contraseña inmediatamente.
Referencia de configuración
El 3C Release Manager se configura mediante tres archivos application-prod.properties (uno por módulo): 3C-Gateway, 3C-Auth, y 3C-Backend. Además de estos archivos de propiedades, un SUPERUSER puede ajustar varios parámetros de tiempo de ejecución del 3C Release Manager desde la pantalla Configuración del sistema de la aplicación. A continuación se incluye la referencia completa de parámetros.
3C-Gateway (threec)
El módulo de puerta de enlace enruta las solicitudes entrantes al servicio backend apropiado.
| Parámetro | Descripción |
|---|---|
| logging.config | Propiedad estándar de Spring Boot / Java para el registro. Especifica la ubicación exacta del archivo de configuración de registro. Ejemplo: file:/c:/Automic/Tomcat-3C/appconf/threec/logback.xml |
| spring.application.name | Establece el nombre lógico de la aplicación Spring. Predeterminado: 3c-gateway |
| spring.cloud.gateway.mvc.routes[N].id | Define un ID de ruta para Spring Cloud Gateway (basado en MVC). |
| spring.cloud.gateway.mvc.routes[N].uri | Especifica el servicio backend de destino para esta ruta. |
| spring.cloud.gateway.mvc.routes[N].predicates[0] | Define un predicado de ruta (una condición para hacer coincidir solicitudes). Ejemplo: Path=/oauth2/** |
| spring.cloud.gateway.mvc.routes[N].filters[0] | Aplica un filtro que modifica la ruta de la solicitud. Ejemplo: StripPrefix=1 |
| spring.cloud.gateway.mvc.routes[N].filters[1] | Agrega un nuevo prefijo a la ruta de la solicitud después de StripPrefix. Ejemplo: PrefixPath=/threec-auth |
3C-Auth (threec-auth)
El módulo de autenticación gestiona el inicio de sesión, la emisión de JWT y la administración de credenciales.
| Parámetro | Descripción |
|---|---|
| logging.config | Ruta al archivo de configuración de Logback. |
| spring.datasource.driverClassName | Clase del controlador JDBC utilizada para conectarse a PostgreSQL. Predeterminado: org.postgresql.Driver |
| spring.datasource.url | URL de conexión JDBC para la base de datos. Ejemplo: jdbc:postgresql://localhost:5432/db3c |
| spring.datasource.username | Nombre de usuario que utiliza la aplicación para autenticarse con PostgreSQL. |
| spring.datasource.password | Contraseña utilizada por la aplicación para autenticarse con PostgreSQL. |
| capture.authorization.gateway-context-path | Define la ruta de contexto en la que la puerta de enlace expone la aplicación. Predeterminado: /threec |
| capture.authorization.gateway-uri | URL base del servicio de puerta de enlace de autorización. |
| capture.authorization.rsa-key | Contiene la clave RSA (codificada en Base64) utilizada en los flujos de autorización. |
3C-Backend (threec-backend)
El módulo de backend es la lógica principal de la aplicación. Contiene el conjunto más grande de parámetros ajustables, agrupados a continuación por tema.
Registro
| Parámetro | Descripción |
|---|---|
| logging.config | Carga la configuración de Logback desde una ruta de archivo externa (niveles, appenders, ubicaciones/rotación de archivos de registro, formatos, etc.). |
Serialización JSON
| Parámetro | Descripción |
|---|---|
| spring.jackson.mapper.default-view-inclusion | Habilita la inclusión predeterminada de propiedades al usar Jackson @JsonView. Si es verdadero, las propiedades que no están explícitamente en una vista pueden incluirse igualmente (puede afectar a qué campos aparecen en las respuestas de la API). |
| spring.jackson.property-naming-strategy | Serializa/deserializa propiedades JSON en SNAKE_CASE (por ejemplo, created_at) en lugar de camelCase. |
| spring.data.web.pageable.one-indexed-parameters | Los parámetros de paginación tienen base 0 cuando se establecen en false (page=0 es la primera página). Si es true, page=1 sería la primera página. |
Base de datos y pool de conexiones
| Parámetro | Descripción |
|---|---|
| spring.datasource.driverClassName | Clase del controlador JDBC para PostgreSQL. |
| spring.datasource.url | URL de conexión JDBC. |
| spring.datasource.username | Usuario de base de datos utilizado por la aplicación. |
| spring.datasource.password | Contraseña de la base de datos utilizada por la aplicación. |
| spring.datasource.hikari.pool-name | Nombre del pool Hikari (aparece en logs/métricas). Predeterminado: db-pool |
| spring.datasource.hikari.maximum-pool-size | Número máximo de conexiones a la base de datos en el pool. Predeterminado: 30 |
| spring.datasource.hikari.minimum-idle | Número mínimo de conexiones inactivas que se mantienen disponibles. Predeterminado: 1 |
| spring.datasource.hikari.idle-timeout | Tiempo (ms) que una conexión inactiva puede permanecer antes de cerrarse (cuando se supera minimum-idle). Predeterminado: 30000 |
| spring.datasource.hikari.connection-timeout | Tiempo máximo (ms) de espera para obtener una conexión del pool antes de fallar. Predeterminado: 5000 |
| spring.datasource.hikari.max-lifetime | Duración máxima (ms) de una conexión antes de ser reemplazada. A menudo se establece por debajo de los límites de la base de datos/red para evitar conexiones no válidas. Predeterminado: 60000 |
| spring.jpa.database-platform | Indica a Hibernate qué dialecto SQL utilizar. Predeterminado: org.hibernate.dialect.PostgreSQLDialect |
| spring.jpa.open-in-view | Deshabilita “Open Session in View” cuando se establece en false (previene la carga diferida durante la representación de la respuesta web; generalmente mejor para el rendimiento y una arquitectura limpia). |
| spring.jpa.properties.hibernate.id.db_structure_naming_strategy | Estrategia de nombres para generadores de ID de Hibernate para estructuras de BD (afecta a los nombres de secuencias/tablas utilizadas para los ID). Predeterminado: single |
| spring.flyway.out-of-order | Permite aplicar migraciones “fuera de orden” (por ejemplo, si una versión anterior aparece después de que ya se haya aplicado una superior). Útil en algunos flujos de lanzamiento, pero puede ser arriesgado si no se controla. |
Seguridad y autenticación
| Parámetro | Descripción |
|---|---|
| spring.security.oauth2.resourceserver.jwt.jwk-set-uri | URL donde la aplicación obtiene el conjunto JWK (claves públicas) para verificar las firmas JWT. |
| capture.authorization.rsa-key | Material de clave RSA (a menudo un blob similar a JWK/JWKS) utilizado para firmar/verificar en flujos de autorización. |
| capture.encryption.secret.key | Secreto de cifrado de la aplicación (utilizado para cifrar datos sensibles / tokens / valores de configuración según la implementación). |
| capture.encryption.salt | Sal utilizada con hashing/derivación de claves (ayuda a proteger contra ataques de tabla arcoíris). |
| server.servlet.session.cookie.secure | Marca las cookies de sesión como Secure (enviadas solo a través de HTTPS). Si no utiliza HTTPS de extremo a extremo, es posible que las sesiones no se mantengan en los navegadores. |
Licencia y caché
| Parámetro | Descripción |
|---|---|
| capture.license.server.url | Punto final del servidor de licencias (vacío → no establecido, deshabilitado o proporcionado en otro lugar). |
| capture.system.cache-time-to-live | TTL para una caché interna en segundos. Predeterminado: 86400 (24 horas). |
XOG (comunicación con sistemas externos)
| Parámetro | Descripción |
|---|---|
| capture.xog.timeout-in-seconds | Tiempo de espera de las solicitudes para las llamadas XOG. Predeterminado: 300 |
| capture.xog.connection-timeout-in-seconds | Tiempo de espera de establecimiento de conexión para llamadas XOG. Predeterminado: 20 |
| capture.xog.http-buffersize-bytes | Tamaño del búfer HTTP en bytes. Predeterminado: 33554432 (≈ 32 MiB). Útil para cargas de datos grandes. |
| capture.xog.soap-cache-time-to-live | TTL para la caché relacionada con SOAP en segundos. Predeterminado: 60 |
Planificador y ejecución de tareas
| Parámetro | Descripción |
|---|---|
| capture.scheduler.enabled | Activa/desactiva el planificador de la aplicación. |
| capture.worker.settings.refresh.interval | Frecuencia con la que se actualiza la configuración de los agentes de trabajo (ms). Predeterminado: 30000 (30 segundos). |
| capture.task.execution.pool.core-size | Número de hilos de trabajo base (core). Predeterminado: 30 |
| capture.task.execution.pool.max-size | Número máximo de hilos permitidos bajo carga. Predeterminado: 60 |
| capture.task.execution.pool.queue-capacity | Tamaño de la cola para tareas pendientes antes de que entren en juego nuevos hilos/límites máximos. Predeterminado: 300 |
| capture.task.execution.pool.keep-alive | Cuánto tiempo se mantienen activos los hilos adicionales (no core) (a menudo en segundos). Predeterminado: 10 |
| spring.task.scheduling.pool.size | El tamaño del pool de hilos para las tareas programadas de Spring (@Scheduled), independiente del pool de ejecución personalizado. Predeterminado: 10 |
Límites de paralelismo e intervalos de los agentes
| Parámetro | Descripción |
|---|---|
| capture.limit.parallel.diff | Número máximo de trabajos de diferencias en paralelo. Predeterminado: 10 |
| capture.limit.parallel.snapshot | Número máximo de trabajos de instantáneas en paralelo. Predeterminado: 4 |
| capture.interval.diff.populator.agent | Intervalo del agente de llenado de diferencias (ms). Predeterminado: 300000 |
| capture.interval.diff.worker.agent | Intervalo del agente de trabajo de diferencias (ms). Predeterminado: 300000 |
| capture.interval.snapshot.populator.agent | Intervalo del agente de llenado de instantáneas (ms). Predeterminado: 300000 |
| capture.interval.snapshot.worker.agent | Intervalo del agente de trabajo de instantáneas (ms). Predeterminado: 300000 |
| capture.interval.deployment.worker.agent | Intervalo del agente de trabajo de despliegues (ms). Predeterminado: 300000 |
| capture.interval.cleanup.worker.agent | Intervalo del agente de trabajo de limpieza (ms). Predeterminado: 300000 |
| capture.interval.diff.status.agent | Intervalo del agente de estado de diferencias (ms). Predeterminado: 30000 |
| capture.interval.snapshot.status.agent | Intervalo del agente de estado de instantáneas (ms). Predeterminado: 30000 |
Watchdog
| Parámetro | Descripción |
|---|---|
| capture.watchdog.external-internal | Selecciona el modo de watchdog interno frente a externo. Para instalaciones locales (on-premise): INTERNAL |
| capture.watchdog.snapshot-interval | Intervalo del watchdog de instantáneas (ms). Predeterminado: 1800000 |
| capture.watchdog.diff-interval | Intervalo del watchdog de diferencias (ms). Predeterminado: 1800000 |
Integración con AWS (deshabilitada por defecto en instalaciones locales)
| Parámetro | Descripción |
|---|---|
| spring.cloud.aws.sqs.enabled | Deshabilita la autoconfiguración/integración de AWS SQS cuando se establece en false. |
| spring.cloud.aws.sns.enabled | Deshabilita la autoconfiguración/integración de AWS SNS cuando se establece en false. |
| cloud.aws.region.auto | Deshabilita la detección automática de región cuando se establece en false. |
| cloud.aws.region.static | Establece explícitamente la región de AWS. Predeterminado: eu-central-1 (Fráncfort). |
Ciclo de vida del servidor y manejo de errores
| Parámetro | Descripción |
|---|---|
| server.shutdown | Habilita el apagado ordenado cuando se establece en graceful (deja de aceptar nuevas solicitudes, finaliza el trabajo en curso). |
| spring.lifecycle.timeout-per-shutdown-phase | Tiempo permitido por fase de apagado antes de forzar la terminación. Predeterminado: 3s |
| server.error.include-message | Incluye la excepción/mensaje en las respuestas de error (útil para depurar, pero puede revelar detalles en producción). |
Configuración del sistema en la aplicación
Además de los archivos de propiedades, un SUPERUSER puede ajustar varios parámetros de tiempo de ejecución desde la pantalla de la aplicación Configuración del sistema .
Agentes internos
- Agentes de instantáneas: el número de agentes que trabajarán en una nueva instantánea en paralelo. Demasiados agentes pueden ralentizar el sistema externo conectado y significan un mayor uso de recursos en el servidor de 3C. En servidores más antiguos, con CPU y memoria limitadas, recomendamos usar un número menor de agentes.
- Agentes de estado de instantáneas: se recomienda mantenerlo en 1.
- Agentes de llenado de instantáneas: se recomienda mantenerlo en 1.
- Agentes de diferencias: el número de agentes que trabajarán en paralelo en una nueva diferencia. Demasiados agentes requieren mayores recursos en el servidor de 3C. En servidores más antiguos, con CPU y memoria limitadas, se aconseja usar un número menor de agentes.
- Agentes de estado de diferencias: se recomienda mantenerlo en 1.
- Agentes de llenado de diferencias: se recomienda mantenerlo en 1.
- Agentes de despliegue: se recomienda mantenerlo en 1.
- Agentes de limpieza: se recomienda mantenerlo en 1.
Agentes externos
No se utiliza en las versiones locales (on-premise).
Credenciales predeterminadas
Tras la instalación del 3C Release Manager, el superusuario predeterminado es:
- Nombre de usuario: super
- Contraseña: super
Uso — operación del 3C Release Manager
Después de la instalación y configuración del 3C Release Manager, el flujo de trabajo típico del 3C Release Manager sigue esta estructura: Inquilinos → Usuarios → Entornos → Instantáneas → Diferencias → Historias de usuario → Despliegues. En las secciones siguientes se describe cada área funcional tal como aparece en la interfaz de usuario web.
Diseño y navegación
La disposición general del 3C Release Manager consta de los siguientes módulos: menú principal, barra de herramientas de usuario, tablas y contenidos.
Diseño principal
La interfaz de usuario web del 3C Release Manager contiene los siguientes elementos:
- Barra de menú
- Barra de herramientas del usuario
- Título de la página
- Botones de acción de página
- Información y ayuda
- Acciones especiales relacionadas con el contenido
- Controles de filtro de lista
- Contenido de la lista
- Paginación
- Elementos de la lista: por lo general, los campos ID y Título abren la vista de detalle
- Acciones del elemento de la lista, como editar, eliminar
- Control de recuento de registros
Barra de herramientas del usuario
Al hacer clic en el pequeño icono de perfil de la esquina superior derecha de la pantalla, se abre el submenú de usuario. El primer elemento del menú abre la pantalla Mi Perfil .
Menú
La estructura del menú del 3C Release Manager es la siguiente:
- Inicio: este botón le devuelve a la página de inicio del 3C Release Manager.
- Entornos: navega a la página de Lista de Entornos, para ver la lista de entornos conectados o crear nuevas conexiones.
- Instantáneas: navega a la página de Lista de instantáneas para ver la lista de instantáneas existentes o crear nuevas.
- Diferencias: navega a la página de Lista de Diferencias, para ver la lista de las diferencias existentes o crear nuevas.
- Despliegues: navega a la página de lista de Paquetes de Despliegue, para ver la lista de Paquetes de Despliegue existentes o crear nuevos.
- Historias de usuario: navega a la página de Lista de Historias de Usuario, para ver las historias de usuario existentes o crear nuevas.
- Administración:
- Inquilinos: solo visible para el SUPERUSER
- Usuarios: navega a la página Lista de usuarios, para administrar usuarios
- Configuración del sistema: parámetros generales del sistema
- Configuración de GIT: Configuración del repositorio Git
- Registro de Auditoría: navega a la página del Registro de auditoría, para ver la información del rastro de auditoría
- Configuración de licencia: una pantalla para administrar la clave de licencia
- Acerca de: navega a la página Acerca de, para ver información adicional de la aplicación
La visibilidad de los elementos del menú depende de los roles actuales del usuario que ha iniciado sesión (consulte derechos y roles).
Iniciar sesión y cerrar sesión
Inicio de sesión
Al introducir la URL correcta de la aplicación, se pide primero a los usuarios que inicien sesión en la pantalla de inicio de sesión. Las credenciales necesarias son:
- Nombre de usuario
- Contraseña
Al seleccionar la opción Recordarme , el nombre de usuario se guardará para futuros inicios de sesión. Después de iniciar sesión correctamente, los usuarios accederán a la página de inicio del 3C Release Manager.
Cierre de sesión
Para cerrar sesión en la aplicación, los usuarios tienen que hacer clic en la acción Cierre de sesión de la barra de herramientas del usuario. Al cerrar sesión, la aplicación redirige a la pantalla de inicio de sesión.
Mi Perfil
Página Mi Perfil
La página Mi Perfil está estructurada en tres secciones:
- Sección Datos principales: información personal principal — Nombre de usuario (LoginID), Nombre, Apellido, Dirección de correo electrónico.
- Sección Cambiar contraseña: permite cambiar la contraseña actual.
- Sección Mis Roles: información sobre los roles actuales del usuario conectado. Los roles solo se pueden cambiar utilizando la pantalla Detalles del usuario en la lista de usuarios, por un usuario con el rol de Administrador de usuarios.
Acceder a la página Mi Perfil
Los usuarios pueden navegar a la página Mi Perfil para ver y editar información personal o cambiar su contraseña actual. Para acceder a la página Mi Perfil, seleccione el icono de cuenta en la barra de herramientas del usuario y haga clic en la acción Logged in as username .
Editar información personal
Los usuarios pueden editar su información personal en la página Mi Perfil cambiando la información introducida:
- Nombre
- Apellido
- Dirección de correo electrónico
Después de editar, haga clic en el botón Guardar . Si se guarda correctamente, se muestra un mensaje de notificación.
Cambiar contraseña
Los usuarios tienen la posibilidad de cambiar su contraseña actual en la página Mi Perfil de la siguiente manera:
- Introduciendo la contraseña actual
- Introduciendo la nueva contraseña
- Volviendo a introducir la nueva contraseña en el campo “Confirmar contraseña”
- Haciendo clic en el botón Cambiar Contraseña .
Tras un cambio de contraseña exitoso, se muestra un mensaje de notificación.
Administración
Esta sección contiene todas las funciones administrativas y posibilidades de configuración de la aplicación 3C Release Manager: Inquilinos, Usuarios, Configuración del sistema, Configuración de Git, Registro de auditoría, Configuración de licencia. Para acceder a estas funciones, se requieren roles administrativos elevados.
Inquilinos
Los inquilinos son contenedores especiales en 3C que representan empresas o departamentos específicos. Solo son accesibles para usuarios con el rol SUPERUSER. En la versión SaaS, los usuarios no tienen acceso a estos ajustes. En la versión local (on-premise), se recomienda usar el inquilino DEFAULT, y los usuarios administradores generales deben crearse en ese inquilino.
Lista de inquilinos. Muestra los inquilinos disponibles actualmente en el sistema. El inquilino DEFAULT no se puede eliminar.
Funciones:
- Actualizar: actualiza la vista de lista actual
- Nuevo Inquilino: navega a la pantalla Crear inquilino
- Información: muestra el panel de información
Campos:
- ID: ID técnico generado
- Nombre: el título del registro del inquilino
- Licencia: activa o inactiva, según la configuración de la licencia
- Módulos con licencia: Clarity, Automic o ambos, según la configuración de la licencia
- Creado el: hora de creación del registro
- Editar: navega a la pantalla de Detalles del Inquilino
- Eliminar: elimina el inquilino
Crear Inquilino. Campos obligatorios: Nombre del inquilino (debe ser único), Descripción (texto libre). Tras la creación, los usuarios del inquilino solo pueden acceder a objetos del mismo inquilino, lo que los separa de los objetos de otros inquilinos.
Editar Inquilino. El usuario puede ver los detalles del inquilino y modificar algunos de sus atributos. Campos: ID del inquilino (solo lectura), Nombre del inquilino, Descripción, Creado por, Creado el. Funciones: Cancelar, Guardar.
Usuarios
Los usuarios representan cuentas de inicio de sesión en el sistema. Las pantallas administrativas permiten administrar los detalles del usuario, contraseñas y roles.
Campos de la lista de usuarios:
- LoginID: el ID del usuario, utilizado para iniciar sesión en 3C
- Nombre: nombre real del usuario
- Correo electrónico: la dirección de correo electrónico del usuario
- Inquilino: el inquilino al que está asociado el usuario
- Activo: muestra si el usuario está activo (puede iniciar sesión en el sistema)
- Creado el: hora de creación del usuario
- Editar / Eliminar
Campos de Crear usuario: LoginID (obligatorio, único), Nombre (obligatorio), Apellido (obligatorio), Correo electrónico (obligatorio), Activo (desactivado por defecto — solo los usuarios activos pueden iniciar sesión), Contraseña (inicial), Confirmar contraseña. Los roles del usuario solo se pueden establecer después de la creación.
Editar Usuario. El usuario puede ver los detalles y modificar algunos atributos, cambiar la contraseña o modificar los roles activos. El LoginID no se puede cambiar después de la creación.
Roles disponibles:
- USER_USER: puede acceder a la Lista de Usuarios y a los detalles del Usuario
- USER_MANAGER: puede acceder a la Lista de Usuarios, puede eliminar Usuarios, puede crear nuevos Usuarios, puede editar Usuarios
- ENVIRONMENT_USER: puede acceder a la Lista de Entornos y a los detalles del Entorno
- ENVIRONMENT_MANAGER: puede acceder a la Lista de Entornos, puede eliminar Entornos, puede crear un nuevo Entorno, puede editar los detalles de un Entorno (incluyendo la configuración de conexión, contraseña, filtros, configuración de Git)
- SCHEDULE_USER: puede acceder a las instantáneas programadas del Entorno
- SCHEDULE_MANAGER: puede acceder a las instantáneas programadas del Entorno y modificarlas, eliminarlas o crear otras nuevas
- SNAPSHOT_USER: puede acceder a la Lista de instantáneas y a los detalles de la instantánea
- SNAPSHOT_MANAGER: puede acceder a la Lista de Instantáneas, puede eliminar Instantáneas, puede iniciar una nueva Instantánea, puede editar los metadatos de la Instantánea
- DIFF_USER: puede acceder a la Lista de Diferencias y a los detalles de la Diferencia
- DIFF_MANAGER: puede acceder a la Lista de Diferencias, eliminar las Diferencias existentes, puede crear una nueva Diferencia, puede editar los metadatos de la Diferencia
- DEPLOYMENT_USER: puede acceder a la Lista de Despliegues y ver los detalles del Despliegue, incluyendo las ejecuciones
- DEPLOYMENT_MANAGER: puede acceder a la Lista de Despliegues, eliminar Despliegues existentes, crear nuevos Despliegues, iniciar nuevos procesos de Despliegue, editar su contenido
- USER_STORY_USER: puede acceder a la Lista de Historias de Usuario y a los detalles de las Historias de Usuario
- USER_STORY_MANAGER: puede acceder a las Historias de Usuario y modificarlas, eliminar Historias de Usuario existentes, crear nuevas, editar su contenido
- SUPERUSER: puede acceder a cualquier función en 3C, puede editar los inquilinos, establecer nuevas claves de licencia
Configuración de Git
Estos ajustes son necesarios para sincronizar la configuración del sistema conectado con un repositorio Git externo. Es un parámetro global por inquilino. Para conectarse a un repositorio Git, el usuario debe establecer la URL del repositorio y las credenciales de un usuario técnico con permisos para hacer commit y push en ese repositorio. Alternativamente, se puede usar una clave SSH.
Campos:
- URL del repositorio Git: la URL del repositorio
- Tipo de conexión: Credenciales o SSH
- Credenciales: Nombre de usuario, Contraseña, Confirmar contraseña
- SSH: Clave SSH privada requerida por el proveedor de Git
- Conectado: después de la creación o modificación, el 3C Release Manager intentará conectarse al repositorio con esta configuración y confirmará si la conexión funciona
Funciones: Guardar guarda los valores modificados; Probar conexión intenta conectarse al repositorio con la configuración actual.
Registro de auditoría
Esta tabla es una lista representativa de los eventos y acciones importantes realizados en el sistema con fines de auditoría y seguimiento de errores.
Campos:
- ID de registro: ID técnico generado
- ID de inicio de sesión: el ID del usuario asociado
- Nivel de registro: el nivel del mensaje (INFO, WARNING, ERROR)
- Hora del registro: la marca de tiempo del mensaje
- Mensaje de registro: el texto del mensaje
- Módulo: el nombre del módulo del sistema que originó el mensaje
Configuración de licencia
En esta pantalla, el administrador puede verificar y modificar la clave de licencia actual.
Campos:
- Licencia válida: verdadero si la licencia es válida y está activa para esta instancia
- Licencia a nombre de: el propietario de la licencia
- Licencia válida hasta: la fecha de caducidad de la licencia
- Número máximo de entornos: el número máximo de entornos que se pueden gestionar con esta licencia
- Módulos con licencia: la lista de sistemas externos que se pueden gestionar con 3C (CLARITY, AUTOMIC o ambos)
- Cambiar clave de licencia: el usuario puede añadir una nueva clave de licencia
- Botón Cambiar clave de licencia: cambia la clave de licencia por la nueva proporcionada
Entornos
Los entornos son conexiones a instancias de Automic (o Clarity). Son necesarios para cualquier análisis, instantánea o despliegue. Si la conexión del entorno se establece correctamente, también ofrece, a modo de resumen general, una lista de los objetos disponibles en la instancia.
Lista de entornos
La página Lista de entornos muestra las conexiones de Clarity PPM y Automic creadas y detalles adicionales sobre ellas, y permite crear, editar o eliminar elementos.
Funciones: Actualizar, Nuevo Entorno, Información.
Filtros: Filtro de producto (solo visible si su licencia es válida para Automic y Clarity).
Campos:
- ID: identificador único del registro de conexión del entorno. Generado automáticamente por el sistema.
- Título: nombre de la conexión de entorno, asignado por el usuario que la creó.
- Host: dirección del servidor donde se está ejecutando la aplicación externa.
- Cliente: solo visible para instancias de Automic.
- Tipo: el tipo de uso del entorno, como DEVELOPMENT, TEST, PRODUCTION, etc.
- Base de datos: el proveedor de base de datos del sistema externo. Solo visible para entornos Clarity.
- Inicializado: muestra si las consultas necesarias ya están instaladas en el sistema. Solo visible para entornos Clarity.
- Conectado: muestra si las credenciales y la configuración de conexión son correctas, y si 3C puede acceder al sistema.
- Última instantánea: la marca de tiempo de la última instantánea exitosa generada para el sistema.
- Próxima instantánea: la fecha de la próxima instantánea de copia de seguridad programada para el sistema.
- Mostrar: navega a la pantalla de Detalles del Entorno.
- Eliminar: elimina el entorno.
Crear entorno
Cree un registro de entorno para almacenar los detalles de conexión, que se utilizarán para crear instantáneas. Si tiene licencias Clarity y Automic disponibles, primero debe elegir el tipo de producto.
Parámetros del sistema:
- Título: identificador corto del entorno. Este título aparece en otras páginas también. Se recomienda que sea único.
- Direcciones de servidor: dirección del entorno Automic en formato URL:PORT sin http o https. Se pueden agregar puertos utilizando rangos (xyurl:10-20) o comas (yyurl:1,2,3). Utilice el botón + para agregar nuevos registros a la configuración de conexión para diferentes nombres de host.
- Tipo de entorno: el tipo de uso. Valores: DEVELOPMENT, TEST, MIGRATION, PRODUCTION.
- Certificado del entorno: El 3C Release Manager necesita el certificado de conexión. Copie en este campo el texto del archivo .cert con las líneas —–BEGIN CERTIFICATE—– y —–END CERTIFICATE—– incluidas.
Credenciales:
- Número de cliente: el número de cliente del usuario técnico en Automic.
- Nombre de usuario: el nombre del usuario técnico, por ejemplo, UC. El 3C Release Manager solo podrá acceder (descargar o desplegar) a objetos de Automic a los que el usuario técnico tenga acceso.
- Departamento: el departamento del usuario técnico.
- Guardar contraseña: recomendado. Puede usar 3C sin guardarla, pero entonces se le pedirá la contraseña en cada solicitud de conexión antes de crear una instantánea o un despliegue.
- Contraseña: la contraseña del usuario técnico.
- Descripción: campo de texto libre para información adicional sobre la conexión con el entorno.
Editar entorno
Una vez que se crea y guarda una conexión de entorno, se puede abrir desde la página Lista de entornos y se pueden modificar todos los ajustes relacionados. Al hacer clic en el título de la conexión en la página de lista, se abre la página Editar entorno. La página Editar entorno tiene varias pestañas:
- Base: información genérica sobre la conexión del entorno
- Conexión: indicadores sobre el estado de la conexión
- Credenciales: posibilidad de cambiar la contraseña de inicio de sesión de la conexión
- Trabajos programados: configuración de la generación automática de instantáneas de copia de seguridad para el entorno
- Filtros guardados: filtros de objeto definidos por el usuario — solo para Automic
- Filtros: posibilidad de incluir o excluir ciertos elementos de las instantáneas — solo para Clarity
- Objetos: lista de objetos identificados
- Configuración de Git: para configurar la sincronización de Git para este entorno
- Reglas de despliegue: reglas del script de despliegue automatizado — solo para Automic
Pantalla base
La configuración básica de conexión y los metadatos del entorno. Los mismos campos que en Crear Entorno (Título, Direcciones del servidor, Tipo de entorno, Número de cliente, Nombre de usuario, Departamento, Descripción). Funciones: Cancelar, Guardar.
Pantalla de conexión
Indica si la configuración de conexión es correcta.
Campos:
- Conectado: verdadero si la conexión es correcta
- Error de conexión: contiene el mensaje de error de la solicitud de conexión, si lo hubo (solo para Automic)
- Inicializado: indica si la conexión se estableció correctamente y la aplicación pudo conectarse a la instancia de Clarity PPM al menos una vez (solo para Clarity)
- Conexión REST: indica si 3C puede acceder a la API REST (solo para Automic)
Funciones:
- Comprobar conexión: actualiza el estado de la conexión
- Reinicializar / Inicializar: ejecuta en el entorno los scripts de consulta necesarios para que funcione el 3C Release Manager (solo para Clarity)
Pantalla de credenciales
Campos: Guardar contraseña (recomendado), Contraseña (la contraseña del usuario técnico). Funciones: Guardar cambios (guarda la nueva contraseña e intenta conectarse al sistema externo), Agregar nuevo (abre un diálogo donde el usuario puede configurar el certificado de la conexión).
Pantalla de trabajos programados
Muestra la lista de trabajos de instantánea programados para este entorno. El 3C Release Manager iniciará una nueva instantánea automáticamente para crear una copia de seguridad de la configuración en los momentos especificados aquí.
Campos:
- Título de la programación: título de texto libre
- Activo: el trabajo solo se ejecutará si el indicador Activo está activado
- Diferencias automáticas: si se establece en verdadero, 3C también creará automáticamente un análisis de diferencias con respecto a la última instantánea programada
- Última ejecución: la marca de tiempo de la última ejecución del trabajo
- Próxima ejecución: la próxima vez que el trabajo esté programado para ejecutarse
- Número de ejecuciones: el número de veces que el trabajo se ha ejecutado correctamente
- Detalles: navega a la pantalla Editar programación
- Eliminar: elimina el trabajo programado
Funciones: Crear programación (navega a la pantalla Nueva programación).
Pantalla de trabajos programados — Nueva programación
Use esta página para definir un nuevo trabajo de instantánea programada para el entorno.
Campos:
- Título: nombre de texto libre, obligatorio
- Descripción: campo de descripción de texto libre
- Diferencias automáticas: si está habilitado, cada instantánea desencadenará automáticamente un trabajo de análisis de diferencias, que comparará la configuración actual con el último estado guardado previamente
- Filtro: opcional — si no se establece, se realizará una instantánea completa
- Hora de inicio de la copia de seguridad: HH:MM (formato). El trabajo comenzará a la hora indicada.
- Zona horaria: establezca la zona horaria de la hora de inicio de la copia de seguridad
- Frecuencia de programación: establezca la frecuencia. Están disponibles las siguientes opciones:
- Diaria: el trabajo se iniciará cada día a la hora indicada
- Semanal: establezca los días de la semana en que desea que comience el trabajo
- Mensual: establezca los días del mes en que desea que comience el trabajo
- Anual: establezca los días del año en que desea que comience el trabajo
Funciones: Cancelar (regresa a la lista de programaciones sin modificaciones), Guardar (crea el nuevo trabajo programado).
Pantalla de trabajos programados — Editar programación
Utilice esta página para modificar un trabajo de instantánea programada para el entorno. Los campos son idénticos a los de la pantalla “Nueva programación”: Título, Descripción, Diferencias automáticas, Filtro, Hora de inicio de la copia de seguridad (HH:MM), Zona horaria y Frecuencia de programación (Diaria, Semanal, Mensual, Anual). Funciones: Cancelar, Guardar.
Pantalla de filtros guardados (solo Automic)
Utilice esta página para administrar los filtros guardados del entorno. Cuando el usuario desea crear una instantánea personalizada, tiene la opción de guardar el filtro utilizado actualmente para usarlo en el futuro. Esta pantalla muestra la lista de estos filtros.
Campos:
- Título: el nombre del filtro
- Creado por: el propietario del filtro
- Creado el: fecha de creación
- Editar: navega a la pantalla Nueva instantánea, con los filtros cargados
- Eliminar: elimina el filtro
Pantalla de lista de objetos
La pantalla de objetos proporciona un catálogo de configuración general sobre el entorno. Después de cada instantánea, esta lista se actualiza y también se puede actualizar manualmente en esta pantalla. Cumple dos propósitos básicos: primero, puede verificar qué objetos están disponibles en el sistema; segundo, puede usar el botón Historial para ver las modificaciones anteriores en el objeto.
Vista del historial
La vista de historial muestra cada versión anterior del objeto a la izquierda. Al seleccionar un elemento específico en la lista, la vista de la derecha muestra los cambios reales en el elemento de configuración como una diferencia de texto.
Pantalla de configuración de Git
Si el repositorio Git global está configurado correctamente, está disponible esta página, en la que el usuario puede habilitar o deshabilitar la función de sincronización de Git para el entorno y establecer el nombre de la rama que se utilizará en el repositorio para hacer un seguimiento de las configuraciones.
Campos:
- Nombre de la rama: esta rama se creará en el repositorio si no existe y se utilizará para almacenar la configuración.
- Sincronización de Git habilitada: si está habilitada, después de cada instantánea el 3C Release Manager escribirá la configuración en el sistema de archivos y, a continuación, confirmará y enviará (commit y push) automáticamente los cambios al repositorio Git definido.
- Guardar: guarda los valores del formulario.
Pantalla de reglas de despliegue (solo Automic)
El usuario puede establecer las reglas predeterminadas para este entorno, que se utilizarán durante el proceso de despliegue. El proceso de cambio de texto funciona de manera similar a la utilidad AEDB Change; las reglas específicas que se pueden usar en los archivos de reglas son las mismas que en la documentación de AEDB Change de Automic.
Campos:
- Reglas del entorno: el texto que contiene las reglas (cada línea es una regla)
- Validar: revisa las reglas y muestra un mensaje de error en caso de errores de sintaxis
- Guardar: guarda el conjunto de reglas para el entorno. Siempre que se defina un nuevo despliegue para este entorno, este conjunto de reglas se copiará y se usará como predeterminado para el despliegue.
Pantalla de filtros (solo Clarity)
El usuario puede establecer filtros específicos para este entorno que modificarán cómo se deben crear las instantáneas para esta instancia. Hay tres categorías:
- Filtros de idioma: 3C eliminará de los archivos XML cualquier línea que contenga etiquetas de los idiomas que se excluyen aquí
- Filtros de objetos: 3C solo incluirá en la instantánea los tipos de objeto que estén habilitados en esta lista de filtros
- Otros filtros: filtros específicos para los archivos XML que eliminan atributos, etiquetas o partes de los XML que no son necesarios para el análisis comparativo, como los ID generados y similares
Instantáneas
Las instantáneas son una de las funcionalidades básicas del 3C Release Manager. Una instantánea es una representación de la configuración de la instancia administrada en un momento dado. El 3C Release Manager se conecta al sistema Clarity o Automic y, basándose en los filtros y configuraciones, encontrará y descargará todos los objetos de configuración del sistema. Estos conjuntos se pueden nombrar y guardar, para ser utilizados posteriormente como historial de configuración, copia de seguridad del sistema, base para análisis de diferencias o la fuente de un paquete de despliegue.
Instantáneas incrementales
El 3C Release Manager exporta y guarda los objetos de forma incremental. Siempre que se inicia una nueva instantánea, el 3C Release Manager comprueba cada objeto que está disponible en el sistema seleccionado, basándose en los filtros y ajustes. Solo se almacenan los elementos que han cambiado desde la última instantánea almacenada, para reducir la duración del proceso y el consumo de la base de datos. En una instancia nueva, la primera instantánea tardará más, pero las siguientes se crearán más rápido.
Instantáneas completas versus parciales
Si el usuario no especifica ningún filtro ni selección de objeto, se creará una instantánea completa (Full Snapshot). Se descargarán todos los objetos. Se recomienda configurar los filtros de manera que solo se guarde la configuración importante, para agilizar el proceso.
Lista de instantáneas
Funciones: Actualizar, Crear instantánea, Información.
Filtros:
- Fuente: el entorno que fue la fuente de la instantánea
- Tipo: Creado manualmente, Generado automáticamente, Copia de seguridad programada, Copia de seguridad antes del despliegue, Validación de despliegue
- Rango de fechas: la hora de inicio de la instantánea
- Campo de búsqueda: búsqueda de texto libre en título y descripción
Controles especiales: El primer icono alterna entre la selección de historias de usuario y la selección de despliegues. La lista desplegable muestra las historias de usuario o los despliegues disponibles para gestionar; si se selecciona alguno, un botón “Abrir despliegue” o “Abrir historia de usuario” lleva al elemento seleccionado.
Campos:
- ID: el ID técnico de la instantánea
- Título: el título de la instantánea
- Entorno: el entorno de origen de la instantánea
- Estado: DONE, ERROR, IN_PROGRESS, WAITING
- Estadísticas: número total de objetos en azul, objetos con errores en rojo
- Etiquetas: etiquetas especificadas por el usuario o creadas automáticamente
- Inicio: la hora de inicio
- Mostrar: abre la pantalla Detalles de la instantánea
- Eliminar: elimina la instantánea
- Elementos seleccionados: si se selecciona un despliegue o una historia de usuario en la página, esta columna muestra el número de objetos añadidos a esa historia de usuario o despliegue desde cada instantánea
Crear instantánea
Campos:
- Título de la instantánea: obligatorio, generado automáticamente con un valor predeterminado
- Entorno seleccionado: la conexión de entorno que se utilizará como origen
- Descripción: texto libre
- Etiquetas: etiquetas manuales para la instantánea
- Instantánea personalizada: si no está habilitado, 3C iniciará una instantánea completa
Funciones: Cancelar, Iniciar instantánea.
Instantánea personalizada
Si el selector “Instantánea personalizada” está activado, la pantalla muestra todo el catálogo de configuración del entorno, donde el usuario puede seleccionar manualmente qué elementos deben incluirse en la instantánea. El usuario puede seleccionar carpetas (los elementos se descargarán de forma recursiva) o elementos individuales. Esta selección se puede guardar como filtro mediante el botón Filtro nuevo y los filtros guardados previamente se pueden aplicar con el selector Filtro de la pantalla.
Creación de instantánea
En función de los objetos del entorno y de los filtros y elementos seleccionados por el usuario, una instantánea puede tardar bastante tiempo. Durante ese período, el 3C Release Manager muestra una barra de progreso.
Detalles de la instantánea
Los detalles de una instantánea específica, incluidos sus metadatos y los elementos de configuración descargados.
Metadatos: ID de la instantánea (solo lectura), Entorno (solo lectura), Título de la instantánea (obligatorio), Estado, Hora de inicio, Hora de finalización, Descripción, Etiquetas.
Funciones: Actualizar, Atrás, Información, Guardar (guarda los cambios en el formulario de metadatos), Reiniciar — si había objetos en estado de error o la instantánea terminó con error, el usuario puede intentar descargar los objetos restantes.
Vista del árbol de objetos
El contenido principal de la instantánea. En el lado izquierdo, la vista de árbol muestra las categorías de objetos en el caso de Clarity y, en el caso de Automic, la estructura de carpetas de la instancia correspondiente. Las carpetas se pueden abrir y cerrar; al hacer clic en ellas se muestra el contenido de la carpeta o categoría en el lado derecho.
Para toda la instantánea y para cada carpeta, los números azules muestran el número total de objetos, los números verdes muestran los objetos descargados correctamente y los números rojos muestran los objetos en estado de error. La descarga de un objeto puede fallar por problemas de conexión, errores del programa o problemas de autorización si el usuario técnico no tiene los permisos necesarios.
Campos: ID, Código de objeto, Tipo de objeto, Estado (WAITING, IN_PROGRESS, DONE, ERROR), Detalles (abre el diálogo Objeto de instantánea), Historial (abre la vista de historial del objeto).
Gestión de despliegues / historias de usuario
Si se selecciona una Historia de Usuario o un Despliegue en la esquina superior derecha, el diseño de la pantalla cambia. Con el control añadido, puede seleccionar carpetas, el contenido de las carpetas o elementos específicos que se añadirán a la Historia de Usuario o al Despliegue seleccionado.
Pantalla de detalles del objeto
Muestra los detalles del objeto, con el código de configuración real en un campo de solo lectura.
Campos:
- ID: identificador técnico del objeto
- Código: el código del objeto
- Hora de inicio: hora de inicio de descarga del objeto
- Última actualización: hora del cambio de configuración del objeto en el sistema externo
- Objeto modificado: verdadero si se cambió desde la última instantánea
- Objeto movido: verdadero si se movió de otra carpeta desde la última instantánea
- Tipo de configuración: XML / JSON
- Estado: el estado de la exportación
- Tipo de objeto: el tipo de objeto en el sistema
- Hora de finalización: la hora en que se guardó el objeto en 3C
- Última actualización por: si está disponible, el ID del usuario que modificó el elemento en el sistema externo
- Instantánea original: si el elemento no se ha modificado, muestra el ID de la primera instantánea que contenía la configuración actual
- Carpeta original: si el elemento se movió, muestra la carpeta anterior guardada en 3C
- Contenido: la configuración realmente guardada
Diferencias
Los análisis de diferencias (Diff) son la segunda función importante del 3C Release Manager. Un Diff es una comparación entre dos instantáneas. Según el caso de uso, se puede utilizar para analizar las diferencias entre:
- El mismo entorno en diferentes momentos — útil para copias de seguridad diarias y seguimiento de errores, para recopilar los cambios durante una fase de desarrollo o para validar un despliegue
- Entornos diferentes — útil para encontrar diferencias entre un entorno de prueba y uno de desarrollo, para ver qué hay que desplegar, para comprobar si el despliegue en prueba es el esperado tras el desarrollo, entre un entorno de producción y uno de prueba para ver qué debería incluir la versión, o entre un entorno de producción y un sistema estándar (vanilla) para recopilar todas las personalizaciones que se hayan realizado en el sistema
El usuario también puede seleccionar entornos, no solo instantáneas; con esta función, el 3C Release Manager creará una nueva instantánea sobre la marcha y la usará para la comparación. Al igual que las instantáneas, las diferencias también pueden servir como origen del contenido de despliegues o historias de usuario.
Lista de diferencias
Funciones: Actualizar, Nuevo Diff, Información.
Controles especiales: Selector de historias de usuario / despliegues con el mismo comportamiento que en la lista de instantáneas.
Filtros: Entorno de origen, Entorno de destino, Intervalo de tiempo de inicio, Campo de búsqueda.
Campos:
- ID: ID técnico generado para la diferencia
- Título: el título de la diferencia
- Estado: DONE, ERROR, WAITING, IN_PROGRESS
- Hora de inicio: la hora de la creación de la diferencia
- Etiquetas: las etiquetas establecidas para la diferencia
- Estadísticas: objetos recién creados en verde, objetos eliminados o faltantes en rojo, elementos modificados en amarillo, elementos movidos en azul
- Mostrar: abre la pantalla Detalles de la diferencia
- Eliminar: elimina el registro de diferencia
- Elementos seleccionados: si se selecciona un Despliegue o una Historia de Usuario, esta columna muestra el número de objetos añadidos de cada diferencia
Crear diferencia
El usuario puede usar esta pantalla para iniciar un nuevo proceso de diferencias. Si la licencia de 3C es válida tanto para Clarity como para Automic, el usuario debe seleccionar primero el producto que desea utilizar.
Campos:
- Entorno de origen: si se selecciona, el proceso de diferencias iniciará primero un nuevo proceso de instantánea para el entorno seleccionado
- Instantánea de origen: la lista de instantáneas disponibles en 3C. Los filtros se pueden usar para reducir la lista de selección. Se debe seleccionar el Entorno de origen o la Instantánea de origen.
- Entorno de destino: si se selecciona, el proceso de diferencias iniciará primero un nuevo proceso de instantánea para el entorno seleccionado
- Instantánea de destino: la lista de instantáneas disponibles en 3C. Se debe seleccionar el Entorno de destino o la Instantánea de destino.
- Título: título de texto libre para la diferencia, obligatorio
- Descripción: campo de descripción de texto libre
- Etiquetas: el usuario puede establecer etiquetas específicas para una diferencia
- Prefiltros personalizados: el usuario puede establecer partes específicas de la configuración que se omitirán en los análisis de diferencias, como los ID generados y similares
Funciones: Cancelar, Crear.
Detalles de la diferencia
Una vez completado el proceso de diferencias, los análisis pueden consultarse en la pantalla Detalles de la diferencia.
Campos: ID (solo lectura), Título, Estado, Hora de inicio/fin, Instantánea de origen, Instantánea de destino, Descripción, Etiquetas.
Funciones: Actualizar, Atrás, Información, Guardar.
Vista del árbol de objetos
El mismo diseño que la vista de árbol de instantáneas. También muestra un registro especial llamado == All diffs == que muestra todas las diferencias en el lado derecho de la pantalla. Para toda la diferencia y para cada carpeta, los números azules muestran el número total de objetos movidos, los números verdes muestran los objetos recién creados, los números amarillos muestran los objetos modificados y los números rojos muestran los objetos faltantes o eliminados.
Campos:
- Código de objeto: el nombre del objeto. El color del icono del objeto también representa el cambio (rojo para eliminación, verde para adición, amarillo para modificación, azul para movimiento)
- Modificado en origen: la hora del cambio del objeto en el entorno de origen
- Modificado en destino: la hora del cambio del objeto en el entorno de destino
- Diferencias: abre la pantalla de comparación de XML o vista de árbol para las modificaciones
- Fuente: navega a la Instantánea de origen
- Destino: navega a la Instantánea de destino
Gestión de despliegues / historias de usuario
Si hay una Historia de Usuario o un Despliegue seleccionado en la esquina superior derecha, la pantalla cambia. Con el control añadido, puede seleccionar carpetas, el contenido de carpetas o elementos específicos para añadirlos a la Historia de Usuario o Despliegue seleccionado.
En la vista de árbol de la izquierda, el botón + agregará recursivamente todos los elementos de la carpeta al objeto seleccionado. El botón – eliminará recursivamente todo su contenido. Los números en gris muestran cuántos objetos hay en la carpeta que potencialmente se pueden agregar y cuántos de ellos ya se han agregado.
En la parte superior de la lista, Añadir todo añadirá cada elemento de la lista que se muestra arriba, y Quitar todo eliminará los elementos.
En los registros individuales hay tres opciones: Añadir elemento añade ese elemento específico; Añadir relacionados añade el elemento con objetos directamente relacionados; Añadir relacionados recursivamente añade todos los elementos relacionados con el actual, incluidas también sus referencias.
Detalles del objeto Diff
La comparación de XML abre la pantalla de cambio de configuración. La pestaña Origen muestra la configuración en el lado de origen, la pestaña Destino muestra la configuración en el lado del destino, y la pestaña Diferencia muestra las diferencias en el código XML o JSON mediante una vista de comparación de texto.
Vista de análisis
Proporciona otra pantalla de visualización en la que los elementos de configuración del XML del objeto se muestran en una vista de árbol para facilitar su comprensión.
Despliegues
Los despliegues son el tercer elemento importante del 3C Release Manager. Un Paquete de Despliegue es una colección de elementos de configuración que se pueden recopilar directamente de instantáneas o diferencias, o se pueden agregar a través de historias de usuario. Un despliegue siempre tiene un sistema de destino, donde el usuario desea escribir las configuraciones recopiladas.
Una vez configurado y preparado el despliegue, se puede iniciar, y el 3C Release Manager desplegará automáticamente cada paso uno por uno en el orden dado. El 3C Release Manager también puede crear una instantánea de copia de seguridad antes de que comience el despliegue y una instantánea de validación después de que finalice, para que los cambios puedan ser validados posteriormente. En caso de error, se puede crear automáticamente un despliegue de reversión.
Una vez finalizada la ejecución de un despliegue, ya no se puede modificar, por lo que los registros de despliegue pueden utilizarse como fuente de auditoría para los sistemas de destino.
Lista de despliegues
Funciones: Actualizar, Nuevo despliegue, Información.
Filtros: Entornos, selector de estado (uno o más), intervalo de fecha de creación, campo de texto (texto libre en título o descripción).
Campos:
- ID: ID técnico generado
- Título: el título del Paquete de Despliegue
- Estado: DRAFT, PREPARED, IN_PROGRESS, DONE, ERROR
- Tipo: Despliegue o Reversión
- Fecha de creación: hora de la creación del Paquete de Despliegue
- Destino: el entorno de destino
- Mostrar: navega a la pantalla Editar despliegue
- Eliminar: elimina el despliegue
Crear paquete de despliegue
Campos: Entorno de destino, Título (obligatorio), Descripción. Funciones: Cancelar, Crear.
Los valores adicionales se pueden establecer después de la creación.
Editar paquete de despliegue
La pantalla Editar paquete de despliegue tiene 5 pestañas:
- Base: los datos básicos del despliegue
- Reglas: solo para Automic, donde el usuario puede definir reglas automáticas para ejecutar en los elementos de configuración antes del despliegue
- Preparar paquete: donde el usuario puede editar los pasos de despliegue
- Registro de ejecución: donde el usuario puede iniciar y monitorizar el paquete de despliegue
- Validación: donde el usuario puede verificar los pasos de validación después de que el despliegue haya finalizado
Pestaña Base
Si hay elementos en conflicto en los pasos del despliegue, se muestra un mensaje de advertencia. También se muestra otro mensaje si se han añadido al despliegue objetos que, por lo general, no se recomienda modificar en una instancia de Automic.
Campos:
- Título: el título del despliegue
- Entorno de destino: el entorno donde se realizará el despliegue
- Estado: el estado del despliegue
- ID de despliegue: ID técnico generado automáticamente
- Tipo de despliegue: Despliegue o Reversión
- Descripción: campo de descripción de texto libre
- Opciones avanzadas: para deshabilitar manualmente la creación de la instantánea de copia de seguridad y de la instantánea de validación
Historias de usuario: la lista de las historias de usuario que se incluyen en el Paquete de Despliegue.
Lista de origen: la lista de las instantáneas y diferencias que se utilizaron como origen para los pasos del Paquete de Despliegue, directa o indirectamente a través de historias de usuario.
Funciones: Cancelar, Guardar, Clonar despliegue (clona el despliegue actual y crea uno nuevo con el mismo contenido y configuración), Reglas de despliegue (navega a la siguiente pestaña).
Pestaña Reglas (solo Automic)
El usuario puede establecer las reglas concretas para este despliegue, que se utilizarán durante el proceso. Si el entorno de destino tiene un conjunto de reglas predeterminado definido, estas se copiarán aquí automáticamente, pero el usuario también podrá eliminarlas. El proceso de cambio de texto funciona de manera similar a la utilidad AEDB Change.
Campos:
- Reglas del entorno: el texto que contiene las reglas (cada línea es una regla)
- Validar: revisa las reglas y muestra un mensaje de error en caso de errores de sintaxis
- Guardar: guarda el conjunto de reglas para el despliegue. Cualquier objeto agregado al despliegue activará las reglas y su contenido se modificará en consecuencia.
Pestaña Preparar paquete
De manera similar al contenido de la historia de usuario, el Paquete de Despliegue contiene pasos que deben ejecutarse durante el proceso. Los pasos pueden ser de los siguientes tipos:
- Crear un nuevo objeto (acción Crear)
- Borrar un objeto (acción Eliminar) — para Clarity, la eliminación no funciona automáticamente debido a limitaciones del sistema externo
- Modificar la configuración de un objeto existente
- Mover un objeto existente a otra carpeta — solo relevante para instancias Automic
- Pasos manuales — pasos personalizados del proceso de despliegue en los que el proceso debe detenerse para que el administrador pueda completar una tarea manual
Los objetos se pueden agregar desde una instantánea; los cambios de eliminar/crear/mover se pueden agregar desde una diferencia.
Filtro: Búsqueda de texto libre dentro de códigos de objeto o tipos de objeto.
Campos:
- Número: el orden de los pasos. El usuario puede arrastrar y soltar los registros para reordenarlos. Durante el proceso, los pasos de despliegue se ejecutan en el orden del script.
- ID: ID técnico generado. Si hay una advertencia para el registro (como conflictos), también se muestra aquí un icono de advertencia.
- Historia de usuario: el enlace a la historia de usuario de origen
- Fuente: el enlace a la instantánea o diferencia de la que se originó la configuración
- Tipo de paso: AUTO o MANUAL
- Tipo de objeto: si hay objetos dentro del despliegue que, por lo general, no se aconseja modificar, se mostrará aquí un icono de advertencia
- Código de objeto: el código del objeto
- Tipo de configuración: XML o JSON
- Acción: la acción que se realizará durante el despliegue
- Desplegar XML: muestra el código del objeto que se desplegará en el sistema de destino
- Configuración de destino: muestra el código del objeto que se sobrescribirá en el sistema de destino
- Operaciones:
- Punto de interrupción: el proceso de despliegue se detendrá después de este paso hasta que el usuario lo reanude
- Subir / bajar: reordena los pasos
- +: crea un paso manual después del seleccionado
- Nota: abre la nota para el paso de despliegue
- Eliminar: elimina el paso del despliegue
Funciones: Añadir desde diferencia (navega a la lista de diferencias con el despliegue actual seleccionado para añadir), Añadir desde Instantánea, Preparación lista (cambia el estado del despliegue a “Preparado”), Iniciar (solo visible para despliegues con estado Preparado — inicia el proceso y navega a la pestaña Registro de ejecución).
Diálogo de paso de despliegue
Muestra los detalles del paso de despliegue, con la configuración que se utilizará durante el despliegue.
Campos: Tipo de origen (Instantánea o Diferencia), ID, Origen del objeto, Código, Tipo de objeto, Origen (la configuración del objeto), Descripción, Notas.
Pestaña Registro de ejecución
Una vez iniciado el proceso de despliegue, este registro permite supervisar el proceso. Si la opción de instantánea de copia de seguridad está habilitada, el 3C Release Manager creará primero una instantánea que contiene todos los elementos que se modificarán durante el proceso de despliegue. Una vez hecho esto, comenzará con el primer paso.
Si no hay pasos manuales ni puntos de interrupción establecidos en los pasos, cada paso se realizará automáticamente y luego se creará una instantánea de validación de los cambios. Si el proceso de despliegue se detiene, se puede continuar mediante el botón Reanudar o bien detener todo el proceso mediante el botón Cancelar correspondiente.
Si el proceso está en pausa, los pasos de despliegue se pueden repetir o saltar, e incluso se pueden añadir puntos de interrupción adicionales.
Funciones:
- Pausa: pausa el proceso de despliegue
- Reanudar: reanuda un proceso de despliegue pausado
- Cancelar: botón de pánico — detiene por completo el proceso de despliegue y pone el despliegue en estado Cancelado
Tarjetas de pasos de despliegue:
- Número: el número de orden del paso
- Estado: DONE, WAITING, IN_PROGRESS, ERROR
- ID: ID del paso de despliegue
- Tipo: Automático o manual
- Objeto: el tipo de objeto
- Código: el código del objeto
- Tipo de configuración: XML o JSON
- Título: el título del cambio
- Lista de ejecución: si el paso ya se ha realizado, el registro de ejecución se mostrará aquí
- Detalles: muestra los detalles y notas del paso
- Repetir: solo visible si el proceso está en pausa — 3C intentará ejecutar de nuevo el mismo paso
- Saltar: solo visible si el proceso está en pausa — 3C no realizará el paso
- Terminar: solo visible para pasos manuales — el usuario tiene que terminar la tarea manualmente antes de que se reanude el proceso
Ventana de detalles de ejecución
Muestra los detalles de la ejecución de un paso de despliegue.
Campos: Número de ejecución (1 si no hubo repeticiones), Estado de la ejecución (SUCCESS o ERROR), Hora de inicio, Hora de finalización, Resultado (OK si se ejecutó correctamente; de lo contrario, el mensaje de error del sistema externo), Solicitud (la configuración que se utilizó para el despliegue).
Pestaña Validación
Solo visible una vez que se haya completado el despliegue. Esta pantalla recopila los detalles de la instantánea de copia de seguridad (Backup Snapshot), la instantánea de validación (Validation Snapshot) y la diferencia de validación (Validation Diff) en un solo lugar. Si todo salió bien, los análisis de diferencias deberían mostrar exactamente lo que se pretendía desplegar en el entorno de destino.
Funciones:
- Revertir: en caso de error o de un despliegue sin éxito, use el botón Revertir. Creará un Despliegue de Reversión especial que es exactamente lo opuesto al despliegue actual, revirtiendo el estado de los objetos mediante la Instantánea de Copia de Seguridad. Después de su creación, el Despliegue de Reversión funciona como un despliegue estándar y debe iniciarse manualmente.
Historias de usuario
Las historias de usuario sirven como contenedor lógico para los cambios relacionados con un requisito de negocio. La forma recomendada de usar el 3C Release Manager es:
- Defina las historias de usuario en el sistema, muy probablemente procedentes de un sistema externo de gestión de historias de usuario
- Cree una instantánea del entorno de desarrollo antes de que comience el desarrollo
- Cree una instantánea del entorno de desarrollo después de que finalice el desarrollo
- Cree un análisis de diferencias entre las dos instantáneas
- A partir de las diferencias, recopile los cambios individuales y vincúlelos a las historias de usuario. De esta manera, el equipo entenderá claramente por qué se realizó cada cambio de configuración y qué requisitos de negocio se ven afectados.
Más tarde, las historias de usuario se pueden agregar a los despliegues para mover los cambios al sistema deseado.
Lista de historias de usuario
Funciones: Actualizar, Nueva historia de usuario, Información.
Filtros: Filtro de estado (estados visibles), Selección de sprint, Campo de búsqueda (texto libre en títulos y descripciones).
Campos:
- ID: ID técnico generado
- Nombre: el nombre de la historia de usuario
- Estado: el estado actual (DRAFT, WORK IN PROGRESS, READY FOR DEVELOPMENT, TESTING, DONE, etc.)
- Sprint: el sprint al que está asignada la historia de usuario
- Sistema activo: el sistema al que corresponde el estado actual
- Despliegues: la lista de despliegues de los que forma parte la historia de usuario
- Mostrar: navega a la pantalla de detalles de la historia de usuario
- Eliminar: elimina la historia de usuario
Crear historia de usuario
Esta pantalla se puede usar para crear nuevas historias de usuario en el 3C Release Manager. Tenga en cuenta que las nuevas historias de usuario también se pueden crear desde las páginas de instantáneas y de diferencias.
Campos:
- Nombre del producto: solo visible si la clave de licencia de 3C es válida tanto para Clarity como para Automic
- Nombre: campo de texto libre obligatorio
- Número de historia de usuario: opcional, para almacenar el ID de la historia de usuario en sistemas de seguimiento externos, como Jira
- Enlace externo: opcional, para almacenar el enlace del ticket externo
- Descripción: campo de descripción de texto libre
- Usuario responsable: opcional, el usuario del 3C Release Manager responsable de la historia de usuario
Funciones: Cancelar, Guardar.
Editar historia de usuario
La pantalla contiene 5 pestañas diferentes: Descripción, Contenido, Análisis de conflictos, Despliegue, Actividades.
Pestaña Descripción
Se utiliza para editar los datos básicos de la historia de usuario.
Campos:
- Producto: solo visible si las licencias de Clarity y de Automic son válidas
- ID de la historia: ID técnico generado
- Nombre: campo de texto libre obligatorio
- Número de historia de usuario: opcional, para referencia del sistema de tickets externo
- Enlace externo: opcional, para la URL del ticket externo
- Descripción: texto libre
- Usuario responsable: opcional
- Historia de usuario padre: las historias de usuario se pueden organizar en jerarquías: aquí el usuario puede seleccionar otra historia de usuario como padre de esta
- Historias de usuario hijas: la lista de historias de usuario relacionadas con esta
- Estado: el estado actual (campo informativo)
- Sistema activo: el sistema externo en el que ya están desplegados los cambios de la historia de usuario
- Sprint: control de gestión de sprint para seleccionar un sprint existente o crear uno nuevo mediante un diálogo
- Fecha de creación / Última modificación: marcas de tiempo de solo lectura
Funciones: Cancelar, Guardar.
Pestaña Contenido
El usuario puede administrar el contenido de la historia de usuario: los cambios de configuración reales.
Filtro: Buscar objetos (búsqueda de texto libre en códigos y tipos de objetos).
Campos:
- ID: ID técnico generado del elemento de configuración
- Fuente: el origen desde el que se agregó el objeto o el cambio de objeto (instantánea o elemento de diferencia)
- Tipo de objeto: el tipo del objeto
- Código de objeto: el código del objeto
- Acción: Adición, Eliminación, Cambio, Movimiento o Personalizado (en caso de un paso manual)
- Desplegar XML: muestra el código de configuración del objeto
- Notas: muestra las notas del usuario relacionadas con el objeto
- Eliminar: elimina el objeto de la historia de usuario
Funciones: Añadir desde Instantánea (navega a la lista de instantáneas con la historia de usuario actual seleccionada para añadir), Añadir desde diferencia, Añadir paso manual (agrega un paso personalizado a la lista).
Diálogo de elemento de configuración
Muestra los detalles del elemento de configuración seleccionado, con su código actual y otros metadatos.
Campos: Tipo de origen (Instantánea o Diferencia), ID, Origen del objeto, Código, Tipo de objeto, Origen (la configuración), Descripción, Notas.
Pestaña Análisis de conflictos
Esta lista muestra todas las demás historias de usuario que pueden entrar en conflicto con la actual. Se mostrará cada historia de usuario que contenga cambios para los mismos elementos de configuración. La lista también muestra el objeto en conflicto. Esta función está diseñada para coordinar los cambios de objetos en grupos de desarrollo grandes.
Campos:
- ID de la historia: el ID de 3C de la historia de usuario en conflicto
- Historia de usuario: el nombre de la historia de usuario en conflicto
- Estado: el estado actual de la historia de usuario en conflicto
- Propietario: el propietario de la historia de usuario en conflicto
- Objeto en conflicto: el tipo y el código del objeto contenido en la historia de usuario
- Mostrar: navega a la historia de usuario en conflicto
Pestaña Despliegue
Se utiliza para añadir historias de usuario a los despliegues. También muestra todos los despliegues que contienen la historia de usuario. La forma recomendada de usar el 3C Release Manager es recopilar los cambios en las historias de usuario, y la misma historia de usuario debe añadirse al despliegue del entorno de Pruebas y posteriormente al entorno de Producción.
Campos: ID, Título, Entorno de destino, Estado, Fecha de creación, Mostrar, Eliminar.
Funciones: Selector de despliegue (muestra los despliegues disponibles). Al seleccionar un despliegue, se muestra el botón Añadir a despliegue y, cuando se selecciona la opción – Nuevo despliegue – en la lista, aparece el botón Crear nuevo despliegue para abrir el cuadro de diálogo de creación de despliegues.
Pestaña Actividades
Se utiliza con fines de auditoría: muestra las modificaciones realizadas en la historia de usuario. Aquí también se pueden añadir comentarios manuales.
Actualización y migración
3C Release Manager se actualiza siguiendo las mismas dos variantes que la instalación inicial: manual y guiada. Los ejemplos usan valores genéricos; asegúrese de reemplazarlos por los valores correctos para el entorno de destino del 3C Release Manager.
Actualización — manual
Copie los nuevos archivos WAR a <TOMCAT_HOME>/webapps/:
- threec.war
- threec-auth.war
- threec-backend.war
- threec-frontend.war
Elimine las siguientes carpetas de <TOMCAT_HOME>/work/Catalina/localhost:
- threec
- threec-auth
- threec-backend
- threec-frontend
- Reinicie Apache Tomcat.
- Verifique que el despliegue se haya realizado correctamente mediante los registros de Tomcat y las URL de la aplicación.
Actualización — guiada
Introduzca los siguientes directorios, que deben estar disponibles:
- Directorio HOME de Tomcat (por ejemplo, c:/Automic/Tomcat-3C)
- Directorio HOME de Java (por ejemplo, c:/Program Files/Java/jdk-17)
- Reinicie Apache Tomcat.
- Verifique que el despliegue se haya realizado correctamente mediante los registros de Tomcat y las URL de la aplicación.
Notas de la versión
Versiones recientes del 3C Release Manager y los cambios de cada una.
v3.3.4
| Tipo | Descripción |
|---|---|
| Mejora | Principio de los cuatro ojos |
| Corrección de errores | Correcciones de errores del instalador con interfaz gráfica |
v3.3.3
| Tipo | Descripción |
|---|---|
| Mejora | Instalador con interfaz gráfica añadido |
| Corrección de errores | Varias correcciones de errores |
v3.3.2
| Tipo | Descripción |
|---|---|
| Corrección de errores | Se corrigieron las limitaciones del recuento de objetos — se mejoraron las consultas |
| Mejora | Velocidad de despliegue mejorada |
v3.3.1
| Tipo | Descripción |
|---|---|
| Mejora | Nueva funcionalidad de importación/exportación para admitir la importación y exportación de archivos ZIP de instantáneas |
| Mejora | Análisis mejorado de importación JSON y XML para manejar estructuras de blueprint y preservar la identidad de los objetos |
| Mejora | Manejo refinado de las marcas de tiempo de inicio y fin de las instantáneas durante la importación |
v3.3.0
| Tipo | Descripción | Notas |
|---|---|---|
| Mejora | Roles personalizados añadidos | |
| Mejora | Gestión de blueprints de 3C | Compatibilidad con Clarity 16.3.3 |
| Mejora | Subpestañas en el módulo Blueprint | Compatibilidad con Clarity 16.3.3 |
| Corrección de errores | Correcciones menores de errores para estabilidad y mantenibilidad |
Preguntas frecuentes
Haga clic en cualquier pregunta para ver la respuesta.
¿Qué es 3C Release Manager y qué hace?
3C Release Manager es una herramienta de transporte, comparación y despliegue para Automic Automation que revoluciona la forma en que las configuraciones se mueven entre los entornos DEV, TEST, UAT y PROD. Amplía el Transport Case estándar de Automic con captura de configuraciones basada en instantáneas, análisis de diferencias entre entornos y puntos en el tiempo, paquetes de despliegue con reversión automática, agrupación de cambios basada en historias de usuario y sincronización opcional con Git.
3C Release Manager se ejecuta como una aplicación web Java/Spring en Apache Tomcat con un backend PostgreSQL y se integra con Automic Automation Engine V21 o superior a través de la API de Java sobre TLS.
¿Qué versiones de Automic son compatibles?
3C Release Manager requiere Automic Automation Engine V21 o superior. La integración utiliza la API de Java de Automic mediante una comunicación protegida con TLS. Necesita uno o varios clientes de Automic configurados por instancia y certificados compatibles con TLS.
El 3C Release Manager también soporta Clarity PPM como sistema de destino alternativo si su licencia incluye el módulo Clarity; ambos se pueden gestionar desde la misma instancia de 3C.
¿Cuáles son los requisitos técnicos para instalar el 3C Release Manager?
El 3C Release Manager es independiente de la plataforma y se puede implementar en Microsoft Windows (64 bits) o Linux (64 bits, cualquier distribución moderna con soporte del fabricante, como RHEL, Rocky Linux, Ubuntu LTS). Los componentes requeridos son:
- Java 21 (Open Edition / OpenJDK)
- Apache Tomcat 10 con HTTPS/TLS habilitado
- PostgreSQL 15 con conectividad JDBC
- Acceso de red desde el backend de 3C a sus instancias de Automic
- Certificados compatibles con TLS para la comunicación con Automic
¿Cómo se almacenan las contraseñas?
Para los usuarios de 3C, las contraseñas se almacenan en formato hash. Para los entornos externos (instancias de Automic), la contraseña se almacena con cifrado bidireccional: esto es necesario para que 3C pueda conectarse al sistema externo en nombre del usuario técnico configurado.
¿Cuáles son el nombre de usuario y la contraseña predeterminados después de la instalación?
Las credenciales predeterminadas del superusuario después de una instalación nueva son: nombre de usuario super, contraseña super. Cambie esta contraseña inmediatamente después del primer inicio de sesión a través de la página Mi Perfil.
¿Cuál es la diferencia entre una instantánea y una diferencia?
Una instantánea es una representación de la configuración de un entorno Automic en un momento específico. 3C se conecta al entorno y descarga cada objeto de configuración basándose en los filtros configurados. Las instantáneas sirven como historial de configuración, copias de seguridad del sistema y origen de los paquetes de despliegue.
Una diferencia es una comparación entre dos instantáneas, o entre dos entornos, en cuyo caso 3C crea las instantáneas sobre la marcha. Las diferencias revelan qué difiere entre el origen y el destino: objetos recién creados, eliminados, modificaciones y movimientos. Suelen ser el punto de partida para definir el alcance de un despliegue.
¿Por qué mi primera instantánea tarda tanto en comparación con las posteriores?
El 3C Release Manager exporta y guarda los objetos de forma incremental. La primera instantánea de un entorno nuevo debe descargar todos los objetos de configuración, lo cual lleva tiempo. Cada instantánea subsiguiente solo almacena los objetos que han cambiado desde la instantánea anterior, lo que reduce significativamente tanto el tiempo de ejecución como el consumo de la base de datos.
Para acelerar las instantáneas en general, considere configurar filtros que excluyan tipos de configuración irrelevantes, de modo que solo se capturen los objetos importantes.
¿Cómo funciona la reversión si falla un despliegue?
Cada despliegue crea automáticamente una Instantánea de copia de seguridad antes de ejecutarse, que contiene todos los elementos que se modificarán durante el proceso de despliegue. Después del despliegue, se crea una Instantánea de validación para verificar los cambios.
Si algo sale mal, la pestaña Validación proporciona un botón Revertir. Crea un Despliegue de Reversión especial, exactamente opuesto al despliegue original, que restaura los objetos afectados a partir de la Instantánea de copia de seguridad. La reversión funciona como un despliegue estándar y debe iniciarse manualmente.
¿Pueden varios equipos de desarrollo trabajar en paralelo sin sobrescribir los cambios de los demás?
Sí. El apartado Análisis de Conflictos en cada historia de usuario lista automáticamente todas las demás historias de usuario que contienen cambios para los mismos elementos de configuración. La vista muestra qué objeto en conflicto se ve afectado, quién es el propietario de la historia en conflicto y su estado actual, y le permite navegar directamente a la historia en conflicto.
Esta función está diseñada específicamente para coordinar los cambios de objetos en grupos de desarrollo grandes, en los que, de lo contrario, el trabajo en paralelo sobre los mismos objetos de Automic provocaría sobrescrituras inadvertidas durante el despliegue.
¿Cómo integro 3C con Git (GitHub o Bitbucket)?
La integración con Git en el 3C Release Manager se configura en dos pasos:
1. Configuración de Git a nivel de inquilino. Un administrador configura la URL del repositorio Git y el método de conexión (Credenciales con nombre de usuario/contraseña, o SSH con clave privada) en Administración → Configuración de Git. El usuario técnico debe tener permisos de commit y push en el repositorio.
2. Sincronización de Git por entorno. En la pestaña Configuración de Git de cada entorno, establezca un nombre de rama (se crea automáticamente si no existe) y active Sincronización de Git habilitada. A partir de entonces, cada instantánea exitosa escribe la configuración en el sistema de archivos y confirma/envía automáticamente los cambios a la rama configurada.
¿Qué sucede con los objetos en el historial cuando se eliminan del sistema externo?
Los objetos eliminados permanecen visibles en el historial de 3C gracias a las instantáneas anteriores que los capturaron. Todavía puede acceder a su configuración anterior a través de la vista Historial de la lista de objetos, aunque el objeto ya no exista en la instancia de Automic de origen. Esto convierte a 3C en una fuente fiable de auditoría e investigación forense, incluso para objetos que se han eliminado del sistema en ejecución.
¿Cómo puedo realizar cambios masivos (por ejemplo, renombrar hosts) durante un despliegue?
El 3C Release Manager soporta cambios masivos basados en reglas durante el despliegue utilizando la misma sintaxis que la utilidad AEDB Change de Automic. Puede definir conjuntos de reglas en dos niveles:
- Por entorno — en la pestaña Reglas de despliegue del entorno. Estas reglas se copian como predeterminadas en cualquier nuevo despliegue que tenga como destino ese entorno.
- Por despliegue — en la pestaña Reglas del despliegue. El conjunto de reglas predeterminado del entorno se copia aquí automáticamente y puede editarse o eliminarse.
Cuando se ejecuta un despliegue, las reglas se aplican automáticamente a cada objeto antes de que se escriba en el sistema de destino. Utilice el botón Validar para comprobar si el conjunto de reglas tiene errores de sintaxis antes de guardarlo.
¿Cómo consulto el tamaño de la base de datos y cuál es el crecimiento esperado?
Para comprobar el tamaño de la base de datos, use la línea de comandos de PostgreSQL:
O use esta consulta SQL:
Valor de referencia: 20 MB es el tamaño típico para 1 instantánea de 2.600 elementos de configuración (con un filtro de 2 idiomas) más 5 diferencias con aproximadamente 300 cambios en cada una.
¿Cómo funciona el principio de los cuatro ojos para las liberaciones de transporte?
El principio de los cuatro ojos se introdujo en la versión 3.3.4 del 3C Release Manager para dar soporte a entornos donde las acciones de transporte requieren trazabilidad explícita, típicamente en industrias reguladas u organizaciones de TI con control de cambios. Requiere que un segundo usuario apruebe las liberaciones de transporte antes de que puedan ejecutarse, asegurando que ningún individuo pueda desplegar cambios en un entorno de destino sin supervisión.
En combinación con el registro de auditoría (que recoge cada acción importante del sistema con usuario, marca de tiempo y módulo), ofrece la trazabilidad que exigen los entornos sujetos a requisitos de cumplimiento normativo.