Versione attuale
v3.4.1
Action Pack · Automic
Guida completa · Action Pack

3C Release Manager — installazione, configurazione e utilizzo

Guida completa al 3C Release Manager — il riferimento completo per installare, configurare e utilizzare gli strumenti di snapshot, diff, deployment e governance del 3C Release Manager per Automic Automation V24+.

Versione
3.4.1
Compatibile con
Automic AE V24+
Stack
Java 21 · Tomcat 10 · PG 15
Distribuzione
On-premise / SaaS
Indice
  1. Ambito tecnico e architettura
  2. Installazione — prerequisiti, percorsi manuale e guidato
  3. Configurazione — gateway, auth, backend, impostazioni di sistema in-app
  4. Utilizzo — amministrazione, ambienti, snapshot, differenze, deployment, user story
  5. Aggiornamento e migrazione
  6. Note di rilascio
  7. FAQ
Video di installazione

Video (in inglese, 1:45): l’installazione guidata con install3c.bat in nove passaggi, dai prerequisiti al primo accesso.

1 · Ambito tecnico

Architettura e ambito tecnico

Il 3C Release Manager è un'applicazione web a tre livelli distribuita su uno stack tecnologico basato su Java con integrazioni esterne sicure con Automic. Comprendere l'architettura aiuta nel dimensionamento, nella risoluzione dei problemi e nella pianificazione dell'integrazione.

Panoramica dell'architettura

Diagramma dell'architettura a 3 livelli del 3C Release Manager
3C Release Manager — architettura di applicazione web a 3 livelli distribuita su uno stack tecnologico basato su Java con integrazioni esterne sicure con Automic.

Livello di accesso utente

  • Gli utenti finali accedono al sistema tramite HTTPS.
  • Il traffico è crittografato end-to-end utilizzando TLS.
  • Le richieste sono indirizzate al front end web ospitato all'interno dell'ambiente 3C Release Manager.

Livello applicazione

L'applicazione principale è distribuita all'interno di un server applicativo Tomcat e consiste di due componenti principali:

Front End

  • Implementato usando Angular.
  • Servito da Tomcat come parte dell'applicazione 3C Release Manager.
  • Responsabile del rendering dell'interfaccia utente, della logica lato client e della comunicazione con il backend tramite API REST.

Back End

  • Implementato utilizzando Spring (Spring Boot / Spring Framework).
  • Espone un'API RESTful consumata dal front-end Angular e da sistemi esterni (Automic).
  • Gestisce la logica di business, l'autenticazione/autorizzazione e l'accesso al database.
  • La comunicazione tra front end e back end avviene tramite REST.

Livello dati

  • Utilizza PostgreSQL come database relazionale.
  • Il backend si connette al database utilizzando JDBC.
  • Il database memorizza tutti i dati persistenti dell'applicazione 3C Release Manager.

Integrazione di sistema

  • Il sistema si integra con Automic.
  • Supporto per più istanze Automic (sistemi / client).
  • La comunicazione utilizza un'API Java.
  • La sicurezza a livello di trasporto è garantita tramite TLS.
  • Le connessioni vengono avviate dal backend 3C Release Manager ai client Automic.

Panoramica di sicurezza e comunicazione

L'HTTPS/TLS è utilizzato per tutte le comunicazioni esterne: Utente → Front End e Backend → Automic. La comunicazione interna utilizza REST tra frontend e backend e JDBC tra backend e database.

Riepilogo architettura logica

  • Livello di presentazione: Front-end Angular
  • Livello applicativo: Backend basato su Spring su Tomcat
  • Livello dati: Database PostgreSQL
  • Livello di integrazione: Integrazione sicura con Automic tramite API Java

Requisiti e compatibilità

I requisiti tecnici minimi per la distribuzione e l'operatività dell'applicazione 3C Release Manager.

Sistema operativo

Il 3C Release Manager è indipendente dalla piattaforma e può essere distribuito su:

  • Microsoft Windows (64 bit)
  • Linux (64 bit) — qualsiasi distribuzione moderna supportata dal vendor (ad es. RHEL, Rocky Linux, Ubuntu LTS)

Il sistema operativo deve supportare: Java 21, PostgreSQL 15, Apache Tomcat 10, comunicazione di rete protetta da TLS.

Ambiente di esecuzione Java (JRE)

  • Versione minima: Java 21
  • Edizione: Open Edition (OpenJDK)

La JRE è necessaria per eseguire il server applicativo Apache Tomcat e l'applicazione backend del 3C Release Manager (basata su Spring) e per supportare la comunicazione TLS sicura con sistemi esterni (Automic).

Server applicativo

  • Versione minima: Apache Tomcat 10

Tomcat è necessario per ospitare l'applicazione 3C Release Manager, gestire il front-end basato su Angular, eseguire i componenti back-end Java e fornire endpoint REST per la comunicazione interna ed esterna. Tomcat deve essere configurato con compatibilità Java 21, HTTPS/TLS abilitato e impostazioni appropriate relative alla memoria e ai thread per l'uso in produzione.

Database

  • Versione minima: PostgreSQL 15

PostgreSQL viene utilizzato come repository di dati persistente per 3C. Requisiti: connettività JDBC dal backend 3C Release Manager, spazio di archiviazione e prestazioni sufficienti per i dati dell'applicazione, configurazione sicura dell'accesso (autenticazione, restrizioni di rete).

Integrazione di sistemi esterni (Automic)

  • Versione minima: Automic Automation Engine V21

Automic è integrato con 3C tramite API Java e comunicazione sicura TLS. Requisiti: una o più istanze Automic (V21 o superiori), uno o più client Automic configurati per istanza, connettività di rete tra il backend 3C e le istanze Automic, certificati compatibili per la comunicazione TLS.

Rete e sicurezza

HTTPS/TLS deve essere abilitato per l'accesso utente al frontend 3C Release Manager e per la comunicazione backend con Automic.

Porte aperte richieste:

  • Porta HTTPS di Tomcat (tipicamente 443 o personalizzata)
  • Porta di PostgreSQL (predefinita 5432)
  • Porte di comunicazione Automic come definite dall'installazione Automic

2 · Installazione

Installazione

Il 3C Release Manager viene fornito in due varianti di installazione: manuale (controllo completo, adatta ad ambienti air-gapped o sottoposti a hardening) e guidata (script di installazione interattivo install3c.bat, più veloce per configurazioni standard). Entrambe producono lo stesso risultato.

Preferite guardare prima? L’installazione guidata è disponibile anche come video di meno di due minuti.

Controlli pre-installazione

Prima di procedere con l'installazione del 3C Release Manager, assicuratevi che tutti i prerequisiti richiesti siano installati, accessibili e pienamente funzionanti.

Disponibilità di PostgreSQL

  • PostgreSQL è installato sul server del database designato.
  • Il psql è disponibile ed eseguibile come client a riga di comando.
  • È possibile stabilire una connessione al server PostgreSQL utilizzando psql.
  • Il servizio PostgreSQL è in esecuzione e in ascolto sulla porta configurata (predefinita: 5432).
  • Verifica da riga di comando: psql –version

Disponibilità di Java Runtime / Development Kit

  • È installata la versione 17 di JRE o JDK (Open Edition).
  • Il java è disponibile come comando nel PATH di sistema.
  • L'esecuzione di Java funziona e riporta la versione corretta.
  • Il JAVA_HOME è impostato correttamente come variabile d'ambiente (consigliato).
  • Verifica da riga di comando: java -version

Disponibilità di Apache Tomcat

  • È installata la versione 10 di Apache Tomcat.
  • Tomcat è in esecuzione senza errori.
  • Il servizio Tomcat è raggiungibile tramite un URL HTTP da un browser o dalla riga di comando.
  • La porta HTTP/HTTPS configurata è aperta e accessibile.
  • Verifica tramite browser: http://<tomcat_host>:<port>

Installazione — manuale

Eseguite i seguenti passaggi per installare manualmente 3C Release Manager. Gli esempi utilizzano valori generici; assicuratevi che questi vengano sostituiti con i valori corretti per l'ambiente di destinazione.

PASSO 1
Ottenete il pacchetto di installazione
  • Scaricate l'ultimo pacchetto di installazione 3C Release Manager dalla fonte di distribuzione ufficiale.
  • Verificate l'integrità del pacchetto secondo gli standard interni (ad es. checksum, firma).
PASSO 2
Preparazione del database (PostgreSQL)

Create un utente di database dedicato. Create un utente PostgreSQL dedicato per il 3C Release Manager (ad es. db3cuser) con privilegi limitati e le seguenti proprietà: NOSUPERUSER, INHERIT, NOCREATEDB, NOCREATEROLE, NOCREATEREPLICATION.

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

Create un database dedicato. Create il database 3C Release Manager con le seguenti proprietà: Codifica UTF8, Proprietario db3cuser, Tablespace pg_default, Limite di connessione -1 (illimitato), Modello template0, Collation 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’;
PASSO 3
Distribuite i file WAR dell'applicazione

Distribuite i componenti dell'applicazione 3C Release Manager copiando i seguenti file WAR su <TOMCAT_HOME>/webapps/:

  • threec.war
  • threec-auth.war
  • threec-backend.war
  • threec-frontend.war

Tomcat distribuirà automaticamente le applicazioni durante l'avvio.

PASSO 4
Copiate i file di configurazione dell'applicazione

Create le directory di configurazione dell'applicazione richieste, se non esistono già, quindi copiate i file di configurazione del logging:

File sorgentePercorso di destinazione
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
PASSO 5
Configurazione del contesto dell'applicazione

Gateway. Modificate <TOMCAT_HOME>/appconf/threec/application-prod.properties

ParametroValore
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>

Autenticazione. Modificate <TOMCAT_HOME>/appconf/threec-auth/application-prod.properties

ParametroValore
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. Modificate <TOMCAT_HOME>/appconf/threec-backend/application-prod.properties

ParametroValore
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
PASSO 6
Configurazione del contesto di Tomcat

Configurate i file di contesto di Tomcat per fare riferimento alle posizioni di configurazione esterne di Spring. Create i seguenti file sotto <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>
PASSO 7
Finalizzazione
  • Assicuratevi che i permessi dei file consentano a Tomcat di leggere i file di configurazione e di log.
  • Riavviate Apache Tomcat.
  • Attendete l'inizializzazione del database.
  • Riavviate Apache Tomcat una seconda volta.
  • Verificate che il deployment sia riuscito controllando i log di Tomcat e gli URL dell'applicazione.

Installazione — guidata

Eseguite i seguenti passaggi per installare il 3C Release Manager utilizzando lo script di installazione dedicato. Gli esempi utilizzano valori generici; assicuratevi che questi vengano sostituiti con i valori corretti per l'ambiente di destinazione.

Video (in inglese, 1:45): l’installazione guidata con install3c.bat in nove passaggi, dai prerequisiti al primo accesso.
PASSO 1
Avviate l'installer
Avviate il programma di installazione 3C Release Manager dalla riga di comando eseguendo install3c.bat.
Finestra del prompt dei comandi dell'installer 3C con il messaggio Welcome to 3C v3.3.5 installer
Passaggio 1 — Avviate l'installer. L'esecuzione di install3c.bat apre il prompt dei comandi dell'installer.
PASSO 2
Impostazioni delle directory

Inserite le seguenti directory, che devono essere disponibili:

  • Directory HOME di Tomcat (ad es. c:/Automic/Tomcat-3C)
  • Directory HOME di Java (ad es. c:/Program Files/Java/jdk-17)
  • Directory HOME di PostgreSQL (ad es. c:/Program Files/PostgreSQL/17)
Installer 3C: richiesta delle impostazioni delle directory home di Tomcat, Java e PostgreSQL
Passaggio 2 — Impostazioni delle directory. L'installer chiede le directory home di Tomcat, Java e PostgreSQL.
PASSO 3
Impostazioni del database

Inserite le seguenti impostazioni del database:

  • Nome DB (ad es. db3c)
  • Nome del server DB (ad es. localhost)
  • Porta del server DB (ad es. 5432)
  • Nome utente DB (ad es. db3c)
  • Password utente DB (non la password master di postgres)
Installer 3C: richiesta delle impostazioni del database (nome DB, host, porta, utente e password)
Passaggio 3 — Impostazioni del database. L'installer richiede il nome del DB, l'host, la porta, l'utente e la password dell'utente del DB (non la password master di postgres).
PASSO 4
Creazione database
Decidete se creare un nuovo database (Y/N) e inserite la password master di postgres. Dopo aver inserito la password master, la creazione del DB e la migrazione iniziano immediatamente. La creazione dell'utente del DB verrà saltata se è già disponibile.
Creazione del database nell'installer 3C con password master di PostgreSQL e migrazione CREATE DATABASE
Passaggio 4 — Creazione del database. Dopo aver confermato con Y e inserito la password master di postgres, l'installer crea lo schema ed esegue la migrazione.
PASSO 5
Importazione licenza
Decidete se importare una chiave di licenza (Y/N). Questa importazione richiede un file valido license_data.txt all'interno della cartella dell'installer. Se non disponibile, Tricise può fornire un file corrispondente.
Installer 3C: importazione della chiave di licenza con LICENSE UPDATE READY
Passaggio 5 — Importazione licenza. L'installer importa la chiave di licenza dal file license_data.txt.
PASSO 6
Impostazioni di Tomcat
Inserite le impostazioni di Tomcat relative al nome di dominio e alla porta da utilizzare (ad es. http://localvm:8061).
Impostazioni di Tomcat per l'installer 3C: richiesta del nome del dominio del server e della porta
Passaggio 6 — Impostazioni di Tomcat. L'installer richiede il nome di dominio e la porta di Tomcat.
PASSO 7
Distribuzione dell'applicazione
L'installer copia i file WAR nelle cartelle Tomcat corrispondenti.
Installer 3C: distribuzione dell'applicazione (COPYING FILES), copia dei file WAR in Tomcat
Passaggio 7 — Distribuzione dell'applicazione. L'installer copia i quattro file WAR in <TOMCAT_HOME>/webapps.
PASSO 8
Creazione dei file di configurazione
L'installer crea i file di configurazione per le corrispondenti applicazioni 3C Tomcat.
Installer 3C: creazione dei file di configurazione (CREATING CONFIGURATION FILES)
Passaggio 8 — Creazione dei file di configurazione. L'installer crea i file application-prod.properties per i moduli gateway, auth e backend.
PASSO 9
Installazione di un servizio Windows
Decidete se installare Tomcat 3C come servizio Windows (Y/N). Dopo quest'ultimo passaggio l'installazione è terminata.
Schermata INSTALLATION READY dell'installer 3C con la richiesta del servizio Tomcat e le credenziali predefinite del superutente
Passaggio 9 — Installazione del servizio Windows. Dopo aver risposto alla richiesta del servizio Tomcat, l'installer mostra le credenziali predefinite del superutente e si chiude con INSTALLATION READY.
PASSO 10
Finalizzazione
  • Assicuratevi che i permessi dei file consentano a Tomcat di leggere i file di configurazione e di log.
  • Riavviate Apache Tomcat.
  • Verificate che il deployment sia riuscito controllando i log di Tomcat e gli URL dell'applicazione.

Verifica post-installazione

Qualunque sia il percorso di installazione scelto, confermate il deployment controllando i log di Tomcat per eventuali errori di avvio in una delle quattro applicazioni WAR, navigando all'URL del gateway (dovrebbe apparire la schermata di login di 3C) ed effettuando l'accesso con il superutente predefinito (consultate Configurazione → Credenziali predefinite) — cambiate la password immediatamente.


3 · Configurazione

Riferimento alla configurazione

Il 3C Release Manager è configurato tramite tre file application-prod.properties distinti, uno per modulo: 3C-Gateway, 3C-Auth, e 3C-Backend. Oltre a questi file di proprietà, diversi parametri di runtime del 3C Release Manager possono essere regolati da un SUPERUSER tramite la schermata Impostazioni di sistema dell'app. Di seguito il riferimento completo dei parametri.

3C-Gateway (threec)

Il modulo gateway instrada le richieste in arrivo al servizio di backend appropriato.

ParametroDescrizione
logging.configProprietà standard di logging di Spring Boot / Java. Specifica la posizione esatta del file di configurazione del logging. Esempio: file:/c:/Automic/Tomcat-3C/appconf/threec/logback.xml
spring.application.nameImposta il nome logico dell'applicazione Spring. Predefinito: 3c-gateway
spring.cloud.gateway.mvc.routes[N].idDefinisce un ID di route per Spring Cloud Gateway (basato su MVC).
spring.cloud.gateway.mvc.routes[N].uriSpecifica il servizio di backend di destinazione per questa route.
spring.cloud.gateway.mvc.routes[N].predicates[0]Definisce un predicato di route (una condizione per il matching delle richieste). Esempio: Path=/oauth2/**
spring.cloud.gateway.mvc.routes[N].filters[0]Applica un filtro che modifica il percorso della richiesta. Esempio: StripPrefix=1
spring.cloud.gateway.mvc.routes[N].filters[1]Aggiunge un nuovo prefisso al percorso della richiesta dopo StripPrefix. Esempio: PrefixPath=/threec-auth

3C-Auth (threec-auth)

Il modulo di autenticazione gestisce l'accesso, l'emissione di JWT e la gestione delle credenziali.

ParametroDescrizione
logging.configPercorso del file di configurazione Logback.
spring.datasource.driverClassNameClasse driver JDBC utilizzata per connettersi a PostgreSQL. Predefinito: org.postgresql.Driver
spring.datasource.urlURL di connessione JDBC per il database. Esempio: jdbc:postgresql://localhost:5432/db3c
spring.datasource.usernameNome utente utilizzato dall'applicazione per autenticarsi con PostgreSQL.
spring.datasource.passwordPassword utilizzata dall'applicazione per l'autenticazione con PostgreSQL.
capture.authorization.gateway-context-pathDefinisce il percorso di contesto con cui il gateway espone l'applicazione. Predefinito: /threec
capture.authorization.gateway-uriURL di base del servizio gateway di autorizzazione.
capture.authorization.rsa-keyContiene la chiave RSA (codificata in Base64) utilizzata nei flussi di autorizzazione.

3C-Backend (threec-backend)

Il modulo backend è la logica principale dell'applicazione. Contiene il maggior numero di parametri configurabili, raggruppati di seguito per argomento.

Logging

ParametroDescrizione
logging.configCarica la configurazione di Logback da un percorso di file esterno (livelli, appender, posizioni/rotazione dei file di log, formati, ecc.).

Serializzazione JSON

ParametroDescrizione
spring.jackson.mapper.default-view-inclusionAbilita l'inclusione predefinita delle proprietà quando si utilizza Jackson @JsonView. Se impostato su true, le proprietà non assegnate esplicitamente a una vista possono comunque essere incluse (ciò può influire sui campi che compaiono nelle risposte API).
spring.jackson.property-naming-strategySerializza/deserializza proprietà JSON in SNAKE_CASE (ad es. created_at) invece di camelCase.
spring.data.web.pageable.one-indexed-parametersI parametri di paginazione sono basati su 0 quando impostati su false (page=0 è la prima pagina). Se true, page=1 sarebbe la prima pagina.

Database e pool di connessioni

ParametroDescrizione
spring.datasource.driverClassNameClasse del driver JDBC per PostgreSQL.
spring.datasource.urlURL di connessione JDBC.
spring.datasource.usernameUtente del DB usato dall'applicazione.
spring.datasource.passwordPassword del database utilizzata dall'applicazione.
spring.datasource.hikari.pool-nameNome del pool Hikari (visualizzato nei log/metriche). Predefinito: db-pool
spring.datasource.hikari.maximum-pool-sizeNumero massimo di connessioni DB nel pool. Predefinito: 30
spring.datasource.hikari.minimum-idleNumero minimo di connessioni inattive mantenute pronte. Predefinito: 1
spring.datasource.hikari.idle-timeoutPer quanto tempo (ms) una connessione inattiva può restare aperta prima di essere chiusa (quando si supera minimum-idle). Predefinito: 30000
spring.datasource.hikari.connection-timeoutTempo massimo (ms) di attesa per una connessione dal pool prima di fallire. Predefinito: 5000
spring.datasource.hikari.max-lifetimeDurata massima (ms) di una connessione prima che venga sostituita. Spesso impostata al di sotto dei limiti del database/rete per evitare connessioni obsolete. Predefinito: 60000
spring.jpa.database-platformIndica a Hibernate quale dialetto SQL utilizzare. Predefinito: org.hibernate.dialect.PostgreSQLDialect
spring.jpa.open-in-viewDisabilita “Open Session in View” quando impostato su false (impedisce il lazy-loading durante il rendering della risposta web; in genere è migliore per le prestazioni e per un'architettura pulita).
spring.jpa.properties.hibernate.id.db_structure_naming_strategyStrategia di denominazione dei generatori di ID Hibernate per le strutture del DB (influisce sulla denominazione di sequenze/tabelle utilizzate per gli ID). Predefinito: single
spring.flyway.out-of-orderPermette di applicare le migrazioni “fuori ordine” (ad esempio, se una versione inferiore appare dopo che una versione superiore è già stata applicata). Utile in alcuni flussi di rilascio ma può essere rischioso se non controllato.

Sicurezza e autenticazione

ParametroDescrizione
spring.security.oauth2.resourceserver.jwt.jwk-set-uriURL da cui l'app recupera il JWK Set (chiavi pubbliche) per verificare le firme JWT.
capture.authorization.rsa-keyMateriale chiave RSA (spesso un blob simile a JWK/JWKS) utilizzato per la firma/verifica nei flussi di autorizzazione.
capture.encryption.secret.keySegreto di crittografia dell'applicazione (utilizzato per crittografare dati sensibili / token / valori di configurazione a seconda dell'implementazione).
capture.encryption.saltSale usato con hashing/derivazione delle chiavi (aiuta a proteggere contro gli attacchi rainbow table).
server.servlet.session.cookie.secureContrassegna i cookie di sessione come Secure (inviati solo tramite HTTPS). Se non si utilizza HTTPS end-to-end, le sessioni potrebbero non rimanere attive nei browser.

Licenza e cache

ParametroDescrizione
capture.license.server.urlEndpoint del server di licenza (vuoto → non impostato, disabilitato o fornito altrove).
capture.system.cache-time-to-liveTTL per una cache interna in secondi. Predefinito: 86400 (24 ore).

XOG (comunicazione con sistemi esterni)

ParametroDescrizione
capture.xog.timeout-in-secondsTimeout della richiesta per chiamate XOG. Predefinito: 300
capture.xog.connection-timeout-in-secondsTimeout per l'instaurazione della connessione per le chiamate XOG. Predefinito: 20
capture.xog.http-buffersize-bytesDimensione del buffer HTTP in byte. Predefinito: 33554432 (≈ 32 MiB). Utile per payload di grandi dimensioni.
capture.xog.soap-cache-time-to-liveTTL per la cache relativa a SOAP in secondi. Predefinito: 60

Scheduler ed esecuzione delle attività

ParametroDescrizione
capture.scheduler.enabledAttiva/disattiva lo scheduler dell'applicazione.
capture.worker.settings.refresh.intervalCon quale frequenza vengono aggiornate le impostazioni dei worker (ms). Predefinito: 30000 (30 secondi).
capture.task.execution.pool.core-sizeNumero di thread worker di base (core). Predefinito: 30
capture.task.execution.pool.max-sizeNumero massimo di thread consentiti sotto carico. Predefinito: 60
capture.task.execution.pool.queue-capacityDimensione della coda per le attività in sospeso prima che intervengano nuovi thread/limiti massimi. Predefinito: 300
capture.task.execution.pool.keep-alivePer quanto tempo i thread aggiuntivi (non core) vengono mantenuti attivi (spesso in secondi). Predefinito: 10
spring.task.scheduling.pool.sizeDimensione del pool di thread per le attività pianificate di Spring (@Scheduled), separato dal pool di esecuzione personalizzato. Predefinito: 10

Limiti di parallelismo e intervalli degli agenti

ParametroDescrizione
capture.limit.parallel.diffMax processi diff paralleli. Predefinito: 10
capture.limit.parallel.snapshotMax processi snapshot paralleli. Predefinito: 4
capture.interval.diff.populator.agentIntervallo dell'agente diff populator (ms). Predefinito: 300000
capture.interval.diff.worker.agentIntervallo dell'agente diff worker (ms). Predefinito: 300000
capture.interval.snapshot.populator.agentIntervallo dell'agente di popolamento snapshot (ms). Predefinito: 300000
capture.interval.snapshot.worker.agentIntervallo dell'agente snapshot worker (ms). Predefinito: 300000
capture.interval.deployment.worker.agentIntervallo dell'agente deployment worker (ms). Predefinito: 300000
capture.interval.cleanup.worker.agentIntervallo dell'agente di pulizia (ms). Predefinito: 300000
capture.interval.diff.status.agentIntervallo dell'agente di stato diff (ms). Predefinito: 30000
capture.interval.snapshot.status.agentIntervallo dell'agente di stato snapshot (ms). Predefinito: 30000

Watchdog

ParametroDescrizione
capture.watchdog.external-internalSeleziona la modalità watchdog interna o esterna. Per on-premise: INTERNAL
capture.watchdog.snapshot-intervalIntervallo watchdog snapshot (ms). Predefinito: 1800000
capture.watchdog.diff-intervalIntervallo watchdog diff (ms). Predefinito: 1800000

Integrazione AWS (disabilitata per impostazione predefinita nelle installazioni on-premise)

ParametroDescrizione
spring.cloud.aws.sqs.enabledDisabilita la configurazione/integrazione automatica di AWS SQS quando impostato su false.
spring.cloud.aws.sns.enabledDisabilita la configurazione/integrazione automatica di AWS SNS quando impostato su false.
cloud.aws.region.autoDisabilita il rilevamento automatico della regione quando impostato su false.
cloud.aws.region.staticImposta esplicitamente la regione AWS. Predefinito: eu-central-1 (Francoforte).

Ciclo di vita del server e gestione degli errori

ParametroDescrizione
server.shutdownAbilita lo spegnimento graduale quando impostato su graceful (smette di accettare nuove richieste, finisce il lavoro in corso).
spring.lifecycle.timeout-per-shutdown-phaseTempo concesso per ciascuna fase di spegnimento prima di forzare la terminazione. Predefinito: 3s
server.error.include-messageInclude l'eccezione/il messaggio nelle risposte di errore (utile per il debug, ma può rivelare dettagli in produzione).

Impostazioni di sistema nell'app

Schermata Impostazioni di sistema di 3C con il numero di agenti interni per snapshot, diff, deployment e pulizia
La schermata Impostazioni di sistema nell'app: numero di agenti interni per snapshot, diff, deployment e pulizia.

Oltre ai file di proprietà, diversi parametri di runtime possono essere regolati da un SUPERUSER tramite la schermata Impostazioni di sistema dell'app.

Avvertimento. Questa schermata è accessibile solo con un utente con il ruolo SUPERUSER. La modifica di questi valori può influire sulle prestazioni e sulla stabilità del 3C Release Manager e dei sistemi esterni connessi. Si prega di contattare il supporto tecnico di Tricise per il 3C Release Manager prima di modificare questi numeri.

Agenti interni

  • Agenti snapshot: il numero di agenti che lavoreranno in parallelo su un nuovo snapshot. Troppi agenti possono rallentare il sistema esterno collegato e comportano un maggiore utilizzo delle risorse sul server di 3C. Sui server più vecchi, con CPU e memoria limitate, si consiglia di utilizzare un numero inferiore di agenti.
  • Agenti di stato snapshot: si consiglia di mantenere il valore a 1.
  • Agenti di popolamento snapshot: si consiglia di mantenere il valore a 1.
  • Agenti diff: il numero di agenti che lavoreranno in parallelo su un nuovo diff. Troppi agenti richiedono maggiori risorse sul server di 3C. Sui server più vecchi, con CPU e memoria limitate, si consiglia di utilizzare un numero inferiore di agenti.
  • Agenti di stato diff: si consiglia di mantenere il valore a 1.
  • Agenti di popolamento diff: si consiglia di mantenere il valore a 1.
  • Agenti di deployment: si consiglia di mantenere il valore a 1.
  • Agenti di pulizia: si consiglia di mantenere il valore a 1.

Agenti esterni

Non utilizzati nelle versioni on-premise.

Credenziali predefinite

Dopo l'installazione del 3C Release Manager, il superutente predefinito è:

  • Nome utente: super
  • Password: super
Cambiate subito. Cambiate sempre la password predefinita del superutente subito dopo il primo accesso.

4 · Utilizzo

Utilizzo — lavorare con il 3C Release Manager

Dopo l'installazione e la configurazione del 3C Release Manager, il flusso di lavoro tipico segue questa struttura: Tenant → Utenti → Ambienti → Snapshot → Differenze → User Story → Deployment. Le sezioni sottostanti descrivono ogni area funzionale così come presentata nell'interfaccia utente web.

Layout e navigazione

Il layout generale del 3C Release Manager è costituito dai seguenti moduli: menu principale, barra degli strumenti utente, tabelle e contenuti.

Layout principale

Layout principale dell'interfaccia utente web di 3C con elementi annotati numerati da 1 a 12
L'interfaccia utente web del 3C Release Manager — barra dei menu, barra degli strumenti utente, titolo della pagina, pulsanti di azione, filtri dell'elenco, contenuto e paginazione.

L'interfaccia utente web del 3C Release Manager contiene i seguenti elementi:

  1. Barra dei menu
  2. Barra degli strumenti utente
  3. Titolo della pagina
  4. Pulsanti di azione della pagina
  5. Informazioni e aiuto
  6. Azioni speciali relative al contenuto
  7. Controlli di filtro dell'elenco
  8. Contenuto dell'elenco
  9. Paginazione
  10. Elementi dell'elenco — in genere i campi ID e Titolo aprono la vista di dettaglio
  11. Azioni sulle voci dell'elenco, come modifica ed eliminazione
  12. Controllo del numero di record per elenco

Barra degli strumenti utente

Sottomenu del profilo nella barra degli strumenti utente di 3C con le voci Connesso come SUPER ed Esci
Facendo clic sull'icona del profilo in alto a destra si apre il sottomenu utente con “Connesso come” (nome utente) ed “Esci”.

Facendo clic sulla piccola icona del profilo in alto a destra dello schermo si apre il sottomenu utente. La prima voce di menu apre la schermata Il mio profilo dell'app.

Menu

Struttura del menu principale 3C con sottomenu Amministrazione aperto che mostra Tenant, Utenti, Impostazioni di sistema, Impostazioni Git, Registro di controllo e Impostazioni licenza
Il menu principale di 3C — Home, Ambienti, Snapshot, Differenze, Deployment, User Story e il sottomenu Amministrazione.

La struttura del menu di 3C Release Manager è la seguente:

  • Home: questo pulsante vi riporta alla pagina iniziale del 3C Release Manager.
  • Ambienti: naviga alla pagina Elenco ambienti, per visualizzare l'elenco degli ambienti connessi o crearne di nuovi.
  • Snapshot: naviga alla pagina Elenco snapshot, per visualizzare l'elenco degli snapshot esistenti o crearne di nuovi.
  • Differenze: naviga alla pagina Elenco Differenze, per vedere l'elenco delle differenze esistenti, o crearne di nuove.
  • Deployment: naviga alla pagina Elenco pacchetti di distribuzione, per visualizzare l'elenco dei pacchetti di distribuzione esistenti o crearne di nuovi.
  • User Story: naviga alla pagina Elenco delle User Story, per visualizzare le user story esistenti o crearne di nuove.
  • Amministrazione:
    • Tenant: visibile solo per il SUPERUSER
    • Utenti: naviga alla pagina Elenco utenti, per gestire gli utenti
    • Impostazioni di sistema: parametri di sistema
    • Impostazioni GIT: Configurazione del repository Git
    • Registro di controllo: naviga alla pagina Registro di controllo, per visualizzare le informazioni del registro di controllo
    • Impostazioni licenza: una schermata per gestire la chiave di licenza
    • Informazioni su: naviga alla pagina Informazioni, per vedere ulteriori informazioni sull'applicazione

La visibilità delle voci di menu dipende dai ruoli effettivi dell'utente collegato (vedere diritti e ruoli).

Accesso e disconnessione

Accesso

Schermata di accesso 3C con campi nome utente e password e casella di controllo "Ricordami"
La schermata di accesso di 3C — nome utente, password e la casella di controllo opzionale "Ricordami".

Una volta inserito l'URL corretto dell'applicazione, gli utenti vengono prima invitati a effettuare il login nella schermata di accesso. Le credenziali necessarie sono:

  • Nome utente
  • Password

Selezionando l'opzione Ricordami nella schermata di accesso, il nome utente verrà salvato per i successivi accessi. Dopo un accesso riuscito, gli utenti vengono reindirizzati alla pagina iniziale del 3C Release Manager.

Nota. Il sistema non prevede la registrazione autonoma. Per creare nuovi utenti, utilizzare l'utente amministratore fornito e creare manualmente gli utenti necessari.

Disconnessione

Barra degli strumenti utente 3C che mostra l'azione Logout
L'azione Logout nella barra degli strumenti utente — facendo clic su di essa si torna alla schermata di accesso.

Per disconnettersi dall'applicazione, gli utenti devono fare clic sull'azione Disconnessione nella barra degli strumenti utente. La disconnessione dall'applicazione riporta alla schermata di accesso.

Il mio profilo

Pagina Il mio profilo

Pagina Il mio profilo di 3C con le sezioni Dati principali, Cambia password e I miei ruoli
La pagina Il mio profilo — sezioni Dati principali, Cambia password e I miei ruoli.

La pagina Il mio profilo è strutturata in tre sezioni:

  • Sezione Dati principali: informazioni personali principali — Nome utente (LoginID), Nome, Cognome, Indirizzo e-mail.
  • Sezione Cambia password: fornisce la possibilità di cambiare la password attuale.
  • Sezione I miei ruoli: informazioni sui ruoli attuali dell'utente connesso. I ruoli possono essere modificati solo utilizzando la schermata Dettagli utente nell'elenco Utenti, da un utente con il ruolo Amministratore utente.

Accedete alla pagina Il mio profilo

Sottomenu dell'icona dell'account nella barra degli strumenti utente di 3C con Connesso come SUPER
Accedete alla pagina Il mio profilo selezionando l'icona dell'account e facendo clic su Connesso come (nome utente).

Gli utenti possono navigare alla pagina Il mio profilo per visualizzare e modificare le informazioni personali o cambiare la password attuale. Per accedere alla pagina Il mio profilo, selezionare l'icona dell'account nella barra degli strumenti utente e fare clic sull'azione Connesso come nome utente .

Modifica informazioni personali

Modulo Dati principali della pagina Il mio profilo di 3C con i campi modificabili Nome, Cognome ed Email
Modifica informazioni personali — modificate Nome, Cognome e indirizzo E-mail. Il LoginID è di sola lettura.

Gli utenti possono modificare le proprie informazioni personali nella pagina Il mio profilo modificando le informazioni inserite:

  • Nome
  • Cognome
  • Indirizzo e-mail
Nota. Il nome utente (LoginID) non può essere modificato dagli utenti finali.

Dopo la modifica, fare clic sul pulsante Salva per confermare. Se il salvataggio va a buon fine, viene mostrato un messaggio di notifica.

Notifica toast “Profilo aggiornato” di 3C
Dopo il salvataggio, appare una notifica "Profilo aggiornato".

Cambia password

Gli utenti hanno la possibilità di modificare la loro password corrente nella pagina Il mio profilo effettuando le seguenti operazioni:

  • Inserire la password corrente
  • Inserire la nuova password
  • Reinserire la nuova password nel campo “Conferma password”
  • Fare clic sul pulsante Cambia password per confermare

Se la modifica della password va a buon fine, viene mostrato un messaggio di notifica.

Notifica toast “Password cambiata” di 3C
Dopo aver cambiato la password, appare una notifica "Password cambiata".

Amministrazione

Questa sezione contiene tutte le funzioni amministrative e le opzioni di configurazione dell'applicazione 3C Release Manager: Tenant, Utenti, Impostazioni di sistema, Impostazioni Git, Registro di controllo, Impostazioni licenza. Per accedere a queste funzioni sono necessari ruoli amministrativi elevati.

Tenant

Elenco tenant 3C che mostra il tenant DEFAULT e le informazioni sulla licenza
L'elenco dei tenant — tenant DEFAULT con stato della licenza e moduli concessi in licenza.

I tenant sono contenitori speciali in 3C che rappresentano specifiche aziende o reparti. Sono accessibili solo agli utenti con il ruolo SUPERUSER. Per la versione SaaS, queste impostazioni non sono accessibili agli utenti. Per la versione on-premise, si consiglia di utilizzare il tenant DEFAULT e di creare gli utenti amministratori generali in quel tenant.

Elenco dei tenant. Mostra i tenant attualmente disponibili nel sistema. Il tenant DEFAULT non può essere eliminato.

Funzioni:

  • Aggiorna: aggiorna la vista elenco corrente
  • Nuovo tenant: naviga alla schermata Crea tenant
  • Informazioni: mostra il pannello informativo

Campi:

  • ID: ID tecnico generato automaticamente
  • Nome: il titolo del record del tenant
  • Licenza: attiva o inattiva, in base alle impostazioni della licenza
  • Moduli con licenza: Clarity, Automic, o entrambi, in base alle impostazioni della licenza
  • Creato il: ora di creazione del record
  • Modifica: naviga alla schermata Dettagli tenant
  • Elimina: elimina il tenant

Crea tenant. Campi obbligatori: Nome tenant (deve essere unico), Descrizione (testo libero). Dopo la creazione, gli utenti del tenant possono accedere solo agli oggetti dello stesso tenant, separandoli dagli oggetti degli altri tenant.

Schermata Crea tenant di 3C con i campi Nome tenant e Descrizione
Schermata Crea tenant — Nome tenant obbligatorio e Descrizione in testo libero.

Modifica tenant. L'utente può visualizzare i dettagli del tenant e modificarne alcuni attributi. Campi: ID tenant (sola lettura), Nome tenant, Descrizione, Creato da, Creato il. Funzioni: Annulla, Salva.

Schermata Modifica tenant di 3C con le sezioni Dati principali, Dati licenza e Dati di utilizzo
Schermata Modifica tenant — Dati principali (ID tenant di sola lettura, Nome e Descrizione modificabili), Dati licenza e Dati di utilizzo.

Utenti

Elenco utenti 3C con ID di accesso, nomi, email, tenant e flag di attività
Elenco Utenti — LoginID, nome, email, assegnazione tenant e stato attivo.

Gli utenti rappresentano gli account di accesso nel sistema. Le schermate amministrative consentono di gestire i dettagli degli utenti, le password e i ruoli.

Campi elenco utenti:

  • LoginID: l'ID dell'utente, utilizzato per l'accesso in 3C
  • Nome: nome reale dell'utente
  • E-mail: l'indirizzo email dell'utente
  • Tenant: il tenant a cui l'utente è collegato
  • Attivo: mostra se l'utente è attivo (può accedere al sistema)
  • Creato il: ora di creazione dell'utente
  • Modifica / Elimina

Campi della schermata Crea utente: LoginID (richiesto, univoco), Nome (richiesto), Cognome (richiesto), E-mail (richiesto), Attivo (disabilitato per impostazione predefinita — solo gli utenti attivi possono accedere), Password (iniziale), Conferma password. I ruoli dell'utente possono essere impostati solo dopo la creazione.

Schermata Crea utente di 3C con tutti i campi obbligatori
La schermata Crea utente: LoginID, nome, cognome, email, flag attivo e password iniziale. I ruoli possono essere impostati solo dopo la creazione.

Modifica utente. L'utente può visualizzare i dettagli e modificare alcuni attributi, cambiare la password o modificare i ruoli attivi. Il LoginID non può essere modificato dopo la creazione.

Schermata Modifica utente di 3C con le sezioni dati principali, cambio password e ruoli attivi
La schermata Modifica utente: dati principali, modifica password e assegnazione ruolo attivo. Il LoginID non può essere modificato.

Ruoli disponibili:

  • USER_USER: può accedere all'elenco utenti e ai dettagli dell'utente
  • USER_MANAGER: può accedere all'elenco utenti, può eliminare utenti, può creare nuovi utenti, può modificare utenti
  • ENVIRONMENT_USER: può accedere all'elenco degli ambienti e ai dettagli dell'ambiente
  • ENVIRONMENT_MANAGER: può accedere all'elenco degli ambienti, può eliminare ambienti, può creare un nuovo ambiente, può modificare i dettagli dell'ambiente (incluse le impostazioni di connessione, la password, i filtri, le impostazioni Git)
  • SCHEDULE_USER: può accedere agli snapshot pianificati dell'ambiente
  • SCHEDULE_MANAGER: può accedere agli snapshot pianificati dell'ambiente e modificarli, eliminarli o crearne di nuovi
  • SNAPSHOT_USER: può accedere all'Elenco Snapshot e ai dettagli di uno Snapshot
  • SNAPSHOT_MANAGER: può accedere all'Elenco Snapshot, può eliminare snapshot, può avviare un nuovo snapshot, può modificare i metadati dello snapshot
  • DIFF_USER: può accedere all'Elenco delle Differenze e ai dettagli delle differenze
  • DIFF_MANAGER: può accedere all'Elenco delle Differenze, eliminare le differenze esistenti, creare una nuova differenza, modificare i metadati della differenza
  • DEPLOYMENT_USER: può accedere all'Elenco di Deployment e vederne i dettagli, incluse le esecuzioni
  • DEPLOYMENT_MANAGER: può accedere all'Elenco di Deployment, eliminare i deployment esistenti, creare nuovi deployment, avviare nuovi processi di deployment e modificarne il contenuto
  • USER_STORY_USER: può accedere all'elenco delle User Story e ai dettagli delle User Story
  • USER_STORY_MANAGER: può accedere alle User Story e modificarle, eliminare le User Story esistenti, crearne di nuove e modificarne il contenuto
  • SUPERUSER: può accedere a qualsiasi funzionalità in 3C, può modificare i tenant, impostare nuove chiavi di licenza

Impostazioni Git

Schermata di configurazione delle impostazioni Git a livello di tenant 3C
Impostazioni Git a livello di tenant — URL del repository, credenziali o chiave SSH e test di connessione.

Queste impostazioni sono necessarie per sincronizzare la configurazione del sistema connesso con un repository Git esterno. Si tratta di un parametro globale basato sul tenant. Per connettersi a un repository Git, l'utente deve impostare l'URL del repository e le credenziali di un utente tecnico con la capacità di eseguire il commit e il push su quel repository. In alternativa, è possibile utilizzare una chiave SSH.

Campi:

  • URL del repository Git: l'URL del repository
  • Tipo di connessione: Credenziali o SSH
  • Credenziali: Nome utente, Password, Conferma password
  • SSH: Chiave SSH privata richiesta dal provider Git
  • Connesso: dopo la creazione o la modifica, 3C Release Manager tenterà di connettersi al repository utilizzando le impostazioni e confermerà se la connessione funziona

Funzioni: Salva salva i valori modificati; Test di connessione tenta di connettersi al repository utilizzando le impostazioni correnti.

Registro di controllo

Tabella del registro di controllo di 3C con timestamp, livelli di log e moduli
Il registro di controllo — ID registro, ID accesso, livello (INFO/WARNING/ERROR), data e ora, messaggio e modulo.

Questa tabella è un elenco rappresentativo degli eventi e delle azioni importanti eseguiti nel sistema per scopi di audit e di tracciamento dei bug.

Campi:

  • ID registro: ID tecnico generato
  • ID accesso: l'ID dell'utente associato
  • Livello di log: il livello del messaggio (INFO, WARNING, ERROR)
  • Ora del log: il timestamp del messaggio
  • Messaggio di log: il messaggio effettivo
  • Modulo: il nome del modulo di sistema da cui proviene il messaggio

Impostazioni licenza

Schermata delle impostazioni della licenza 3C con validità, scadenza e moduli concessi in licenza
La schermata delle impostazioni di licenza — validità, titolare, scadenza, numero massimo di ambienti e moduli con licenza.

In questa schermata, l'amministratore può controllare e modificare la chiave di licenza attuale.

Campi:

  • Licenza valida: true se la licenza è valida e attiva per questa istanza
  • Concesso in licenza a: il titolare della licenza
  • Licenza valida fino al: la data di scadenza della licenza
  • Numero massimo di ambienti: il limite degli ambienti gestibili con questa licenza
  • Moduli con licenza: l'elenco dei sistemi esterni che possono essere gestiti con 3C (CLARITY, AUTOMIC o entrambi)
  • Cambia chiave di licenza: l'utente può aggiungere una nuova chiave di licenza
  • Pulsante Cambia chiave di licenza: sostituisce la chiave di licenza con quella nuova fornita
Nota. L'uso di chiavi di licenza non corrette può rendere inutilizzabile 3C. Utilizzare solo le chiavi fornite da Tricise.

Ambienti

Gli ambienti sono connessioni a istanze Automic (o Clarity). Sono necessari per qualsiasi analisi, snapshot o distribuzione. Una connessione di ambiente riuscita fornisce anche un elenco degli oggetti disponibili di un'istanza da leggere come riepilogo di primo livello.

Elenco degli ambienti

Elenco degli ambienti di 3C con tipo, host, client, stato della connessione e timestamp degli snapshot
L'elenco degli ambienti — connessioni con tipo, host, client, stato della connessione e timestamp dell'ultimo/successivo snapshot.

La pagina Elenco degli ambienti mostra le connessioni Clarity PPM e Automic create e ulteriori dettagli su di esse, offrendo la possibilità di creare, modificare o eliminare voci.

Funzioni: Aggiorna, Nuovo ambiente, Informazioni.

Filtri: Filtro prodotto (visibile solo se la vostra licenza è valida per Automic e Clarity).

Campi:

  • ID: identificatore univoco del record di connessione all'ambiente. Generato automaticamente dal sistema.
  • Titolo: nome della connessione all'ambiente, fornito dall'utente che l'ha creata.
  • Host: indirizzo del server su cui è in esecuzione l'applicazione esterna.
  • Client: visibile solo per le istanze Automic.
  • Tipo: il tipo di utilizzo dell'ambiente, come DEVELOPMENT, TEST, PRODUCTION, ecc.
  • Database: il fornitore del DB del sistema esterno. Visibile solo per gli ambienti Clarity.
  • Inizializzato: mostra se le query necessarie sono già installate nel sistema. Visibile solo per ambienti Clarity.
  • Connesso: mostra se le credenziali e le impostazioni di connessione sono corrette e se 3C può accedere al sistema.
  • Ultimo snapshot: il timestamp dell'ultimo snapshot generato correttamente per il sistema.
  • Prossimo snapshot: la data del prossimo snapshot di backup pianificato per il sistema.
  • Mostra: naviga alla schermata Dettagli ambiente.
  • Elimina: elimina l'ambiente.
Avvertimento. L'eliminazione di un ambiente elimina anche tutti gli snapshot e i diff ad esso collegati.

Crea ambiente

Schermata Crea ambiente di 3C con parametri di sistema e credenziali
La schermata Crea ambiente — parametri di sistema, indirizzi del server, certificato e credenziali dell'utente tecnico.

Create un record di ambiente per archiviare i dettagli della connessione, che verranno utilizzati per creare snapshot. Se avete entrambe le licenze Clarity e Automic disponibili, dovete prima scegliere il tipo di prodotto.

Parametri di sistema:

  • Titolo: identificatore breve dell'ambiente. Questo titolo appare anche in altre pagine. Si consiglia che sia univoco.
  • Indirizzi server: indirizzo dell'ambiente Automic nel formato URL:PORT senza il prefisso http o https. Le porte possono essere aggiunte utilizzando intervalli (xyurl:10-20) o virgole (yyurl:1,2,3). Utilizzate il pulsante + per aggiungere nuovi record alle impostazioni di connessione per diversi nomi host.
  • Tipo di ambiente: il tipo di utilizzo. Valori: DEVELOPMENT, TEST, MIGRATION, PRODUCTION.
  • Certificato dell'ambiente: Il 3C Release Manager necessita del certificato di connessione. Copiate in questo campo il testo del file .cert e includete le righe —–BEGIN CERTIFICATE—– e —–END CERTIFICATE—– del certificato.
Importante. Il 3C Release Manager utilizzerà il primo URL funzionante e cercherà di usarlo anche la prossima volta. Se si aggiungono stringhe di connessione a diverse istanze Automic, i dati degli snapshot potrebbero essere incoerenti in futuro.

Credenziali:

  • Numero client: il numero del client dell'utente tecnico in Automic.
  • Nome utente: il nome utente dell'utente tecnico, ad es. UC. Il 3C Release Manager potrà accedere (scaricare o distribuire) solo agli oggetti di Automic a cui l'utente tecnico ha accesso.
  • Dipartimento: il dipartimento dell'utente tecnico.
  • Memorizza password: consigliato. Potete usare 3C anche senza, ma in tal caso, prima di ogni richiesta di connessione per creare uno snapshot o un deployment, vi verrà chiesta la password.
  • Password: la password dell'utente tecnico.
  • Descrizione: campo di testo libero per informazioni aggiuntive sulla connessione all'ambiente.

Modifica ambiente

Una volta creata e salvata una connessione all'ambiente, questa può essere aperta dalla pagina Elenco ambienti e ogni impostazione correlata può essere modificata. Facendo clic sul titolo della connessione nella pagina dell'elenco si apre la pagina Modifica ambiente. La pagina Modifica ambiente ha più schede:

  • Base: informazioni generali sulla connessione all'ambiente
  • Connessione: indicatori sullo stato della connessione
  • Credenziali: possibilità di cambiare la password di accesso alla connessione
  • Lavori pianificati: impostazioni di generazione di snapshot di backup automatici per l'ambiente
  • Filtri salvati: filtri oggetto definiti dall'utente — solo per Automic
  • Filtri: possibilità di includere o escludere determinati elementi dagli snapshot — solo per Clarity
  • Oggetti: elenco degli oggetti identificati
  • Impostazioni Git: per configurare la sincronizzazione Git per questo ambiente
  • Regole di distribuzione: regole di script di deployment automatico — solo per Automic

Schermata Base

Scheda Base della schermata Modifica ambiente di 3C con i metadati della connessione
La scheda Base — titolo, indirizzi del server, tipo di ambiente, numero del client, nome utente, dipartimento e descrizione.

Le impostazioni di base della connessione e i metadati per l'ambiente. Stessi campi di Crea ambiente (Titolo, Indirizzi del server, Tipo di ambiente, Numero client, Nome utente, Dipartimento, Descrizione). Funzioni: Annulla, Salva.

Schermata di connessione

Scheda Connessione della schermata Modifica ambiente di 3C con gli indicatori di stato della connessione
La scheda Connessione — flag connesso, messaggio di errore, stato inizializzato e stato della connessione REST.

Mostra un'indicazione sulla correttezza delle impostazioni di connessione.

Campi:

  • Connesso: true se la connessione funziona correttamente
  • Errore di connessione: contiene l'eventuale messaggio di errore restituito durante la richiesta di connessione (solo per Automic)
  • Inizializzato: indica se la connessione è stata impostata correttamente e se l'applicazione è riuscita a connettersi all'istanza Clarity PPM almeno una volta (solo per Clarity)
  • Connessione REST: indica se l'API REST è accessibile da 3C (solo per Automic)

Funzioni:

  • Verifica connessione: aggiorna lo stato della connessione
  • Reinizializza / Inizializza: esegue gli script di query nell'ambiente necessari affinché 3C Release Manager funzioni (solo per Clarity)

Schermata credenziali

Scheda Credenziali della schermata Modifica ambiente di 3C con opzione di memorizzazione della password
La scheda Credenziali — interruttore per salvare la password e campo password con finestra di dialogo certificato.

Campi: Memorizza password (consigliato), Password (la password dell'utente tecnico). Funzioni: Salva modifiche (salva la nuova password e tenta di collegarsi al sistema esterno), Aggiungi nuovo (apre una finestra di dialogo in cui l'utente può impostare il certificato della connessione).

Schermata lavori pianificati

Elenco dei lavori pianificati nella schermata Modifica ambiente di 3C con flag attivo, diff automatici e prossima esecuzione
L'elenco dei lavori pianificati: titolo, flag attivo, differenze automatiche, ultima/prossima esecuzione e conteggio esecuzioni.

Mostra l'elenco dei processi di snapshot pianificati per questo ambiente. Il 3C Release Manager avvierà automaticamente un nuovo snapshot per creare un backup della configurazione negli orari specificati qui.

Campi:

  • Titolo della pianificazione: titolo in testo libero
  • Attivo: il lavoro verrà eseguito solo se il flag Attivo è true
  • Diff automatici: se impostato su true, 3C creerà automaticamente anche un'analisi diff, rispetto all'ultimo snapshot pianificato
  • Ultima esecuzione: il timestamp dell'ultima esecuzione del job
  • Prossima esecuzione: il momento in cui è pianificata la prossima esecuzione del lavoro
  • Conteggio esecuzioni: il numero di volte in cui il lavoro è già stato eseguito con successo
  • Dettagli: naviga alla schermata Modifica pianificazione
  • Elimina: elimina il lavoro pianificato

Funzioni: Crea pianificazione (naviga alla schermata Nuova pianificazione).

Schermata lavori pianificati — Nuova pianificazione

Finestra di dialogo Nuova pianificazione di 3C con titolo, ora di backup, fuso orario e impostazioni di frequenza
La finestra di dialogo Nuova pianificazione — titolo, descrizione, differenze automatiche, filtro, ora di inizio backup (HH:MM), fuso orario e frequenza (Giornaliera/Settimanale/Mensile/Annuale).

Utilizzate questa pagina per definire un nuovo processo di snapshot pianificato per l'ambiente.

Campi:

  • Titolo: richiesto, nome in testo libero
  • Descrizione: campo di testo libero
  • Diff automatici: se abilitato, ogni snapshot attiverà automaticamente anche un processo di analisi delle differenze, che confronterà la configurazione corrente con l'ultimo stato salvato in precedenza
  • Filtro: facoltativo — se non impostato, verrà creato uno snapshot completo
  • Ora di inizio del backup: HH:MM (formato ore:minuti). Il lavoro inizierà all'ora indicata.
  • Fuso orario: impostate il fuso orario dell'ora di inizio del backup
  • Frequenza di pianificazione: impostate la frequenza. Le opzioni disponibili sono:
    • Giornaliera: il lavoro inizierà ogni giorno all'ora indicata
    • Settimanale: impostate i giorni della settimana in cui volete che inizi il lavoro
    • Mensile: impostate i giorni del mese in cui volete che il lavoro inizi
    • Annuale: impostate i giorni dell'anno in cui volete che il lavoro inizi

Funzioni: Annulla (torna all'elenco delle pianificazioni senza modifiche), Salva (crea il nuovo lavoro pianificato).

Schermata lavori pianificati — Modifica pianificazione

Finestra di dialogo Modifica pianificazione di 3C con gli stessi campi di Nuova pianificazione
La finestra di dialogo Modifica pianificazione — stesso set di campi di Nuova pianificazione, utilizzata per modificare un lavoro pianificato esistente.

Usate questa pagina per modificare un lavoro di snapshot pianificato per l'ambiente. I campi sono identici a quelli della schermata Nuova pianificazione: Titolo, Descrizione, Diff automatici, Filtro, Ora di inizio del backup (HH:MM), Fuso orario e Frequenza di pianificazione (Giornaliera, Settimanale, Mensile, Annuale). Funzioni: Annulla, Salva.

Schermata filtri salvati (solo Automic)

Lista filtri salvati 3C per un ambiente Automic
Elenco filtri salvati: filtri oggetto riutilizzabili creati da snapshot personalizzati.

Utilizzate questa pagina per gestire i filtri salvati per l'ambiente. Quando l'utente desidera creare uno snapshot personalizzato, c'è un'opzione per salvare il filtro attualmente utilizzato per un uso futuro. Questa schermata ne mostra l'elenco.

Campi:

  • Titolo: il nome del filtro
  • Creato da: il proprietario del filtro
  • Creato il: data di creazione
  • Modifica: naviga alla schermata Nuovo Snapshot, con i filtri caricati
  • Elimina: cancella il filtro

Schermata elenco oggetti

Schermata elenco oggetti 3C che mostra il catalogo di configurazione di un ambiente
L'elenco Oggetti — catalogo di configurazione dell'ambiente, aggiornato dopo ogni snapshot.

La schermata degli oggetti offre un catalogo di configurazione generale sull'ambiente. Dopo ogni snapshot, questo elenco viene aggiornato e può anche essere aggiornato manualmente in questa schermata. Serve a due scopi principali: in primo luogo, è possibile verificare quali oggetti sono disponibili nel sistema; in secondo luogo, è possibile utilizzare il pulsante Cronologia per vedere le modifiche precedenti sull'oggetto.

Nota. Se un oggetto viene eliminato dal sistema, rimarrà comunque nella cronologia di 3C in base agli snapshot precedenti.

Vista Cronologia

Cronologia oggetto 3C con elenco delle versioni e diff del testo
La vista Cronologia: ogni versione precedente dell'oggetto a sinistra, le modifiche effettive come diff di testo a destra.

La vista cronologia mostra ogni versione precedente dell'oggetto sulla sinistra. Selezionando un elemento specifico nell'elenco, la vista di destra mostra le modifiche effettive nell'elemento di configurazione come differenza di testo.

Schermata delle impostazioni di Git

Impostazioni di sincronizzazione Git per ambiente in 3C, con nome del branch e interruttore Sincronizzazione Git abilitata
Sincronizzazione Git per ambiente: nome del branch e interruttore Sincronizzazione Git abilitata.

Se il repository Git globale è configurato correttamente, è disponibile questa pagina, in cui l'utente può abilitare o disabilitare la funzione di sincronizzazione Git per l'ambiente e impostare il nome del branch che verrà utilizzato nel repository per tenere traccia delle configurazioni.

Campi:

  • Nome del branch: questo branch verrà creato nel repository se non esiste e verrà utilizzato per archiviare la configurazione.
  • Sincronizzazione Git abilitata: se abilitato, dopo ogni snapshot il 3C Release Manager scriverà la configurazione nel file system, quindi eseguirà automaticamente il commit e il push delle modifiche nel repository Git definito.
  • Salva: salva i valori nel modulo.

Schermata regole di distribuzione (solo Automic)

Editor delle regole di distribuzione per ambiente in 3C con sintassi AEDB Change
L'editor delle regole di distribuzione — set di regole dell'ambiente con la sintassi dell'utility AEDB Change, con convalida.

L'utente può impostare le regole predefinite per questo ambiente, che verranno utilizzate durante il processo di distribuzione. Il processo di modifica del testo funziona in modo simile all'utility AEDB Change: le regole specifiche che possono essere utilizzate nei file di regole sono le stesse indicate nella documentazione Automic di AEDB Change.

Campi:

  • Set di regole dell'ambiente: il testo che contiene le regole (ogni riga è una regola)
  • Convalida: controlla il set di regole e mostra un messaggio di errore in caso di errori di sintassi
  • Salva: salva il set di regole per l'ambiente. Ogni volta che verrà definito un nuovo deployment per questo ambiente, questo set di regole verrà copiato e utilizzato come predefinito per il deployment.

Schermata filtri (solo Clarity)

Schermata dei filtri di 3C (solo Clarity) con categorie di filtri per lingua, oggetti e altro
La schermata Filtri Clarity: filtri lingua, filtri oggetto e altri filtri XML.

L'utente può impostare filtri specifici per questo ambiente che modificano il modo in cui devono essere creati gli snapshot di questa istanza. Ci sono tre categorie:

  • Filtri lingua: 3C eliminerà dai file XML ogni riga che contiene etichette per le lingue escluse qui
  • Filtri oggetto: 3C includerà nello snapshot solo i tipi di oggetto abilitati in questo elenco di filtri
  • Altri filtri: filtri specifici per i file XML, che filtrano attributi, tag o parti degli XML non necessari per l'analisi comparativa, come gli ID generati e simili

Snapshot

Gli snapshot sono una delle funzionalità di base del 3C Release Manager. Uno snapshot è una rappresentazione della configurazione dell'istanza gestita in un dato momento. Il 3C Release Manager si connette al sistema Clarity o Automic e, in base ai filtri e alle impostazioni, troverà e scaricherà ogni oggetto di configurazione dal sistema. Questi set possono essere denominati e salvati, per essere poi utilizzati come cronologia della configurazione, backup di sistema, base per analisi delle differenze o origine di un pacchetto di distribuzione.

Snapshot incrementali

Il 3C Release Manager esporta e salva gli oggetti in modo incrementale. Ogni volta che viene avviato un nuovo snapshot, il 3C Release Manager controlla ogni oggetto disponibile nel sistema selezionato, in base ai filtri e alle impostazioni. Verranno archiviati solo gli elementi modificati dall'ultimo snapshot salvato, al fine di ridurre il tempo necessario per il processo e anche il consumo del database. Il primo snapshot su un'istanza nuova richiederà più tempo, ma in seguito gli snapshot successivi verranno creati più velocemente.

Snapshot completi e snapshot parziali

Se l'utente non specifica alcun filtro o selezione di oggetti, verrà creato uno snapshot completo: tutti gli oggetti verranno scaricati. Si consiglia di impostare i filtri in modo che venga salvata solo la configurazione importante, per velocizzare il processo.

Elenco snapshot

Elenco degli snapshot di 3C con stato, statistiche e tag
L'elenco Snapshot — ambiente, stato (DONE/ERROR/IN_PROGRESS/WAITING), statistiche degli oggetti e tag.

Funzioni: Aggiorna, Crea snapshot, Info.

Filtri:

  • Fonte: l'ambiente da cui è stato creato lo snapshot
  • Tipo: Creato manualmente, Generato automaticamente, Backup pianificato, Backup prima del Deployment, Validazione del Deployment
  • Intervallo di date: l'ora di inizio dello snapshot
  • Campo di ricerca: ricerca testuale libera nel titolo e nella descrizione

Controlli speciali: La prima icona permette di alternare tra la selezione della User Story e quella del Deployment. Il menu a tendina mostra le User Story o i Deployment disponibili da gestire; se ne viene selezionato uno, un pulsante “Apri deployment” o “Apri user story” apre l'elemento selezionato.

Campi:

  • ID: l'ID tecnico dello snapshot
  • Titolo: il titolo dello snapshot
  • Ambiente: l'ambiente di origine dello snapshot
  • Stato: DONE, ERROR, IN_PROGRESS, WAITING
  • Statistiche: numero totale di oggetti in blu, oggetti con errore in rosso
  • Tag: tag specificati dall'utente o creati automaticamente
  • Inizio: l'ora di inizio
  • Mostra: apre la schermata Dettagli snapshot
  • Elimina: elimina lo snapshot
  • Elementi selezionati: se viene selezionato un deployment o una user story nella pagina, questa colonna mostra il numero di oggetti aggiunti a quella user story o a quel deployment da ciascuno snapshot

Crea snapshot

Schermata Crea snapshot di 3C con selezione dell'ambiente e tag
La schermata Crea snapshot — titolo, ambiente di origine, descrizione, tag e interruttore snapshot personalizzato.

Campi:

  • Titolo snapshot: obbligatorio, generato automaticamente con un valore predefinito
  • Ambiente selezionato: la connessione all'ambiente che verrà utilizzata come sorgente
  • Descrizione: testo libero
  • Tag: tag manuali per lo snapshot
  • Snapshot personalizzato: se non abilitato, 3C avvierà uno snapshot completo

Funzioni: Annulla, Avvia snapshot.

Snapshot personalizzato

Catalogo di configurazione della vista Snapshot personalizzato di 3C con cartelle ed elementi selezionabili
La vista Snapshot personalizzato — catalogo di configurazione con selezione manuale di cartelle/elementi e filtri riutilizzabili.

Se l'interruttore Snapshot personalizzato è abilitato, la schermata mostra l'intero catalogo di configurazione per l'ambiente, dove l'utente può selezionare manualmente quali elementi includere nello snapshot. L'utente può selezionare cartelle (gli elementi verranno scaricati ricorsivamente) o elementi individuali. Questa selezione può essere salvata come filtro utilizzando il pulsante Nuovo filtro . I filtri salvati in precedenza possono essere applicati con il selettore Filtro .

Creazione di snapshot

Creazione snapshot 3C in corso con barra di avanzamento
Creazione snapshot in corso — barra di avanzamento che mostra lo stato del download per oggetto.

In base agli oggetti nell'ambiente e ai filtri e agli elementi selezionati dall'utente, uno snapshot potrebbe richiedere più tempo. Durante quel periodo, il 3C Release Manager visualizza una barra di avanzamento.

Dettagli snapshot

Schermata Dettagli snapshot di 3C con metadati e oggetti scaricati
La schermata Dettagli snapshot — metadati, stato, statistiche ed elementi di configurazione scaricati.

I dettagli di uno snapshot specifico, inclusi i suoi metadati e gli elementi di configurazione scaricati.

Metadati: ID snapshot (sola lettura), Ambiente (sola lettura), Titolo snapshot (obbligatorio), Stato, Ora di inizio, Ora di fine, Descrizione, Tag.

Funzioni: Aggiorna, Indietro, Info, Salva (salva le modifiche nel modulo dei metadati), Riavvia — se ci sono oggetti in stato di errore o lo snapshot ha prodotto un errore, l'utente può provare a scaricare gli oggetti rimanenti.

Vista ad albero degli oggetti

I contenuti principali dello snapshot. Sul lato sinistro, per Clarity vengono mostrate le Categorie Oggetto nella vista ad albero; per Automic, la struttura delle cartelle dell'istanza in questione. Le cartelle possono essere aperte e chiuse; facendo clic su di esse viene mostrato il contenuto della cartella o della categoria sul lato destro.

Per l'intero snapshot e per le cartelle specifiche, i numeri blu indicano il numero totale di oggetti, i numeri verdi indicano gli oggetti scaricati con successo e i numeri rossi indicano gli oggetti in stato di errore. Il download di un oggetto può terminare con un errore a causa di problemi di connessione, errori del programma o problemi di autorizzazione, se l'utente tecnico non dispone dei diritti necessari.

Campi: ID, Codice oggetto, Tipo oggetto, Stato (WAITING, IN_PROGRESS, DONE, ERROR), Dettagli (apre la finestra di dialogo Oggetto snapshot), Cronologia (apre la vista Cronologia dell'oggetto).

Gestione di Deployment / User Story

Se c'è una User Story o un Deployment selezionato nell'angolo in alto a destra, il layout dello schermo cambia. Con il controllo aggiunto, è possibile selezionare cartelle, il contenuto delle cartelle o elementi specifici da aggiungere alla User Story o al Deployment selezionato.

Vista ad albero snapshot 3C con controlli di selezione Deployment e User Story
Gestione di Deployment / User Story all'interno di uno snapshot: selezione di cartelle ed elementi da aggiungere a un pacchetto di destinazione.

Schermata Dettagli oggetto

Schermata Dettagli oggetto dello snapshot in 3C con codice di configurazione di sola lettura
La schermata Dettagli oggetto — codice di configurazione, flag di modifica/spostamento, riferimento allo snapshot originale e metadati.

Mostra i dettagli dell'oggetto, con il codice di configurazione effettivo in un campo di sola lettura.

Campi:

  • ID: ID tecnico dell'oggetto
  • Codice: il codice dell'oggetto
  • Ora di inizio: ora di inizio download dell'oggetto
  • Ultimo aggiornamento alle: data della modifica della configurazione dell'oggetto sul sistema esterno
  • Oggetto modificato: vero se è cambiato dall'ultimo snapshot
  • Oggetto spostato: vero se è stato spostato da un'altra cartella dall'ultimo snapshot
  • Tipo di configurazione: XML / JSON
  • Stato: lo stato dell'esportazione
  • Tipo di oggetto: il tipo di oggetto nel sistema
  • Ora di fine: l'ora in cui l'oggetto è stato salvato in 3C
  • Ultimo aggiornamento di: se disponibile, l'ID dell'utente che ha modificato l'elemento nel sistema esterno
  • Snapshot originale: se l'elemento non è stato modificato, mostra l'ID dello snapshot che per primo conteneva la configurazione corrente
  • Cartella originale: se l'elemento è stato spostato, mostra la cartella precedente salvata in 3C
  • Contenuto: la configurazione salvata effettiva

Differenze

Le analisi Diff sono la seconda funzionalità importante del 3C Release Manager. Un Diff è un confronto tra due snapshot. In base al caso d'uso, può essere utilizzato per analizzare le differenze tra:

  • Lo stesso ambiente in momenti diversi: utile per i backup giornalieri e il tracciamento dei bug, per raccogliere le modifiche durante una fase di sviluppo o per convalidare un deployment
  • Ambienti diversi: utili per trovare le differenze tra un ambiente di test e uno di sviluppo, per vedere cosa deve essere distribuito, per verificare se il deployment di test corrisponde a quanto previsto dopo lo sviluppo, tra un ambiente di produzione e uno di test per vedere cosa deve entrare nel rilascio, o tra un ambiente di produzione e un sistema vanilla per raccogliere tutte le personalizzazioni apportate al sistema

L'utente può selezionare anche ambienti, non solo snapshot — utilizzando questa funzionalità, 3C Release Manager creerà un nuovo snapshot al volo e lo utilizzerà per il confronto. Le differenze possono anche servire come origine per il contenuto di Deployment o User Story, come gli snapshot.

Elenco delle differenze

Elenco dei diff di 3C con statistiche per oggetti creati, eliminati, modificati e spostati
L'elenco delle differenze — oggetti appena creati in verde, eliminati in rosso, modificati in giallo, spostati in blu.

Funzioni: Aggiorna, Nuovo diff, Info.

Controlli speciali: Selettore User Story / Deployment con lo stesso comportamento dell'elenco Snapshot.

Filtri: Ambiente di origine, Ambiente di destinazione, Intervallo di tempo di inizio, Campo di ricerca.

Campi:

  • ID: ID tecnico generato per il diff
  • Titolo: il titolo del diff
  • Stato: DONE, ERROR, WAITING, IN_PROGRESS
  • Ora di inizio: l'ora della creazione del diff
  • Tag: i tag impostati per il diff
  • Statistiche: nuovi oggetti creati in verde, oggetti eliminati o mancanti in rosso, elementi modificati in giallo, elementi spostati in blu
  • Mostra: apre la schermata Dettagli diff
  • Elimina: elimina il record del diff
  • Elementi selezionati: se viene selezionato un Deployment o una User Story, questa colonna mostra il numero di oggetti aggiunti da ogni diff

Crea diff

Schermata Crea diff di 3C con selezione di snapshot o ambiente di origine e di destinazione
La schermata Crea diff — scegliete origine e destinazione come snapshot o ambienti, con pre-filtri opzionali.

L'utente può utilizzare questa schermata per avviare un nuovo processo di diff. Se la licenza 3C è valida sia per Clarity che per Automic, l'utente deve prima selezionare il prodotto da utilizzare.

Campi:

  • Ambiente di origine: se selezionato, il processo di diff avvierà prima un nuovo processo di snapshot per l'ambiente selezionato
  • Snapshot di origine: l'elenco degli snapshot disponibili in 3C. I filtri possono essere utilizzati per ridurre l'elenco di selezione. È necessario selezionare l'Ambiente di origine o lo Snapshot di origine.
  • Ambiente di destinazione: se selezionato, il processo di diff avvierà prima un nuovo processo di snapshot per l'ambiente selezionato
  • Snapshot di destinazione: l'elenco degli snapshot disponibili in 3C. È necessario selezionare l'Ambiente di destinazione o lo Snapshot di destinazione.
  • Titolo: titolo in testo libero per il diff, obbligatorio
  • Descrizione: campo di testo libero
  • Tag: l'utente può impostare tag specifici per un diff
  • Pre-filtri personalizzati: l'utente può escludere parti specifiche della configurazione dall'analisi delle differenze, come ID generati e simili

Funzioni: Annulla, Crea.

Dettagli diff

Schermata dettagli diff 3C con riferimenti agli snapshot di origine e destinazione
La schermata Dettagli diff — snapshot sorgente, snapshot di destinazione, stato, statistiche e metadati.

Al termine del processo di diff, le analisi sono visibili nella schermata Dettagli diff.

Campi: ID (sola lettura), Titolo, Stato, Ora di inizio/fine, Snapshot di origine, Snapshot di destinazione, Descrizione, Tag.

Funzioni: Aggiorna, Indietro, Info, Salva.

Vista ad albero degli oggetti

Stesso layout della vista ad albero dello snapshot. Visualizza anche un record speciale chiamato == All diffs == che mostra tutte le differenze sul lato destro della schermata. Per l'intero diff e per le singole cartelle, i numeri blu indicano il numero totale di oggetti spostati, i numeri verdi gli oggetti appena creati, i numeri gialli gli oggetti modificati e i numeri rossi gli oggetti mancanti o eliminati.

Campi:

  • Codice oggetto: il nome dell'oggetto. Il colore dell'icona dell'oggetto rappresenta anche la modifica (rosso per eliminazione, verde per aggiunta, giallo per modifica, blu per spostamento)
  • Sorgente modificata: l'ora della modifica dell'oggetto nell'ambiente di origine
  • Destinazione modificata: l'ora della modifica dell'oggetto nell'ambiente di destinazione
  • Differenze: apre la schermata di confronto XML o ad albero per le modifiche
  • Fonte: naviga allo Snapshot di origine
  • Destinazione: naviga allo Snapshot di destinazione

Gestione di Deployment / User Story

Se nel riquadro in alto a destra è selezionata una User Story o un Deployment, la schermata cambia. Con il controllo aggiunto, è possibile selezionare cartelle, il contenuto delle cartelle o elementi specifici da aggiungere alla User Story o al Deployment selezionato.

Vista ad albero diff 3C con controlli di selezione per Deployment e User Story
Gestione del Deployment / User Story all'interno di un diff — aggiungete elementi, oggetti correlati o correlati in modo ricorsivo.

Nella vista ad albero sulla sinistra, il pulsante + aggiungerà ricorsivamente ogni elemento della cartella all'oggetto selezionato. Il pulsante – rimuoverà ricorsivamente tutto da esso. I numeri in grigio indicano quanti oggetti ci sono nella cartella che potenzialmente possono essere aggiunti e quanti di essi sono già stati aggiunti.

In cima alla lista, Aggiungi tutto aggiungerà tutti gli elementi dell'elenco mostrato sopra e Rimuovi tutto rimuoverà gli elementi.

Sui singoli record ci sono tre opzioni: Aggiungi elemento aggiunge quell'elemento specifico; Aggiungi correlati aggiunge l'elemento con oggetti direttamente correlati; Aggiungi correlati ricorsivamente aggiunge ogni elemento correlato a quello attuale, insieme ai relativi riferimenti.

Attenzione. La funzione “Aggiungi correlati ricorsivamente” può aggiungere contemporaneamente diversi altri elementi al deployment.

Dettagli oggetto diff

Dettagli dell'oggetto diff in 3C con le schede Sorgente, Destinazione e Diff per il confronto XML
La schermata Dettagli oggetto diff — schede Sorgente, Destinazione e Diff per il confronto di testo XML/JSON.

Il confronto XML apre la schermata di modifica della configurazione. La scheda Sorgente mostra la configurazione sul lato sorgente, la scheda Destinazione mostra la configurazione sul lato destinazione e la scheda Diff mostra le differenze nel codice XML o JSON, utilizzando una vista di confronto testuale.

Vista Analisi

Vista ad albero dell'analisi diff in 3C con gli elementi di configurazione XML
La vista Analisi — visualizzazione ad albero degli elementi di configurazione all'interno dell'XML di un oggetto.

Fornisce un'ulteriore schermata di visualizzazione, in cui le voci di configurazione nell'XML dell'oggetto vengono mostrate in una vista ad albero, per una più facile comprensione.

Deployment

I deployment sono il terzo elemento importante del 3C Release Manager. Un pacchetto di distribuzione è una raccolta di elementi di configurazione che possono essere prelevati direttamente da snapshot o diff, oppure aggiunti tramite user story. Un deployment ha sempre un sistema di destinazione, in cui l'utente desidera scrivere le configurazioni raccolte.

Una volta che il deployment è impostato e preparato, può essere avviato e il 3C Release Manager distribuirà automaticamente ogni passaggio uno per uno nell'ordine specificato. Il 3C Release Manager può anche creare un Backup Snapshot prima che inizi il deployment e un Validation Snapshot dopo che il deployment è terminato, in modo che le modifiche possano essere validate in seguito. In caso di errore, può essere creato automaticamente un Rollback Deployment.

Una volta che un deployment ha terminato l'esecuzione, non può più essere modificato, quindi i log di deployment possono essere utilizzati come fonte di audit per i sistemi di destinazione.

Elenco dei deployment

Elenco dei deployment di 3C con stato, tipo e ambiente di destinazione
L'elenco dei deployment — stato (DRAFT/PREPARED/IN_PROGRESS/DONE/ERROR), tipo, ambiente di destinazione e data di creazione.

Funzioni: Aggiorna, Nuova distribuzione, Info.

Filtri: Ambienti, Selettore di stato (uno o più), Intervallo data di creazione, Campo di testo (testo libero nel titolo o nella descrizione).

Campi:

  • ID: ID tecnico generato
  • Titolo: il titolo del pacchetto di distribuzione
  • Stato: DRAFT, PREPARED, IN_PROGRESS, DONE, ERROR
  • Tipo: Distribuzione o Rollback
  • Data di creazione: ora di creazione del pacchetto di distribuzione
  • Destinazione: l'ambiente di destinazione
  • Mostra: naviga alla schermata Modifica pacchetto di distribuzione
  • Elimina: elimina il deployment

Crea pacchetto di distribuzione

Schermata Crea pacchetto di distribuzione di 3C con ambiente di destinazione e titolo
La schermata Crea pacchetto di distribuzione — ambiente di destinazione, titolo e descrizione.

Campi: Ambiente di destinazione, Titolo (obbligatorio), Descrizione. Funzioni: Annulla, Crea.

I valori aggiuntivi possono essere impostati dopo la creazione.

Modifica pacchetto di distribuzione

La schermata Modifica pacchetto di distribuzione ha 5 schede:

  • Base: i dati di base del deployment
  • Regole: solo per Automic, dove l'utente può definire regole automatiche da eseguire sugli elementi di configurazione prima della distribuzione
  • Prepara pacchetto: dove l'utente può modificare i passaggi di distribuzione
  • Registro di esecuzione: dove l'utente può avviare e monitorare il pacchetto di distribuzione
  • Convalida: dove l'utente può controllare i passaggi di validazione dopo che il deployment è terminato

Scheda Base

Scheda Base della schermata Modifica deployment di 3C con user story ed elenco delle sorgenti
La scheda Base di Modifica deployment – titolo, destinazione, stato, user story ed elenco delle sorgenti (snapshot e diff utilizzati).

Se ci sono elementi in conflitto nei passaggi di distribuzione, viene visualizzato un messaggio di avviso. Viene visualizzato un altro messaggio anche se alla distribuzione sono stati aggiunti oggetti che in genere è sconsigliato modificare in un'istanza Automic.

Campi:

  • Titolo: il titolo del deployment
  • Ambiente di destinazione: l'ambiente in cui verrà eseguito il deployment
  • Stato: lo stato del deployment
  • ID deployment: ID tecnico generato automaticamente
  • Tipo di distribuzione: Distribuzione o Rollback
  • Descrizione: campo di testo libero
  • Opzioni avanzate: per disabilitare manualmente la creazione di Backup Snapshot e Validation Snapshot

User Story: l'elenco delle user story incluse nel pacchetto di distribuzione.

Elenco delle sorgenti: l'elenco degli snapshot e dei diff utilizzati come origine per i passaggi del pacchetto di distribuzione, direttamente o indirettamente tramite user story.

Funzioni: Annulla, Salva, Clona deployment (clona il deployment corrente e ne crea uno nuovo con gli stessi contenuti e le stesse impostazioni), Regole di distribuzione (naviga alla scheda successiva).

Scheda Regole (solo Automic)

Scheda Regole della schermata Modifica deployment di 3C con l'editor del set di regole AEDB Change
La scheda Regole — set di regole per singolo deployment con la sintassi dell'utility AEDB Change.

L'utente può impostare le regole effettive per questo deployment, che verranno utilizzate durante il processo. Se l'ambiente di destinazione dispone di un set di regole predefinito, queste verranno copiate qui automaticamente, ma possono anche essere eliminate dall'utente. Il processo di modifica del testo funziona in modo simile all'utility AEDB Change.

Campi:

  • Set di regole dell'ambiente: il testo che contiene le regole (ogni riga è una regola)
  • Convalida: controlla il set di regole e mostra un messaggio di errore in caso di errori di sintassi
  • Salva: salva il set di regole per il deployment. Tutti gli oggetti aggiunti al deployment attiveranno le regole e il loro contenuto verrà modificato di conseguenza.

Scheda Prepara pacchetto

Scheda Prepara pacchetto di 3C con passaggi di distribuzione ed elenco riordinabile
La scheda "Prepara pacchetto" – passaggi di distribuzione con tipo (Crea/Modifica/Elimina/Sposta/Manuale), anteprima origine e destinazione.

Analogamente ai contenuti delle user story, il pacchetto di distribuzione contiene i passaggi da eseguire durante il processo. I passaggi possono essere dei seguenti tipi:

  • Crea un nuovo oggetto (azione Crea)
  • Elimina un oggetto (azione Rimuovi) — per Clarity, l'eliminazione non funziona automaticamente a causa di limitazioni del sistema esterno
  • Modifica la configurazione di un oggetto esistente
  • Sposta un oggetto esistente in un'altra cartella — rilevante solo per le istanze Automic
  • Passaggi manuali — passaggi personalizzati durante il processo di distribuzione in cui il processo dovrebbe interrompersi, in modo che l'amministratore possa completare alcune attività manuali

Gli oggetti possono essere aggiunti da uno snapshot; le modifiche di Eliminazione/Creazione/Spostamento possono essere aggiunte da un diff.

Filtro: Ricerca testuale libera nei codici oggetto o nei tipi oggetto.

Campi:

  • Numero: l'ordine dei passaggi. I record possono essere trascinati e rilasciati dall'utente per riordinarli. I passaggi di distribuzione verranno eseguiti nell'ordine dello script durante il processo.
  • ID: ID tecnico generato. Se c'è un avviso per il record (come conflitti), qui viene mostrato anche un segnale di avviso.
  • User story: il link della user story di origine
  • Fonte: il link dello snapshot o del diff da cui ha avuto origine la configurazione
  • Tipo di passaggio: AUTO o MANUAL
  • Tipo di oggetto: se nel deployment ci sono oggetti che in genere è sconsigliato modificare, qui verrà mostrata un'icona di avviso
  • Codice oggetto: il codice dell'oggetto
  • Tipo di configurazione: XML o JSON
  • Azione: l'azione che verrà eseguita durante il deployment
  • XML da distribuire: mostra il codice dell'oggetto che verrà distribuito sul sistema di destinazione
  • Configurazione di destinazione: mostra il codice dell'oggetto che verrà sovrascritto sul sistema di destinazione
  • Operazioni:
    • Punto di interruzione: il processo di distribuzione si interromperà dopo questo passaggio finché l'utente non riprenderà la distribuzione
    • Sposta su / giù: riordina i passaggi
    • +: crea un passaggio manuale dopo quello selezionato
    • Nota: apre la nota del passaggio di distribuzione
    • Elimina: rimuove il passaggio dalla distribuzione

Funzioni: Aggiungi da Diff (naviga all'elenco delle differenze con il deployment corrente selezionato per l'aggiunta), Aggiungi da Snapshot, Preparazione completata (cambia lo stato del deployment in “Prepared”), Inizia (visibile solo per deployment con stato Prepared — avvia il processo e naviga alla scheda Registro di esecuzione).

Nota. È possibile modificare solo il contenuto di un deployment con stato “Draft”. Se era già stato preparato, utilizzare prima il pulsante Imposta su Draft per sbloccare i contenuti.

Finestra di dialogo del passaggio di distribuzione

Finestra di dialogo del passaggio di deployment di 3C con configurazione sorgente e note
La finestra di dialogo del passaggio di distribuzione — tipo di origine, codice, tipo di oggetto e la configurazione che verrà distribuita.

Mostra i dettagli del passaggio di deployment, con la configurazione che verrà utilizzata durante il deployment.

Campi: Tipo di origine (Snapshot o Diff), ID, Origine dell'oggetto, Codice, Tipo di oggetto, Fonte (la configurazione dell'oggetto), Descrizione, Note.

Scheda Registro di esecuzione

Scheda Registro di esecuzione di 3C durante un processo di distribuzione con schede di stato dei passaggi e controlli di pausa
La scheda Registro di esecuzione: controlli di pausa, ripresa e annullamento con schede di stato per ogni passaggio.
Scheda Registro di esecuzione di 3C con un deployment completato correttamente e tutti i passaggi in stato DONE
Un deployment riuscito nella scheda Registro di esecuzione — ogni passaggio in stato DONE.

Dopo l'avvio del processo di distribuzione, è possibile utilizzare questo log per monitorare il processo. Se l'opzione Snapshot di backup è abilitata, 3C Release Manager creerà prima uno snapshot che conterrà ogni elemento che verrà modificato durante il processo di distribuzione. Una volta terminato, inizierà con il primo passaggio.

Se non ci sono passaggi manuali o breakpoint impostati sui passaggi, ogni passaggio verrà eseguito automaticamente e poi verrà creato uno snapshot di validazione delle modifiche. Se il processo di distribuzione si interrompe, può essere continuato utilizzando il pulsante Riprendi oppure l'intero processo può essere interrotto con il pulsante Annulla .

Se il processo viene messo in pausa, i passaggi di distribuzione possono essere ripetuti o saltati ed è anche possibile aggiungere altri punti di interruzione.

Funzioni:

  • Pausa: mette in pausa il processo di deployment
  • Riprendi: riprende un processo di distribuzione in pausa
  • Annulla: pulsante di panico — interrompe il processo di distribuzione completamente e imposta la distribuzione sullo stato Annullato

Schede dei passaggi di distribuzione:

  • Numero: il numero d'ordine del passaggio
  • Stato: DONE, WAITING, IN_PROGRESS, ERROR
  • ID: ID del passaggio di distribuzione
  • Tipo: Automatico o manuale
  • Oggetto: il tipo di oggetto
  • Codice: il codice oggetto
  • Tipo di configurazione: XML o JSON
  • Titolo: il titolo della modifica
  • Elenco esecuzioni: se il passaggio è già stato eseguito, il registro di esecuzione verrà mostrato qui
  • Dettagli: mostra i dettagli e le note del passaggio
  • Ripeti: visibile solo se il processo è in pausa — 3C tenterà di eseguire nuovamente lo stesso passaggio
  • Salta: visibile solo se il processo è in pausa — 3C non eseguirà il passaggio
  • Completa: visibile solo per passaggi manuali — l'utente deve completare manualmente l'attività prima che il processo riprenda

Finestra dettagli esecuzione

Finestra dettagli di esecuzione 3C con ora di inizio, ora di fine e risultato
La finestra Dettagli Esecuzione — numero esecuzione, stato (SUCCESS/ERROR), tempi, risultato e configurazione della richiesta.

Mostra i dettagli dell'esecuzione di un passaggio di distribuzione.

Campi: Numero di esecuzione (1 se non ci sono state ripetizioni), Stato dell'esecuzione (SUCCESS o ERROR), Orario di inizio, Orario di fine, Risultato (OK in caso di successo, altrimenti il messaggio di errore dal sistema esterno), Richiesta (la configurazione utilizzata per il deployment).

Scheda Convalida

Scheda Convalida di 3C con snapshot di backup, snapshot di validazione e pulsante Rollback
La scheda Convalida — snapshot di backup, snapshot di validazione, diff di validazione e il pulsante Rollback.

Visibile solo dopo che il deployment è terminato. Questa schermata raccoglie le informazioni di Backup Snapshot, Validation Snapshot e Validation Diff in un unico posto. Se tutto è andato bene, l'analisi delle differenze dovrebbe mostrare esattamente ciò che intendevate distribuire nell'ambiente di destinazione.

Funzioni:

  • Rollback: in caso di errore o di un deployment non riuscito, utilizzate il pulsante Rollback. Verrà creato un Rollback Deployment speciale che è l'esatto opposto del deployment corrente, ripristinando lo stato degli oggetti utilizzando il Backup Snapshot. Dopo la creazione, il Rollback Deployment funziona come un deployment standard e deve essere avviato manualmente.

User Story

Le User Story fungono da contenitore logico per le modifiche collegate a un requisito di business. Il modo consigliato di usare il 3C Release Manager è il seguente:

  • Definite le user story nel sistema, di norma provenienti da un sistema esterno di gestione delle user story
  • Create uno snapshot dall'ambiente di sviluppo prima che lo sviluppo inizi
  • Create uno snapshot dall'ambiente di sviluppo dopo la fine dello sviluppo
  • Create un'analisi delle differenze tra i due snapshot
  • Sulla base delle differenze, raccogliete le singole modifiche e collegatele alle user story. In questo modo il team avrà una chiara comprensione del perché ogni modifica di configurazione è stata effettuata e quali requisiti di business ne sono interessati.

In seguito, le user story possono essere aggiunte ai deployment per trasferire le modifiche nel sistema desiderato.

Elenco delle user story

Elenco delle User Story di 3C con stato, sprint e sistema attivo
L'elenco delle User Story — stato, sprint, sistema attivo e i deployment di cui fa parte la user story.

Funzioni: Aggiorna, Nuova User Story, Info.

Filtri: Filtro degli stati (stati visibili), Selezione sprint, Campo di ricerca (testo libero nei titoli e nelle descrizioni).

Campi:

  • ID: ID tecnico generato
  • Nome: il nome della user story
  • Stato: lo stato attuale (DRAFT, WORK IN PROGRESS, READY FOR DEVELOPMENT, TESTING, DONE, ecc.)
  • Sprint: lo sprint a cui è collegata la user story
  • Sistema attivo: il sistema a cui è collegato lo stato attuale
  • Deployment: l'elenco dei deployment di cui fa parte la user story
  • Mostra: naviga alla schermata dei dettagli della user story
  • Elimina: cancella la user story

Crea user story

Schermata Crea User Story di 3C con nome, link esterno e utente responsabile
La schermata Crea User Story — nome, riferimento al sistema di ticketing esterno e utente responsabile.

Questa schermata consente di creare nuove user story nel 3C Release Manager. Le user story possono essere create anche dalle pagine Snapshot e Diff.

Campi:

  • Nome del prodotto: visibile solo se la chiave di licenza 3C è valida sia per Clarity sia per Automic
  • Nome: obbligatorio, campo di testo libero
  • Numero della User Story: opzionale, per memorizzare l'ID della user story nei sistemi di ticketing esterni, come Jira
  • Link esterno: facoltativo, per memorizzare il link del ticket esterno
  • Descrizione: campo di testo libero
  • Utente responsabile: facoltativo, l'utente 3C Release Manager responsabile della user story

Funzioni: Annulla, Salva.

Modifica user story

La schermata contiene 5 schede diverse: Descrizione, Contenuto, Analisi dei conflitti, Deployment, Attività.

Scheda Descrizione

Scheda Descrizione della schermata Modifica User Story di 3C con user story padre e figlie e sprint
La scheda Descrizione — user story padre/figlie, gestione degli sprint e riferimenti ai ticket esterni.

Serve a modificare i dati di base della user story.

Campi:

  • Prodotto: visibile solo se entrambe le licenze Clarity e Automic sono valide
  • ID della user story: ID tecnico generato
  • Nome: obbligatorio, campo di testo libero
  • Numero della User Story: opzionale, per riferimento al sistema di ticketing esterno
  • Link esterno: opzionale, per l'URL del ticket esterno
  • Descrizione: testo libero
  • Utente responsabile: opzionale
  • User story padre: le user story possono essere organizzate in gerarchie — qui l'utente può selezionare un'altra user story come padre di questa
  • User story figlie: l'elenco delle user story correlate a questa
  • Stato: lo stato attuale (campo informativo)
  • Sistema attivo: il sistema esterno attuale in cui sono già state distribuite le modifiche contenute nella user story
  • Sprint: controllo di gestione dello sprint per selezionare uno sprint esistente o crearne uno nuovo tramite finestra di dialogo
  • Creato il / Ultima modifica: timestamp di sola lettura

Funzioni: Annulla, Salva.

Scheda Contenuto

Scheda Contenuto della schermata Modifica User Story di 3C con modifiche di configurazione da snapshot e diff
La scheda Contenuto — modifiche di configurazione aggiunte da snapshot e diff, con tipo di azione e note.

L'utente può gestire i contenuti della user story: le effettive modifiche di configurazione.

Filtro: Cerca oggetti (ricerca testuale libera nei codici e tipi di oggetto).

Campi:

  • ID: ID tecnico generato dell'elemento di configurazione
  • Fonte: la sorgente da cui è stato aggiunto l'oggetto o la modifica all'oggetto (snapshot o elemento di diff)
  • Tipo di oggetto: il tipo dell'oggetto
  • Codice oggetto: il codice dell'oggetto
  • Azione: Aggiunta, Eliminazione, Modifica, Spostamento o Personalizzato (in caso di passaggio manuale)
  • XML da distribuire: mostra il codice di configurazione dell'oggetto
  • Note: mostra le note dell'utente relative all'oggetto
  • Elimina: elimina l'oggetto dalla user story

Funzioni: Aggiungi da Snapshot (naviga all'elenco Snapshot con la user story corrente selezionata per l'aggiunta), Aggiungi da Diff, Aggiungi passaggio manuale (aggiunge un passaggio personalizzato all'elenco).

Finestra di dialogo Elemento di configurazione

Finestra di dialogo Elemento di configurazione della User Story in 3C con i dettagli dell'elemento di configurazione selezionato
La finestra di dialogo Elemento di configurazione — tipo di sorgente, codice, tipo di oggetto e la configurazione salvata.

Mostra i dettagli dell'elemento di configurazione selezionato, con il suo codice corrente e altri metadati.

Campi: Tipo di origine (Snapshot o Diff), ID, Origine oggetto, Codice, Tipo di oggetto, Origine (la configurazione), Descrizione, Note.

Scheda Analisi dei conflitti

Scheda Analisi dei conflitti della User Story in 3C che elenca le user story con modifiche sovrapposte agli oggetti
La scheda Analisi dei conflitti — altre user story che interessano gli stessi elementi di configurazione.

Questo elenco mostra ogni altra user story che può entrare in conflitto con quella attuale. Verranno visualizzate tutte le user story che contengono modifiche per gli stessi elementi di configurazione. L'elenco mostra anche l'oggetto in conflitto. Questa funzionalità è progettata per coordinare le modifiche agli oggetti per gruppi di sviluppo numerosi.

Campi:

  • ID della user story: l'ID 3C della user story in conflitto
  • User Story: il nome della user story in conflitto
  • Stato: lo stato attuale della user story in conflitto
  • Proprietario: il proprietario della user story in conflitto
  • Oggetto in conflitto: il tipo e il codice dell'oggetto contenuto nella user story
  • Mostra: naviga verso la user story in conflitto

Scheda Deployment

Scheda Deployment della User Story in 3C con selettore di deployment
La scheda Deployment della user story — aggiungete la user story ai deployment esistenti o createne uno nuovo.

Usata per aggiungere user story ai deployment. Mostra anche ogni deployment che contiene la user story. Il modo consigliato di utilizzare il 3C Release Manager è raccogliere le modifiche nelle user story; la stessa user story dovrebbe essere aggiunta al deployment dell'ambiente di Test e successivamente a quello dell'ambiente di Produzione.

Campi: ID, Titolo, Ambiente di destinazione, Stato, Creato il, Mostra, Elimina.

Funzioni: Selettore di deployment (elenca i deployment disponibili). Selezionando un deployment, il pulsante Aggiungi al deployment viene mostrato. Quando – Nuovo deployment – è selezionato, il pulsante Crea nuovo deployment diventa visibile e consente di aprire la finestra di dialogo per la creazione del deployment.

Scheda Attività

Scheda Attività della User Story in 3C con modifiche di audit e commenti manuali
La scheda Attività: registro di controllo delle modifiche con l'opzione per aggiungere commenti manuali.

Utilizzata a scopo di audit: mostra le modifiche apportate alla user story. Qui è possibile aggiungere anche commenti manuali.


5 · Aggiornamento e migrazione

Aggiornamento e migrazione

3C Release Manager — i suoi aggiornamenti seguono le stesse due varianti dell'installazione iniziale: manuale e guidata. Gli esempi utilizzano valori generici; assicuratevi che questi vengano sostituiti con i valori corretti per l'ambiente 3C Release Manager di destinazione.

Aggiornamento — manuale

PASSO 1
Fermate Tomcat
Arrestate il servizio Apache Tomcat prima di apportare qualsiasi modifica ai file.
PASSO 2
Distribuzione WAR

Copiate i nuovi file WAR in <TOMCAT_HOME>/webapps/:

  • threec.war
  • threec-auth.war
  • threec-backend.war
  • threec-frontend.war
PASSO 3
Rimozione file temporanei

Rimuovete le seguenti cartelle da <TOMCAT_HOME>/work/Catalina/localhost:

  • threec
  • threec-auth
  • threec-backend
  • threec-frontend
PASSO 4
Finalizzazione
  • Riavviate Apache Tomcat.
  • Verificate che il deployment sia riuscito controllando i log di Tomcat e gli URL dell'applicazione.

Aggiornamento — guidato

PASSO 1
Avviate l'aggiornamento
Avviate lo script di aggiornamento dedicato.
Prompt dei comandi dell'installer di aggiornamento 3C con il messaggio Welcome to 3C v3.2.0 upgrade installer
Passaggio 1 — Avviate l'aggiornamento. L'esecuzione di upgrade3c.bat apre la finestra dei comandi dell'installer di aggiornamento.
PASSO 2
Impostazioni delle directory

Inserite le seguenti directory, che devono essere disponibili:

  • Directory HOME di Tomcat (ad es. c:/Automic/Tomcat-3C)
  • Directory HOME di Java (ad es. c:/Program Files/Java/jdk-17)
Installer di aggiornamento 3C: richiesta delle impostazioni delle directory home di Tomcat e Java
Passaggio 2 — Impostazioni delle directory. L'installer di aggiornamento richiede le directory home di Tomcat e Java.
PASSO 3
Impostazioni di Tomcat
Inserite le impostazioni di Tomcat relative al nome di dominio e alla porta da utilizzare (ad es. http://localvm:8061). Dopo aver inserito le impostazioni di Tomcat, la migrazione inizia immediatamente.
Installer di aggiornamento 3C: impostazioni di Tomcat con MIGRATE DATABASE SCHEMA
Passaggio 3 — Impostazioni di Tomcat. Dopo aver inserito l'host e la porta di Tomcat, la migrazione dello schema del database inizia immediatamente.
PASSO 4
Distribuzione WAR
La rimozione dei vecchi file e il deployment dei nuovi file WAR saranno elaborati automaticamente.
Installer di aggiornamento 3C: passaggio di deployment dei WAR con REMOVING OLD FILES e COPYING NEW FILES
Passaggio 4 — Deployment dei WAR. I vecchi file vengono rimossi e i nuovi file WAR vengono copiati in <TOMCAT_HOME>/webapps.
PASSO 5
Aggiornamento della configurazione
I file di configurazione per l'applicazione Tomcat verranno aggiornati automaticamente.
Installer di aggiornamento 3C: passaggio di aggiornamento della configurazione con UPDATING CONFIGURATION FILES
Passaggio 5 — Aggiornamento della configurazione. L'installer di aggiornamento sovrascrive i file application-prod.properties per tutti e tre i moduli.
PASSO 6
Finalizzazione
  • Riavviate Apache Tomcat.
  • Verificate che il deployment sia riuscito controllando i log di Tomcat e gli URL dell'applicazione.

6 · Note di rilascio

Note di rilascio

Versioni recenti di 3C Release Manager e cosa è cambiato in ciascuna.

v3.3.4

TipoDescrizione
MiglioramentoPrincipio dei quattro occhi
Correzione bugCorrezioni di bug dell'installer GUI

v3.3.3

TipoDescrizione
MiglioramentoAggiunto l'installer GUI
Correzione bugCorrezioni varie di bug

v3.3.2

TipoDescrizione
Correzione bugCorretti limiti del conteggio degli oggetti — query migliorate
MiglioramentoVelocità di deployment migliorata

v3.3.1

TipoDescrizione
MiglioramentoAggiunta funzionalità di import/export per supportare l'importazione e l'esportazione dei file ZIP di snapshot
MiglioramentoImportazione ed elaborazione JSON e XML migliorate per gestire strutture di blueprint e preservare l'identità degli oggetti
MiglioramentoGestione migliorata dei timestamp di inizio e fine degli snapshot durante l'importazione

v3.3.0

TipoDescrizioneNote
MiglioramentoRuoli personalizzati aggiunti
MiglioramentoGestione dei blueprint 3CSupporto Clarity 16.3.3
MiglioramentoSottoschede nel modulo blueprintSupporto Clarity 16.3.3
Correzione bugCorrezioni minori di bug per stabilità e manutenibilità

7 · Domande frequenti

Domande frequenti

Fate clic su una domanda qualsiasi per espandere la risposta.

Che cos'è 3C Release Manager e cosa fa?

3C Release Manager è uno strumento di trasporto, confronto e distribuzione per Automic Automation che rivoluziona il modo in cui le configurazioni si spostano tra gli ambienti DEV, TEST, UAT e PROD. Estende il Transport Case standard di Automic con acquisizione di configurazioni basata su snapshot, analisi delle differenze tra ambienti e punti temporali, pacchetti di distribuzione con rollback automatico, raggruppamento delle modifiche basato su user story e sincronizzazione Git opzionale.

3C Release Manager viene eseguito come applicazione web Java/Spring su Apache Tomcat con un backend PostgreSQL, integrandosi con Automic Automation Engine V21 o versioni successive tramite l'API Java su TLS.

Quali versioni di Automic sono supportate?

3C Release Manager richiede Automic Automation Engine V21 o superiore. L'integrazione utilizza l'API Java Automic tramite comunicazione protetta da TLS. Avete bisogno di uno o più client Automic configurati per ogni istanza e certificati compatibili con TLS.

Il 3C Release Manager supporta anche Clarity PPM come sistema di destinazione alternativo, se la vostra licenza include il modulo Clarity: entrambi possono essere gestiti dalla stessa istanza 3C.

Quali sono i requisiti tecnici per l'installazione di 3C Release Manager?

Il 3C Release Manager è indipendente dalla piattaforma e può essere distribuito su Microsoft Windows (64 bit) o Linux (64 bit, qualsiasi distribuzione moderna supportata dai fornitori come RHEL, Rocky Linux, Ubuntu LTS). I componenti richiesti sono:

  • Java 21 (Open Edition / OpenJDK)
  • Apache Tomcat 10 con HTTPS/TLS abilitato
  • PostgreSQL 15 con connettività JDBC
  • Accesso di rete dal backend 3C alle vostre istanze Automic
  • Certificati compatibili con TLS per la comunicazione con Automic
Come vengono archiviate le password?

Per gli utenti 3C, le password vengono archiviate in formato hash. Per gli ambienti esterni (istanze Automic), la password viene archiviata utilizzando la crittografia bidirezionale: ciò è necessario affinché 3C possa connettersi al sistema esterno per conto dell'utente tecnico configurato.

Quali sono il nome utente e la password predefiniti dopo l'installazione?

Le credenziali predefinite del superutente dopo una nuova installazione sono: nome utente super, password super. Modificatela subito dopo il primo accesso tramite la pagina Il mio profilo.

Qual è la differenza tra uno snapshot e un diff?

Uno snapshot è una rappresentazione della configurazione di un ambiente Automic in un determinato momento. 3C si collega all'ambiente e scarica ogni oggetto di configurazione in base ai filtri configurati. Gli snapshot fungono da cronologia della configurazione, backup di sistema e origine per i pacchetti di distribuzione.

Un diff è un confronto tra due snapshot – o tra due ambienti, nel qual caso 3C crea gli snapshot al volo. I diff rivelano cosa differisce tra origine e destinazione: oggetti appena creati, eliminati, modifiche e spostamenti. Sono tipicamente il punto di partenza per definire l'ambito di una distribuzione.

Perché il mio primo snapshot richiede così tanto tempo rispetto ai successivi?

Il 3C Release Manager esporta e salva gli oggetti in modo incrementale. Il primo snapshot di un nuovo ambiente deve scaricare ogni oggetto di configurazione, il che richiede tempo. Ogni snapshot successivo memorizza solo gli oggetti che sono cambiati rispetto allo snapshot precedente, riducendo significativamente sia il tempo di esecuzione che il consumo del database.

Per velocizzare gli snapshot in generale, considerate la configurazione di filtri che escludono tipi di configurazione irrilevanti, in modo che vengano catturati solo gli oggetti importanti.

Come funziona il rollback in caso di fallimento di un deployment?

Ogni deployment crea automaticamente uno Snapshot di backup prima dell'esecuzione, che contiene ogni elemento che verrà modificato durante il processo di distribuzione. Dopo la distribuzione, uno Snapshot di validazione viene creato per verificare le modifiche.

Se qualcosa va storto, la scheda Convalida mette a disposizione il pulsante Rollback. Crea un Rollback Deployment speciale che è l'esatto opposto del deployment originale e ripristina gli oggetti interessati a partire dal Backup Snapshot. Il rollback funziona come un deployment standard e deve essere avviato manualmente.

Più team di sviluppo possono lavorare in parallelo senza sovrascrivere le modifiche degli altri?

Sì. La scheda Analisi dei conflitti di ogni user story elenca automaticamente tutte le altre user story che contengono modifiche per gli stessi elementi di configurazione. La vista mostra quale oggetto in conflitto è interessato, chi è il proprietario della user story in conflitto e il suo stato attuale, e consente di passare direttamente alla user story in conflitto.

Questo è progettato specificamente per coordinare le modifiche degli oggetti per i grandi gruppi di sviluppo, dove il lavoro parallelo sugli stessi oggetti Automic porterebbe altrimenti a sovrascritture silenziose durante il deployment.

Come si integra 3C con Git (GitHub o Bitbucket)?

L'integrazione di Git in 3C Release Manager è una configurazione in due passaggi:

1. Impostazioni Git a livello di tenant. Un amministratore configura l'URL del repository Git e il metodo di connessione (Credenziali con nome utente/password, o SSH con chiave privata) in Amministrazione → Impostazioni Git. L'utente tecnico deve disporre delle autorizzazioni di commit e push sul repository.

2. Sincronizzazione Git per ambiente. Nella scheda Impostazioni Git di ogni ambiente, impostate un nome di branch (creato automaticamente se non esiste) e attivate Sincronizzazione Git abilitata. Da quel momento in poi, ogni snapshot riuscito scrive la configurazione nel file system ed esegue automaticamente il commit/push delle modifiche nel branch configurato.

Cosa succede agli oggetti nella cronologia quando vengono eliminati dal sistema esterno?

Gli oggetti eliminati rimangono visibili nella cronologia 3C in base agli snapshot precedenti che li hanno acquisiti. Potete ancora accedere alla loro configurazione precedente tramite la vista Cronologia dell'elenco Oggetti, anche se l'oggetto non esiste più nell'istanza Automic di origine. Ciò rende 3C una fonte affidabile per audit e indagini forensi anche per gli oggetti che sono stati rimossi dal sistema in esecuzione.

Come posso eseguire modifiche massive (ad esempio rinominare host) durante un deployment?

Il 3C Release Manager supporta modifiche massive basate su regole durante il deployment utilizzando la stessa sintassi della utility AEDB Change di Automic. Potete definire set di regole a due livelli:

  • Per ambiente — nella scheda Regole di distribuzione dell'ambiente. Queste regole vengono copiate come impostazioni predefinite in ogni nuovo deployment che ha come destinazione tale ambiente.
  • Per deployment — nella scheda Regole del deployment. Il set di regole predefinito dell'ambiente viene copiato qui automaticamente e può essere modificato o rimosso.

Quando una distribuzione viene eseguita, le regole vengono applicate automaticamente a ogni oggetto prima che venga scritto sul sistema di destinazione. Usate il pulsante Convalida per verificare la presenza di errori di sintassi nel set di regole prima del salvataggio.

Come posso controllare la dimensione del database e qual è la crescita prevista?

Per controllare la dimensione del database, usate la riga di comando di PostgreSQL:

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

Oppure usate questa query 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;

Valore di riferimento: 20 MB è la dimensione tipica per 1 snapshot di 2.600 elementi di configurazione (con filtro per 2 lingue) più 5 diff con circa 300 modifiche ciascuno.

Come funziona il principio dei quattro occhi per i rilasci dei trasporti?

Il principio dei 4 occhi è stato introdotto nella versione 3.3.4 del 3C Release Manager per supportare ambienti in cui le azioni di trasporto richiedono una tracciabilità esplicita — tipicamente settori regolamentati o organizzazioni IT con controllo delle modifiche. Richiede un secondo utente per approvare le release di trasporto prima che possano essere eseguite, garantendo che nessun singolo individuo possa distribuire modifiche a un ambiente di destinazione senza controllo.

In combinazione con il registro di controllo (che registra ogni azione importante del sistema con utente, timestamp e modulo), questo garantisce la tracciabilità richiesta dagli ambienti soggetti a requisiti di conformità.

Avete bisogno di aiuto con 3C nel vostro ambiente?
Parlate con i nostri esperti di installazione, integrazione, formazione o licenze.
Torna in alto