- Ambito tecnico e architettura
- Installazione — prerequisiti, percorsi manuale e guidato
- Configurazione — gateway, auth, backend, impostazioni di sistema in-app
- Utilizzo — amministrazione, ambienti, snapshot, differenze, deployment, user story
- Aggiornamento e migrazione
- Note di rilascio
- FAQ
Video (in inglese, 1:45): l’installazione guidata con install3c.bat in nove passaggi, dai prerequisiti al primo accesso.
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
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
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.
- 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).
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 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.
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.
Create le directory di configurazione dell'applicazione richieste, se non esistono già, quindi copiate i file di configurazione del logging:
| File sorgente | Percorso 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 |
Gateway. Modificate <TOMCAT_HOME>/appconf/threec/application-prod.properties
| Parametro | Valore |
|---|---|
| logging.config | <TOMCAT_HOME>/appconf/threec/logback.xml |
| spring.cloud.gateway.mvc.routes[0].uri | http://<TOMCAT_HOST>:<PORT> |
| spring.cloud.gateway.mvc.routes[1].uri | http://<TOMCAT_HOST>:<PORT> |
| spring.cloud.gateway.mvc.routes[2].uri | http://<TOMCAT_HOST>:<PORT> |
| spring.cloud.gateway.mvc.routes[3].uri | http://<TOMCAT_HOST>:<PORT> |
| spring.cloud.gateway.mvc.routes[4].uri | http://<TOMCAT_HOST>:<PORT> |
Autenticazione. Modificate <TOMCAT_HOME>/appconf/threec-auth/application-prod.properties
| Parametro | Valore |
|---|---|
| logging.config | <TOMCAT_HOME>/appconf/threec-auth/logback.xml |
| capture.authorization.gateway-uri | http://<TOMCAT_HOST>:<PORT> |
| spring.datasource.url | jdbc:postgresql://<PG_HOST>:<PORT>/<DBNAME> |
| spring.datasource.username | <DBUSER> |
| spring.datasource.password | <DBPASSWORD> |
Backend. Modificate <TOMCAT_HOME>/appconf/threec-backend/application-prod.properties
| Parametro | Valore |
|---|---|
| logging.config | <TOMCAT_HOME>/appconf/threec-backend/logback.xml |
| spring.datasource.url | jdbc:postgresql://<PG_HOST>:<PORT>/<DBNAME> |
| spring.datasource.username | <DBUSER> |
| spring.datasource.password | <DBPASSWORD> |
| spring.security.oauth2.resourceserver.jwt.jwk-set-uri | http://<TOMCAT_HOST>:<PORT>/threec-auth/oauth2/jwks |
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
threec-auth.xml
threec-backend.xml
- 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.
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)
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)
- 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.
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.
| Parametro | Descrizione |
|---|---|
| logging.config | Proprietà 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.name | Imposta il nome logico dell'applicazione Spring. Predefinito: 3c-gateway |
| spring.cloud.gateway.mvc.routes[N].id | Definisce un ID di route per Spring Cloud Gateway (basato su MVC). |
| spring.cloud.gateway.mvc.routes[N].uri | Specifica 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.
| Parametro | Descrizione |
|---|---|
| logging.config | Percorso del file di configurazione Logback. |
| spring.datasource.driverClassName | Classe driver JDBC utilizzata per connettersi a PostgreSQL. Predefinito: org.postgresql.Driver |
| spring.datasource.url | URL di connessione JDBC per il database. Esempio: jdbc:postgresql://localhost:5432/db3c |
| spring.datasource.username | Nome utente utilizzato dall'applicazione per autenticarsi con PostgreSQL. |
| spring.datasource.password | Password utilizzata dall'applicazione per l'autenticazione con PostgreSQL. |
| capture.authorization.gateway-context-path | Definisce il percorso di contesto con cui il gateway espone l'applicazione. Predefinito: /threec |
| capture.authorization.gateway-uri | URL di base del servizio gateway di autorizzazione. |
| capture.authorization.rsa-key | Contiene 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
| Parametro | Descrizione |
|---|---|
| logging.config | Carica la configurazione di Logback da un percorso di file esterno (livelli, appender, posizioni/rotazione dei file di log, formati, ecc.). |
Serializzazione JSON
| Parametro | Descrizione |
|---|---|
| spring.jackson.mapper.default-view-inclusion | Abilita 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-strategy | Serializza/deserializza proprietà JSON in SNAKE_CASE (ad es. created_at) invece di camelCase. |
| spring.data.web.pageable.one-indexed-parameters | I 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
| Parametro | Descrizione |
|---|---|
| spring.datasource.driverClassName | Classe del driver JDBC per PostgreSQL. |
| spring.datasource.url | URL di connessione JDBC. |
| spring.datasource.username | Utente del DB usato dall'applicazione. |
| spring.datasource.password | Password del database utilizzata dall'applicazione. |
| spring.datasource.hikari.pool-name | Nome del pool Hikari (visualizzato nei log/metriche). Predefinito: db-pool |
| spring.datasource.hikari.maximum-pool-size | Numero massimo di connessioni DB nel pool. Predefinito: 30 |
| spring.datasource.hikari.minimum-idle | Numero minimo di connessioni inattive mantenute pronte. Predefinito: 1 |
| spring.datasource.hikari.idle-timeout | Per quanto tempo (ms) una connessione inattiva può restare aperta prima di essere chiusa (quando si supera minimum-idle). Predefinito: 30000 |
| spring.datasource.hikari.connection-timeout | Tempo massimo (ms) di attesa per una connessione dal pool prima di fallire. Predefinito: 5000 |
| spring.datasource.hikari.max-lifetime | Durata 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-platform | Indica a Hibernate quale dialetto SQL utilizzare. Predefinito: org.hibernate.dialect.PostgreSQLDialect |
| spring.jpa.open-in-view | Disabilita “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_strategy | Strategia 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-order | Permette 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
| Parametro | Descrizione |
|---|---|
| spring.security.oauth2.resourceserver.jwt.jwk-set-uri | URL da cui l'app recupera il JWK Set (chiavi pubbliche) per verificare le firme JWT. |
| capture.authorization.rsa-key | Materiale chiave RSA (spesso un blob simile a JWK/JWKS) utilizzato per la firma/verifica nei flussi di autorizzazione. |
| capture.encryption.secret.key | Segreto di crittografia dell'applicazione (utilizzato per crittografare dati sensibili / token / valori di configurazione a seconda dell'implementazione). |
| capture.encryption.salt | Sale usato con hashing/derivazione delle chiavi (aiuta a proteggere contro gli attacchi rainbow table). |
| server.servlet.session.cookie.secure | Contrassegna 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
| Parametro | Descrizione |
|---|---|
| capture.license.server.url | Endpoint del server di licenza (vuoto → non impostato, disabilitato o fornito altrove). |
| capture.system.cache-time-to-live | TTL per una cache interna in secondi. Predefinito: 86400 (24 ore). |
XOG (comunicazione con sistemi esterni)
| Parametro | Descrizione |
|---|---|
| capture.xog.timeout-in-seconds | Timeout della richiesta per chiamate XOG. Predefinito: 300 |
| capture.xog.connection-timeout-in-seconds | Timeout per l'instaurazione della connessione per le chiamate XOG. Predefinito: 20 |
| capture.xog.http-buffersize-bytes | Dimensione del buffer HTTP in byte. Predefinito: 33554432 (≈ 32 MiB). Utile per payload di grandi dimensioni. |
| capture.xog.soap-cache-time-to-live | TTL per la cache relativa a SOAP in secondi. Predefinito: 60 |
Scheduler ed esecuzione delle attività
| Parametro | Descrizione |
|---|---|
| capture.scheduler.enabled | Attiva/disattiva lo scheduler dell'applicazione. |
| capture.worker.settings.refresh.interval | Con quale frequenza vengono aggiornate le impostazioni dei worker (ms). Predefinito: 30000 (30 secondi). |
| capture.task.execution.pool.core-size | Numero di thread worker di base (core). Predefinito: 30 |
| capture.task.execution.pool.max-size | Numero massimo di thread consentiti sotto carico. Predefinito: 60 |
| capture.task.execution.pool.queue-capacity | Dimensione della coda per le attività in sospeso prima che intervengano nuovi thread/limiti massimi. Predefinito: 300 |
| capture.task.execution.pool.keep-alive | Per quanto tempo i thread aggiuntivi (non core) vengono mantenuti attivi (spesso in secondi). Predefinito: 10 |
| spring.task.scheduling.pool.size | Dimensione 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
| Parametro | Descrizione |
|---|---|
| capture.limit.parallel.diff | Max processi diff paralleli. Predefinito: 10 |
| capture.limit.parallel.snapshot | Max processi snapshot paralleli. Predefinito: 4 |
| capture.interval.diff.populator.agent | Intervallo dell'agente diff populator (ms). Predefinito: 300000 |
| capture.interval.diff.worker.agent | Intervallo dell'agente diff worker (ms). Predefinito: 300000 |
| capture.interval.snapshot.populator.agent | Intervallo dell'agente di popolamento snapshot (ms). Predefinito: 300000 |
| capture.interval.snapshot.worker.agent | Intervallo dell'agente snapshot worker (ms). Predefinito: 300000 |
| capture.interval.deployment.worker.agent | Intervallo dell'agente deployment worker (ms). Predefinito: 300000 |
| capture.interval.cleanup.worker.agent | Intervallo dell'agente di pulizia (ms). Predefinito: 300000 |
| capture.interval.diff.status.agent | Intervallo dell'agente di stato diff (ms). Predefinito: 30000 |
| capture.interval.snapshot.status.agent | Intervallo dell'agente di stato snapshot (ms). Predefinito: 30000 |
Watchdog
| Parametro | Descrizione |
|---|---|
| capture.watchdog.external-internal | Seleziona la modalità watchdog interna o esterna. Per on-premise: INTERNAL |
| capture.watchdog.snapshot-interval | Intervallo watchdog snapshot (ms). Predefinito: 1800000 |
| capture.watchdog.diff-interval | Intervallo watchdog diff (ms). Predefinito: 1800000 |
Integrazione AWS (disabilitata per impostazione predefinita nelle installazioni on-premise)
| Parametro | Descrizione |
|---|---|
| spring.cloud.aws.sqs.enabled | Disabilita la configurazione/integrazione automatica di AWS SQS quando impostato su false. |
| spring.cloud.aws.sns.enabled | Disabilita la configurazione/integrazione automatica di AWS SNS quando impostato su false. |
| cloud.aws.region.auto | Disabilita il rilevamento automatico della regione quando impostato su false. |
| cloud.aws.region.static | Imposta esplicitamente la regione AWS. Predefinito: eu-central-1 (Francoforte). |
Ciclo di vita del server e gestione degli errori
| Parametro | Descrizione |
|---|---|
| server.shutdown | Abilita lo spegnimento graduale quando impostato su graceful (smette di accettare nuove richieste, finisce il lavoro in corso). |
| spring.lifecycle.timeout-per-shutdown-phase | Tempo concesso per ciascuna fase di spegnimento prima di forzare la terminazione. Predefinito: 3s |
| server.error.include-message | Include l'eccezione/il messaggio nelle risposte di errore (utile per il debug, ma può rivelare dettagli in produzione). |
Impostazioni di sistema nell'app
Oltre ai file di proprietà, diversi parametri di runtime possono essere regolati da un SUPERUSER tramite la schermata Impostazioni di sistema dell'app.
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
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
L'interfaccia utente web del 3C Release Manager contiene i seguenti elementi:
- Barra dei menu
- Barra degli strumenti utente
- Titolo della pagina
- Pulsanti di azione della pagina
- Informazioni e aiuto
- Azioni speciali relative al contenuto
- Controlli di filtro dell'elenco
- Contenuto dell'elenco
- Paginazione
- Elementi dell'elenco — in genere i campi ID e Titolo aprono la vista di dettaglio
- Azioni sulle voci dell'elenco, come modifica ed eliminazione
- Controllo del numero di record per elenco
Barra degli strumenti utente
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
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
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.
Disconnessione
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
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
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
Gli utenti possono modificare le proprie informazioni personali nella pagina Il mio profilo modificando le informazioni inserite:
- Nome
- Cognome
- Indirizzo e-mail
Dopo la modifica, fare clic sul pulsante Salva per confermare. Se il salvataggio va a buon fine, viene mostrato un messaggio di notifica.
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.
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
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.
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.
Utenti
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.
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.
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
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
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
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
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
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.
Crea ambiente
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.
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
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
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
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
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
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
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)
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
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.
Vista Cronologia
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
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)
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)
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
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
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
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
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
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.
Schermata Dettagli oggetto
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
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
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
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.
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.
Dettagli oggetto diff
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
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
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
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
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)
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
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).
Finestra di dialogo del passaggio di distribuzione
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
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
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
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
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
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
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
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
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
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
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à
Utilizzata a scopo di audit: mostra le modifiche apportate alla user story. Qui è possibile aggiungere anche commenti manuali.
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
Copiate i nuovi file WAR in <TOMCAT_HOME>/webapps/:
- threec.war
- threec-auth.war
- threec-backend.war
- threec-frontend.war
Rimuovete le seguenti cartelle da <TOMCAT_HOME>/work/Catalina/localhost:
- threec
- threec-auth
- threec-backend
- threec-frontend
- Riavviate Apache Tomcat.
- Verificate che il deployment sia riuscito controllando i log di Tomcat e gli URL dell'applicazione.
Aggiornamento — guidato
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)
- Riavviate Apache Tomcat.
- Verificate che il deployment sia riuscito controllando i log di Tomcat e gli URL dell'applicazione.
Note di rilascio
Versioni recenti di 3C Release Manager e cosa è cambiato in ciascuna.
v3.3.4
| Tipo | Descrizione |
|---|---|
| Miglioramento | Principio dei quattro occhi |
| Correzione bug | Correzioni di bug dell'installer GUI |
v3.3.3
| Tipo | Descrizione |
|---|---|
| Miglioramento | Aggiunto l'installer GUI |
| Correzione bug | Correzioni varie di bug |
v3.3.2
| Tipo | Descrizione |
|---|---|
| Correzione bug | Corretti limiti del conteggio degli oggetti — query migliorate |
| Miglioramento | Velocità di deployment migliorata |
v3.3.1
| Tipo | Descrizione |
|---|---|
| Miglioramento | Aggiunta funzionalità di import/export per supportare l'importazione e l'esportazione dei file ZIP di snapshot |
| Miglioramento | Importazione ed elaborazione JSON e XML migliorate per gestire strutture di blueprint e preservare l'identità degli oggetti |
| Miglioramento | Gestione migliorata dei timestamp di inizio e fine degli snapshot durante l'importazione |
v3.3.0
| Tipo | Descrizione | Note |
|---|---|---|
| Miglioramento | Ruoli personalizzati aggiunti | |
| Miglioramento | Gestione dei blueprint 3C | Supporto Clarity 16.3.3 |
| Miglioramento | Sottoschede nel modulo blueprint | Supporto Clarity 16.3.3 |
| Correzione bug | Correzioni minori di bug per stabilità e manutenibilità |
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:
Oppure usate questa query SQL:
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à.