Below are my notes when setting up a local Sitecore XM Cloud development environment. There are many good blog articles for local XM setup but the following 3 were the most useful for me
Blog 1 - Used for Docker setup
Blog 2 - Used for Rendering site setup
Blog 3 - Used to install test content in local CM
Using the information from the first 2 articles I was able to setup my local docker environment by running the up.ps1 script and then having a local Sitecore instance running on
https://xmcloudcm.localhost
I also had my local next js rendering site running using start:connected and accessed using the url
http://localhost:3000
You can write all your rendering React code in your React app. You can create components using Json renderings in Sitecore and have corresponding tsx files in the components folder of your React app. For any Sitecore content items that are part of the component, you serialize those items as yml files in your codebase.
Important Filesscjssconfig.json => contains jss config for local Sitecore CM
sitecore.json => contains path of the serialization folder and files
user.json => contains user specific config details to xmcloud dev and local
Setup Option #1
This is an ideal setup so that all developers have a local Sitecore instance they can use for development. This only works with Windows machines since the Sitecore XM Cloud Foundation template relies on Windows-based Docker containers.
Setup Option #2
Most of the information in this article is about option #1 but there is another option that can be considered and worked for me. If your team consists of more front end React developers who are all on Macs, this second option would work for you. So all the developers would use a Sitecore XM cloud environment as their local Sitecore instance. This needs more communication among the developers so they don't step on each other's items and bring an environment down for everyone. But it works as long as everyone understands what they are doing. Worst case be ready to bring down an environment and re-create it if needed.
Conclusion
It's nice that with Sitecore XM Cloud development your local setup is more simpler than traditional Sitecore local setups. Additionally you are no longer tied to using a Windows machine. Happy XM Cloud Sitecoreing!
Comments
Post a Comment