Versión actual
v3.4.1
Action Pack · Automic
Guía completa · Action Pack

3C Release Manager — instalar, configurar y operar

Guía completa del 3C Release Manager — la referencia completa para instalar, configurar y operar las herramientas de instantáneas, diferencias, despliegues y gobernanza del 3C Release Manager para Automic Automation V24+.

Versión
3.4.1
Compatible con
Automic AE V24+
Pila tecnológica
Java 21 · Tomcat 10 · PG 15
Despliegue
Local (on-premise) / SaaS
Contenidos
  1. Alcance técnico y arquitectura
  2. Instalación — requisitos previos, instalación manual y guiada
  3. Configuración — puerta de enlace, autenticación, back-end, configuración del sistema en la aplicación
  4. Uso — administración, entornos, instantáneas, diferencias, despliegues, historias de usuario
  5. Actualización y migración
  6. Notas de la versión
  7. Preguntas frecuentes
Vídeo de instalación

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.

1 · Alcance técnico

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

Diagrama de la arquitectura de 3 niveles del 3C Release Manager
3C Release Manager — arquitectura de aplicación web de 3 niveles desplegada en una pila tecnológica basada en Java con integraciones externas seguras con Automic.

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

2 · Instalación

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.

PASO 1
Obtener paquete de instalación
  • 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).
PASO 2
Preparación de la base de datos (PostgreSQL)

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.

CREATE USER db3cuser WITH PASSWORD ‘<secure_password>’ NOSUPERUSER INHERIT NOCREATEDB NOCREATEROLE NOREPLICATION;

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.

CREATE DATABASE threec WITH OWNER = db3cuser ENCODING = ‘UTF8’ TABLESPACE = pg_default CONNECTION LIMIT = -1 TEMPLATE = template0 LC_COLLATE = ‘C’ LC_CTYPE = ‘C’;
PASO 3
Desplegar archivos WAR de aplicación

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.

PASO 4
Copiar archivos de configuración de la aplicación

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 fuenteUbicació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
PASO 5
Configuración del contexto de la aplicación

Puerta de enlace. Ajustar <TOMCAT_HOME>/appconf/threec/application-prod.properties

ParámetroValor
logging.config<TOMCAT_HOME>/appconf/threec/logback.xml
spring.cloud.gateway.mvc.routes[0].urihttp://<TOMCAT_HOST>:<PORT>
spring.cloud.gateway.mvc.routes[1].urihttp://<TOMCAT_HOST>:<PORT>
spring.cloud.gateway.mvc.routes[2].urihttp://<TOMCAT_HOST>:<PORT>
spring.cloud.gateway.mvc.routes[3].urihttp://<TOMCAT_HOST>:<PORT>
spring.cloud.gateway.mvc.routes[4].urihttp://<TOMCAT_HOST>:<PORT>

Autenticación. Ajustar <TOMCAT_HOME>/appconf/threec-auth/application-prod.properties

ParámetroValor
logging.config<TOMCAT_HOME>/appconf/threec-auth/logback.xml
capture.authorization.gateway-urihttp://<TOMCAT_HOST>:<PORT>
spring.datasource.urljdbc:postgresql://<PG_HOST>:<PORT>/<DBNAME>
spring.datasource.username<DBUSER>
spring.datasource.password<DBPASSWORD>

Backend. Ajustar <TOMCAT_HOME>/appconf/threec-backend/application-prod.properties

ParámetroValor
logging.config<TOMCAT_HOME>/appconf/threec-backend/logback.xml
spring.datasource.urljdbc:postgresql://<PG_HOST>:<PORT>/<DBNAME>
spring.datasource.username<DBUSER>
spring.datasource.password<DBPASSWORD>
spring.security.oauth2.resourceserver.jwt.jwk-set-urihttp://<TOMCAT_HOST>:<PORT>/threec-auth/oauth2/jwks
PASO 6
Configuración del contexto de Tomcat

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

<Context> <Parameter name=”spring.config.location” value=”<TOMCAT_HOME>/appconf/threec/application-prod.properties” override=”false”/> </Context>

threec-auth.xml

<Context> <Parameter name=”spring.config.location” value=”<TOMCAT_HOME>/appconf/threec-auth/application-prod.properties” override=”false”/> </Context>

threec-backend.xml

<Context> <Parameter name=”spring.config.location” value=”<TOMCAT_HOME>/appconf/threec-backend/application-prod.properties” override=”false”/> </Context>
PASO 7
Finalización
  • 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.

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.
PASO 1
Iniciar instalador
Inicie el instalador del 3C Release Manager desde la línea de comandos ejecutando install3c.bat.
Ventana del símbolo del sistema del instalador 3C con el mensaje Welcome to 3C v3.3.5 installer
Paso 1 — Iniciar el instalador. Al ejecutar install3c.bat se abre la ventana del símbolo del sistema del instalador.
PASO 2
Configuración de directorios

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)
Solicitud de configuración de directorios del instalador 3C para los directorios HOME de Tomcat, Java y PostgreSQL
Paso 2 — Configuración de directorios. El instalador solicita los directorios HOME de Tomcat, Java y PostgreSQL.
PASO 3
Configuración de la base de datos

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)
El instalador 3C solicita la configuración de la base de datos: nombre de la base de datos, host, puerto, usuario y contraseña
Paso 3 — Configuración de la base de datos. El instalador solicita el nombre de la BD, el host, el puerto, el usuario y la contraseña del usuario de la BD (no la contraseña maestra de postgres).
PASO 4
Creación de la base de datos
Decida si se debe crear una nueva base de datos (Y/N) e introduzca la contraseña maestra de postgres. Después de introducir la contraseña maestra, la creación y la migración de la BD comienzan inmediatamente. La creación del usuario de la BD se omitirá si ya existe.
Paso de creación de la base de datos del instalador 3C con la contraseña maestra de postgres y la migración CREATE DATABASE
Paso 4 — Creación de la base de datos. Después de confirmar Y e introducir la contraseña maestra de postgres, el instalador crea el esquema y ejecuta la migración.
PASO 5
Importación de la licencia
Decida si se debe importar una clave de licencia (Y/N). Esta importación requiere un archivo válido license_data.txt dentro de la carpeta del instalador. Si no está disponible, Tricise puede proporcionar el archivo correspondiente.
Paso de importación de clave de licencia del instalador 3C con LICENSE UPDATE READY
Paso 5 — Importación de licencia. El instalador importa la clave de licencia del archivo license_data.txt.
PASO 6
Configuración de Tomcat
Introduzca la configuración de Tomcat sobre el nombre de dominio y el puerto a utilizar (por ejemplo, http://localvm:8061).
Solicitud de configuración de Tomcat del instalador 3C, que pide el nombre de dominio y el puerto del servidor
Paso 6 — Configuración de Tomcat. El instalador solicita el nombre de dominio y el puerto de Tomcat.
PASO 7
Despliegue de la aplicación
El instalador copia los archivos WAR a las carpetas correspondientes de Tomcat.
Paso de despliegue de la aplicación del instalador 3C: COPYING FILES copia los archivos WAR a Tomcat
Paso 7 — Despliegue de la aplicación. El instalador copia los cuatro archivos WAR en <TOMCAT_HOME>/webapps.
PASO 8
Creación de archivos de configuración
El instalador crea los archivos de configuración para las aplicaciones Tomcat de 3C correspondientes.
Paso de creación de archivos de configuración del instalador 3C: CREATING CONFIGURATION FILES
Paso 8 — Creación de archivos de configuración. El instalador crea application-prod.properties para los módulos gateway, auth y backend.
PASO 9
Instalación del servicio de Windows
Decida si desea instalar Tomcat 3C como servicio de Windows (Y/N). Después de este paso final, la instalación habrá terminado.
Pantalla INSTALLATION READY del instalador 3C con la pregunta sobre el servicio Tomcat y las credenciales predeterminadas del superusuario
Paso 9 — Instalación del servicio de Windows. Después de responder a la pregunta sobre el servicio Tomcat, el instalador muestra las credenciales predeterminadas del superusuario y finaliza con INSTALLATION READY.
PASO 10
Finalización
  • 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.


3 · Configuración

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ámetroDescripción
logging.configPropiedad 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.nameEstablece el nombre lógico de la aplicación Spring. Predeterminado: 3c-gateway
spring.cloud.gateway.mvc.routes[N].idDefine un ID de ruta para Spring Cloud Gateway (basado en MVC).
spring.cloud.gateway.mvc.routes[N].uriEspecifica 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ámetroDescripción
logging.configRuta al archivo de configuración de Logback.
spring.datasource.driverClassNameClase del controlador JDBC utilizada para conectarse a PostgreSQL. Predeterminado: org.postgresql.Driver
spring.datasource.urlURL de conexión JDBC para la base de datos. Ejemplo: jdbc:postgresql://localhost:5432/db3c
spring.datasource.usernameNombre de usuario que utiliza la aplicación para autenticarse con PostgreSQL.
spring.datasource.passwordContraseña utilizada por la aplicación para autenticarse con PostgreSQL.
capture.authorization.gateway-context-pathDefine la ruta de contexto en la que la puerta de enlace expone la aplicación. Predeterminado: /threec
capture.authorization.gateway-uriURL base del servicio de puerta de enlace de autorización.
capture.authorization.rsa-keyContiene 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ámetroDescripción
logging.configCarga 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ámetroDescripción
spring.jackson.mapper.default-view-inclusionHabilita 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-strategySerializa/deserializa propiedades JSON en SNAKE_CASE (por ejemplo, created_at) en lugar de camelCase.
spring.data.web.pageable.one-indexed-parametersLos 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ámetroDescripción
spring.datasource.driverClassNameClase del controlador JDBC para PostgreSQL.
spring.datasource.urlURL de conexión JDBC.
spring.datasource.usernameUsuario de base de datos utilizado por la aplicación.
spring.datasource.passwordContraseña de la base de datos utilizada por la aplicación.
spring.datasource.hikari.pool-nameNombre del pool Hikari (aparece en logs/métricas). Predeterminado: db-pool
spring.datasource.hikari.maximum-pool-sizeNúmero máximo de conexiones a la base de datos en el pool. Predeterminado: 30
spring.datasource.hikari.minimum-idleNúmero mínimo de conexiones inactivas que se mantienen disponibles. Predeterminado: 1
spring.datasource.hikari.idle-timeoutTiempo (ms) que una conexión inactiva puede permanecer antes de cerrarse (cuando se supera minimum-idle). Predeterminado: 30000
spring.datasource.hikari.connection-timeoutTiempo máximo (ms) de espera para obtener una conexión del pool antes de fallar. Predeterminado: 5000
spring.datasource.hikari.max-lifetimeDuració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-platformIndica a Hibernate qué dialecto SQL utilizar. Predeterminado: org.hibernate.dialect.PostgreSQLDialect
spring.jpa.open-in-viewDeshabilita “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_strategyEstrategia 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-orderPermite 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ámetroDescripción
spring.security.oauth2.resourceserver.jwt.jwk-set-uriURL donde la aplicación obtiene el conjunto JWK (claves públicas) para verificar las firmas JWT.
capture.authorization.rsa-keyMaterial de clave RSA (a menudo un blob similar a JWK/JWKS) utilizado para firmar/verificar en flujos de autorización.
capture.encryption.secret.keySecreto de cifrado de la aplicación (utilizado para cifrar datos sensibles / tokens / valores de configuración según la implementación).
capture.encryption.saltSal utilizada con hashing/derivación de claves (ayuda a proteger contra ataques de tabla arcoíris).
server.servlet.session.cookie.secureMarca 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ámetroDescripción
capture.license.server.urlPunto final del servidor de licencias (vacío → no establecido, deshabilitado o proporcionado en otro lugar).
capture.system.cache-time-to-liveTTL para una caché interna en segundos. Predeterminado: 86400 (24 horas).

XOG (comunicación con sistemas externos)

ParámetroDescripción
capture.xog.timeout-in-secondsTiempo de espera de las solicitudes para las llamadas XOG. Predeterminado: 300
capture.xog.connection-timeout-in-secondsTiempo de espera de establecimiento de conexión para llamadas XOG. Predeterminado: 20
capture.xog.http-buffersize-bytesTamaño del búfer HTTP en bytes. Predeterminado: 33554432 (≈ 32 MiB). Útil para cargas de datos grandes.
capture.xog.soap-cache-time-to-liveTTL para la caché relacionada con SOAP en segundos. Predeterminado: 60

Planificador y ejecución de tareas

ParámetroDescripción
capture.scheduler.enabledActiva/desactiva el planificador de la aplicación.
capture.worker.settings.refresh.intervalFrecuencia con la que se actualiza la configuración de los agentes de trabajo (ms). Predeterminado: 30000 (30 segundos).
capture.task.execution.pool.core-sizeNúmero de hilos de trabajo base (core). Predeterminado: 30
capture.task.execution.pool.max-sizeNúmero máximo de hilos permitidos bajo carga. Predeterminado: 60
capture.task.execution.pool.queue-capacityTamañ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-aliveCuánto tiempo se mantienen activos los hilos adicionales (no core) (a menudo en segundos). Predeterminado: 10
spring.task.scheduling.pool.sizeEl 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ámetroDescripción
capture.limit.parallel.diffNúmero máximo de trabajos de diferencias en paralelo. Predeterminado: 10
capture.limit.parallel.snapshotNúmero máximo de trabajos de instantáneas en paralelo. Predeterminado: 4
capture.interval.diff.populator.agentIntervalo del agente de llenado de diferencias (ms). Predeterminado: 300000
capture.interval.diff.worker.agentIntervalo del agente de trabajo de diferencias (ms). Predeterminado: 300000
capture.interval.snapshot.populator.agentIntervalo del agente de llenado de instantáneas (ms). Predeterminado: 300000
capture.interval.snapshot.worker.agentIntervalo del agente de trabajo de instantáneas (ms). Predeterminado: 300000
capture.interval.deployment.worker.agentIntervalo del agente de trabajo de despliegues (ms). Predeterminado: 300000
capture.interval.cleanup.worker.agentIntervalo del agente de trabajo de limpieza (ms). Predeterminado: 300000
capture.interval.diff.status.agentIntervalo del agente de estado de diferencias (ms). Predeterminado: 30000
capture.interval.snapshot.status.agentIntervalo del agente de estado de instantáneas (ms). Predeterminado: 30000

Watchdog

ParámetroDescripción
capture.watchdog.external-internalSelecciona el modo de watchdog interno frente a externo. Para instalaciones locales (on-premise): INTERNAL
capture.watchdog.snapshot-intervalIntervalo del watchdog de instantáneas (ms). Predeterminado: 1800000
capture.watchdog.diff-intervalIntervalo del watchdog de diferencias (ms). Predeterminado: 1800000

Integración con AWS (deshabilitada por defecto en instalaciones locales)

ParámetroDescripción
spring.cloud.aws.sqs.enabledDeshabilita la autoconfiguración/integración de AWS SQS cuando se establece en false.
spring.cloud.aws.sns.enabledDeshabilita la autoconfiguración/integración de AWS SNS cuando se establece en false.
cloud.aws.region.autoDeshabilita la detección automática de región cuando se establece en false.
cloud.aws.region.staticEstablece explícitamente la región de AWS. Predeterminado: eu-central-1 (Fráncfort).

Ciclo de vida del servidor y manejo de errores

ParámetroDescripción
server.shutdownHabilita el apagado ordenado cuando se establece en graceful (deja de aceptar nuevas solicitudes, finaliza el trabajo en curso).
spring.lifecycle.timeout-per-shutdown-phaseTiempo permitido por fase de apagado antes de forzar la terminación. Predeterminado: 3s
server.error.include-messageIncluye 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

Pantalla Configuración del sistema de 3C con el número de agentes internos para instantáneas, diferencias, despliegues y limpieza
La pantalla Configuración del sistema de la aplicación: número de agentes internos para instantáneas, diferencias, despliegues y limpieza.

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 .

Advertencia. Esta pantalla solo es accesible con un usuario que tenga el rol SUPERUSER. Modificar estos valores puede afectar al rendimiento y la estabilidad del 3C Release Manager y también de los sistemas externos conectados. Póngase en contacto con el soporte técnico de Tricise para el 3C Release Manager antes de modificar estos valores.

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
Cámbiela inmediatamente. Cambie siempre la contraseña predeterminada del superusuario inmediatamente después del primer inicio de sesión.

4 · Uso

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

Diseño principal de la interfaz de usuario web de 3C con los elementos de la interfaz numerados del 1 al 12
La interfaz de usuario web del 3C Release Manager — barra de menú, barra de herramientas del usuario, título de la página, botones de acción, filtros de lista, contenido y paginación.

La interfaz de usuario web del 3C Release Manager contiene los siguientes elementos:

  1. Barra de menú
  2. Barra de herramientas del usuario
  3. Título de la página
  4. Botones de acción de página
  5. Información y ayuda
  6. Acciones especiales relacionadas con el contenido
  7. Controles de filtro de lista
  8. Contenido de la lista
  9. Paginación
  10. Elementos de la lista: por lo general, los campos ID y Título abren la vista de detalle
  11. Acciones del elemento de la lista, como editar, eliminar
  12. Control de recuento de registros

Barra de herramientas del usuario

Submenú de perfil de la barra de herramientas de usuario de 3C con las entradas “Logged in as SUPER” y “Logout”
Al hacer clic en el icono de perfil de la esquina superior derecha se abre el submenú de usuario con “Logged in as username” y “Logout”.

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ú

Estructura del menú principal de 3C con el submenú Administración abierto, que muestra Inquilinos, Usuarios, Configuración del Sistema, Configuración de Git, Registro de Auditoría y Configuración de Licencia
El menú principal de 3C — Inicio, Entornos, Instantáneas, Diferencias, Despliegues, Historias de Usuario y el submenú Administración.

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

Pantalla de inicio de sesión de 3C con los campos de nombre de usuario y contraseña y la casilla de verificación Recordarme
La pantalla de inicio de sesión de 3C — nombre de usuario, contraseña y la casilla de verificación opcional “Recordarme”.

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.

Nota. El sistema no ofrece la posibilidad de autorregistro. Para crear nuevos usuarios, utilice el usuario administrador proporcionado y cree manualmente los usuarios necesarios.

Cierre de sesión

Barra de herramientas del usuario de 3C que muestra la acción de cierre de sesión
La acción Cierre de sesión de la barra de herramientas del usuario: al hacer clic en ella, se redirige a la pantalla de inicio 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

Página Mi Perfil de 3C con las secciones Datos principales, Cambiar contraseña y Mis roles
La página Mi Perfil — secciones Datos principales, Cambiar contraseña y Mis roles.

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

Submenú del icono de cuenta de la barra de herramientas del usuario de 3C con Logged in as SUPER
Acceda a la página Mi Perfil seleccionando el icono de la cuenta y haciendo clic en “Logged in as username”.

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

Formulario de datos principales de Mi Perfil en 3C con los campos editables Nombre, Apellido y Correo electrónico
Editar información personal — cambiar Nombre, Apellido y dirección de correo electrónico. El LoginID es de solo lectura.

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
Nota. El nombre de usuario (LoginID) no puede ser modificado por los usuarios finales.

Después de editar, haga clic en el botón Guardar . Si se guarda correctamente, se muestra un mensaje de notificación.

Notificación emergente de 3C: Perfil actualizado
Después de guardar, aparece una notificación de Perfil actualizado.

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.

Notificación emergente de 3C: Contraseña cambiada
Después de cambiar la contraseña, aparece una notificación de Contraseña cambiada.

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

Lista de inquilinos de 3C que muestra el inquilino DEFAULT e información de licencia
La lista de inquilinos — inquilino DEFAULT con estado de licencia y módulos con licencia.

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.

Pantalla Crear inquilino de 3C con los campos Nombre del inquilino y Descripción
La pantalla Crear inquilino: Nombre del inquilino (obligatorio) y Descripción en texto libre.

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.

Pantalla Editar inquilino de 3C con las secciones Datos principales, Datos de licencia y Datos de uso
La pantalla Editar inquilino — Datos principales (ID del inquilino de solo lectura, Nombre y Descripción editables), Datos de licencia y Datos de uso.

Usuarios

Lista de usuarios de 3C con LoginID, nombres, correos electrónicos, inquilinos e indicador de activo
La lista de Usuarios — LoginID, nombre, correo electrónico, asignación de inquilino y estado activo.

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.

Pantalla Crear usuario de 3C con todos los campos obligatorios
La pantalla Crear usuario: LoginID, nombres, correo electrónico, indicador activo y contraseña inicial. Los roles 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.

Pantalla Editar usuario de 3C con las secciones de datos principales, cambio de contraseña y roles activos
La pantalla Editar Usuario: datos principales, cambio de contraseña y asignación de rol activo. El LoginID no se puede cambiar.

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

Pantalla de configuración de Git a nivel de inquilino de 3C
Configuración de Git a nivel de inquilino: URL del repositorio, credenciales o clave SSH, y prueba de conexión.

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

Tabla Registro de Auditoría de 3C con marcas de tiempo, niveles de registro y módulos
El Registro de Auditoría — ID de registro, ID de inicio de sesión, nivel (INFO/WARNING/ERROR), marca de tiempo, mensaje y módulo.

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

Pantalla Configuración de licencia de 3C con validez, caducidad y módulos con licencia
La pantalla Configuración de licencia: validez, propietario, caducidad, límite de entornos y módulos con 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
Nota. Usar claves de licencia incorrectas puede inutilizar 3C. Utilice solo las claves proporcionadas por Tricise.

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

Lista de entornos de 3C con tipo, host, cliente, estado de conexión y marcas de tiempo de instantáneas
La lista de entornos: conexiones con tipo, host, cliente, estado de la conexión y marcas de tiempo de la última/siguiente instantánea.

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.
Advertencia. Eliminar un entorno también elimina todas las instantáneas y diferencias asociadas.

Crear entorno

Pantalla Crear entorno de 3C con parámetros del sistema y credenciales
La pantalla Crear entorno — parámetros del sistema, direcciones del servidor, certificado y credenciales del usuario técnico.

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.
Importante. El 3C Release Manager usará la primera URL que funcione e intentará usarla también la próxima vez. Si añade cadenas de conexión a distintas instancias de Automic, los datos de las instantáneas podrían ser incoherentes en el futuro.

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

Pestaña Base de Editar entorno en 3C con metadatos de conexión
La pestaña Base — título, direcciones del servidor, tipo de entorno, número de cliente, nombre de usuario, departamento y descripción.

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

Pestaña Conexión de Editar entorno en 3C con indicadores de estado de conexión
La pestaña Conexión — indicador conectado, mensaje de error, estado inicializado y estado de la conexión REST.

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

Pestaña Credenciales de Editar entorno en 3C con opción de almacenamiento de contraseña
La pestaña Credenciales — el interruptor Guardar contraseña y el campo de contraseña con el cuadro de diálogo del certificado.

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

Lista de trabajos programados de Editar entorno en 3C con indicador de activo, diferencias automáticas y próxima ejecución
La lista de trabajos programados: título, indicador activo, diferencias automáticas, última/próxima ejecución y recuento de ejecuciones.

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

Diálogo Nueva programación de 3C con título, hora de copia de seguridad, zona horaria y ajustes de frecuencia
El diálogo Nueva programación — título, descripción, diferencias automáticas, filtro, hora de inicio de copia de seguridad (HH:MM), zona horaria y frecuencia (Diaria/Semanal/Mensual/Anual).

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

Diálogo Editar programación de 3C con los mismos campos que Nueva programación
El cuadro de diálogo Editar programación — mismo conjunto de campos que Nueva programación, usado para modificar un trabajo programado existente.

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)

Lista de filtros guardados de 3C para un entorno Automic
La lista de Filtros Guardados: filtros de objetos reutilizables creados a partir de instantáneas personalizadas.

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

Pantalla de lista de objetos de 3C que muestra el catálogo de configuración de un entorno
La lista de objetos: catálogo de configuración del entorno, actualizado después de cada instantánea.

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.

Nota. Si se elimina un objeto del sistema, seguirá figurando en el historial de 3C gracias a las instantáneas anteriores.

Vista del historial

Vista de historial de objetos de 3C con lista de versiones y diferencias de texto
La vista Historial – cada versión anterior del objeto a la izquierda, los cambios reales como diferencia de texto a la derecha.

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

Configuración de sincronización de Git por entorno en 3C con nombre de rama e interruptor Sincronización de Git habilitada
Sincronización de Git por entorno: nombre de rama e interruptor Sincronización de Git habilitada.

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)

Editor de reglas de despliegue por entorno de 3C con sintaxis de AEDB Change
El editor de reglas de despliegue: conjunto de reglas del entorno basado en la sintaxis de la utilidad AEDB Change, con validación.

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)

Pantalla de filtros de 3C (solo Clarity) con categorías de idioma, objeto y otros filtros
La pantalla de filtros (solo Clarity) — filtros de idioma, filtros de objetos y otros filtros XML.

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

Lista de instantáneas de 3C con estado, estadísticas y etiquetas
La lista de instantáneas — entorno, estado (DONE/ERROR/IN_PROGRESS/WAITING), estadísticas de objetos y etiquetas.

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

Pantalla Crear instantánea de 3C con selección de entorno y etiquetas
La pantalla Crear instantánea: título, entorno de origen, descripción, etiquetas e interruptor de instantánea personalizada.

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

Catálogo de configuración de la instantánea personalizada de 3C con carpetas y elementos seleccionables
La vista Instantánea personalizada: catálogo de configuración con selección manual de carpetas/elementos y filtros reutilizables.

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

Creación de una instantánea de 3C en curso, con barra de progreso
Creación de instantánea en curso: barra de progreso que muestra el estado de descarga de cada objeto.

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

Pantalla de detalles de la instantánea de 3C con metadatos y objetos descargados
La pantalla Detalles de la instantánea: metadatos, estado, estadísticas y los elementos de configuración descargados.

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.

Vista de árbol de una instantánea de 3C con controles de selección de Despliegue e Historia de Usuario
Gestión de despliegue / historias de usuario dentro de una instantánea: selección de carpetas y elementos para agregar a un paquete de destino.

Pantalla de detalles del objeto

Pantalla de detalles de un objeto de instantánea de 3C con código de configuración de solo lectura
La pantalla Detalles del objeto: código de configuración, indicadores de cambio/movimiento, referencia de instantánea original y metadatos.

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

Lista de diferencias de 3C con estadísticas de objetos creados, eliminados, modificados y movidos
La lista de diferencias: objetos recién creados en verde, eliminados en rojo, modificados en amarillo, movidos en azul.

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

Pantalla Crear diferencia de 3C con selección de instantánea o entorno de origen y destino
La pantalla Crear diferencia: elija el origen y el destino como instantáneas o entornos, con filtros previos opcionales.

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

Pantalla de detalles de la diferencia de 3C con referencias de instantáneas de origen y destino
La pantalla Detalles de la diferencia: instantánea de origen, instantánea de destino, estado, estadísticas y metadatos.

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.

Vista de árbol de una diferencia de 3C con controles de selección de Despliegue e Historia de Usuario
Gestión de despliegue / historias de usuario dentro de una diferencia — agregar elementos, objetos relacionados o relacionados recursivamente.

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.

Cuidado. La función “Añadir relacionados recursivamente” puede añadir varios elementos más al despliegue a la vez.

Detalles del objeto Diff

Detalles del objeto de diferencia de 3C con las pestañas Origen, Destino y Diferencia para la comparación de XML
La pantalla de Detalles del Objeto de Diff — pestañas Origen, Destino y Diferencia para la comparación de texto XML/JSON.

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

Vista de árbol del análisis de diferencias de 3C con elementos de configuración XML
La vista de análisis: visualización en árbol de los elementos de configuración dentro del XML de un objeto.

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

Lista de despliegues de 3C con estado, tipo y entorno de destino
La lista de Despliegues — estado (DRAFT/PREPARED/IN_PROGRESS/DONE/ERROR), tipo, entorno de destino y fecha de creación.

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

Pantalla Crear paquete de despliegue de 3C con entorno de destino y título
La pantalla Crear paquete de despliegue: entorno de destino, título y descripción.

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

Pestaña Base de Editar despliegue en 3C con historias de usuario y lista de orígenes
La pestaña Base de Editar despliegue: título, destino, estado, historias de usuario y lista de origen (instantáneas y diferencias utilizadas).

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)

Pestaña Reglas de Editar despliegue en 3C con editor de reglas de AEDB Change
La pestaña Reglas — conjunto de reglas por despliegue con la sintaxis de la utilidad AEDB Change.

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

Pestaña Preparar paquete de 3C con pasos de despliegue y lista reordenable
La pestaña Preparar paquete: pasos de despliegue con tipo (Crear/Modificar/Eliminar/Mover/Manual), vista previa de origen y destino.

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).

Nota. Solo se puede modificar el contenido de un despliegue con el estado “Borrador”. Si ya estaba preparado, use primero el botón Establecer como Borrador para desbloquear el contenido.

Diálogo de paso de despliegue

Diálogo Paso de despliegue de 3C con configuración de origen y notas
El cuadro de diálogo Paso de despliegue — tipo de origen, código, tipo de objeto y la configuración que se desplegará.

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

Pestaña Registro de ejecución de 3C durante un proceso de despliegue con tarjetas de estado de los pasos y controles de pausa
La pestaña Registro de ejecución: controles de pausa, reanudación y cancelación con tarjetas de estado por paso.
La pestaña Registro de ejecución de 3C muestra un despliegue completado con éxito con todos los pasos en DONE
Un despliegue exitoso en la pestaña Registro de ejecución — cada paso en estado DONE.

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

Ventana Detalles de ejecución de 3C con hora de inicio, hora de finalización y resultado
La ventana Detalles de ejecución — número de ejecución, estado (SUCCESS/ERROR), tiempos, resultado y configuración de la solicitud.

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

Pestaña Validación de 3C con instantánea de copia de seguridad, instantánea de validación y botón Revertir
La pestaña Validación — instantánea de copia de seguridad, instantánea de validación, diferencia de validación y el botón Revertir.

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

Lista de historias de usuario de 3C con estado, sprint y sistema activo
La lista de historias de usuario: estado, sprint, sistema activo y los despliegues de los que forma parte la historia.

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

Pantalla Crear historia de usuario de 3C con nombre, enlace externo y usuario responsable
La pantalla Crear historia de usuario: nombre, referencia del sistema de tickets externo y usuario responsable.

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

Pestaña Descripción de Editar historia de usuario en 3C con historias de usuario padre e hijas y sprint
La pestaña Descripción — historias de usuario padre/hijas, gestión de sprints y referencias de tickets externos.

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

Pestaña Contenido de Editar historia de usuario en 3C con cambios de configuración de instantáneas y diferencias
La pestaña Contenido: cambios de configuración agregados desde instantáneas y diferencias, con tipo de acción y notas.

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

Diálogo Elemento de configuración de una historia de usuario de 3C con los detalles del elemento de configuración seleccionado
El cuadro de diálogo Elemento de configuración — tipo de origen, código, tipo de objeto y la configuración guardada.

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

Pestaña Análisis de conflictos de una historia de usuario de 3C con las historias de usuario que tienen cambios superpuestos en los mismos objetos
La pestaña Análisis de conflictos: otras historias de usuario que afectan a los mismos elementos de configuración.

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

Pestaña Despliegue de la historia de usuario en 3C con selector de despliegue
La pestaña Despliegue de la historia de usuario — añadir la historia de usuario a despliegues existentes o crear uno nuevo.

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

Pestaña Actividades de la historia de usuario en 3C con modificaciones de auditoría y comentarios manuales
La pestaña Actividades — registro de auditoría de modificaciones con la opción de agregar comentarios manuales.

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.


5 · Actualización y migración

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

PASO 1
Detener Tomcat
Detenga el servicio Apache Tomcat antes de realizar cualquier cambio en los archivos.
PASO 2
Despliegue de WAR

Copie los nuevos archivos WAR a <TOMCAT_HOME>/webapps/:

  • threec.war
  • threec-auth.war
  • threec-backend.war
  • threec-frontend.war
PASO 3
Eliminación de archivos temporales

Elimine las siguientes carpetas de <TOMCAT_HOME>/work/Catalina/localhost:

  • threec
  • threec-auth
  • threec-backend
  • threec-frontend
PASO 4
Finalización
  • 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

PASO 1
Iniciar actualización
Inicie el script de actualización específico.
Símbolo del sistema del instalador de actualización de 3C con el mensaje Welcome to 3C v3.2.0 upgrade installer
Paso 1 — Inicio de la actualización. Al ejecutar upgrade3c.bat se abre el símbolo del sistema del instalador de actualización.
PASO 2
Configuración de directorios

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)
Solicitud de configuración de directorios del instalador de actualización 3C para los directorios HOME de Tomcat y Java
Paso 2 — Configuración de directorios. El instalador de actualización solicita los directorios HOME de Tomcat y Java.
PASO 3
Configuración de Tomcat
Introduzca la configuración de Tomcat sobre el nombre de dominio y el puerto a utilizar (por ejemplo, http://localvm:8061). Después de introducir la configuración de Tomcat, la migración comienza de inmediato.
Solicitud de configuración de Tomcat del instalador de actualización 3C con MIGRATE DATABASE SCHEMA
Paso 3 — Configuración de Tomcat. Después de introducir el host y el puerto de Tomcat, la migración del esquema de la base de datos comienza inmediatamente.
PASO 4
Despliegue de WAR
La eliminación de los archivos antiguos y el despliegue de los nuevos archivos WAR se realizan automáticamente.
Paso de despliegue de WAR del instalador de actualización 3C con REMOVING OLD FILES y COPYING NEW FILES
Paso 4 — Despliegue de WAR. Se eliminan los archivos antiguos y se copian los nuevos archivos WAR en <TOMCAT_HOME>/webapps.
PASO 5
Actualización de configuración
Los archivos de configuración para la aplicación Tomcat se actualizarán automáticamente.
Paso de actualización de la configuración del instalador de actualización 3C: UPDATING CONFIGURATION FILES
Paso 5 — Actualización de configuración. El instalador de actualización reescribe los archivos application-prod.properties para los tres módulos.
PASO 6
Finalización
  • Reinicie Apache Tomcat.
  • Verifique que el despliegue se haya realizado correctamente mediante los registros de Tomcat y las URL de la aplicación.

6 · Notas de la versión

Notas de la versión

Versiones recientes del 3C Release Manager y los cambios de cada una.

v3.3.4

TipoDescripción
MejoraPrincipio de los cuatro ojos
Corrección de erroresCorrecciones de errores del instalador con interfaz gráfica

v3.3.3

TipoDescripción
MejoraInstalador con interfaz gráfica añadido
Corrección de erroresVarias correcciones de errores

v3.3.2

TipoDescripción
Corrección de erroresSe corrigieron las limitaciones del recuento de objetos — se mejoraron las consultas
MejoraVelocidad de despliegue mejorada

v3.3.1

TipoDescripción
MejoraNueva funcionalidad de importación/exportación para admitir la importación y exportación de archivos ZIP de instantáneas
MejoraAnálisis mejorado de importación JSON y XML para manejar estructuras de blueprint y preservar la identidad de los objetos
MejoraManejo refinado de las marcas de tiempo de inicio y fin de las instantáneas durante la importación

v3.3.0

TipoDescripciónNotas
MejoraRoles personalizados añadidos
MejoraGestión de blueprints de 3CCompatibilidad con Clarity 16.3.3
MejoraSubpestañas en el módulo BlueprintCompatibilidad con Clarity 16.3.3
Corrección de erroresCorrecciones menores de errores para estabilidad y mantenibilidad

7 · Preguntas frecuentes

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:

[postgres install folder]\bin\pgsql -U postgres \l+

O use esta consulta SQL:

SELECT t1.datname AS db_name, pg_size_pretty(pg_database_size(t1.datname)) AS db_size FROM pg_database t1 ORDER BY pg_database_size(t1.datname) DESC;

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.

¿Necesita ayuda con 3C en su entorno?
Hable con nuestros expertos sobre instalación, integración, formación o licencias.
Scroll al inicio