Téléchargement et installation de modèles AEM Sites

Ce guide fournit des instructions détaillées pour installer et configurer le dernier modèle AEM Guides pour générer des pages AEM Sites dans un environnement cloud. Pour installer les packages requis, créer et configurer des paramètres prédéfinis et générer AEM Sites, procédez comme suit.

Conditions préalables

Les onglets suivants fournissent les prérequis nécessaires en fonction de votre configuration Experience Manager Guides : Cloud Service ou On-Premise.

Tab
  • Adobe Experience Manager (AEM) Cloud : instance en cours d’exécution de AEM as a Cloud Service avec AEM Guides 2502 ou versions ultérieures.

  • Autorisations requises : vous devez disposer des autorisations suivantes :

    • Accès à ​pour déployer des packages.
    • Accès au référentiel Git associé à votre environnement.
    • Les autorisations de création et de modification des paramètres prédéfinis dans AEM Guides.
  • Télécharger les packages : téléchargez les packages suivants à partir du portail de distribution logicielle :

    • Package de composants : guides-components.all-1.x.0.zip
    • Modèle Sites : aemg-docs-1.x.0.zip
On-Premise
  • Adobe Experience Manager (AEM) : une instance en cours d’exécution de AEM 6.5 avec Service Pack 21, 20 et 19 et AEM Guides 4.6.0, ou des versions ultérieures installées.

  • Autorisations requises : assurez-vous de disposer des autorisations suivantes :

    • Accès au Portail de distribution logicielle pour télécharger les packages requis
    • Accès au gestionnaire de packages pour installer des packages dans AEM.
    • Les autorisations de création et de modification des paramètres prédéfinis dans AEM Guides.
  • Télécharger les packages : téléchargez les packages suivants à partir du Portail de distribution logicielle :

    • Package de composants : on-prem-guides-components.all-1.x.0.zip
    • Package Sites : aemg-docs.all-1.x.0.zip

Installation du package

Les onglets suivants fournissent des instructions pour l’installation du package en fonction de votre configuration Experience Manager Guides : Cloud Service ou On-Premise.

Tab

Installez le Package de composants (guides-components.all-1.x.x.zip) puis effectuez les étapes suivantes

  1. Clonage du référentiel Git :

    1. Accédez à Référentiels dans le panneau de gauche de Cloud Manager.

    2. Sélectionnez Accéder aux informations sur le référentiel et copiez la commande de clone Git.

      Sélectionnez Accéder aux informations sur le référentiel {width="350"}

    3. Clonez le référentiel sur votre système local à l’aide du nom d’utilisateur et du mot de passe fournis (générez un mot de passe si nécessaire).

  2. Ajouter un package au lot Maven :

    1. Dans votre référentiel cloné localement, créez un lot Maven ou ajoutez-le à un lot existant.

    2. Assurez-vous que la structure /jcr_root/apps/fmdita/ installer existe dans le projet Maven.

      Structure dans un projet Maven {width="650"}

    3. Placez le fichier guides-components.all-1.x.x.zip téléchargé dans le dossier d’installation.

  3. Mettre à jour filters.xml:

    1. Ouvrez le fichier filters.xml situé dans le dossier META-INF du répertoire de contenu parent.

    2. Ajoutez le filtre suivant : racine du filtre=/apps/fmdita mode=merge/

      Ajouter un filtre {width="650"}

  4. Configurer pom.xml : mettez à jour le fichier pom.xml en fonction des exigences de votre environnement.

  5. Envoi des modifications et exécution du pipeline :

    1. Envoyez les modifications au référentiel Git principal.
    2. Accédez à Pipelines dans Cloud Manager et exécutez le pipeline pour l’environnement souhaité.
  6. Vérifier l’installation : une fois le déploiement terminé, le package de composants sera installé dans l’environnement AEM Cloud.

On-Premise
  1. Installez le package de composants :

    1. Accédez au Gestionnaire de packages.
    2. Téléchargez et installez le package on-prem-guides-components.all-1.x.0.zip .
  2. Installation du package Sites : téléchargez et installez le package aemg-docs.all-1.x.0.zip à l’aide du gestionnaire de packages CRX.

Créer un site à l’aide de modèles installés (pour Cloud Service)

  1. Modèle d’importation de sites :

    1. Accédez à la page AEM Sites (servername/sites.html/content).
    2. Sélectionnez Créer > Site à partir d’un modèle.
    3. Importez le modèle de sites aemg-docs-1.x.x.zip à l’aide de l’option Importer.
  2. Sélectionner le modèle : sélectionnez AEMG Docs 1.x.x puis sélectionnez Suivant.

  3. Saisir les détails du site : saisissez le titre du site et le nom du site.

    Créer un site {width="350"}

  4. Sélectionnez Créer.

Créer un paramètre prédéfini de site AEM

  1. Créer un nouveau paramètre prédéfini :

    1. Ouvrez un plan DITA dans AEM Guides et accédez au panneau Sortie.

    2. Sélectionnez Créer un paramètre prédéfini.

    3. Sélectionnez le type comme .

    4. Saisissez le nom du paramètre prédéfini.

    5. Décochez le paramètre Utiliser le mappage des composants hérités.

    6. Sélectionnez Ajouter pour créer le paramètre prédéfini.

      Créer un nouveau paramètre prédéfini de site AEM {width="350"}

  2. Configurer le paramètre prédéfini de site AEM : il existe deux options pour configurer le site prêt à l’emploi :

    Option 1 : utiliser la liste déroulante Site

    1. Sélectionnez Site comme celui créé ci-dessus (par exemple, Site de documents AEMG).

    2. Vérifiez que les modèles Chemin de publication et Page de rubrique sont automatiquement définis sur :

      • Chemin de publication : Cloud Service : /content/AEMG-Docs-Site/en/docs/product et On-Premise : aemg-docs/en/docs/product1
      • Modèle de page de rubrique : Page de rubrique

      Utilisez la liste déroulante Site pour configurer le site AEM {width="350"}

    Option 2 : utiliser le chemin du site

    1. Définissez manuellement le chemin d’accès au site comme /content/AEMG-Docs-Site/en/docs/product pour Cloud Service et /content/aemg-docs/en/docs/product1 pour On-Premise.

    2. Vérifiez que le modèle Page de rubrique est automatiquement défini sur Page de rubrique.

      Pour Cloud Service :

      Utilisez le chemin du site pour configurer le site AEM {width="650"}

      Pour On-Premise :

      Utiliser le chemin du site {width="350"}

  3. Enregistrer le paramètre prédéfini : enregistrer les modifications apportées au paramètre prédéfini.

Générer AEM Sites

  1. Générer le site :

    1. Une fois le paramètre prédéfini configuré, générez le site AEM pour le plan DITA correspondant.
    2. Le site généré sera disponible à l’emplacement suivant : /content/AEMG-Docs-Site/en/docs/product pour Cloud Service et /content/aemg-docs/en/docs/product1 pour On-Premise.
  2. Modifier le chemin de génération par défaut (facultatif) : si vous souhaitez modifier le chemin par défaut pour la génération du site, procédez comme suit :

    1. Accédez à .

    2. Créez une page produit sous la structure de site prête à l’emploi.

    3. Accédez à Documents AEMG > Français > Documents.

      Création d’une page {width="650"}

    4. Sélectionnez la mosaïque Page d’accueil puis sélectionnez Suivant.

      Sélectionnez la mosaïque Accueil {width="650"}

    5. Saisissez les Titre et Nom de la page.

    6. Sélectionnez Créer.

NOTE
Pour la configuration de Cloud Service, assurez-vous que toutes les configurations sont testées dans un environnement hors production avant le déploiement en production.

Pour plus d’informations, reportez-vous à la documentation officielle Déploiement sur AEM as a Cloud Service.
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178