Configuration de l’équipe de développement d’entreprise pour AEM as a Cloud Service :headding-anchor:enterprise-setup

Découvrez comment configurer et mettre à l’échelle votre équipe de développement d’entreprise et comment AEM as a Cloud Service peut prendre en charge votre processus de développement.

Présentation :headding-anchor:introduction

Pour prendre en charge les clientes et les clients avec les configurations de développement d’entreprise, AEM as a Cloud Service s’intègre entièrement à Cloud Manager et à ses pipelines CI/CD parfaitement définis conçus spécifiquement pour les besoins. Ces pipelines et services sont créés sur la base des bonnes pratiques, ce qui garantit des tests complets et la plus haute qualité de code.

Prise en charge de Cloud Manager dans la configuration de l’équipe de développement d’entreprise :headding-anchor:cloud-manager

Pour garantir une intégration rapide, Cloud Manager fournit tout ce qui est nécessaire pour commencer à développer immédiatement des expériences numériques, notamment un référentiel Git pour stocker les personnalisations qui seront ensuite créées, vérifiées et déployées par Cloud Manager.

Grâce à Cloud Manager, les équipes de développement peuvent envisager de valider fréquemment les modifications sans dépendre des équipes d’Adobe.

Trois types d’environnements sont disponibles dans Cloud Manager.

  • Développement
  • Évaluation
  • Production

Il est possible de déployer le code dans des environnements de développement en utilisant un pipeline hors production. Pour les environnements d’évaluation et de production, qui vont toujours de pair et garantissent ainsi la bonne pratique de validation avant le déploiement en production, un pipeline de production utilise des points de contrôle qualité pour valider le code de l’application et les modifications de configuration.

Le pipeline de production déploie d’abord le code et la configuration dans l’environnement d’évaluation, teste l’application et effectue enfin le déploiement en production.

Un SDK Cloud Service, toujours mis à jour avec les dernières améliorations d’AEM as a Cloud Service, permet le développement local en utilisant directement le matériel local du développeur ou de la développeuse. Le développement est ainsi rapide et les temps de réponse très courts. Les développeurs peuvent ainsi rester dans l’environnement local avec lequel ils sont familiarisés, choisir parmi un large éventail d’outils de développement, et accéder à des environnements de développement ou de production lorsqu’ils le jugent approprié.

Cloud Manager prend en charge des configurations multi-équipes flexibles, ajustables en fonction des besoins de l’entreprise. Pour garantir des déploiements stables pour plusieurs équipes tout en évitant les situations où une équipe a un impact sur la production de toutes les autres équipes, le pipeline parfaitement défini de Cloud Manager approuve et teste toujours le code de toutes les équipes simultanément.

Exemple concret :headding-anchor:real-world-example

Chaque entreprise a des exigences différentes, notamment la configuration de l’équipe, les processus et les processus de développement. La configuration décrite ci-dessous est utilisée par Adobe pour plusieurs projets qui assurent la mise en œuvre d’expériences en s’appuyant sur AEM as a Cloud Service.

Par exemple, les applications Adobe Creative Cloud comme Adobe Photoshop ou Adobe Illustrator, contiennent des ressources de contenu, notamment des tutoriels, des exemples et des guides mis à la disposition des utilisateurs finaux. Ce contenu est consommé par les applications client à l’aide d’AEM as a Cloud Service sans interface utilisateur graphique, en effectuant des appels d’API vers le niveau de publication d’AEM Cloud pour récupérer le contenu structuré en tant que flux JSON, et en utilisant le réseau de diffusion de contenu (CDN) dans AEM as a Cloud Service pour fournir du contenu structuré et non structuré avec des performances optimales.

Les équipes qui contribuent à ce projet suivent le processus suivant.

Chaque équipe utilise son propre processus de développement et dispose d’un référentiel Git distinct. Un référentiel Git partagé supplémentaire est utilisé pour l’intégration des projets. Ce référentiel Git contient la structure racine du référentiel Git de Cloud Manager, y compris la configuration du Dispatcher partagé.

L’intégration d’un nouveau projet nécessite une liste dans le fichier de projet Maven Reactor à la racine du référentiel Git partagé. Pour la configuration du Dispatcher, un nouveau fichier de configuration est créé dans le projet de Dispatcher. Ce fichier est ensuite inclus par la configuration Dispatcher principale. Chaque équipe est responsable de son propre fichier de configuration de Dispatcher. Les modifications apportées au référentiel Git partagé sont rares et ne sont généralement requises que lorsqu’un nouveau projet est intégré. Le travail principal est effectué par chaque équipe de projet dans son propre référentiel Git.

Diagramme de workflow

Ce référentiel a été configuré à l’aide de l’archétype de projet AEM et suit donc les bonnes pratiques pour configurer les projets AEM. La seule exception concerne la configuration du Dispatcher qui est effectuée dans le référentiel Git partagé, comme indiqué ci-dessus.

Chaque équipe utilise un processus Git simplifié avec deux+ N branches, suivant le modèle de flux Git :

  • Une branche de version stable contient le code de production.

  • Une branche de développement contient le développement le plus récent.

  • Pour chaque fonctionnalité, une nouvelle branche est créée.

Le développement est effectué dans une branche de fonctionnalité. Lorsque celle-ci se développe, elle est fusionnée dans la branche de développement. Les fonctionnalités terminées et validées sont sélectionnées à partir de la branche de développement et fusionnées dans la branche stable.

Toutes les modifications sont effectuées par le biais des demandes d’extraction (PR). Chaque requête d’extraction est automatiquement validée par les points de contrôle qualité. Sonar est utilisé pour la vérification de la qualité du code et un ensemble de suites de tests est exécuté pour s’assurer que le nouveau code n’introduit aucune régression.

La configuration du référentiel Git de Cloud Manager comporte deux branches :

  • Une branche de version stable contient le code de production de toutes les équipes.
  • Une branche de développement contient le code de développement de toutes les équipes.

Chaque notification push vers le référentiel Git d’une équipe de la branche de développement ou de la branche stable déclenche une action GitHub.

Tous les projets appliquent la même configuration pour la branche stable. Une notification push vers la branche stable d’un projet est automatiquement envoyée à la branche stable du référentiel Git de Cloud Manager. Le pipeline de production de Cloud Manager est configuré pour être déclenché par une notification push vers la branche stable. Le pipeline de production est donc exécuté par chaque notification push d’une équipe dans une branche stable et le déploiement en production est mis à jour si tous les points de contrôle qualité sont franchis avec succès.

Diagramme de notification push

Les envois vers la branche de développement sont gérés différemment. Bien qu’un envoi à une branche de développement du référentiel Git d’une équipe déclenche également une action GitHub et que le code soit automatiquement envoyé à la branche de développement dans le référentiel Git de Cloud Manager, le pipeline hors production n’est pas automatiquement déclenché par l’envoi du code. Il est déclenché par un appel à l’API de Cloud Manager.

L’exécution du pipeline de production comprend la vérification du code de toutes les équipes via les points de contrôle qualité fournis. Une fois le code déployé dans l’environnement intermédiaire, les tests et les audits sont exécutés pour s’assurer que tout fonctionne comme prévu. Une fois tous les points de contrôle passés, les modifications sont déployées en production sans interruption ou arrêt.

Le SDK d’AEM as a Cloud Service est utilisé pour le développement local. Le SDK permet de configurer une instance de création, une instance de publication et un Dispatcher locaux. Vous pouvez ainsi effectuer votre développement hors ligne et obtenir des délais d’exécution rapides. Parfois, seul l’environnement de création est utilisé pour le développement, mais la configuration rapide du Dispatcher et des environnements de publication permet de tout tester localement avant d’effectuer un transfert vers le référentiel Git.

Les membres de chaque équipe extraient généralement le code du référentiel Git partagé pour leur propre code de projet. Il n’est pas nécessaire de passer en revue d’autres projets, car ceux-ci sont indépendants.

Extraction locale et SDK

Il est possible d’utiliser cette configuration concrète comme plan directeur, puis de la personnaliser selon les besoins de l’entreprise. Le concept flexible d’embranchement et de fusion de Git permet de créer des variantes des processus ci-dessus, personnalisées selon les besoins de chaque équipe. AEM as a Cloud Service prend en charge toutes ces variations sans sacrifier la valeur de base du pipeline parfaitement défini de Cloud Manager.

TIP
Pour en savoir plus sur cette configuration, voir la section Utilisation de plusieurs référentiels Git source.

Considérations relatives à une configuration multi-équipes :headding-anchor:considerations

Avec le référentiel Git de Cloud Manager et le pipeline de production, le code de production complet est toujours exécuté par tous les points de contrôle qualité, en le considérant comme une unité de déploiement. Ainsi, le système de production est toujours activé sans interruption ni temps d’arrêt.

En revanche, en l’absence d’un tel système, chaque équipe pouvant effectuer un déploiement distinct, il est possible qu’une mise à jour d’une seule équipe entraîne des problèmes de stabilité en production. En outre, il est nécessaire de prévoir une coordination et des temps d’arrêt planifiés pour déployer les mises à jour. Avec un nombre croissant d’équipes, l’effort de coordination devient beaucoup plus complexe et rapidement ingérable.

Si un problème est détecté au niveau des points de contrôle qualité, la production ne sera pas affectée, et le problème pourra être détecté et corrigé sans que le personnel Adobe ait à intervenir. Sans Cloud Service et sans test systématique de l’ensemble du déploiement, les déploiements partiels peuvent entraîner des pannes qui nécessitent une requête de restauration ou même une restauration complète à partir d’une sauvegarde. Les tests partiels peuvent aussi entraîner d’autres problèmes qui devront être résolus ultérieurement, ce qui nécessitera à nouveau la coordination et l’assistance du personnel d’Adobe.

TIP
Dans le cas d’une configuration multi-équipes, il est essentiel de définir un modèle de gouvernance et un ensemble de normes que toutes les équipes doivent respecter. Le plan directeur précédent, qui correspond à une configuration multi-équipes, permet de mettre à l’échelle un plus grand nombre d’équipes.Vous pouvez ainsi utiliser ce plan directeur comme point de départ.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab