Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Sitecore/Sitecore-Azure-Quickstart-Templates
This repo contains all currently available Azure Resource Manager templates for Sitecore
https://github.com/Sitecore/Sitecore-Azure-Quickstart-Templates
arm-templates sitecore
Last synced: 3 months ago
JSON representation
This repo contains all currently available Azure Resource Manager templates for Sitecore
- Host: GitHub
- URL: https://github.com/Sitecore/Sitecore-Azure-Quickstart-Templates
- Owner: Sitecore
- License: mit
- Created: 2016-10-31T16:58:44.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2024-07-19T15:03:17.000Z (4 months ago)
- Last Synced: 2024-07-19T19:32:05.484Z (4 months ago)
- Topics: arm-templates, sitecore
- Language: PowerShell
- Size: 1.98 MB
- Stars: 140
- Watchers: 58
- Forks: 280
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: Security patches/SC2019-002-312864/8.2/SC2019-002-312864.zip
Awesome Lists containing this project
- Awesome-Sitecore - ARM templates for Sitecore - All currently available Azure Resource Manager templates for Sitecore. (Azure)
README
# Sitecore-Azure-Quickstart-Templates
This repo contains all currently available Azure Resource Manager templates for Sitecore
# Documentation
You can read all about Sitecore Azure AppService integration and ARM Template deployment at [Sitecore Documentation Site](https://doc.sitecore.com/developers/90/#sitecore_azure)
# Compatibility
Choose the compatible templates for your Sitecore version:
| Templates Folder | Compatible Product versions |
|------------------|-----------------------------------------------------------------------|
| Sitecore 8.2.1 | Sitecore 8.2 Update-1 and Update-2 |
| Sitecore 8.2.3 | Sitecore 8.2 Update-3 |
| Sitecore 8.2.4 | Sitecore 8.2 Update-4 |
| Sitecore 8.2.5 | Sitecore 8.2 Update-5 and Update-6 |
| Sitecore 8.2.7 | Sitecore 8.2 Update-7 |
| Sitecore 9.0.0 | Sitecore 9.0 |
| Sitecore 9.0.1 | Sitecore 9.0 Update-1
Please note that these ARM templates link to an additional WDP in order to resolve a potential performance issue on start-up (see KB [article](https://kb.sitecore.net/articles/290593) for more info). |
| Sitecore 9.0.2 | Sitecore 9.0 Update-2 |
| Sitecore 9.1.0 | Sitecore 9.1 |
| Sitecore 9.1.1 | Sitecore 9.1 Update-1 |
| Sitecore 9.2.0 | Sitecore 9.2 |
| Sitecore 9.3.0 | Sitecore 9.3 |
| Sitecore 10.0.0 | Sitecore 10.0.0, 10.0.1, 10.0.2 and 10.0.3 |
| Sitecore 10.1.0 | Sitecore 10.1.0 |
| Sitecore 10.1.1 | Sitecore 10.1.1, 10.1.2, 10.1.3 |
| Sitecore 10.2.0 | Sitecore 10.2.0, 10.2.1, 10.2.2, 10.3.0, 10.3.1, 10.4.0 |
| WFFM 8.2.3 | Web Forms For Marketers 8.2 Update-3, Update-4 and Update-5 |
| WFFM 9.0.0 | Web Forms For Marketers 9.0 |
| AD 1.3.0 | Active Directory 1.3 |
| EXM 3.5.0 | Email Experience Manager 3.5.0 |
| SXA | Sitecore Experience Accelerator 1.3 - 1.6 for Sitecore 8.2 and Sitecore 9.0 |
| Sitecore XC 9.0.0 | Commerce 9.0 Initial, Commerce 9.0 Update-1. Use with templates: Sitecore 9.0.1, SXA 1.6, SXA Storefront 1.0 |
| Sitecore XC 9.0.2 | Commerce 9.0 Update-2. Use with templates: Sitecore 9.0.2, SXA 1.7.1, SXA Storefront 1.2 |
| Sitecore XC 9.0.3 | Commerce 9.0 Update-3. Use with templates: Sitecore 9.0.2, SXA 1.8, SXA Storefront 1.4 |
| Sitecore XC 9.1.0 | Commerce 9.1 Initial. Use with templates: Sitecore 9.1.1, SXA 1.8, SXA Storefront 2.0 |
| Sitecore XC 9.2.0 | Commerce 9.2 Initial. Use with templates: Sitecore 9.2.0, SXA 1.9.0, SXA Storefront 3.0 |
| Sitecore XC 9.3.0 | Commerce 9.3 Initial. Use with templates: Sitecore 9.3.0, SXA 9.3.0, SXA Storefront 4.0 |
| Sitecore XC 10.0.0 | Commerce 10.0.0. Use with templates: Sitecore 10.0.0, SXA 10.0.0, SXA Storefront 5.0 |
| SXA Storefront 1.0 | SXA Storefront 1.0. Use with templates: Sitecore 9.0.1, Sitecore XC 9.0.0, SXA 1.6 |
| SXA Storefront 1.2 | SXA Storefront 1.2. Use with templates: Sitecore 9.0.2, Sitecore XC 9.0.2, SXA 1.7.1 |
| SXA Storefront 1.4 | SXA Storefront 1.4. Use with templates: Sitecore 9.0.2, Sitecore XC 9.0.3, SXA 1.8 |
| SXA Storefront 2.0 | SXA Storefront 2.0. Use with templates: Sitecore 9.1.1, Sitecore XC 9.1.0, SXA 1.8 |
| SXA Storefront 3.0 | SXA Storefront 3.0. Use with templates: Sitecore 9.2.0, Sitecore XC 9.2.0, SXA 1.9.0 |
| SXA Storefront 4.0 | SXA Storefront 4.0. Use with templates: Sitecore 9.3.0, Sitecore XC 9.3.0, SXA 9.3.0 |
| SXA Storefront 5.0 | SXA Storefront 5.0. Use with templates: Sitecore 10.0.0, Sitecore XC 10.0.0, SXA 10.0.0 |
# Pre-deployment Checklist
1. Ensure you have the latest Azure PowerShell Az module installed. You can find installation instructions at [Install Azure PowerShell](https://docs.microsoft.com/en-us/powershell/azure/install-az-ps)
2. Ensure that Sitecore Web Deploy packages you are going to deploy are available for download over the Internet
3. Download and update the parameter values in the **azuredeploy.parameters.json** file
# Preparing prerequisites
Prerequisites section allows to deploy pre-step(s) (for example solr deployment, etc. ) before the main deployment.
In order to deploy prerequisites as part of Sitecore deployment, you will need to change azuredeploy.parameters.json by adding prerequisites object with necessary parameters.
Parameters that should be passed to the prerequisite depend on the actual deployment template. For example:
```JSON
"prerequisites": {
"value": {
"items": [
{
"name": "",
"templateLink": "",
"parameters": {
/* Parameters for the prerequisite. Can be empty */
"": {
"value": ""
}
}
}
]
}
}
```
# Sample PowerShell Script
Below is a sample PowerShell script that can help you to get up and running quickly with the ARM Templates. There is also a Sitecore PowerShell CmdLet available for download at [Sitecore Downloads Site](https://dev.sitecore.net/) that makes the deployment even easier.
```PowerShell
# Specify the parameters for the deployment
$ArmTemplateUrl = "AZUREDEPLOY_JSON_URL"
$ArmParametersPath = ".\azuredeploy.parameters.json"
$licenseFilePath = "PATH_TO_LICENSE_XML"
# Specify the certificate file path and password if you want to deploy Sitecore XP or XDB configurations
$certificateFilePath = $null
$certificatePassword = $null
$certificateBlob = $null
$Name = "RESOURCE_GROUP_NAME"
$location = "AZURE_DATA_CENTER_NAME"
$AzureSubscriptionId = "AZURE_SUBSCRIPTION_ID"
# read the contents of your Sitecore license file
$licenseFileContent = Get-Content -Raw -Encoding UTF8 -Path $licenseFilePath | Out-String
# read the contents of your authentication certificate
if ($certificateFilePath) {
$certificateBlob = [System.Convert]::ToBase64String([System.IO.File]::ReadAllBytes($certificateFilePath))
}
#region Create Params Object
# license file needs to be secure string and adding the params as a hashtable is the only way to do it
$additionalParams = New-Object -TypeName Hashtable
$params = (Get-Content $ArmParametersPath -Raw | ConvertFrom-Json).parameters
foreach($p in $params | Get-Member -MemberType *Property)
{
$additionalParams.Add($p.Name, $params.$($p.Name).value)
}
$additionalParams.Set_Item('licenseXml',$licenseFileContent)
$additionalParams.Set_Item('deploymentId',$Name)
# Inject Certificate Blob and Password into the parameters
if ($certificateBlob) {
$additionalParams.Set_Item('authCertificateBlob',$certificateBlob)
}
if ($certificatePassword) {
$additionalParams.Set_Item('authCertificatePassword',$certificatePassword)
}
#endregion
#region Service Principle Details
# By default this script will prompt you for your Azure credentials but you can update the script to use an Azure Service Principal instead by following the details at the link below and updating the four variables below once you are done.
# https://azure.microsoft.com/en-us/documentation/articles/resource-group-authenticate-service-principal/
$UseServicePrincipal = $false
$TenantId = "SERVICE_PRINCIPAL_TENANT_ID"
$ApplicationId = "SERVICE_PRINCIPAL_APPLICATION_ID"
$ApplicationPassword = "SERVICE_PRINCIPAL_APPLICATION_PASSWORD"
#endregion
try
{
#region Validate Resouce Group Name
Write-Host "Validating Resource Group Name..."
if(!($Name -cmatch '^(?!.*--)[a-z0-9]{2}(|([a-z0-9\-]{0,37})[a-z0-9])$'))
{
Write-Error "Name should only contain lowercase letters, digits or dashes,
dash cannot be used in the first two or final character,
it cannot contain consecutive dashes and is limited between 2 and 40 characters in length!"
Break;
}
#endregion
Write-Host "Setting Azure PowerShell session context..."
if($UseServicePrincipal -eq $true)
{
#region Use Service Principle
$secpasswd = ConvertTo-SecureString $ApplicationPassword -AsPlainText -Force
$mycreds = New-Object System.Management.Automation.PSCredential ($ApplicationId, $secpasswd)
Connect-AzAccount -ServicePrincipal -Tenant $TenantId -Credential $mycreds
Set-AzContext -SubscriptionId $AzureSubscriptionId -TenantId $TenantId
#endregion
}
else
{
#region Use Manual Login
try
{
Write-Host "inside try"
Set-AzContext -SubscriptionId $AzureSubscriptionId
}
catch
{
Write-Host "inside catch"
Connect-AzAccount
Set-AzContext -SubscriptionId $AzureSubscriptionId
}
#endregion
}
Write-Host "Check if resource group already exists..."
$notPresent = Get-AzResourceGroup -Name $Name -ev notPresent -ea 0
if (!$notPresent)
{
New-AzResourceGroup -Name $Name -Location $location
}
Write-Host "Starting ARM deployment..."
New-AzResourceGroupDeployment `
-Name $Name `
-ResourceGroupName $Name `
-TemplateUri $ArmTemplateUrl `
-TemplateParameterObject $additionalParams `
# -DeploymentDebugLogLevel All -Debug -Verbose
Write-Host "Deployment Complete."
}
catch
{
Write-Error $_.Exception.Message
Break
}
```