A new XM Cloud Docker tools image for local development, based on the Sitecore Docker tools image, is now available. If you are working with a local content management instance that runs in Docker, the new foundation code has the advantage of automatically syncing and updating with the XM Cloud Deploy app, making sure your code is up to date with our new releases, and making XM Cloud an extension point to your local starter kit.
To upgrade to the new version, apply the following changes to the sitecore-xmcloud-docker-tools-assets
image:
In the .env
file:
Change the
TOOLS_IMAGE
environment variable
fromTOOLS_IMAGE=scr.sitecore.com/tools/sitecore-docker-tools-assets:10.2.0-1809
toTOOLS_IMAGE=scr.sitecore.com/tools/sitecore-xmcloud-docker-tools-assets.
In the docker-compose.override.yaml
file:
Change cm build args
fromTOOLS_IMAGE: ${TOOLS_IMAGE}
toTOOLS_IMAGE: ${TOOLS_IMAGE}:${SITECORE_VERSION}
Change the cm container entrypoint
fromentrypoint: powershell -Command "& C:/tools/entrypoints/iis/Development.ps1”
toentrypoint: powershell -Command "& C:/tools/entrypoints/iis/XmCloudDevelopment.ps1"
In the up.ps1
file:
add the following code before the docker compose build command instruction:
$xmcloudDockerToolsImage = ($envContent | Where-Object { $_ -imatch "^TOOLS_IMAGE=.+" }).Split("=")[1]
Write-Host "Keeping XM Cloud Tools image up to date" -ForegroundColor Green
docker pull "$($xmcloudDockerToolsImage):$($sitecoreVersion)"
For an example of how to update these files, refer to the following pull request.