Getting Started with the Experience Modernization Agent getting-started
Learn the first steps to quickly become productive with the Experience Modernization Agent using the Experience Modernization Console.
Prepare an Edge Delivery GitHub Repository prepare-repo
-
Select an Edge Delivery Services repository for use with the Experience Modernization Console.
- This can be an existing Edge Delivery Services project or you can create a new one following the developer tutorial using the boilerplate repository.
-
Ensure that the AEM Code Connector is installed in the repository.
- This allows the console to inspect your code.
-
Ensure that the AEM Code Sync GitHub app is installed in the repository.
- This allows Edge Delivery Services to sync your code.
- If your repo is based the on the tutorial, this step is already complete.
Open the Experience Modernization Console open-console
- Navigate to
aemcoder.adobe.io. - Log in with your Adobe ID.
Connect Your GitHub Repository connect-repo
The console prompts you for a repository when you first sign in.
- Click Connect repository.
- This opens the AEM Code Connector app on a new browser tab. Click Authorize AEM Code Connector.
- Back in the console, select Owner, Repository, and Branch selection and click Checkout to workspace.
- When prompted to Replace existing workspace, click Replace workspace.
Your GitHub project is now connected to the console and you are on the home screen.
Start Prompting start-prompting
Now that your console can access your code, you are ready to start prompting.
-
To get started you can import the content of a site:
- “Migrate the page
https://wknd-trendsetters.site.”
- “Migrate the page
-
This imports the content of the site.
- The console observes separation of concerns and handles content and presentation separately.
- The initial import of a site’s content may take several minutes.
- The console presents you with ongoing feedback as it begins its work, including an overview of its planned steps.
-
Once the site is imported, the Workspace panel shows the pages. Select a page to preview it in the right panel.
-
Now that you have content, you can prompt to import the styles from the same source.
- “Import the general styles from
https://wknd-trendsetters.site.”
- “Import the general styles from
-
As with the initial content import, the import may take several minutes and the console provides feedback as it processes your request and imports the styles. Once the task is complete, click Refresh preview in the right panel to view the styled content.
Now you have both the content and styles imported into the console.
Upload Content upload-content
To upload your content to Document Authoring:
-
Make sure you are in the Content view and then click the Upload content button on the top-right.
- By default you are in Content view when entering the console.
- Your view is indicated by the highlighted icon in the sidebar along the left side of the console.
-
The Upload content dialog opens with the destination org and repo pre-filled from your
fstab.yaml.- If an
fstab.yamlis not present in your connected repository, you will need to manually enter your Organization and Repository… - If you used the boilerplate, an
fstab.yamlis provided.
- If an
-
Select the files you want to upload and click Upload.
-
The console indicates upload process by graying the Upload button.
-
Once complete, a notification appears at the bottom of the console.
To access the uploaded content in Document Authoring, optionally click View in AEM in the notification when the upload completes, or navigate to https://da.live/#/{organization}/{repository}.
Your imported content is now in Document Authoring.
Push Code Changes push-code-changes
Once you are satisfied with the changes you have made to your code, you can push them to your GitHub repository.
- Switch to Code view (
</>icon in the left sidebar) and then the Git Changes tab (branch icon at the top-right).
- In the list of files changed, if some files show up as untracked, click their
+button to stage them. - Click the GitHub actions button at the top-right and then select Push from the drop-down.
- In the Push changes dialog, choose to push changes to a new PR (default) or the current branch and click Confirm to push.
- When in doubt, you can push to the current branch to keep things simple.
- Once complete, a notification appears at the bottom of the console.
If you wish to directly access the pushed changes in GitHub, click View PR in the notification when the push completes.
Your code is now in GitHub.
Preview Site preview-site
To view the changes in the preview environment:
-
Go back to Document Authoring.
- It may still be open in a browser tab you opened after clicking View in AEM after uploading the content.
- Or navigate to
https://da.live/#/{organization}/{repository}
-
Open one of the pages that you previously uploaded to AEM.
-
Click the paper plane icon (top right) and select Preview.
Congratulations! Your migrated content and styles are now live on the AEM preview environment.
If you pushed your code to a branch other than main, the preview opened from Document Authoring will not show the styles. Change to the branch by updating the URL of the preview and you can see your styles.
Additional Resources additional-resources
The following documents may be useful as you continue to explore the Experience Modernization Agent and its console.
- Experience Modernization Console - Details on the console, it’s views, options, and capabilities
- Edge Delivery Services developer tutorial - Useful if you are new to AEM and Edge Delivery Services projects
- Document Authoring - Useful if you are new to Document Authoring for content management