Merge pull request Sitecore#60 from AmitKumar-AK/feature/SITECORE-10-3-LTSC2022

Update for Sitecore 10.3 ltsc2019 and ltsc2022

Author: sc-olenanosenko

.gitignore

@@ -29,4 +29,7 @@ _ReSharper*/
 [Tt]est[Rr]esult*
 .vs/
 .vscode/
-packages/
+packages/
+# Device Detection Data files
+docker/devicedetection/*.lock
+docker/devicedetection/*.hash

custom-images/.env

@@ -51,4 +51,4 @@ SQL_SERVER=mssql
 SQL_SA_LOGIN=sa
 SQL_SA_PASSWORD=
 SQL_CUSTOM_DATABASE_PREFIX_UPDATE_FROM=
-SQL_DATABASE_PREFIX=Sitecore
+SQL_DATABASE_PREFIX=Sitecore

custom-images/README.md

@@ -0,0 +1,44 @@
+# Sitecore Custom Images
+
+Example solution for creating [custom Sitecore images](https://doc.sitecore.com/xp/en/developers/103/developer-tools/create-custom-sitecore-images.html), with recommended folder structure for container development.
+
+Please follow below steps to setup this repository on your local system
+
+## Steps
+
+1. Clone this repo
+
+2. Open the PowerShell command prompt with `ADMIN` access
+
+3. Go to the folder `custom-images` in the PowerShell window
+
+4. Execute the `init.ps1` with `ADMIN` access and pass the license file path
+
+```powershell
+.\init.ps1 -LicenseXmlPath "<C:\path\to\license.xml><path to your license.xml file>"
+```
+
+
+5. Build the appropriate Docker images and then start up.
+
+```powershell
+.\clean-install.ps1 <XP1 or XM1>
+```
+ - `.\clean-install.ps1 XP1` will create the XP Scaled environment
+- `.\clean-install.ps1 XM1` will create the XM environment
+- `.\clean-install.ps1` will create the XP0 environment
+
+    The above command will create the specific Sitecore Topology environemnt.
+
+6. Tear down and cleanup code changes when done.
+```powershell
+.\down.ps1 <XP1 or XM1>
+```
+ - `.\down.ps1 XP1` will clear artifacts for the XP Scaled environment
+- `.\down.ps1 XM1` will clear artifacts for the XM environment
+- `.\down.ps1` will clear artifacts for the XP0 environment
+
+
+
+
+

custom-images/clean-install.ps1

@@ -0,0 +1,61 @@
+param(
+    $XM1
+)
+
+
+Write-Host "The purpose of this script to start setup from scratch`n" -ForegroundColor Magenta
+Write-Host "  1. Stop all containers`n" -ForegroundColor DarkCyan
+Write-Host "  2. Docker Prune -Remove all unused containers, networks, images (both dangling and unreferenced), and optionally, volumes`n" -ForegroundColor DarkCyan
+Write-Host "  3. Stop IIS, Stop/Start Host Network Service (HNS)`n" -ForegroundColor DarkCyan
+Write-Host "  4. Run .\clean.ps1 from Sitecore > Docker`n" -ForegroundColor DarkCyan
+Write-Host "  5. Restore Sitecore CLI Tool`n" -ForegroundColor DarkCyan
+Write-Host "  6. Run docker compose up command`n" -ForegroundColor DarkCyan
+
+Write-Host "`n`n1. Stop all containers..." -ForegroundColor Cyan
+docker container stop $(docker container ls -q --filter name=docker-examples*);
+docker-compose stop; docker-compose down
+
+Write-Host "`n`n2. Docker Prune" -ForegroundColor Cyan
+docker system prune
+docker rmi $(docker images --format "{{.Repository}}:{{.Tag}}" | findstr "docker-examples")
+
+
+if ($XM1 -ieq 'XM1') {
+    docker rmi $(docker images --format "{{.Repository}}:{{.Tag}}" | findstr "docker-examples-xm1")
+}
+elseif ($XM1 -ieq 'XP1') {
+    docker rmi $(docker images --format "{{.Repository}}:{{.Tag}}" | findstr "docker-examples-xp1")
+}
+else {
+    docker rmi $(docker images --format "{{.Repository}}:{{.Tag}}" | findstr "docker-examples-xp0")
+} 
+
+Write-Host "`n`n3. Stop IIS, Stop/Start Host Network Service (HNS)" -ForegroundColor Cyan
+iisreset /stop; net stop hns; net start hns
+
+Write-Host "`n`n4. Clean all previous build artifacts" -ForegroundColor Cyan
+Push-Location docker
+.\clean.ps1
+
+Write-Host "`n`n5. Restore Sitecore CLI tool" -ForegroundColor Cyan
+Pop-Location
+dotnet tool restore
+
+Write-Host "`n`n6. Build/Compose Docker" -ForegroundColor Cyan
+Pop-Location
+
+
+if ($XM1 -ieq 'XM1') {
+    Write-Host "Start Up script for XM1......" -ForegroundColor Cyan
+    docker-compose -f docker-compose.xm1.yml -f docker-compose.xm1.override.yml up -d
+}
+elseif ($XM1 -ieq 'XP1') {
+    Write-Host "Start Up script for XP1......" -ForegroundColor Cyan
+    docker-compose -f docker-compose.xp1.yml -f docker-compose.xp1.override.yml up -d
+}
+else {
+    Write-Host "Start Up script for XP0......" -ForegroundColor Cyan
+    docker-compose up -d
+}
+
+Write-Host "***Setup completed successfully***" -ForegroundColor Green

custom-images/docker-compose.xp1.override.yml

@@ -15,7 +15,7 @@ services:
     volumes:
       - ./docker/traefik:C:/etc/traefik
 
-  redis:
+redis:
     image: ${REGISTRY}${COMPOSE_PROJECT_NAME}-redis:${VERSION:-latest}
     build:
       context: ./docker/build/redis

custom-images/docker/data/devicedetection/.gitkeep

@@ -0,0 +1,31 @@
+param(
+  $XM1
+)
+
+Write-Host "Down containers..." -ForegroundColor Green
+try {
+  docker-compose kill mssql
+  if ($LASTEXITCODE -ne 0) {
+    Write-Error "Container down failed, see errors above."
+  }
+
+  if ($XM1 -ieq 'XM1') {
+    Write-Host "Down script for XM1......" -ForegroundColor Cyan
+    docker-compose -f docker-compose.xm1.yml -f docker-compose.xm1.override.yml down
+
+  }
+  elseif ($XM1 -ieq 'XP1') {
+    Write-Host "Down script for XP1......" -ForegroundColor Cyan
+    docker-compose -f docker-compose.xp1.yml -f docker-compose.xp1.override.yml down
+
+  }
+
+  docker-compose down
+  if ($LASTEXITCODE -ne 0) {
+    Write-Error "Container down failed, see errors above."
+  }
+
+
+}
+finally {
+}

custom-images/down.ps1

@@ -1,6 +1,6 @@
 COMPOSE_PROJECT_NAME=sitecore-xp0
 SITECORE_DOCKER_REGISTRY=scr.sitecore.com/sxp/
-SITECORE_VERSION=10.3.0-ltsc2019
+SITECORE_VERSION=10.3-ltsc2022
 SITECORE_ADMIN_PASSWORD=
 SQL_SA_PASSWORD=
 TELERIK_ENCRYPTION_KEY=
@@ -33,4 +33,4 @@ SITECORE_GRAPHQL_ENABLED=false
 SITECORE_GRAPHQL_EXPOSEPLAYGROUND=false
 
 LOG_LEVEL_VALUE=INFO
-EXTERNAL_IMAGE_TAG_SUFFIX=ltsc2019
+EXTERNAL_IMAGE_TAG_SUFFIX=ltsc2022