AEM Edge Delivery - Create Brand Specific EDS Sites using Repoless


Following steps outline the process to create Brand Specific EDS Sites using a single code repository aka Repoless

For indepth understanding and setting up EDS, create first site follow: https://www.aem.live/developer/ue-tutorial 

For more understanding on setting brand specific sites using repoless check: https://www.aem.live/developer/repoless-multisite-manager



Create Original Site

1) Navigate to https://github.com/adobe-rnd/aem-boilerplate-xwalk -> Use this template -> Create a new repository eg. eaem-rde-eds

2) In a new tab in the same browser, navigate to https://github.com/apps/aem-code-sync and click Configure

3) Select the repository eg. schoudry/eaem-rde-eds and save

4) Clone the repo eaem-rde-eds to your IDE, open eaem-rde-eds/fstab.yaml and give your AEM author url in format https://<aem-author>/bin/franklin.delivery/<owner>/<repository>/main

mountpoints:
  /:
    url: "https://author-p10961-e1322140.adobeaemcloud.com/bin/franklin.delivery/schoudry/eaem-rde-eds/main"
    type: "markup"
    suffix: ".html"

6) Open eaem-rde-eds/paths.json and provide the site name for mapping eg. eaem-rde-eds

{
  "mappings": [
    "/content/eaem-rde-eds/:/",
    "/content/eaem-rde-eds/configuration:/.helix/config.json",
    "/content/eaem-rde-eds/metadata:/metadata.json"
  ],
  "includes": [
    "/content/eaem-rde-eds/"
  ]
}

7) Commit and push the changes made to fstab.yaml and paths.json

8) Download the latest AEM authoring EDS template from https://github.com/adobe-rnd/aem-boilerplate-xwalk/releases eg. aem-sites-with-edge-delivery-services-template-0.1.2.zip

9) Navigate to the Sites console and click Create -> Site from template, click the Import button to import the template downloaded above. Once uploaded it can be reused to create additional sites

10) In the next screen of wizard, provide... 

                     Site title: Experience AEM RDE EDS Site 

                     Site name: eaem-rde-eds

                     Github url: https://github.com/schoudry/eaem-rde-eds

11) A background job is created, and when done you can see the inbox item  Background Job with source: "/content/eaem-rde-eds" has completed successfully.

12) Edit the index page eg. /content/eaem-rde-eds/index to open it in universal editor eg. https://author-p10961-e1322140.adobeaemcloud.com/ui#/@acsaem/aem/universal-editor/canvas/author-p10961-e1322140.adobeaemcloud.com/content/eaem-rde-eds/index.html

13) In Sites console use the Quick Publish to publish pages index, nav, footer and view the pages in Preview, Live using format https://main--<repository-name>--<owner>.aem.page 

                    eg. Preview: https://main--eaem-rde-eds--schoudry.aem.page

                    eg. Live: https://main--eaem-rde-eds--schoudry.aem.live/


Create Repoless Brand Site

This document explains activating repoless feature https://www.aem.live/developer/repoless-authoring

1) Get the token by logging into  https://admin.hlx.page/login and clicking https://admin.hlx.page/auth/adobe, copy auth_token cookie from browser console to pass it in admin api requests as -H 'x-auth-token: <your-token>'


2) Add a page of template type Configuration at /content/eaem-rde-eds 


3) Add config of site eaem-rde-eds-brand-one by doing a PUT to https://admin.hlx.page/config/schoudry/sites/eaem-rde-eds-brand-one.json


4) At this point you should see the site config (but no paths) https://admin.hlx.page/config/schoudry/sites/eaem-rde-eds-brand-one.json


5) Update the paths for eaem-rde-eds-brand-one by making a POST request to https://admin.hlx.page/config/schoudry/sites/eaem-rde-eds-brand-one.json/public.json and validate the config on live https://main--eaem-rde-eds-brand-one--schoudry.aem.live/config.json



6) Once the site configuration is mapped, configure Access Control by defining your Technical Account so it has privileges to publish by going to Tools -> Cloud Services -> Edge Delivery Services Configuration



7) Make the configuration eaem-rde-eds repoless by going to Tools -> Cloud Services -> Edge Delivery Services (eg. https://author-p10961-e1322140.adobeaemcloud.com/ui#/aem/libs/core/franklin/shell/content/configuration.html/conf?appId=aemshell)


8) Create Pages /content/eaem-rde-eds-brand-one and /content/eaem-rde-eds-brand-one/index with some brand specific content and publish using universal editor

9) You can view all your org sites here https://admin.hlx.page/config/schoudry/sites.json







No comments:

Post a Comment