CHANGELOG.md

Changelog

November 2021

• [Added] CoveoVersion parameter (Specifies which version of Coveo to use and includes it in the build: -CoveoVersion "x.x.x.x")
• [Added] Coveo for Sitecore tools (\build\coveo-for-sitecore-tools)

May 2021

• [Added] Sitecore 10.1.0 XM1 Linux SQL Images

April 2021

• [Added] Sitecore 10.1.0 images
• [Added] PublishModuleAssetsOnly parameter (if 'true', Build.ps1 will exit after publishing module assets)
• [Added] LinuxBuildAssetPath parameter
• [Changed] 'SkipModuleAssets' parameter was replaced with 'IncludeModuleAssets'
• [Fixed] SitecoreFilter was filtering based on Path; now filters based on Tag

January 2021

• [Changed] Removed -Property FullName from Get-Item "C:\Program Files\Microsoft SQL Server*\DAC\bin\SqlPackage.exe" | Select-Object -Last 1 -ExpandProperty FullName.
• [Changed] Collapsed 10.x.x folders into version-specific to greatly improve upgradability. Added build\New-SitecoreVersion.ps1 script.
• [Added] Missing JSS 15.0.1 Linux images
• [Changed] Changed all 2009 images to 20H2
• [Removed] entrypoint and development scripts from the 10.x asset image. These are available at https://github.com/sitecore/docker-tools

December 2020

• [Added] Sitecore JSS v15.0.1 See #474. Thanks @vtml 👍
• [Added] re-tagged versions of sitecore-docker-tools-assets (now called custom-sitecore-docker-tools-assets)
• [Changed] Download-Module-Prerequisites.ps1 to use new CDN urls and no longer require username/password
• [Added] Automatic download and extract of Horizon assets
• [Added] Sitecore 10.0.1 Images, including Horizon
• [Fixed] Sitecore 10.0.0 JSS missing NodeJS in CM / CD Docker containers, which causes JSS Integrated mode to fail. See #386. Thanks @vtml 👍
• [Fixed] Sitecore 10.0.0 SXA / JSS missing Web.config transforms. See #387. Thanks @vtml 👍
• [Added] Windows 2009 is now supported. You can override which platforms you want by setting the parameter AutoGenerateWindowsVersionTags when calling Invoke-Build, default value is now: "2009", "2004", "1909", "1903", "ltsc2019".
• [Added] Sitecore 10.0.1 community modules Linux/Windows Coveo for Sitecore and Coveo for Sitecore SXA 5.0.858.1 assets images
• [Added] Global Downloads Support
• [Changed] Removed username/password from documentation. Fixed Test-SitecorePackages and sorted packages.

November 2020

• [Added] Ability to skip Module Asset Images with -SkipModuleAssets
• [Added] Ability to provide -OutputJson switch to build.ps1 to generate a Json file with a formatted list of images

October 2020

• [Added] JSS 15 images

• [Breaking] -JSS tags now upgraded to v10. To use JSS v14, make sure you use the -jss1400 tag

• [Added] missing packages to download file

• [Breaking] Renamed Download-PS-Prerequisites.ps1 to Download-Module-Prerequisites.ps1

• [Changed] Refactored Download-Module-Prerequisites.ps1 to download more than just Publishing Service

• [Changed] Fixed incorrect path logic in Download-Module-Prerequisites.ps1

• [Added] DEF tenant service (TS)

• [Added] additional TS plugin asset images

• [Added] additional DEF MA Action asset images

• [Changed] Removed defaultTags (mssql-developer-2017) from building for v10.x +

• [WIP] Temporarily disabling Horizon asset images

• [Added] Sitcore 10.0.0 (XP1) CD with PS and JSS

• [Changed] Sitcore 10.0.0 community module Windows PS include CD role

September 2020

• [Changed] Add Namespace to make difference between Sitecore vs commintry tags. Example: community/TAG, and community/modules/TAG
• [Added] Sitcore 10.0.0 community modules Linux/Windows CMP/DAM/DEF/PS/SFMC/SPE/SXA assets images
• [Added] Sitcore 10.0.0 XP0/XP1/SPE/SXA/JSS/PS MsSql Linux images
• [Breaking] Refactored repository to most build-related files to a /build folder
• [Breaking] Sitecore Version build.ps1 default set to 10.0.0
• [Added] XP0 10.0.0. SPE/SXA/JSS
• [WIP] Sitecore 10.0.0 docker-compose tests (XM/XP/XP0)
• [Breaking] Removed sitecore-tags.md from the root of the repo. Could cause broken links if someone refers to it
• [Changed] Refactored README.md to reflect official Sitecore folder, pulled out instructions
• [Added] INSTRUCTIONS.md pulled from the original README.md
• [Added] /sitecore-container-support folder which will hold sitecore-tags.md and other official assets

August 2020

• [Added] Sitecore 10.0.0 XM/SPE/SXA/JSS/PS Windows images.
• [Added] Sitecore 10.0.0 XP/SPE/SXA/JSS/PS Windows images.

July 2020

• [Bug] Sitecore 9.3.0 XP set ServerName xConnect shards on SQL linux images.
• [Fixed] Sitecore 9.3.0 XP SQL Shard linux images.
• [Added] Sitecore 9.3.0 XP/SXA/PS SQL linux images.
• [Fixed] Sitecore 9.3.0 XP/SXA Solr linux images.

May 2020

• [Added] Windows 2004 is now supported. You can override which platforms you want by setting the parameter AutoGenerateWindowsVersionTags when calling Invoke-Build, default value is now: "2004", "1909", "1903", "ltsc2019".

April 2020

• [Added] Sitecore 9.3.0 XP SPE/SXA SQL linux images
• [Added] Sitecore 9.3.0 XP SQL and Solr linux images

March 2020

• [Added] Sitecore 9.3.0 XM SQL and Solr linux images.
• [Breaking] Modified WindowsOSVersion to OSVersion in Build.ps1 in support of Linux. See #279
• [Breaking] Modified yml pipeline to remove "Start VM" stage and switch to .\build.ps1. New parameters required. See #279 and #280

January 2020

• [Added] Sitecore 9.3.0 XC/SXA.
• [Added] Hash values of Sitecore downloads are now validated before being used. If a file hash does not match the expected value, the build will fail with a message explaining what happened and how to resolve. See #148. Thanks @michaellwest 👍
• [Changed] 7-zip is removed from the sitecore-assets images since it was only used for validating Sitecore downloads which is now done by validating file hashes instead.

December 2019

• [Changed] Added .gitkeep to $DefaultExcludedFiles parameter in Watch-Directory.ps1.
• [Changed] Development ENTRYPOINT scripts now supports parsing in parameters to Watch-Directory.ps1 using parameter splattering. See README.md on how to use.
• [Added] Development ENTRYPOINT scripts for XConnect worker roles (auto start watch directory). See README.md on how to use. Thanks @jeanfrancoislarente 👍
• [Added] Sitecore 9.3.0 XM/XP-SXA/PS (publishing service) variant.

November 2019

• [Added] Sitecore 9.3.0 XM/XP/SXA.
• [Added] New optional ENTRYPOINT scripts (log streaming, auto start watch directory and auto start remote debugger) for IIS based images. See README.md on how to use.
• [Added] Windows 1909 is now also supported. You can override which platforms you want by setting the parameter AutoGenerateWindowsVersionTags when calling Invoke-Build, default value is: "1909", "1903", "ltsc2019".
• [Added] Build images updated to now include XC - PSE, XC - SXA, XC - SXA Storefront

October 2019

• [Added] Sitecore 9.2.0 XC images.
• [Added] New 9.2.0 xp-xconnect-processingengine images. See #43. Thanks @adoprog 👍
• [Changed] Windows and Linux spe "Sitecore PowerShell Extensions" images updated to v6.0, indirectly also updating all sxa images. See #84. Thanks @michaellwest 👍
• [Changed] The c:\tools\scripts\Watch-Directory.ps1 no longer deletes destination directories, only files. See #89. Thanks @sshushliapin 👍
• [Fixed] The c:\tools folder was empty.
• [Breaking] Windows and Linux "Sitecore PowerShell Extensions" images is now correctly tagged with spe instead of pse.
• [Breaking] Linux variant tags aligned with Windows variant tags, variant version is not part of tag anymore, latest compatible version is always used. Old images moved to ./legacy/linux.
• [Breaking] When building, then default value used for the -Tags parameter will now only build images of the latest Sitecore version (including variants such as SXA/SPE) on the latest LTSC (Long Term Support Channel) Windows version instead of everything. As of today that would be Sitecore 9.2.0 on windowsservercore-ltsc2019. To build everything you could use -Tag "*", see README.md for more details.
• [Breaking] Switched from using SIF to manual installing contents from the Sitecore WDP's.
  • Official mcr.microsoft.com/dotnet/framework/aspnet images are now used at runtime:
    • Sitecore in now installed into C:\inetpub\wwwroot instead of C:\inetpub\sc.
    • IIS site Default Web Site and application pool DefaultAppPool is now used instead of sc.
  • The WatchDirectory.ps1 helper script has been moved from C:\Sitecore\Scripts:
    • It's now in C:\tools\scripts and this path is also in the system PATH.
    • New script Invoke-XdtTransform.ps1 added.
  • Docker files has been rewritten (also with comments) and images are now smaller and has fewer layers.
• [Breaking] Windows base and variant images merged into .\windows:
  • When calling Invoke-PackageRestore and Invoke-Build you need to point to .\windows going forward.
  • The previous .\images, .\variants and .\tests is moved into .\legacy so you can still build them if needed.
    • IMPORTANT: Do not build both .\windows and .\legacy\images (or .\legacy\variants) as they will overwrite each other as many tags are the same.
  • New docker-compose files added for testing into .\windows\tests, you can override the default values in the .env file using system environment variables to test other Sitecore versions and/or Windows versions.
• [Breaking] Sitecore XM images has been renamed from sitecore-xm1-* to sitecore-xm-*.
• [Breaking] Sitecore license file license.xml is no longer embedded into the images and you are now required to mount a folder that has the license into C:\license inside the containers.
• [Added] Quick start .\Build.ps1 script added for simpler on-boarding when you just want to try out Sitecore on Docker. See README.md for more details.
• [Changed] XM and XP Solr images on Windows now has the Sitecore schema embedded like the Linux images. No need to remember to run "Populate managed schema" anymore.
• [Changed] Made the -Registry parameter optional. Not specifying the -Registry will build the images locally only.

September 2019

• [Fixed] Invalid download url in sitecore-packages.json was fixed for JSS 11.0.1 XP CM. IMPORTANT: Remove the file Sitecore JavaScript Services Server for Sitecore 9.1.1 XP 11.0.1 rev. 190318.scwdp.zip from where you store the packages and ALSO also inside .\variants\9.1.1\windowsservercore\jss\sitecore-xp-jss-11.0.1-standalone\ so the package will be re-downloaded.

August 2019

• [Fixed] Added missing media handler in the 9.2.0/JSS 12.0.0 images.
• [Added] New Sitecore 9.2.0 XM/XP JSS 12.0.0 SQL Server on Linux images.
• [Added] New Sitecore 9.2.0 XM/XP JSS 12.0.0 on Windows variants.
• [Added] New Sitecore 9.2.0 XM/XP SXA 1.9.0 SQL Server on Linux images.
• [Added] New Sitecore 9.2.0 XM/XP SPE 5.0 SQL Server on Linux images.
• [Changed] Renamed Sitecore SQL Server on Linux images from -sqldev to -sql since you can switch SQL edition using the MSSQL_PID environment variable. Default value is Developer and possible values are Enterprise, Standard, Web and Express.
• [Fixed] Multi-stage builds on Docker engine 19.03.1, see docker/for-win#4349. Temporary workaround applied to affected Docker files.

July 2019

• [Fixed] Fixed Sitecore 9.0.2 XP variants PSE/SXA on Windows.
• [Added] New Sitecore 9.2.0 XM/XP SQL Server on Linux.
• [Added] New Sitecore 9.2.0 XM/XP/SXA Solr 7.5.0 on Linux.
• [Added] Sitecore 9.2.0 XM/XP variants with Sitecore Experience Accelerator (SXA) on ltsc2019 and 1903.
• [Added] Sitecore 9.2.0 XM/XP variants with Sitecore PowerShell Extensions (SPE) on ltsc2019 and 1903.
• [Added] Sitecore 9.2.0 XM/XP base images on ltsc2019 and 1903.

June 2019

• [Added] Added 9.0.2 PSE, SXA 1.8.1 on variants.
• [Fixed] SXA 1.8.1 on Sitecore 9.1.1 XM and XP is now correctly configured with all Web.config transforms, specificity the sxaxm:define appSetting and the SXA MediaRequestHandler.
• [Breaking] Consolidated sitecoreops/sitecore-images and this repository. All future work will happen right here from now on. If you need the old master branch you can use the legacy branch that is a copy from just before the consolidation.
• [Changed] Added multiple release channels (ie ltsc2019, 1903) on variants.

May 2019 (and before)

• [Changed] All SQL images are now based on the mssql-developer:2017 image.
• [Breaking] To build deprecated image tags, you now need set the DeprecatedTagsBehavior parameter to Include.
• [Deprecated] All 1709 images is now deprecated as the .NET framework is no longer supported on this build. You can still build them using -DeprecatedTagsBehavior "Include".
• [Removed] ltsc2016 images is now deleted completely as ltsc2019 is now the current ltsc version.
• [Fixed] Using ARG variables in Docker files can now be with and without {}.
• [Changed] The build.json format has changed to support the use of build-arg during docker image build. In this new format we can support multiple release channels (ie 1803, ltsc2019, 1903) within a single build folder using ARG while reducing maintenance time and disk space needed.
• [Deprecated] Sitecore 8.2 rev. 161221 is now marked as deprecated. You can still build them using -DeprecatedTagsBehavior "Include".
• [Deprecated] Sitecore 7.5 is now marked as deprecated. You can still build them using -DeprecatedTagsBehavior "Include".
• [Breaking] Added build / restore support for deprecated images. Images that are deprecated is not build by default anymore, only when setting parameter -DeprecatedTagsBehavior "Include".
• [Added] Ability to download required packages from dev.sitecore.net, see How to use section for more details. Thanks @Brad-Christie 👍
• [Changed] Implicit tags are now automatically included by default when using the -Tags parameter so you don't have to explicit define all dependent tags. Thanks @Brad-Christie 👍
• [Added] Added Sitecore 9.1.1 XM and XP on 1903. Thanks @jballe 👍
• [Added] Node support for JSS CM images, the integrated Mode require node on the instance for Server-Side Rendering (SSR). @bplasmeijer
• [Changed] Fixed tags for JSS images, was tagged with 10.0.1 instead of 11.0.1 which is the version installed, see #35. Thanks @mikkelvalentinsorensen 👍
• [Changed] Sitecore 9.1.1 XM and XP SQL images are now based on the new mssql-developer:2017-windowsservercore-ltsc2019 image.
• [Added] Microsoft SQL Server 2017 base image on ltsc2019 added.
• [Added] New variant: Sitecore 9.1.1 with Sitecore Experience Accelerator (SXA). Thanks @bplasmeijer 👍
• [Added] New variant: Sitecore 9.1.1 with Sitecore JavaScript Services (JSS). Thanks @bplasmeijer 👍
• [Added] New variant: Sitecore 9.1.1 with PowerShell Extensions (PSE). Thanks @bplasmeijer 👍
• [Added] New variants build support. See How to use and Current variants.
• [Changed] Sitecore 9.1.1 IIS app pools now runs as LocalSystem so they are allowed to write to volume mounts on Windows Server 2016/2019 hosts.
• [Fixed] Sitecore Solr images on 1809 now runs as ContainerAdministrator again to fix access denied errors, see #27. Thanks @joostmeijles 👍
• [Breaking] Sitecore 9.1.1 XM images renamed back to xm1, see #28. Thanks @sergeyshushlyapin 👍
• [Changed] Sitecore 9.1.1 images now overrides default ENTRYPOINT to get ServiceMonitor to monitor and inject Docker defined environment variables into the Application Pool that runs Sitecore. Thanks @jballe 👍
• [Changed] Sitecore 9.1.1 XP Solr image now runs the additional xConnect Solr core configuration from App_Data. Thanks @joostmeijles 👍
• [Added] Sitecore 9.1.1 XM and XP on ltsc2019/1809, please notice that the xm1 tags is now just xm.
• [Breaking] Sitecore 9.1.0 images tagged with 9.1.001564 is renamed to 9.1.0 to align with the new Sitecore NuGet versioning.
• [Added] Sitecore 7.5.150212 CM/CD and SQL on 1803.
• [Added] Sitecore 8.2.161221 CM/CD and SQL on 1709/1803.
• [Fixed] Removed VOLUME instructions from 9.1.0/9.0.2 Solr and SQL on 1809/ltsc2019/1803, see #22.
• [Fixed] Build process now takes tag filters into account when pulling external base images.
• [Added] Sitecore 9.1.0 XP CM/CD/xConnect on ltsc2019, SQL Developer and Solr (7.2.1) on 1809.
• [Added] Sitecore 9.1.0 XP CM/CD/xConnect on 1803, SQL Developer and Solr (7.2.1) on 1803.
• [Added] Sitecore 8.2.180406 Solr on nanoserver-1809.
• [Added] Sitecore 8.2.180406 CD/CM/Processing and Reporting on windowsservercore-ltsc2019.
• [Fixed] Solr write.lock files are now deleted before Solr start, see #15.
• [Added] Sitecore 9.0.2 XP CM/CD/xConnect, SQL Developer and Solr on 1803.
• [Added] Sitecore 9.0.2 XM1 CM/CD, SQL Developer and Solr on 1709.
• [Added] Sitecore 9.1.0 XM1 CM/CD, SQL Developer and Solr (7.2.1) on 1803. Please note the new XM1 specific tags for SQL and Solr.
• [Changed] Restructured Sitecore 9.1.0 XM1 CM/CD/base docker files to use multi-stage builds, number of layers reduced from 25 to 13 and the size is also reduced to 5.06 GB on ltsc2019.
• [Added] Sitecore 9.1.0 XM1 CM/CD, SQL Developer on ltsc2019 and Solr (7.2.1) on 1809. Please note the new XM1 specific tags for SQL and Solr.
• [Changed] Updated Sitecore 9.0.1, 9.0.2 Solr images to latest patch release: 6.6.3.
• [Changed] Updated openjdk base images used for Solr to latest version: java-1.8.0-openjdk-1.8.0.191-1.b12.
• [Added] Sitecore 9.0.2 XM1 CM/CD, SQL Developer on ltsc2019 and Solr on 1809.
• [Changed] Migrated Microsoft base images to use the new official registry "mcr.microsoft.com".
• [Added] Sitecore 8.2.180406 Solr on nanoserver-1803.
• [Added] Sitecore 8.2.180406 SQL Developer on windowsservercore-1803.
• [Added] CD, CM, Processing and Reporting roles to Sitecore 8.2.180406 on windowsservercore-1803.
• [Added] Sitecore 8.2.* on windowsservercore-1803.
• [Added] Sitecore 9.0.2 XM1 CM/CD, SQL Developer and Solr on 1803.
• [Added] Sitecore 9.0.1 on windowsservercore-1803.
• [Added] Sitecore 9.0.1 Solr on nanoserver-1803.
• [Added] Sitecore 9.0.1 SQL Developer on windowsservercore-1803.
• [Added] Sitecore 9.0.1 Solr on windowsservercore-1709.
• [Added] Sitecore 9.0.1 SQL Developer on windowsservercore-1709.
• [Breaking] Restructured versions and tags to support multiple Windows channels (ltsc2016, 1709, 1803 etc), there are now more repositories per version, one for each topology/role. See Tags and Windows versions.
• [Breaking] Decoupled image tags from structure by specifying full tag in "build.json".
• [Added] Sitecore 8.2 Update 7.
• [Fixed] Added UrlRewrite outbound rule to handle Sitecore redirect after login when container is running on another port than 80 (possible in Windows 10 1803).
• [Fixed] Solr build errors regarding downloads from github (TLS 1.2 now used).
• [Added] Specialized Solr image with all Sitecore cores embedded and volume support, for Sitecore 9.0.1 (which defaults to use Solr).
• [Added] Specialized SQL Server images with all Sitecore databases embedded and volume support, for Sitecore 9.
• [Changed] all Sitecore 9 images now default has connection strings matching the new specialized SQL Server images.
• [Added] XM1 CM and CD role images for Sitecore 9.

August 2018

• [Changed] Breaking Change Replaced Build.ps1 by new module "Sitecore.DockerImages.Management"
• [New] Breaking Change Dependency on external module "Bendev.Assets.Management"
• [Changed] Breaking Change New folder naming
• [New] XP Single base image
• [New] XP Single image
• [Changed] Containers' layers optimization
• [Changed] Performance optimizations