- Périmètre technique et architecture
- Installation — prérequis, installation manuelle et guidée
- Configuration — passerelle, authentification, backend, paramètres système intégrés
- Utilisation — administration, environnements, instantanés, diffs, déploiements, user stories
- Mise à niveau et migration
- Notes de publication
- FAQ
Vidéo (en anglais, 1:45) : l’installation guidée avec install3c.bat en neuf étapes, des prérequis jusqu’à la première connexion.
Architecture et périmètre technique
Le 3C Release Manager est une application web à 3 niveaux déployée sur une pile technologique basée sur Java, avec des intégrations externes sécurisées vers Automic. Comprendre l'architecture facilite le dimensionnement, le dépannage et la planification de l'intégration.
Aperçu de l'architecture
Couche d'accès utilisateur
- Les utilisateurs finaux accèdent au système via HTTPS.
- Le trafic est chiffré de bout en bout à l'aide de TLS.
- Les requêtes sont adressées au front-end web hébergé dans l'environnement 3C Release Manager.
Couche applicative
L'application principale est déployée au sein d'un serveur d'applications Tomcat et se compose de deux éléments principaux :
Front-end
- Implémenté avec Angular.
- Servi par Tomcat dans le cadre de l'application 3C Release Manager.
- Responsable du rendu de l'interface utilisateur, de la logique côté client et de la communication avec le backend via des API REST.
Back-end
- Implémenté à l'aide de Spring (Spring Boot / Spring Framework).
- Expose une API RESTful consommée par le front-end Angular et les systèmes externes (Automic).
- Gère la logique métier, l'authentification/l'autorisation et l'accès à la base de données.
- La communication entre le front-end et le back-end s'effectue via REST.
Couche de données
- Utilise PostgreSQL comme base de données relationnelle.
- Le backend se connecte à la base de données à l'aide de JDBC.
- La base de données stocke toutes les données persistantes de l'application 3C Release Manager.
Intégration système
- Le système s'intègre avec Automic.
- Prise en charge de multiples instances Automic (système / clients).
- La communication utilise une API Java.
- La sécurité du transport est assurée par TLS.
- Les connexions sont initiées depuis le back-end 3C Release Manager vers les clients Automic.
Aperçu de la sécurité et de la communication
HTTPS/TLS est utilisé pour toutes les communications externes : utilisateur → front-end et backend → Automic. La communication interne utilise REST entre le front-end et le backend, et JDBC entre le backend et la base de données.
Résumé de l'architecture logique
- Niveau de présentation : Front-end Angular
- Niveau applicatif : Backend basé sur Spring, exécuté sur Tomcat
- Niveau de données : Base de données PostgreSQL
- Niveau d'intégration : Intégration sécurisée avec Automic via l'API Java
Exigences et compatibilité
Les exigences techniques minimales pour déployer et faire fonctionner l'application 3C Release Manager.
Système d'exploitation
Le 3C Release Manager est indépendant de la plateforme et peut être déployé sur :
- Microsoft Windows (64 bits)
- Linux (64 bits) — toute distribution moderne et prise en charge par un fournisseur (par exemple, RHEL, Rocky Linux, Ubuntu LTS)
Le système d'exploitation doit prendre en charge : Java 21, PostgreSQL 15, Apache Tomcat 10, la communication réseau sécurisée par TLS.
Environnement d'exécution Java (JRE)
- Version minimale : Java 21
- Édition : Open Edition (OpenJDK)
La JRE est requise pour exécuter le serveur d'applications Apache Tomcat et l'application backend du 3C Release Manager (basée sur Spring), ainsi que pour prendre en charge la communication TLS sécurisée avec les systèmes externes (Automic).
Serveur d'applications
- Version minimale : Apache Tomcat 10
Tomcat est nécessaire pour héberger l'application 3C Release Manager, servir le front-end basé sur Angular, exécuter les composants backend Java et fournir des points de terminaison REST pour la communication interne et externe. Tomcat doit être configuré pour Java 21, avec HTTPS/TLS activé et des paramètres de mémoire et de threads adaptés à une utilisation en production.
Base de données
- Version minimale : PostgreSQL 15
PostgreSQL est utilisé comme magasin de données persistant pour 3C. Exigences : connectivité JDBC depuis le backend 3C Release Manager, stockage et performances suffisants pour les données de l'application, configuration d'accès sécurisée (authentification, restrictions réseau).
Intégration de systèmes externes (Automic)
- Version minimale : Automic Automation Engine V21
Automic est intégré à 3C via l'API Java et une communication sécurisée par TLS. Prérequis : une ou plusieurs instances d'Automic (version V21 ou supérieure), un ou plusieurs clients Automic configurés par instance, connectivité réseau entre le backend 3C et les instances Automic, certificats compatibles pour la communication TLS.
Réseau et sécurité
HTTPS/TLS doit être activé pour l'accès des utilisateurs au front-end du 3C Release Manager et pour la communication entre le backend et Automic.
Ports à ouvrir :
- Port HTTPS de Tomcat (généralement 443 ou personnalisé)
- Port PostgreSQL (par défaut 5432)
- Ports de communication Automic tels que définis par l'installation Automic
Installation
Le 3C Release Manager est disponible en deux variantes d'installation : manuelle (contrôle total, adapté aux environnements isolés ou durcis) et guidée (script d’installation interactif install3c.bat, plus rapide pour les configurations standard). Les deux produisent le même résultat.
Vous préférez d’abord regarder ? L’installation guidée est également disponible en vidéo de moins de deux minutes.
Vérifications préalables à l'installation
Avant de procéder à l'installation du 3C Release Manager, assurez-vous que tous les prérequis sont installés, accessibles et pleinement fonctionnels.
Disponibilité de PostgreSQL
- PostgreSQL est installé sur le serveur de base de données désigné.
- Le psql (client en ligne de commande) est disponible et exécutable.
- Une connexion au serveur PostgreSQL peut être établie en utilisant psql.
- Le service PostgreSQL est en cours d'exécution et écoute sur le port configuré (par défaut : 5432).
- Vérification en ligne de commande : psql –version
Disponibilité de Java Runtime / Development Kit
- JRE ou JDK version 17 est installé (Open Edition).
- Le java (commande) est disponible dans le PATH du système.
- Java s'exécute correctement et affiche la bonne version.
- Le JAVA_HOME (variable d'environnement) est correctement défini (recommandé).
- Vérification en ligne de commande : java -version
Disponibilité d'Apache Tomcat
- Apache Tomcat version 10 est installé.
- Tomcat fonctionne sans erreurs.
- Le service Tomcat est accessible via une URL HTTP depuis un navigateur ou une ligne de commande.
- Le port HTTP/HTTPS configuré est ouvert et accessible.
- Vérification via le navigateur : http://<tomcat_host>:<port>
Installation — manuelle
Effectuez les étapes suivantes pour installer le 3C Release Manager manuellement. Les exemples utilisent des valeurs génériques ; assurez-vous de les remplacer par les valeurs correctes pour l'environnement cible.
- Téléchargez le dernier package d'installation du 3C Release Manager depuis la source de distribution officielle.
- Vérifiez l'intégrité du package conformément aux normes internes (par exemple somme de contrôle, signature).
Créer un utilisateur de base de données dédié. Créez un utilisateur PostgreSQL dédié pour le 3C Release Manager (exemple : db3cuser) avec des privilèges restreints et les propriétés suivantes : NOSUPERUSER, INHERIT, NOCREATEDB, NOCREATEROLE, NOCREATEREPLICATION.
Créer une base de données dédiée. Créez la base de données 3C Release Manager avec les propriétés suivantes : Encodage UTF8, Propriétaire db3cuser, Espace de tables pg_default, Limite de connexion -1 (illimité), Modèle template0, Collation C, CTYPE C.
Déployez les composants de l'application 3C Release Manager en copiant les fichiers WAR suivants dans <TOMCAT_HOME>/webapps/:
- threec.war
- threec-auth.war
- threec-backend.war
- threec-frontend.war
Tomcat déploiera automatiquement les applications au démarrage.
Créez les répertoires de configuration des applications requis s'ils n'existent pas déjà, puis copiez les fichiers de configuration des journaux :
| Fichier source | Emplacement cible |
|---|---|
| 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 |
Passerelle. Ajuster <TOMCAT_HOME>/appconf/threec/application-prod.properties
| Paramètre | Valeur |
|---|---|
| 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> |
Authentification. Ajuster <TOMCAT_HOME>/appconf/threec-auth/application-prod.properties
| Paramètre | Valeur |
|---|---|
| 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. Ajuster <TOMCAT_HOME>/appconf/threec-backend/application-prod.properties
| Paramètre | Valeur |
|---|---|
| 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 |
Configurez les fichiers de contexte Tomcat pour qu'ils référencent les emplacements de configuration Spring externes. Créez les fichiers suivants dans <TOMCAT_HOME>/conf/Catalina/localhost/:
threec.xml
threec-auth.xml
threec-backend.xml
- Assurez-vous que les permissions des fichiers permettent à Tomcat de lire les fichiers de configuration et de journal.
- Redémarrez Apache Tomcat.
- Attendez l'initialisation de la base de données.
- Redémarrez Apache Tomcat une deuxième fois.
- Vérifiez le bon déroulement du déploiement dans les journaux Tomcat et via les URL de l'application.
Installation — guidée
Effectuez les étapes suivantes pour installer le 3C Release Manager à l'aide du script d'installation dédié. Les exemples utilisent des valeurs génériques ; assurez-vous de les remplacer par les valeurs correctes pour l'environnement cible.
Saisissez les répertoires suivants, qui doivent être disponibles :
- Répertoire HOME de Tomcat (par exemple c:/Automic/Tomcat-3C)
- Répertoire Java HOME (par exemple c:/Program Files/Java/jdk-17)
- Répertoire HOME de PostgreSQL (par exemple c:/Program Files/PostgreSQL/17)
Entrez les paramètres de base de données suivants :
- Nom de la base de données (par exemple db3c)
- Nom du serveur de base de données (par exemple localhost)
- Port du serveur de base de données (par exemple 5432)
- Nom d'utilisateur de la base de données (par exemple db3c)
- Mot de passe de l'utilisateur de la base de données (pas le mot de passe maître postgres)
- Assurez-vous que les permissions des fichiers permettent à Tomcat de lire les fichiers de configuration et de journal.
- Redémarrez Apache Tomcat.
- Vérifiez le bon déroulement du déploiement dans les journaux Tomcat et via les URL de l'application.
Vérification post-installation
Quelle que soit la méthode d'installation choisie, confirmez le déploiement en recherchant dans les journaux de Tomcat d'éventuelles erreurs de démarrage des quatre applications WAR, en ouvrant l'URL de la passerelle (l'écran de connexion 3C doit apparaître) et en vous connectant avec le super utilisateur par défaut (voir Configuration → valeurs par défaut) — changez le mot de passe immédiatement.
Référence de configuration
Le 3C Release Manager est configuré par trois fichiers application-prod.properties (un par module) : 3C-Gateway, 3C-Auth, et 3C-Backend. Au-delà de ces fichiers de propriétés, plusieurs paramètres d'exécution du 3C Release Manager peuvent être ajustés par un SUPERUSER via l'écran System Settings de l'application. La référence complète des paramètres suit.
3C-Gateway (threec)
Le module passerelle achemine les requêtes entrantes vers le service backend approprié.
| Paramètre | Description |
|---|---|
| logging.config | Propriété de journalisation standard Spring Boot / Java. Spécifie l'emplacement exact du fichier de configuration de la journalisation. Exemple : file:/c:/Automic/Tomcat-3C/appconf/threec/logback.xml |
| spring.application.name | Définit le nom logique de l'application Spring. Par défaut : 3c-gateway |
| spring.cloud.gateway.mvc.routes[N].id | Définit un ID de route pour Spring Cloud Gateway (basé sur MVC). |
| spring.cloud.gateway.mvc.routes[N].uri | Spécifie le service backend cible pour cette route. |
| spring.cloud.gateway.mvc.routes[N].predicates[0] | Définit un prédicat de route (une condition pour faire correspondre les requêtes). Exemple : Path=/oauth2/** |
| spring.cloud.gateway.mvc.routes[N].filters[0] | Applique un filtre qui modifie le chemin de la requête. Exemple : StripPrefix=1 |
| spring.cloud.gateway.mvc.routes[N].filters[1] | Ajoute un nouveau préfixe au chemin de la requête après StripPrefix. Exemple : PrefixPath=/threec-auth |
3C-Auth (threec-auth)
Le module d'authentification gère la connexion, l'émission de JWT et la gestion des identifiants.
| Paramètre | Description |
|---|---|
| logging.config | Chemin du fichier de configuration Logback. |
| spring.datasource.driverClassName | Classe de pilote JDBC utilisée pour se connecter à PostgreSQL. Par défaut : org.postgresql.Driver |
| spring.datasource.url | URL de connexion JDBC pour la base de données. Exemple : jdbc:postgresql://localhost:5432/db3c |
| spring.datasource.username | Nom d'utilisateur utilisé par l'application pour s'authentifier auprès de PostgreSQL. |
| spring.datasource.password | Mot de passe utilisé par l'application pour s'authentifier auprès de PostgreSQL. |
| capture.authorization.gateway-context-path | Définit le chemin de contexte sous lequel la passerelle expose l'application. Par défaut : /threec |
| capture.authorization.gateway-uri | URL de base du service de passerelle d'autorisation. |
| capture.authorization.rsa-key | Contient la clé RSA (codée en Base64) utilisée dans les flux d'autorisation. |
3C-Backend (threec-backend)
Le module backend est la logique principale de l'application. Il contient le plus grand ensemble de paramètres configurables, regroupés ci-dessous par sujet.
Journalisation
| Paramètre | Description |
|---|---|
| logging.config | Charge la configuration Logback à partir d'un chemin de fichier externe (niveaux, appenders, emplacements de fichiers journaux/rotation, formats, etc.). |
Sérialisation JSON
| Paramètre | Description |
|---|---|
| spring.jackson.mapper.default-view-inclusion | Active l'inclusion par défaut des propriétés lors de l'utilisation de Jackson @JsonView. Si la valeur est true, les propriétés qui ne figurent pas explicitement dans une vue peuvent tout de même être incluses (ce qui peut influer sur les champs affichés dans les réponses de l'API). |
| spring.jackson.property-naming-strategy | Sérialise/désérialise les propriétés JSON en SNAKE_CASE (par exemple created_at) au lieu de camelCase. |
| spring.data.web.pageable.one-indexed-parameters | Les paramètres de pagination commencent à 0 lorsque la valeur est false (page=0 est la première page). Si la valeur est true, page=1 correspond à la première page. |
Base de données et pool de connexions
| Paramètre | Description |
|---|---|
| spring.datasource.driverClassName | Classe du pilote JDBC pour PostgreSQL. |
| spring.datasource.url | URL de connexion JDBC. |
| spring.datasource.username | Utilisateur de la base de données utilisé par l'application. |
| spring.datasource.password | Mot de passe de la base de données utilisé par l'application. |
| spring.datasource.hikari.pool-name | Nom du pool Hikari (apparaît dans les journaux/métriques). Par défaut : db-pool |
| spring.datasource.hikari.maximum-pool-size | Nombre maximum de connexions DB dans le pool. Par défaut : 30 |
| spring.datasource.hikari.minimum-idle | Nombre minimum de connexions inactives maintenues prêtes. Par défaut : 1 |
| spring.datasource.hikari.idle-timeout | Durée (ms) pendant laquelle une connexion inactive peut rester ouverte avant d'être retirée (lorsque le nombre de connexions dépasse minimum-idle). Par défaut : 30000 |
| spring.datasource.hikari.connection-timeout | Délai d'attente maximal (ms) pour obtenir une connexion du pool avant échec. Par défaut : 5000 |
| spring.datasource.hikari.max-lifetime | Durée de vie maximale (ms) d'une connexion avant son remplacement. Souvent définie en dessous des limites de la base de données/du réseau pour éviter les connexions obsolètes. Par défaut : 60000 |
| spring.jpa.database-platform | Indique à Hibernate quel dialecte SQL utiliser. Par défaut : org.hibernate.dialect.PostgreSQLDialect |
| spring.jpa.open-in-view | Désactive « Open Session in View » lorsque la valeur est false (empêche le chargement différé lors du rendu des réponses web ; généralement préférable pour les performances et une architecture propre). |
| spring.jpa.properties.hibernate.id.db_structure_naming_strategy | Stratégie de nommage du générateur d'ID Hibernate pour les structures de base de données (affecte le nommage des séquences/tables utilisées pour les identifiants). Par défaut : single |
| spring.flyway.out-of-order | Permet d'appliquer des migrations « hors ordre » (par exemple si une version inférieure apparaît après qu'une version supérieure a déjà été appliquée). Utile dans certains flux de publication, mais risqué si cette option n'est pas maîtrisée. |
Sécurité et authentification
| Paramètre | Description |
|---|---|
| spring.security.oauth2.resourceserver.jwt.jwk-set-uri | URL où l'application récupère l'ensemble JWK (clés publiques) pour vérifier les signatures JWT. |
| capture.authorization.rsa-key | Matériel de clé RSA (souvent un blob de type JWK/JWKS) utilisé pour la signature/vérification dans les flux d'autorisation. |
| capture.encryption.secret.key | Secret de chiffrement de l'application (utilisé pour chiffrer les données sensibles / jetons / valeurs de configuration selon l'implémentation). |
| capture.encryption.salt | Sel utilisé avec le hachage/la dérivation de clé (aide à se protéger contre les attaques par table arc-en-ciel). |
| server.servlet.session.cookie.secure | Marque les cookies de session comme Secure (envoyés uniquement via HTTPS). Si HTTPS n'est pas utilisé de bout en bout, les sessions risquent de ne pas être conservées dans les navigateurs. |
Licence et cache
| Paramètre | Description |
|---|---|
| capture.license.server.url | Point de terminaison du serveur de licences (vide → non défini, désactivé ou fourni ailleurs). |
| capture.system.cache-time-to-live | TTL pour un cache interne en secondes. Par défaut : 86400 (24 heures). |
XOG (communication avec les systèmes externes)
| Paramètre | Description |
|---|---|
| capture.xog.timeout-in-seconds | Délai d'attente de la requête pour les appels XOG. Par défaut : 300 |
| capture.xog.connection-timeout-in-seconds | Délai d'établissement de la connexion pour les appels XOG. Par défaut : 20 |
| capture.xog.http-buffersize-bytes | Taille du tampon HTTP en octets. Par défaut : 33554432 (≈ 32 Mio). Pratique pour les charges utiles volumineuses. |
| capture.xog.soap-cache-time-to-live | TTL pour le cache lié à SOAP en secondes. Par défaut : 60 |
Ordonnanceur et exécution des tâches
| Paramètre | Description |
|---|---|
| capture.scheduler.enabled | Active/désactive l'ordonnanceur de l'application. |
| capture.worker.settings.refresh.interval | Fréquence d'actualisation des paramètres des workers (ms). Par défaut : 30000 (30 secondes). |
| capture.task.execution.pool.core-size | Nombre de threads de travail de base. Par défaut : 30 |
| capture.task.execution.pool.max-size | Nombre maximum de threads autorisés en charge. Par défaut : 60 |
| capture.task.execution.pool.queue-capacity | Taille de la file d'attente pour les tâches en attente avant que les nouveaux threads/limites maximales n'interviennent. Par défaut : 300 |
| capture.task.execution.pool.keep-alive | Durée pendant laquelle les threads supplémentaires (hors threads de base) restent actifs (souvent en secondes). Par défaut : 10 |
| spring.task.scheduling.pool.size | Taille du pool de threads pour les tâches planifiées de Spring (@Scheduled), séparé du pool d'exécution personnalisé. Par défaut : 10 |
Limites de parallélisme et intervalles des agents
| Paramètre | Description |
|---|---|
| capture.limit.parallel.diff | Nombre maximum de diffs parallèles. Par défaut : 10 |
| capture.limit.parallel.snapshot | Nombre maximum de jobs de snapshot parallèles. Par défaut : 4 |
| capture.interval.diff.populator.agent | Intervalle de l'agent de remplissage de différences (ms). Par défaut : 300000 |
| capture.interval.diff.worker.agent | Intervalle de l'agent diff worker (ms). Par défaut : 300000 |
| capture.interval.snapshot.populator.agent | Intervalle de l'agent de remplissage d'instantané (ms). Par défaut : 300000 |
| capture.interval.snapshot.worker.agent | Intervalle de l'agent de traitement d'instantané (ms). Par défaut : 300000 |
| capture.interval.deployment.worker.agent | Intervalle de l'agent de traitement de déploiement (ms). Par défaut : 300000 |
| capture.interval.cleanup.worker.agent | Intervalle de l'agent de nettoyage (ms). Par défaut : 300000 |
| capture.interval.diff.status.agent | Intervalle de l'agent d'état des diffs (ms). Par défaut : 30000 |
| capture.interval.snapshot.status.agent | Intervalle de l'agent d'état d'instantané (ms). Par défaut : 30000 |
Chien de garde
| Paramètre | Description |
|---|---|
| capture.watchdog.external-internal | Sélectionne le mode de chien de garde interne ou externe. Pour une installation sur site : INTERNAL |
| capture.watchdog.snapshot-interval | Intervalle de surveillance de l'instantané (ms). Par défaut : 1800000 |
| capture.watchdog.diff-interval | Intervalle de surveillance des diffs (ms). Par défaut : 1800000 |
Intégration AWS (désactivée par défaut pour le mode sur site)
| Paramètre | Description |
|---|---|
| spring.cloud.aws.sqs.enabled | Désactive la configuration automatique/l'intégration d'AWS SQS lorsque la valeur est false. |
| spring.cloud.aws.sns.enabled | Désactive la configuration automatique/l'intégration d'AWS SNS lorsque la valeur est false. |
| cloud.aws.region.auto | Désactive la détection automatique de la région lorsque la valeur est false. |
| cloud.aws.region.static | Définit la région AWS explicitement. Par défaut : eu-central-1 (Francfort). |
Cycle de vie du serveur et gestion des erreurs
| Paramètre | Description |
|---|---|
| server.shutdown | Active l'arrêt en douceur lorsque la valeur est graceful (arrête d'accepter de nouvelles requêtes, termine le travail en cours). |
| spring.lifecycle.timeout-per-shutdown-phase | Temps autorisé par phase d'arrêt avant de forcer la terminaison. Par défaut : 3s |
| server.error.include-message | Inclut l'exception/le message dans les réponses d'erreur (utile pour le débogage, mais peut divulguer des détails en production). |
Paramètres du système dans l'application
Au-delà des fichiers de propriétés, plusieurs paramètres d'exécution peuvent être ajustés par un SUPERUSER via l'écran System Settings de l'application.
Agents internes
- Agents d'instantané : le nombre d'agents qui travaillent en parallèle sur un nouvel instantané. Un trop grand nombre d'agents peut ralentir le système externe connecté et augmente la consommation de ressources sur le serveur de 3C. Sur les serveurs anciens, dont le CPU et la mémoire sont limités, nous recommandons un nombre d'agents moins élevé.
- Agents d'état des instantanés : il est recommandé de conserver la valeur 1.
- Agents de remplissage d'instantanés : il est recommandé de conserver la valeur 1.
- Agents de diff : le nombre d'agents qui travaillent en parallèle sur un nouveau diff. Un trop grand nombre d'agents nécessite davantage de ressources sur le serveur de 3C. Sur les serveurs anciens, dont le CPU et la mémoire sont limités, nous recommandons un nombre d'agents moins élevé.
- Agents d'état des diffs : il est recommandé de conserver la valeur 1.
- Agents de remplissage des diffs : il est recommandé de conserver la valeur 1.
- Agents de déploiement : il est recommandé de conserver la valeur 1.
- Agents de nettoyage : il est recommandé de conserver la valeur 1.
Agents externes
Non utilisé dans les versions sur site.
Identifiants par défaut
Après l'installation du 3C Release Manager, le super utilisateur par défaut est :
- Nom d'utilisateur : super
- Mot de passe : super
Utilisation — exploitation du 3C Release Manager
Après l'installation et la configuration du 3C Release Manager, le flux de travail typique suit la structure suivante : Locataires → Utilisateurs → Environnements → Instantanés → Diffs → User Stories → Déploiements. Les sections ci-dessous décrivent chaque domaine fonctionnel tel qu'il apparaît dans l'interface web.
Disposition et navigation
La disposition générale du 3C Release Manager se compose des modules suivants : menu principal, barre d'outils utilisateur, tableaux et contenu.
Disposition principale
L'interface utilisateur web 3C Release Manager contient les éléments suivants :
- Barre de menu
- Barre d'outils utilisateur
- Titre de la page
- Boutons d'action de page
- Informations et aide
- Actions spéciales liées au contenu
- Contrôles de filtre de liste
- Contenu de la liste
- Pagination
- Éléments de liste — en général, les champs ID et Titre ouvrent la vue détaillée
- Actions sur les éléments de liste, par exemple modifier ou supprimer
- Contrôle du nombre d'enregistrements de la liste
Barre d'outils utilisateur
Cliquer sur la petite icône de profil en haut à droite de l'écran ouvre le sous-menu utilisateur. Le premier élément du menu ouvre l'écran Mon profil de l'application.
Menu
La structure du menu du 3C Release Manager est la suivante :
- Accueil : ce bouton vous ramène à la page d'accueil du 3C Release Manager.
- Environnements : accède à la page Liste d’environnements pour afficher la liste des environnements connectés ou créer de nouvelles connexions.
- Instantanés : accède à la page Liste des instantanés pour afficher les instantanés existants ou en créer de nouveaux.
- Diffs : accède à la page Liste des diffs pour afficher les diffs existants ou en créer de nouveaux.
- Déploiements : accède à la page Liste des packages de déploiement pour afficher les packages de déploiement existants ou en créer de nouveaux.
- User Stories : accède à la page Liste des User Stories pour afficher les User Stories existantes ou en créer de nouvelles.
- Administration :
- Locataires : visible uniquement pour le SUPERUSER
- Utilisateurs : accède à la page Liste des utilisateurs pour gérer les utilisateurs
- Paramètres système : paramètres système globaux
- Paramètres GIT : Configuration du dépôt Git
- Journal d'audit : accède à la page Journal d'audit pour consulter les informations de la piste d'audit
- Paramètres de licence : un écran pour gérer la clé de licence
- À propos : accède à la page À propos pour voir des informations supplémentaires sur l'application
La visibilité des éléments du menu dépend des rôles de l'utilisateur connecté (voir droits et rôles).
Connexion et déconnexion
Connexion
Lorsqu'ils entrent l'URL correcte de l'application, les utilisateurs sont d'abord invités à se connecter sur l'écran de connexion. Les informations d'identification nécessaires sont :
- Nom d'utilisateur
- Mot de passe
Cochez l'option Se souvenir de moi pour enregistrer le nom d'utilisateur en vue des connexions ultérieures. Après une connexion réussie, les utilisateurs sont dirigés vers la page d'accueil du 3C Release Manager.
Déconnexion
Pour se déconnecter de l'application, les utilisateurs doivent cliquer sur l'action Déconnexion dans la barre d'outils utilisateur. La déconnexion de l'application redirige vers l'écran de connexion.
Mon profil
Page Mon profil
La page Mon profil se compose de trois sections :
- Section Données principales : informations personnelles principales — Nom d'utilisateur (LoginID), Prénom, Nom de famille, Adresse e-mail.
- Section Changer le mot de passe : offre la possibilité de changer le mot de passe actuel.
- Section Mes rôles : informations sur les rôles actuels de l'utilisateur connecté. Les rôles ne peuvent être modifiés qu'à partir de l'écran Détails de l'utilisateur dans la liste des utilisateurs, par un utilisateur ayant le rôle Administrateur d'utilisateurs.
Accéder à la page Mon profil
Les utilisateurs peuvent ouvrir la page Mon profil pour consulter et modifier leurs informations personnelles ou changer leur mot de passe actuel. Pour accéder à la page Mon profil, sélectionnez l'icône de compte dans la barre d'outils utilisateur et cliquez sur l'entrée Connecté en tant que nom d'utilisateur dans le sous-menu.
Modifier les informations personnelles
Les utilisateurs peuvent modifier leurs informations personnelles sur la page Mon profil en modifiant les informations saisies :
- Prénom
- Nom de famille
- Adresse e-mail
Après modification, cliquez sur le bouton Enregistrer pour valider. Une fois l'enregistrement effectué, un message de notification s'affiche.
Changer le mot de passe
Les utilisateurs ont la possibilité de changer leur mot de passe actuel sur la page Mon profil :
- Saisir le mot de passe actuel
- Saisir le nouveau mot de passe
- Saisir à nouveau le nouveau mot de passe dans le champ « Confirmer le mot de passe »
- Cliquer sur le bouton Changer le mot de passe pour valider
Lorsqu'un changement de mot de passe est effectué avec succès, un message de notification s'affiche.
Administration
Cette section contient toutes les fonctions administratives et les possibilités de configuration de l'application 3C Release Manager : Locataires, Utilisateurs, Paramètres système, Paramètres Git, Journal d'audit, Paramètres de licence. Pour accéder à ces fonctions, des rôles administratifs élevés sont requis.
Locataires
Les locataires sont des conteneurs spéciaux dans 3C représentant des entreprises ou des départements spécifiques. Ils ne sont accessibles que par les utilisateurs ayant le rôle SUPERUSER. Pour la version SaaS, ces paramètres ne sont pas accessibles par les utilisateurs. Pour la version sur site, il est conseillé d'utiliser le locataire DEFAULT, et les utilisateurs administrateurs généraux doivent être créés sous ce locataire.
Liste des locataires. Affiche les locataires actuellement disponibles dans le système. Le locataire DEFAULT ne peut pas être supprimé.
Fonctions :
- Rafraîchir : rafraîchit la vue de liste actuelle
- Nouveau locataire : ouvre l'écran Créer un locataire
- Infos : affiche le panneau d'informations
Champs :
- Identifiant : ID technique généré automatiquement
- Nom : le titre de la fiche locataire
- Licence : active ou inactive, en fonction des paramètres de licence
- Modules sous licence : Clarity, Automic ou les deux, en fonction des paramètres de licence
- Créé le : heure de création de l'enregistrement
- Modifier : accède à l'écran des détails du locataire
- Supprimer : supprime le locataire
Créer un locataire. Champs obligatoires : Nom du locataire (doit être unique), Description (texte libre). Après la création, les utilisateurs du locataire ne peuvent accéder qu'aux objets de ce même locataire, ce qui les sépare des objets des autres locataires.
Modifier le locataire. L'utilisateur peut voir les détails du locataire et modifier certains de ses attributs. Champs : ID du locataire (lecture seule), Nom du locataire, Description, Créé par, Créé le. Fonctions : Annuler, Enregistrer.
Utilisateurs
Les utilisateurs représentent les comptes de connexion dans le système. Les écrans administratifs permettent de gérer les détails des utilisateurs, les mots de passe et les rôles.
Champs de la liste des utilisateurs :
- LoginID : l'identifiant de l'utilisateur, utilisé pour se connecter à 3C
- Nom : nom réel de l'utilisateur
- E-mail : l'adresse e-mail de l'utilisateur
- Locataire : le locataire auquel l'utilisateur est lié
- Actif : indique si l'utilisateur est actif (peut se connecter au système)
- Créé le : heure de création de l'utilisateur
- Modifier / Supprimer
Champs de création d'utilisateur : LoginID (obligatoire, unique), Prénom (obligatoire), Nom (obligatoire), E-mail (obligatoire), Actif (désactivé par défaut — seuls les utilisateurs actifs peuvent se connecter), Mot de passe (initial), Confirmer le mot de passe. Les rôles de l'utilisateur ne peuvent être définis qu'après la création.
Modifier l'utilisateur. L'utilisateur peut voir les détails et modifier certains attributs, changer le mot de passe ou modifier les rôles actifs. Le LoginID ne peut pas être modifié après sa création.
Rôles disponibles :
- USER_USER : peut accéder à la liste des utilisateurs et aux détails de l'utilisateur
- USER_MANAGER : peut accéder à la liste des utilisateurs, peut supprimer des utilisateurs, peut créer de nouveaux utilisateurs, peut modifier des utilisateurs
- ENVIRONMENT_USER : peut accéder à la liste des environnements et aux détails d'un environnement
- ENVIRONMENT_MANAGER : peut accéder à la liste des environnements, peut supprimer des environnements, peut créer de nouveaux environnements, peut modifier les détails d'un environnement (y compris les paramètres de connexion, le mot de passe, les filtres, les paramètres Git)
- SCHEDULE_USER : peut accéder aux instantanés planifiés de l'environnement
- SCHEDULE_MANAGER : peut accéder aux instantanés planifiés de l'environnement, les modifier, les supprimer ou en créer de nouveaux
- SNAPSHOT_USER : peut accéder à la liste des instantanés et aux détails de l'instantané
- SNAPSHOT_MANAGER : peut accéder à la liste des instantanés, peut supprimer des instantanés, peut démarrer un nouvel instantané, peut modifier les métadonnées d'un instantané
- DIFF_USER : peut accéder à la liste des diffs et aux détails d'un diff
- DIFF_MANAGER : peut accéder à la liste des diffs, supprimer des diffs existants, créer un nouveau diff et modifier les métadonnées d'un diff
- DEPLOYMENT_USER : peut accéder à la liste des déploiements et voir les détails d'un déploiement, y compris les exécutions
- DEPLOYMENT_MANAGER : peut accéder à la liste des déploiements, supprimer les déploiements existants, créer de nouveaux déploiements, démarrer de nouveaux processus de déploiement, modifier leur contenu
- USER_STORY_USER : peut accéder à la liste des User Stories et aux détails des User Stories
- USER_STORY_MANAGER : peut accéder aux User Stories et les modifier, supprimer des User Stories existantes, en créer de nouvelles et modifier leur contenu
- SUPERUSER : peut accéder à n'importe quelle fonctionnalité dans 3C, peut modifier les locataires, définir de nouvelles clés de licence
Paramètres Git
Ces paramètres sont requis pour synchroniser la configuration du système connecté avec un dépôt Git externe. Il s'agit d'un paramètre global, défini au niveau du locataire. Pour se connecter à un dépôt Git, l'utilisateur doit définir l'URL du dépôt ainsi que les identifiants d'un utilisateur technique autorisé à effectuer des commits et des push vers ce dépôt. Une clé SSH peut également être utilisée.
Champs :
- URL du dépôt Git : l'URL du dépôt
- Type de connexion : Identifiants ou SSH
- Identifiants : Nom d'utilisateur, Mot de passe, Confirmer le mot de passe
- SSH : Clé SSH privée requise par le fournisseur Git
- Connecté : après la création ou la modification, le 3C Release Manager essaiera de se connecter au dépôt à l'aide des paramètres, et confirmera si la connexion fonctionne
Fonctions : Enregistrer enregistre les valeurs modifiées ; Tester la connexion essaye de se connecter au dépôt en utilisant les paramètres actuels.
Journal d'audit
Ce tableau est une liste représentative des événements et actions importants effectués dans le système à des fins d'audit et de suivi des bogues.
Champs :
- Identifiant du journal : ID technique généré
- Identifiant de connexion : l'identifiant de l'utilisateur associé
- Niveau de journalisation : le niveau du message (INFO, WARNING, ERROR)
- Heure du journal : l'horodatage du message
- Message de journal : le message lui-même
- Module : le nom du module système à l'origine du message
Paramètres de licence
Sur cet écran, l'administrateur peut vérifier et modifier la clé de licence actuelle.
Champs :
- Licence valide : vrai si la licence est valide et active pour cette instance
- Titulaire de la licence : le titulaire de la licence
- Licence valide jusqu'au : la date d'expiration de la licence
- Nombre maximal d'environnements : le nombre maximal d'environnements pouvant être gérés avec cette licence
- Modules sous licence : la liste des systèmes externes qui peuvent être gérés avec 3C (CLARITY, AUTOMIC ou les deux)
- Changer la clé de licence : l'utilisateur peut ajouter une nouvelle clé de licence
- Bouton Changer la clé de licence : remplace la clé de licence par la nouvelle clé fournie
Environnements
Les environnements sont des connexions à des instances Automic (ou Clarity). Ils sont nécessaires pour toute analyse, tout instantané ou tout déploiement. Une connexion d'environnement réussie fournit également une liste des objets disponibles d'une instance, à lire sous forme de résumé de haut niveau.
Liste des environnements
La page Liste des environnements montre les connexions Clarity PPM et Automic créées ainsi que des détails supplémentaires à leur sujet, tout en offrant la possibilité de créer, modifier ou supprimer des éléments.
Fonctions : Rafraîchir, Nouvel environnement, Infos.
Filtres : Filtre produit (visible uniquement si votre licence est valide pour Automic et Clarity).
Champs :
- Identifiant : identifiant unique de l'enregistrement de la connexion à l'environnement. Généré automatiquement par le système.
- Titre : nom de la connexion d'environnement, donné par l'utilisateur qui l'a créée.
- Hôte : adresse du serveur où l'application externe s'exécute.
- Client : uniquement visible pour les instances Automic.
- Type : le type d'utilisation de l'environnement, comme DEVELOPMENT, TEST, PRODUCTION, etc.
- Base de données : le fournisseur de base de données du système externe. Visible uniquement pour les environnements Clarity.
- Initialisé : indique si les requêtes nécessaires sont déjà installées sur le système. Visible uniquement pour les environnements Clarity.
- Connecté : indique si les informations d'identification et les paramètres de connexion sont corrects et si 3C peut accéder au système.
- Dernier instantané : l'horodatage du dernier instantané réussi généré pour le système.
- Prochain instantané : la date du prochain instantané de sauvegarde planifié pour le système.
- Afficher : ouvre l'écran Détails de l'environnement.
- Supprimer : supprime l'environnement.
Créer un environnement
Créez un enregistrement d'environnement pour stocker les détails de connexion, qui seront utilisés pour la création d'instantanés. Si vous disposez à la fois de licences Clarity et Automic, vous devez d'abord choisir le type de produit.
Paramètres du système :
- Titre : identifiant court de l'environnement. Ce titre apparaît également sur d'autres pages. Il est conseillé qu'il soit unique.
- Adresses des serveurs : adresse de l'environnement Automic au format URL:PORT sans http ou https. Les ports peuvent être ajoutés en utilisant des plages (xyurl:10-20) ou des virgules (yyurl:1,2,3). Utilisez le bouton + pour ajouter de nouveaux enregistrements aux paramètres de connexion pour différents noms d'hôtes.
- Type d'environnement : le type d'usage. Valeurs : DEVELOPMENT, TEST, MIGRATION, PRODUCTION.
- Certificat de l'environnement : Le 3C Release Manager a besoin du certificat de connexion. Copiez dans ce champ le texte du fichier .cert en incluant les lignes —–BEGIN CERTIFICATE—– et —–END CERTIFICATE—– .
Identifiants :
- Numéro de client : le numéro client de l'utilisateur technique dans Automic.
- Nom d'utilisateur : le nom d'utilisateur de l'utilisateur technique, par exemple UC. Le 3C Release Manager ne pourra accéder (télécharger ou déployer) qu'aux objets d'Automic auxquels l'utilisateur technique a accès.
- Département : le département de l'utilisateur technique.
- Stocker le mot de passe : recommandé. Vous pouvez utiliser 3C sans cette option, mais le mot de passe vous sera alors demandé à chaque demande de connexion, avant la création d'un instantané ou d'un déploiement.
- Mot de passe : le mot de passe de l'utilisateur technique.
- Description : champ de texte libre pour des informations supplémentaires sur la connexion d'environnement.
Modifier l'environnement
Une fois qu'une connexion d'environnement est créée et sauvegardée, elle peut être ouverte depuis la page Liste des environnements et tous les paramètres associés peuvent être modifiés. Cliquer sur le titre de la connexion sur la page de liste ouvre la page Modifier l'environnement. La page Modifier l'environnement comporte plusieurs onglets :
- Base : informations générales sur la connexion d'environnement
- Connexion : indicateurs sur le statut de la connexion
- Identifiants : possibilité de changer le mot de passe de connexion
- Tâches planifiées : paramètres de génération automatique d'instantanés de sauvegarde pour l'environnement
- Filtres enregistrés : filtres d'objets définis par l'utilisateur — uniquement pour Automic
- Filtres : possibilité d'inclure ou d'exclure certains éléments des instantanés — uniquement pour Clarity
- Objets : liste des objets identifiés
- Paramètres Git : pour configurer la synchronisation Git pour cet environnement
- Règles de déploiement : règles de script de déploiement automatisé — uniquement pour Automic
Écran Base
Les paramètres de connexion de base et les métadonnées de l'environnement. Mêmes champs que Créer un environnement (Titre, Adresses du serveur, Type d'environnement, Numéro client, Nom d'utilisateur, Département, Description). Fonctions : Annuler, Enregistrer.
Écran Connexion
Indique si les paramètres de connexion sont corrects.
Champs :
- Connecté : vrai si la connexion est OK
- Erreur de connexion : contient le message d'erreur lors de la demande de connexion s'il y en a eu (uniquement pour Automic)
- Initialisé : indique si la connexion a été établie correctement et si l'application a pu se connecter à l'instance Clarity PPM au moins une fois (uniquement pour Clarity)
- Connexion REST : indique si l'API REST est accessible par 3C (uniquement pour Automic)
Fonctions :
- Vérifier la connexion : met à jour le statut de la connexion
- Réinitialiser / Initialiser : exécute dans l'environnement les scripts de requête nécessaires au fonctionnement du 3C Release Manager (uniquement pour Clarity)
Écran des identifiants
Champs : Stocker le mot de passe (recommandé), Mot de passe (le mot de passe de l’utilisateur technique). Fonctions : Enregistrer les modifications (enregistre le nouveau mot de passe et tente de se connecter au système externe), Ajouter (ouvre une boîte de dialogue où l'utilisateur peut définir le certificat de la connexion).
Écran des tâches planifiées
Affiche la liste des tâches d'instantané planifiées pour cet environnement. Aux heures indiquées ici, le 3C Release Manager démarre automatiquement un nouvel instantané afin de créer une sauvegarde de la configuration.
Champs :
- Titre de la planification : titre en texte libre
- Actif : la tâche ne s'exécute que si l'indicateur Actif est vrai
- Diffs automatiques : si cette option est activée, 3C crée en outre automatiquement une analyse diff par rapport au dernier instantané planifié
- Dernière exécution : l'horodatage de la dernière exécution de la tâche
- Prochaine exécution : la date et l'heure de la prochaine exécution planifiée de la tâche
- Nombre d'exécutions : le nombre de fois où la tâche s'est déjà exécutée avec succès
- Détails : accède à l'écran Modifier la planification
- Supprimer : supprime la tâche planifiée
Fonctions : Créer une planification (ouvre l'écran Nouvelle planification).
Écran des tâches planifiées — Nouvelle planification
Utilisez cette page pour définir une nouvelle tâche d'instantané planifiée pour l'environnement.
Champs :
- Titre : obligatoire, nom en texte libre
- Description : champ de description en texte libre
- Diffs automatiques : si l'option est activée, chaque instantané déclenche en outre automatiquement une tâche d'analyse diff qui compare la configuration actuelle au dernier état enregistré
- Filtre : facultatif — si non défini, un instantané complet sera effectué
- Heure de début de la sauvegarde : HH:MM (format attendu). La tâche démarre à l'heure indiquée.
- Fuseau horaire : définir le fuseau horaire de l'heure de début de la sauvegarde
- Fréquence de planification : définir la fréquence. Les options suivantes sont disponibles :
- Quotidienne : la tâche démarre chaque jour à l'heure indiquée
- Hebdomadaire : définir les jours de la semaine où la tâche doit démarrer
- Mensuelle : définir les jours du mois où vous souhaitez que la tâche commence
- Annuelle : définir les jours de l'année où vous souhaitez que la tâche commence
Fonctions : Annuler (revient à la liste des planifications sans modifications), Enregistrer (crée la nouvelle tâche planifiée).
Écran des tâches planifiées — Modifier la planification
Utilisez cette page pour modifier une tâche d'instantané planifiée pour l'environnement. Les champs sont identiques à ceux de l'écran Nouvelle planification : Titre, Description, Diffs automatiques, Filtre, Heure de début de la sauvegarde (HH:MM), Fuseau horaire et Fréquence de planification (Quotidienne, Hebdomadaire, Mensuelle, Annuelle). Fonctions : Annuler, Enregistrer.
Écran des filtres enregistrés (Automic uniquement)
Utilisez cette page pour gérer les filtres enregistrés pour l'environnement. Lorsque l'utilisateur souhaite créer un instantané personnalisé, il existe une option pour enregistrer le filtre actuellement utilisé pour une utilisation future. Cet écran affiche la liste de ces filtres.
Champs :
- Titre : le nom du filtre
- Créé par : le propriétaire du filtre
- Créé le : date de création
- Modifier : navigue vers l'écran Nouvel instantané, avec les filtres chargés
- Supprimer : supprime le filtre
Écran de liste d'objets
L'écran des objets fournit un catalogue général de la configuration de l'environnement. Après chaque instantané, cette liste est actualisée ; elle peut également être actualisée manuellement depuis cet écran. Il remplit deux fonctions principales : premièrement, vous pouvez vérifier quels objets sont disponibles dans le système ; deuxièmement, vous pouvez utiliser le bouton Historique pour consulter les modifications antérieures de l'objet.
Vue Historique
La vue Historique affiche à gauche chaque version précédente de l'objet. Lorsque vous sélectionnez un élément de la liste, la vue de droite affiche les modifications effectives de l'élément de configuration sous forme de diff textuel.
Écran des paramètres Git
Si le dépôt Git global est correctement configuré, cette page est disponible : l'utilisateur peut y activer ou désactiver la fonctionnalité de synchronisation Git pour l'environnement et définir le nom de la branche qui sera utilisée dans le dépôt pour suivre les configurations.
Champs :
- Nom de la branche : cette branche sera créée dans le dépôt si elle n'existe pas, et sera utilisée pour y stocker la configuration.
- Synchronisation Git activée : si l'option est activée, après chaque instantané, le 3C Release Manager écrit la configuration dans le système de fichiers, puis effectue automatiquement le commit et le push des modifications vers le dépôt Git défini.
- Enregistrer : enregistre les valeurs du formulaire.
Écran des règles de déploiement (Automic uniquement)
L'utilisateur peut définir les règles par défaut pour cet environnement, qui seront utilisées pendant le processus de déploiement. Le processus de modification du texte fonctionne de manière similaire à l'utilitaire AEDB Change — les règles spécifiques qui peuvent être utilisées dans les fichiers de règles sont les mêmes que celles de la documentation Automic AEDB Change.
Champs :
- Ensemble de règles d'environnement : le texte qui contient les règles (chaque ligne est une règle)
- Valider : vérifie le jeu de règles et affiche un message d'erreur en cas d'erreurs de syntaxe
- Enregistrer : enregistre le jeu de règles pour l'environnement. Chaque fois qu'un nouveau déploiement est défini pour cet environnement, ce jeu de règles sera copié et utilisé par défaut pour le déploiement.
Écran des filtres (Clarity uniquement)
L'utilisateur peut définir des filtres spécifiques pour cet environnement qui modifieront la manière dont les instantanés de cette instance doivent être créés. Il existe trois catégories :
- Filtres de langue : 3C supprimera des fichiers XML toute ligne contenant des libellés dans les langues exclues ici
- Filtres d'objets : 3C n'inclura dans l'instantané que les types d'objets activés dans cette liste de filtres
- Autres filtres : filtres spécifiques pour les fichiers XML, qui excluent les attributs, les balises ou les parties des fichiers XML qui ne sont pas nécessaires à l'analyse comparative, comme les identifiants générés, etc.
Instantanés
Les instantanés sont l'une des fonctionnalités de base du 3C Release Manager. Un instantané est une représentation de la configuration de l'instance gérée à un moment donné. Le 3C Release Manager se connecte au système Clarity ou Automic et, en fonction des filtres et des paramètres, il trouvera et téléchargera tous les objets de configuration du système. Ces ensembles peuvent être nommés et enregistrés, pour être utilisés plus tard comme historique de configuration, sauvegarde système, base pour l'analyse comparative, ou source d'un package de déploiement.
Instantanés incrémentiels
Le 3C Release Manager exporte et enregistre les objets de manière incrémentielle. À chaque lancement d'un nouvel instantané, le 3C Release Manager vérifie tous les objets disponibles dans le système sélectionné, en fonction des filtres et des paramètres. Seuls les éléments modifiés depuis le dernier instantané enregistré sont stockés, afin de réduire la durée du processus ainsi que la consommation de la base de données. Le premier instantané d'une nouvelle instance prendra plus de temps, mais les instantanés suivants seront créés plus rapidement.
Instantanés complets ou partiels
Si l'utilisateur ne spécifie aucun filtre ni sélection d'objet, un instantané complet (Full Snapshot) sera créé ; tous les objets seront téléchargés. Il est conseillé de configurer les filtres de manière à n'enregistrer que la configuration importante, afin d'accélérer le processus.
Liste d'instantanés
Fonctions : Actualiser, Créer un instantané, Informations.
Filtres :
- Source : l'environnement qui était la source de l'instantané
- Type : Créé manuellement, Généré automatiquement, Sauvegarde planifiée, Sauvegarde avant déploiement, Validation de déploiement
- Période : l'heure de début de l'instantané
- Champ de recherche : recherche en texte libre dans le titre et la description
Contrôles spéciaux : La première icône permet de basculer entre la sélection des User Stories et la sélection des Déploiements. La liste déroulante affiche les User Stories ou les Déploiements disponibles à gérer ; si un élément est sélectionné, un bouton « Ouvrir le déploiement » ou « Ouvrir la User Story » permet d'accéder à l'élément sélectionné.
Champs :
- Identifiant : l'identifiant technique de l'instantané
- Titre : le titre de l'instantané
- Environnement : l'environnement source de l'instantané
- Statut : DONE, ERROR, IN_PROGRESS, WAITING
- Statistiques : nombre total d'objets en bleu, objets en erreur en rouge
- Étiquettes : étiquettes spécifiées par l'utilisateur ou créées automatiquement
- Début : l'heure de début
- Afficher : ouvre l'écran des détails de l'instantané
- Supprimer : supprime l'instantané
- Éléments sélectionnés : si un déploiement ou une user story est sélectionné sur la page, cette colonne affiche le nombre d'objets ajoutés à cette user story ou à ce déploiement à partir de chaque instantané
Créer un instantané
Champs :
- Titre de l'instantané : requis, généré automatiquement avec une valeur par défaut
- Environnement sélectionné : la connexion d'environnement qui sera utilisée comme source
- Description : texte libre
- Étiquettes : étiquettes manuelles pour l'instantané
- Instantané personnalisé : si non activé, 3C démarrera un instantané complet
Fonctions : Annuler, Démarrer l'instantané.
Instantané personnalisé
Si le commutateur Instantané personnalisé est activé, l'écran affiche le catalogue complet de configuration pour l'environnement, où l'utilisateur peut sélectionner manuellement les éléments qui doivent être inclus dans l'instantané. L'utilisateur peut sélectionner des dossiers (les éléments seront téléchargés récursivement) ou des éléments individuels. Cette sélection peut être enregistrée sous forme de filtre à l'aide du bouton Nouveau filtre . Les filtres précédemment enregistrés peuvent être appliqués avec le sélecteur Filtre .
Création d'instantané
En fonction des objets présents dans l'environnement ainsi que des filtres et éléments sélectionnés par l'utilisateur, un instantané peut prendre plus de temps. Pendant cette période, le 3C Release Manager affiche une barre de progression.
Détails de l'instantané
Les détails d'un instantané spécifique, y compris ses métadonnées et les éléments de configuration téléchargés.
Métadonnées : Identifiant de l'instantané (lecture seule), Environnement (lecture seule), Titre de l'instantané (requis), Statut, Heure de début, Heure de fin, Description, Étiquettes.
Fonctions : Actualiser, Retour, Info, Enregistrer (enregistre les modifications dans le formulaire de métadonnées), Redémarrer — s'il y avait des objets en état d'erreur, ou si l'instantané a échoué, l'utilisateur peut essayer de télécharger les objets restants.
Arborescence d'objets
Le contenu principal de l'instantané. Sur le côté gauche, pour Clarity les catégories d'objets sont affichées dans la vue arborescente ; pour Automic, la structure de dossiers de l'instance donnée. Les dossiers peuvent être ouverts et fermés ; cliquer dessus affiche le contenu du dossier ou de la catégorie sur le côté droit.
Pour l'ensemble de l'instantané et pour les dossiers spécifiques, les nombres bleus indiquent le nombre total d'objets, les nombres verts indiquent les objets téléchargés avec succès, et les nombres rouges indiquent les objets en état d'erreur. Un téléchargement d'objet peut échouer en raison de problèmes de connexion, d'erreurs de programme ou de problèmes d'autorisation si l'utilisateur technique ne dispose pas des droits nécessaires.
Champs : ID, Code objet, Type d'objet, Statut (WAITING, IN_PROGRESS, DONE, ERROR), Détails (ouvre la boîte de dialogue Objet d'instantané), Historique (ouvre la vue Historique de l'objet).
Gestion du déploiement / des User Stories
Si une User Story ou un Déploiement est sélectionné dans le coin supérieur droit, la disposition de l'écran change. Avec le contrôle ajouté, vous pouvez sélectionner des dossiers, le contenu de dossiers ou des éléments spécifiques à ajouter à la User Story ou au Déploiement sélectionné.
Écran des détails de l'objet
Affiche les détails de l'objet, avec le code de configuration réel dans un champ en lecture seule.
Champs :
- Identifiant : identifiant technique de l'objet
- Code : le code de l'objet
- Heure de début : l'heure de début du téléchargement de l'objet
- Dernière mise à jour le : heure de la modification de configuration de l'objet sur le système externe
- Objet modifié : vrai s'il a été modifié depuis le dernier instantané
- Objet déplacé : vrai s'il a été déplacé d'un autre dossier depuis le dernier instantané
- Type de configuration : XML / JSON
- Statut : l'état de l'exportation
- Type d'objet : le type d'objet sur le système
- Heure de fin : l'heure à laquelle l'objet a été enregistré dans 3C
- Dernière mise à jour par : si disponible, l'identifiant de l'utilisateur qui a modifié l'élément dans le système externe
- Instantané d'origine : si l'élément n'a pas été modifié, affiche l'identifiant de l'instantané qui contenait initialement la configuration actuelle
- Dossier d'origine : si l'élément a été déplacé, affiche le dossier précédent enregistré dans 3C
- Contenu : la configuration effectivement enregistrée
Diffs
Les analyses Diff constituent la deuxième fonctionnalité importante du 3C Release Manager. Un diff est une comparaison entre deux instantanés. Selon le cas d'utilisation, il peut servir à analyser les différences entre :
- Le même environnement à différents moments — utile pour les sauvegardes quotidiennes et le suivi des bogues, pour collecter les changements pendant une phase de développement, ou pour valider un déploiement
- Différents environnements — utiles pour trouver les différences entre un environnement de test et un environnement de développement, pour voir ce qui doit être déployé, pour vérifier si le déploiement de test correspond à ce qu'il devrait être après le développement, entre un environnement de production et un environnement de test pour voir ce qui doit figurer dans la release, ou entre un système de production et un système vierge pour recenser toutes les personnalisations apportées au système
L'utilisateur peut également sélectionner des environnements, pas seulement des instantanés — grâce à cette fonctionnalité, le 3C Release Manager créera un nouvel instantané à la volée et l'utilisera pour la comparaison. Les diffs peuvent également servir de source pour le contenu d'un déploiement ou d'une user story, tout comme les instantanés.
Liste des diffs
Fonctions : Actualiser, Nouveau diff, Informations.
Contrôles spéciaux : Sélecteur de user story / de déploiement avec le même comportement que dans la liste des instantanés.
Filtres : Environnement source, Environnement cible, Intervalle de temps de début, Champ de recherche.
Champs :
- Identifiant : identifiant technique généré pour le diff
- Titre : le titre du diff
- Statut : DONE, ERROR, WAITING, IN_PROGRESS
- Heure de début : le moment de la création du diff
- Étiquettes : les étiquettes définies pour le diff
- Statistiques : objets nouvellement créés en vert, objets supprimés ou manquants en rouge, éléments modifiés en jaune, éléments déplacés en bleu
- Afficher : ouvre l'écran Détails du diff
- Supprimer : supprime l'enregistrement du diff
- Éléments sélectionnés : si un déploiement ou une user story est sélectionné, cette colonne indique le nombre d'objets ajoutés à partir de chaque diff
Créer un diff
Cet écran permet à l'utilisateur de démarrer un nouveau processus de diff. Si la licence 3C est valide à la fois pour Clarity et pour Automic, l'utilisateur doit d'abord sélectionner le produit à utiliser.
Champs :
- Environnement source : si un environnement est sélectionné, le processus de diff démarrera d'abord un nouveau processus d'instantané pour cet environnement
- Instantané source : la liste des instantanés disponibles dans 3C. Les filtres peuvent être utilisés pour réduire la liste de sélection. Il faut sélectionner un environnement source ou un instantané source.
- Environnement cible : si un environnement est sélectionné, le processus de diff démarrera d'abord un nouveau processus d'instantané pour cet environnement
- Instantané cible : la liste des instantanés disponibles dans 3C. L'environnement cible ou l'instantané cible doit être sélectionné.
- Titre : titre en texte libre du diff, obligatoire
- Description : champ de description en texte libre
- Étiquettes : l'utilisateur peut définir des étiquettes spécifiques pour un diff
- Préfiltres personnalisés : l'utilisateur peut spécifier certaines parties de la configuration à exclure des analyses de différences, comme les identifiants générés, etc.
Fonctions : Annuler, Créer.
Détails du diff
Une fois le processus de diff terminé, les analyses peuvent être consultées dans l'écran Détails du diff.
Champs : ID (lecture seule), Titre, Statut, Heure de début/fin, Instantané source, Instantané cible, Description, Étiquettes.
Fonctions : Actualiser, Retour, Info, Enregistrer.
Arborescence d'objets
La même disposition que dans l'arborescence d'instantané. Elle affiche également un enregistrement spécial nommé == All diffs == qui affiche tous les diffs sur le côté droit de l'écran. Pour l'ensemble du diff et pour les dossiers spécifiques, les nombres bleus indiquent le nombre total d'objets déplacés, les nombres verts indiquent les objets nouvellement créés, les nombres jaunes indiquent les objets modifiés, et les nombres rouges indiquent les objets manquants ou supprimés.
Champs :
- Code objet : le nom de l'objet. La couleur de l'icône de l'objet représente également la modification (rouge pour la suppression, vert pour l'ajout, jaune pour la modification, bleu pour le déplacement)
- Source modifiée : l'heure de modification de l'objet dans l'environnement source
- Cible modifiée : l'heure de modification de l'objet dans l'environnement cible
- Différences : ouvre l'écran de comparaison XML ou arborescent des modifications
- Source : navigue vers l'instantané source
- Cible : navigue vers l'instantané cible
Gestion du déploiement / des User Stories
Si une User Story ou un déploiement est sélectionné dans le coin supérieur droit, l'écran change. Avec le contrôle ajouté, vous pouvez sélectionner des dossiers, le contenu des dossiers ou des éléments spécifiques à ajouter à la User Story ou au déploiement sélectionné.
Dans la vue arborescente à gauche, le bouton + ajoutera récursivement tous les éléments du dossier à l'objet sélectionné. Le bouton – supprimera récursivement tout ce qu'il contient. Les chiffres en gris indiquent le nombre d'objets dans le dossier qui peuvent potentiellement être ajoutés, et combien d'entre eux sont déjà ajoutés.
En haut de la liste, Ajouter tout ajoutera tous les éléments de la liste ci-dessus, et Supprimer tout retirera les éléments.
Sur les enregistrements individuels, il y a trois options : Ajouter un élément ajoute cet élément spécifique ; Ajouter des éléments connexes ajoute l'élément avec des objets directement liés ; Ajouter récursivement les éléments connexes ajoute tous les éléments qui sont liés à celui-ci, ainsi que leurs références.
Détails de l'objet de diff
La comparaison XML ouvre l'écran des modifications de configuration. L'onglet Source présente la configuration du côté source, l'onglet Cible affiche la configuration côté cible et l'onglet Diff affiche les différences dans le code XML ou JSON, à l'aide d'une vue de comparaison de texte.
Vue d'analyse
Fournit un autre écran de visualisation, où les éléments de configuration dans le XML de l'objet sont affichés dans une arborescence, pour une meilleure compréhension.
Déploiements
Les déploiements sont le troisième élément important du 3C Release Manager. Un package de déploiement est un ensemble d'éléments de configuration qui peuvent être collectés directement à partir d'instantanés ou de diffs, ou ajoutés via des user stories. Un déploiement a toujours un système cible, dans lequel l'utilisateur souhaite écrire les configurations collectées.
Une fois le déploiement configuré et préparé, il peut être lancé, et le 3C Release Manager déploiera automatiquement chaque étape une par une dans l'ordre donné. Le 3C Release Manager peut également créer un instantané de sauvegarde avant le début du déploiement, et un instantané de validation après la fin du déploiement, afin que les modifications puissent être validées ultérieurement. En cas d'erreur, un déploiement de restauration peut être créé automatiquement.
Une fois qu'un déploiement a terminé son exécution, il ne peut plus être modifié, de sorte que les journaux de déploiement peuvent servir de source d'audit pour les systèmes ciblés.
Liste des déploiements
Fonctions : Actualiser, Nouveau déploiement, Informations.
Filtres : Environnements, Sélecteur de statut (un ou plusieurs), Intervalle de dates de création, Champ de texte (texte libre dans le titre ou la description).
Champs :
- Identifiant : identifiant technique généré
- Titre : le titre du package de déploiement
- Statut : DRAFT, PREPARED, IN_PROGRESS, DONE, ERROR
- Type : Déploiement ou retour arrière
- Date de création : l'heure de création du package de déploiement
- Cible : l'environnement cible
- Afficher : navigue vers l'écran de modification du déploiement
- Supprimer : supprime le déploiement
Créer un package de déploiement
Champs : Environnement cible, Titre (obligatoire), Description. Fonctions : Annuler, Créer.
Les valeurs supplémentaires peuvent être définies après la création.
Modifier le package de déploiement
L'écran Modifier le package de déploiement comporte 5 onglets :
- Base : les données de base du déploiement
- Règles : uniquement pour Automic, où l'utilisateur peut définir des règles automatiques à appliquer aux éléments de configuration avant leur déploiement
- Préparer le package : où l'utilisateur peut modifier les étapes de déploiement
- Journal d'exécution : où l'utilisateur peut démarrer et surveiller le package de déploiement
- Validation : où l'utilisateur peut vérifier les étapes de validation une fois le déploiement terminé
Onglet Base
S'il y a des éléments conflictuels dans les étapes de déploiement, un message d'avertissement s'affiche. Un autre message s'affiche également si des objets ajoutés au déploiement font partie de ceux qu'il est généralement déconseillé de modifier dans une instance Automic.
Champs :
- Titre : le titre du déploiement
- Environnement cible : l'environnement où le déploiement sera effectué
- Statut : l'état du déploiement
- ID de déploiement : identifiant technique généré automatiquement
- Type de déploiement : Déploiement ou retour arrière
- Description : champ de description en texte libre
- Options avancées : pour désactiver manuellement la création de l'instantané de sauvegarde et de l'instantané de validation
User Stories : la liste des user stories incluses dans le package de déploiement.
Liste source : la liste des instantanés et des diffs qui ont servi de source aux étapes du package de déploiement, directement ou indirectement via les user stories.
Fonctions : Annuler, Enregistrer, Cloner le déploiement (clone le déploiement actuel et en crée un nouveau avec le même contenu et les mêmes paramètres), Règles de déploiement (passe à l'onglet suivant).
Onglet Règles (Automic uniquement)
L'utilisateur peut définir les règles effectives de ce déploiement, qui seront utilisées pendant le processus. Si l'environnement cible a un jeu de règles par défaut défini, celles-ci seront copiées ici automatiquement, mais peuvent également être supprimées par l'utilisateur. Le processus de modification du texte fonctionne de manière similaire à l'utilitaire AEDB Change.
Champs :
- Ensemble de règles d'environnement : le texte qui contient les règles (chaque ligne est une règle)
- Valider : vérifie le jeu de règles et affiche un message d'erreur en cas d'erreurs de syntaxe
- Enregistrer : enregistre l'ensemble de règles pour le déploiement. Tous les objets ajoutés au déploiement déclencheront les règles et leur contenu sera modifié en conséquence.
Onglet Préparer le package
De la même manière que le contenu des user stories, le package de déploiement contient des étapes qui doivent être exécutées pendant le processus. Les étapes peuvent être de l'un des types suivants :
- Créer un nouvel objet (action Créer)
- Supprimer un objet (action Supprimer) — pour Clarity, la suppression ne fonctionne pas automatiquement en raison des limitations du système externe
- Modifier la configuration d'un objet existant
- Déplacer un objet existant vers un autre dossier — pertinent uniquement pour les instances Automic
- Étapes manuelles — étapes personnalisées pendant le processus de déploiement où le processus doit s'arrêter, afin que l'administrateur puisse terminer une tâche manuelle
Les objets peuvent être ajoutés à partir d'un instantané ; les modifications de suppression/création/déplacement peuvent être ajoutées à partir d'un diff.
Filtre : Recherche textuelle libre dans les codes d'objet ou les types d'objet.
Champs :
- Numéro : l'ordre des étapes. L'utilisateur peut réorganiser les enregistrements par glisser-déposer. Pendant le processus, les étapes de déploiement sont exécutées dans l'ordre du script.
- Identifiant : ID technique généré. Si l'enregistrement présente un avertissement (par exemple un conflit), une icône d'avertissement s'affiche également ici.
- User story : le lien de la user story d'origine
- Source : le lien vers l'instantané ou le diff d'où provient la configuration
- Type d'étape : AUTO ou MANUAL
- Type d'objet : si le déploiement contient des objets qu'il est généralement déconseillé de modifier, une icône d'avertissement s'affichera ici
- Code objet : le code de l'objet
- Type de configuration : XML ou JSON
- Action : l'action qui sera effectuée lors du déploiement
- XML à déployer : affiche le code de l'objet qui sera déployé sur le système cible
- Configuration cible : affiche le code de l'objet qui sera écrasé sur le système cible
- Opérations :
- Point d'arrêt : le processus de déploiement s'arrêtera après cette étape jusqu'à ce que l'utilisateur reprenne le déploiement
- Monter / descendre : réorganiser les étapes
- +: crée une étape manuelle après celle sélectionnée
- Note : ouvre la note pour l'étape de déploiement
- Supprimer : retire l'étape du déploiement
Fonctions : Ajouter à partir d'un diff (navigue vers la liste des diffs avec le déploiement actuel sélectionné pour l'ajout), Ajouter à partir d'un instantané, Préparation prête (fait passer l'état du déploiement à « Préparé »), Commencer (visible uniquement pour les déploiements à l'état Préparé — démarre le processus et accède à l'onglet Journal d'exécution).
Boîte de dialogue Étape de déploiement
Affiche les détails de l'étape de déploiement, avec la configuration qui sera utilisée lors du déploiement.
Champs : Type de source (Snapshot ou Diff), Id, Source de l'objet, Code, Type d'objet, Source (la configuration de l'objet), Description, Notes.
Onglet Journal d'exécution
Après le démarrage du processus de déploiement, ce journal peut être utilisé pour le surveiller. Si l'option d'instantané de sauvegarde est activée, le 3C Release Manager créera d'abord un instantané contenant tous les éléments qui seront modifiés pendant le processus de déploiement. Une fois cela terminé, il commencera par la première étape.
S'il n'y a ni étapes manuelles ni points d'arrêt définis sur les étapes, chaque étape est effectuée automatiquement, puis un instantané de validation est créé pour les modifications. Si le processus de déploiement s'arrête, il peut être repris à l'aide du bouton Reprendre , ou l'ensemble du processus peut être arrêté à l'aide du bouton Annuler .
Si le processus est en pause, les étapes de déploiement peuvent être répétées ou ignorées, et il est même possible d'ajouter des points d'arrêt supplémentaires.
Fonctions :
- Pause : met en pause le processus de déploiement
- Reprendre : reprend un processus de déploiement mis en pause
- Annuler : bouton d'arrêt d'urgence — arrête complètement le processus de déploiement et met le déploiement à l'état Annulé
Cartes d'étape de déploiement :
- Numéro : le numéro d'ordre de l'étape
- Statut : DONE, WAITING, IN_PROGRESS, ERROR
- Identifiant : ID de l'étape de déploiement
- Type : Automatique ou Manuelle
- Objet : le type d'objet
- Code : le code de l'objet
- Type de configuration : XML ou JSON
- Titre : le titre du changement
- Liste d'exécution : si l'étape a déjà été réalisée, le journal d'exécution apparaîtra ici
- Détails : affiche les détails et les notes de l'étape
- Répéter : uniquement visible si le processus est en pause — 3C essaiera de refaire la même étape
- Ignorer : uniquement visible si le processus est en pause — 3C n'effectuera pas l'étape
- Terminer : visible seulement pour les étapes manuelles — l'utilisateur doit terminer manuellement la tâche avant que le processus ne reprenne
Fenêtre des détails d'exécution
Affiche les détails de l'exécution d'une étape de déploiement.
Champs : Numéro d'exécution (1 s'il n'y a pas eu de répétitions), Statut d'exécution (SUCCESS ou ERROR), Heure de début, Heure de fin, Résultat (OK en cas de succès, sinon le message d'erreur du système externe), Requête (la configuration qui a été utilisée pour le déploiement).
Onglet Validation
Uniquement visible une fois le déploiement terminé. Cet écran rassemble en un seul endroit les détails de l'instantané de sauvegarde, de l'instantané de validation et du diff de validation. Si tout s'est bien passé, l'analyse diff devrait montrer exactement ce que vous aviez l'intention de déployer sur l'environnement cible.
Fonctions :
- Restauration : en cas d'erreur ou de déploiement non réussi, utilisez le bouton Restauration. Il créera un déploiement de restauration spécial qui sera l'exact opposé du déploiement actuel, restaurant l'état des objets à l'aide de l'instantané de sauvegarde. Après sa création, le déploiement de restauration fonctionnera comme un déploiement standard et devra être démarré manuellement.
User stories
Les User Stories servent de conteneur logique pour les modifications liées à une exigence métier. La manière recommandée d'utiliser le 3C Release Manager est la suivante :
- Définissez les user stories dans le système, provenant très probablement d'un système externe de gestion des user stories
- Créez un instantané de l'environnement de développement avant le début du développement
- Créez un instantané de l'environnement de développement une fois le développement terminé
- Créez une analyse diff entre les deux instantanés
- Sur la base des différences, collectez les modifications individuelles et reliez-les aux user stories. Ainsi, l'équipe aura une compréhension claire de la raison de chaque modification de configuration et des exigences métier qui en sont affectées.
Plus tard, les user stories peuvent être ajoutées aux déploiements pour déplacer les modifications vers le système souhaité.
Liste des user stories
Fonctions : Actualiser, Nouvelle user story, Informations.
Filtres : Filtre de statut (statuts visibles), Sélection de Sprint, Champ de recherche (texte libre dans les titres et descriptions).
Champs :
- Identifiant : identifiant technique généré
- Nom : le nom de la user story
- Statut : le statut actuel (DRAFT, WORK IN PROGRESS, READY FOR DEVELOPMENT, TESTING, DONE, etc.)
- Sprint : le sprint auquel la user story est rattachée
- Système actif : le système auquel le statut actuel est rattaché
- Déploiements : la liste des déploiements dont fait partie la user story
- Afficher : accède à l'écran des détails de la user story
- Supprimer : supprime la user story
Créer une user story
Cet écran peut être utilisé pour créer de nouvelles user stories dans le 3C Release Manager. Notez que de nouvelles user stories peuvent également être créées à partir des pages Instantanés et Diffs.
Champs :
- Nom du produit : visible uniquement si la clé de licence 3C est valide pour Clarity et Automic
- Nom : obligatoire, champ libre
- Numéro de user story : facultatif, pour stocker l'identifiant de la user story dans des systèmes de tickets externes, tels que Jira
- Lien externe : facultatif, pour stocker le lien du ticket externe
- Description : champ de description en texte libre
- Utilisateur responsable : facultatif, l'utilisateur 3C Release Manager responsable de la user story
Fonctions : Annuler, Enregistrer.
Modifier la user story
L'écran contient 5 onglets différents : Description, Contenu, Analyse des conflits, Déploiement, Activités.
Onglet Description
Permet de modifier les données de base de la user story.
Champs :
- Produit : visible uniquement si les licences Clarity et Automic sont toutes deux valides
- ID de la story : identifiant technique généré
- Nom : obligatoire, champ libre
- Numéro de user story : facultatif, pour référence du système de ticketing externe
- Lien externe : facultatif, pour l'URL du ticket externe
- Description : texte libre
- Utilisateur responsable : optionnel
- User story parente : les user stories peuvent être organisées en hiérarchies — ici, l'utilisateur peut sélectionner une autre user story comme parente de celle-ci
- User stories enfants : la liste des user stories liées à celle-ci
- Statut : l'état actuel (champ d'information)
- Système actif : le système externe où les changements de la user story sont déjà déployés
- Sprint : gestion de sprint pour sélectionner un sprint existant ou en créer un nouveau via une boîte de dialogue
- Créé le / Modifié le : horodatages en lecture seule
Fonctions : Annuler, Enregistrer.
Onglet Contenu
L'utilisateur peut gérer le contenu de la user story : les modifications de configuration elles-mêmes.
Filtre : Rechercher des objets (recherche textuelle libre dans les codes et types d'objets).
Champs :
- Identifiant : identifiant technique généré de l'élément de configuration
- Source : la source à partir de laquelle l'objet ou la modification de l'objet a été ajouté (instantané ou élément de diff)
- Type d'objet : le type de l'objet
- Code objet : le code de l'objet
- Action : Ajout, Suppression, Modification, Déplacement, ou Personnalisé (en cas d'étape manuelle)
- XML à déployer : affiche le code de configuration de l'objet
- Remarques : affiche les notes de l'utilisateur relatives à l'objet
- Supprimer : supprime l'objet de la user story
Fonctions : Ajouter à partir d'un instantané (navigue vers la liste des instantanés avec la user story actuelle sélectionnée pour l'ajout), Ajouter à partir d'un diff, Ajouter une étape manuelle (ajoute une étape personnalisée à la liste).
Boîte de dialogue Élément de configuration
Affiche les détails de l'élément de configuration sélectionné, avec son code actuel et d'autres métadonnées.
Champs : Type de source (Snapshot ou Diff), Id, Source de l'objet, Code, Type d'objet, Source (la configuration), Description, Notes.
Onglet Analyse des conflits
Cette liste affiche toutes les autres user stories susceptibles d'entrer en conflit avec la user story actuelle : chaque user story qui contient des modifications des mêmes éléments de configuration y apparaît. La liste indique également l'objet en conflit. Cette fonctionnalité est conçue pour coordonner les modifications d'objets au sein de grandes équipes de développement.
Champs :
- ID de la story : l'ID 3C de la user story en conflit
- User Story : le nom de la user story en conflit
- Statut : l'état actuel de la user story en conflit
- Propriétaire : le propriétaire de la user story en conflit
- Objet en conflit : le type et le code de l'objet contenu dans la user story
- Afficher : navigue vers la user story en conflit
Onglet Déploiement
Permet d'ajouter des user stories aux déploiements. Il affiche également tous les déploiements qui contiennent la user story. La manière recommandée d'utiliser le 3C Release Manager consiste à regrouper les modifications dans des user stories, la même user story devant être ajoutée au déploiement de l'environnement de test, puis à celui de l'environnement de production.
Champs : Identifiant, Titre, Environnement cible, Statut, Créé le, Afficher, Supprimer.
Fonctions : Sélecteur de déploiement (liste les déploiements disponibles). Lorsqu'un déploiement est sélectionné, le bouton Ajouter au déploiement s'affiche. Lorsque – Nouveau déploiement – est sélectionné, le bouton Créer un nouveau déploiement est visible et ouvre la boîte de dialogue de création de déploiement.
Onglet Activités
Utilisé à des fins d'audit — indique les modifications apportées à la user story. Des commentaires manuels peuvent également être ajoutés ici.
Mise à niveau et migration
3C Release Manager : les mises à niveau suivent les deux mêmes variantes que l'installation initiale du 3C Release Manager : manuelle et guidée. Les exemples utilisent des valeurs génériques ; veillez à les remplacer par les valeurs correctes de l'environnement 3C Release Manager cible.
Mise à niveau — manuelle
Copiez les nouveaux fichiers WAR vers <TOMCAT_HOME>/webapps/:
- threec.war
- threec-auth.war
- threec-backend.war
- threec-frontend.war
Supprimez les dossiers suivants de <TOMCAT_HOME>/work/Catalina/localhost:
- threec
- threec-auth
- threec-backend
- threec-frontend
- Redémarrez Apache Tomcat.
- Vérifiez le bon déroulement du déploiement dans les journaux Tomcat et via les URL de l'application.
Mise à niveau — guidée
Saisissez les répertoires suivants, qui doivent être disponibles :
- Répertoire HOME de Tomcat (par exemple c:/Automic/Tomcat-3C)
- Répertoire Java HOME (par exemple c:/Program Files/Java/jdk-17)
- Redémarrez Apache Tomcat.
- Vérifiez le bon déroulement du déploiement dans les journaux Tomcat et via les URL de l'application.
Notes de publication
Versions récentes du 3C Release Manager et modifications apportées par chacune d'elles.
v3.3.4
| Type | Description |
|---|---|
| Amélioration | Principe des quatre yeux |
| Correction de bug | Corrections de bugs de l'installateur graphique |
v3.3.3
| Type | Description |
|---|---|
| Amélioration | Installateur graphique ajouté |
| Correction de bug | Diverses corrections de bugs |
v3.3.2
| Type | Description |
|---|---|
| Correction de bug | Limitations du nombre d'objets corrigées — requêtes améliorées |
| Amélioration | Vitesse de déploiement améliorée |
v3.3.1
| Type | Description |
|---|---|
| Amélioration | Ajout de la fonctionnalité d'importation/exportation pour prendre en charge les importations et exportations de fichiers ZIP d'instantanés |
| Amélioration | Analyse améliorée des importations JSON et XML pour gérer les structures blueprint et préserver l'identité des objets |
| Amélioration | Gestion affinée des horodatages de début et de fin d'instantané lors de l'importation |
v3.3.0
| Type | Description | Notes |
|---|---|---|
| Amélioration | Rôles personnalisés ajoutés | |
| Amélioration | Gestion des blueprints 3C | Prise en charge de Clarity 16.3.3 |
| Amélioration | Sous-onglets dans le module blueprint | Prise en charge de Clarity 16.3.3 |
| Correction de bug | Corrections de bugs mineurs pour la stabilité et la maintenabilité |
Questions fréquemment posées
Cliquez sur n'importe quelle question pour développer la réponse.
Qu'est-ce que 3C Release Manager et que fait-il ?
3C Release Manager est un outil de transport, de comparaison et de déploiement pour Automic Automation qui révolutionne la façon dont les configurations se déplacent entre les environnements DEV, TEST, UAT et PROD. Il étend le Transport Case standard d'Automic avec la capture de configuration basée sur des instantanés, l'analyse des différences entre les environnements et les points dans le temps, des packages de déploiement avec retour arrière automatique, le regroupement des changements basé sur les user stories, et la synchronisation optionnelle avec Git.
3C Release Manager s'exécute en tant qu'application web Java/Spring sur Apache Tomcat avec un backend PostgreSQL, et s'intègre à Automic Automation Engine V21 ou supérieur via l'API Java sur TLS.
Quelles sont les versions d'Automic prises en charge ?
3C Release Manager exige Automic Automation Engine V21 ou supérieur. L'intégration utilise l'API Java Automic via une communication sécurisée TLS. Vous avez besoin d'un ou plusieurs clients Automic configurés par instance et de certificats compatibles TLS.
Le 3C Release Manager prend également en charge Clarity PPM comme système cible alternatif si votre licence inclut le module Clarity — les deux peuvent être gérés à partir de la même instance 3C.
Quelles sont les exigences techniques pour installer le 3C Release Manager ?
Le 3C Release Manager est indépendant de la plateforme et peut être déployé sur Microsoft Windows (64 bits) ou Linux (64 bits, toute distribution moderne prise en charge par son éditeur, comme RHEL, Rocky Linux, Ubuntu LTS). Les composants requis sont :
- Java 21 (Open Edition / OpenJDK)
- Apache Tomcat 10 avec HTTPS/TLS activé
- PostgreSQL 15 avec la connectivité JDBC
- Accès réseau depuis le backend 3C vers vos instances Automic
- Certificats compatibles TLS pour la communication Automic
Comment les mots de passe sont-ils stockés ?
Pour les utilisateurs 3C, les mots de passe sont stockés sous forme hachée. Pour les environnements externes (instances Automic), le mot de passe est stocké à l'aide d'un chiffrement bidirectionnel — cela est nécessaire pour que 3C puisse se connecter au système externe au nom de l'utilisateur technique configuré.
Quels sont le nom d'utilisateur et le mot de passe par défaut après l'installation ?
Les identifiants par défaut du super utilisateur après une nouvelle installation sont : nom d'utilisateur super, mot de passe super. Changez-le immédiatement après la première connexion via la page Mon Profil.
Quelle est la différence entre un instantané (snapshot) et un diff ?
Un instantané est une représentation de la configuration d’un environnement Automic à un moment précis. 3C se connecte à l’environnement et télécharge tous les objets de configuration en fonction des filtres configurés. Les instantanés servent d’historique de configuration, de sauvegardes système et de source pour les packages de déploiement.
Un diff est une comparaison entre deux instantanés — ou entre deux environnements, auquel cas 3C crée les instantanés à la volée. Les diffs révèlent ce qui diffère entre la source et la cible : objets nouvellement créés, supprimés, modifiés et déplacés. Ils constituent généralement le point de départ pour définir le périmètre d'un déploiement.
Pourquoi mon premier instantané prend-il autant de temps par rapport aux suivants ?
Le 3C Release Manager exporte et enregistre les objets de manière incrémentale. Le premier instantané d'un nouvel environnement doit télécharger chaque objet de configuration, ce qui prend du temps. Chaque instantané suivant ne stocke que les objets qui ont changé depuis l'instantané précédent — cela réduit considérablement à la fois le temps d'exécution et la consommation de la base de données.
Pour accélérer les instantanés en général, envisagez de configurer des filtres qui excluent les types de configuration non pertinents, de sorte que seuls les objets importants soient capturés.
Comment fonctionne le retour arrière en cas d'échec d'un déploiement ?
Chaque déploiement crée automatiquement un Instantané de sauvegarde avant son exécution ; il contient tous les éléments qui seront modifiés pendant le processus de déploiement. Après le déploiement, un Instantané de validation est créé pour vérifier les changements.
Si quelque chose tourne mal, l'onglet Validation fournit un bouton Restauration. Il crée un déploiement de restauration spécial qui est exactement l'inverse du déploiement d'origine, restaurant les objets affectés à partir de l'instantané de sauvegarde. La restauration fonctionne comme un déploiement standard et doit être démarrée manuellement.
Plusieurs équipes de développement peuvent-elles travailler en parallèle sans écraser les modifications des autres ?
Oui. L'onglet Analyse des conflits sur chaque user story liste automatiquement toutes les autres user stories qui contiennent des modifications pour les mêmes éléments de configuration. La vue montre quel objet en conflit est concerné, qui est le propriétaire de la story en conflit et son état actuel, et permet de naviguer directement vers la story en conflit.
Cette fonctionnalité est conçue spécifiquement pour coordonner les modifications d'objets au sein de grandes équipes de développement, où le travail en parallèle sur les mêmes objets Automic entraînerait sinon des écrasements silencieux lors du déploiement.
Comment intégrer 3C avec Git (GitHub ou Bitbucket) ?
L'intégration Git dans le 3C Release Manager se configure en deux étapes :
1. Paramètres Git au niveau du locataire. Un administrateur configure l'URL du dépôt Git et la méthode de connexion (Informations d'identification avec nom d'utilisateur/mot de passe, ou SSH avec clé privée) sous Administration → Paramètres Git. L'utilisateur technique doit disposer des autorisations de commit et de push sur le dépôt.
2. Synchronisation Git par environnement. Dans l'onglet Paramètres Git de chaque environnement, définissez un nom de branche (créée automatiquement si elle n'existe pas) et activez Synchronisation Git activée. Dès lors, chaque instantané réussi écrit la configuration dans le système de fichiers et effectue automatiquement le commit et le push des modifications vers la branche configurée.
Que se passe-t-il pour les objets dans l'historique lorsqu'ils sont supprimés du système externe ?
Les objets supprimés restent visibles dans l'historique 3C grâce aux instantanés précédents qui les ont capturés. Vous pouvez toujours accéder à leur configuration précédente via la vue Historique de la liste des objets, même si l'objet n'existe plus dans l'instance Automic source. Cela fait de 3C une source d'audit et d'investigation fiable, même pour les objets qui ont été retirés du système en service.
Comment puis-je effectuer des modifications groupées (par exemple, des renommages d'hôtes) lors d'un déploiement ?
Le 3C Release Manager prend en charge les modifications massives basées sur des règles pendant le déploiement en utilisant la même syntaxe que celle de l'utilitaire Automic AEDB Change. Vous pouvez définir des ensembles de règles à deux niveaux :
- Par environnement — dans l'onglet Règles de déploiement de l'environnement. Ces règles sont copiées par défaut dans tout nouveau déploiement ciblant cet environnement.
- Par déploiement — dans l'onglet Règles du déploiement. Le jeu de règles par défaut de l'environnement y est copié automatiquement et peut être modifié ou supprimé.
Lorsqu'un déploiement s'exécute, les règles sont appliquées automatiquement à chaque objet avant qu'il ne soit écrit sur le système cible. Utilisez le bouton Valider pour vérifier la syntaxe du jeu de règles avant de l'enregistrer.
Comment puis-je vérifier la taille de la base de données et quelle est la croissance attendue ?
Pour vérifier la taille de la base de données, utilisez la ligne de commande PostgreSQL :
Ou utilisez cette requête SQL :
Valeur de référence : 20 Mo est la taille typique pour 1 instantané de 2 600 éléments de configuration (avec un filtre pour 2 langues) plus 5 diffs d'environ 300 modifications chacun.
Comment fonctionne le principe des quatre yeux pour la libération des transports ?
Le principe des « quatre yeux » a été introduit dans la version 3.3.4 du 3C Release Manager pour prendre en charge les environnements où les actions de transport nécessitent une traçabilité explicite — généralement les secteurs réglementés ou les organisations informatiques soumises à une gestion des changements. Il exige qu'un deuxième utilisateur approuve les libérations de transport avant qu'elles ne puissent être exécutées, garantissant ainsi qu'aucune personne seule ne puisse déployer des modifications dans un environnement cible sans vérification.
Combiné au journal d'audit (qui capture chaque action système importante avec l'utilisateur, l'horodatage et le module), cela offre la traçabilité requise par les environnements axés sur la conformité.