Public/PaaS/web-static/New-CmAzPaasWebStatic.ps1
|
function New-CmAzPaaSWebStatic { <# .Synopsis Deploys a static website utilising a CDN and Blob Storage. .Description Completes the following: * Deploys a ResourceGroup, CDNProfile, Storage account and Endpoint with their details set via the Settings object or file. * Sets the endpoint to allow static websites. * Sets CDN rules. .Parameter SettingsFile File path for the settings file to be converted into a settings object. .Parameter SettingsObject An object including all the properties required to configure the target website, with a structure following the same convention as the YAML file. This allows properties to be dynamically generated rather than simply loaded from a file. .Component PaaS .Example New-CmAzPaaSWebStatic -SettingsFile "/mysite/paas.web.static.mysite.yml" Creates a new static website using settings from the specified YML file. .Example New-CmAzPaaSWebStatic -SettingsObject $settings Creates a new static website using settings from the specified configuration data, which must match the format of the documented YML file. .Example /mysite/paas.web.static.mysite.yml # The input file below sets up the static web properties name: mywebsite location: UK South redirectUrl: https://www.mywebsite.com customDomains: - www.mywebsite.com #> [CmdletBinding(SupportsShouldProcess, ConfirmImpact = "Medium")] [OutputType([Hashtable])] param( [parameter(Mandatory=$true, ParameterSetName = "Settings File")] [String]$SettingsFile, [parameter(Mandatory=$true, ParameterSetName = "Settings Object")] [Object]$SettingsObject ) $ErrorActionPreference = "Stop" if($PSCmdlet.ShouldProcess((Get-CmAzSubscriptionName), "Deploy infrastructure for a static website")) { if ($SettingsFile -and !$SettingsObject) { $SettingsObject = Get-CmAzSettingsFile -Path $SettingsFile } elseif (!$SettingsFile -and !$SettingsObject) { Write-Error "No valid input settings." -Category InvalidArgument -CategoryTargetName "SettingsObject" } if (!$SettingsObject.Name) { Write-Error "Please provide a valid name." -Category InvalidArgument -CategoryTargetName "Name" } if (!$SettingsObject.Location) { Write-Error "Please provide a valid location" -Category InvalidArgument -CategoryTargetName "Location" } if (!$SettingsObject.RedirectUrl) { Write-Error "Please provide a valid redirectUrl" -Category InvalidArgument -CategoryTargetName "RedirectUrl" } if (!$SettingsObject.CustomDomain) { Write-Error "Please provide a valid custom domain" -Category InvalidArgument -CategoryTargetName "CustomDomain" } Write-Verbose "Generating resource names..." $resourceGroupName = Get-CmAzResourceName -Resource "ResourceGroup" -Architecture "PaaS" -Region $SettingsObject.Location -Name $SettingsObject.Name $profileName = Get-CmAzResourceName -Resource "CdnProfile" -Architecture "PaaS" -Region $SettingsObject.Location -Name $SettingsObject.Name $endpointName = Get-CmAzResourceName -Resource "Endpoint" -Architecture "PaaS" -Region $SettingsObject.Location -Name $SettingsObject.Name $storageName = Get-CmAzResourceName -Resource "StorageAccount" -Architecture "PaaS" -Region $SettingsObject.Location -Name $SettingsObject.Name -MaxLength 24 Write-Verbose "Deploying resource group: $resourceGroupName..." New-AzResourceGroup -Name $resourceGroupName -Location $SettingsObject.Location -Force > $null $providerNamespace = "Microsoft.CDN" if ((Get-AzResourceProvider -Location $SettingsObject.Location -ProviderNamespace $providerNamespace | Where-Object { $_.RegistrationState -ne "Registered" }).Count -gt 0) { Register-AzResourceProvider -ProviderNamespace $providerNamespace } Write-Verbose "Deploying storage account: $storageName..." New-AzResourceGroupDeployment ` -ResourceGroupName $resourceGroupName ` -TemplateFile "$PSScriptRoot/New-CmAzPaasWebStatic.Storage.json" ` -storageAccountName $storageName ` -location $SettingsObject.Location > $null Write-Verbose "Deploying cdn: $profileName..." New-AzResourceGroupDeployment ` -ResourceGroupName $resourceGroupName ` -TemplateFile "$PSScriptRoot/New-CmAzPaasWebStatic.Cdn.json" ` -storageName $storageName ` -endpointName $endpointName ` -profileName $profileName > $null Write-Verbose "Writng cdn rules..." $ruleOrder = 0 $cdnRules = @() $rpAction = New-AzCdnDeliveryRuleAction -HeaderActionType ModifyResponseHeader -Action Append -HeaderName "referrer-policy" -Value "strict-origin-when-cross-origin" $cspAction = New-AzCdnDeliveryRuleAction -HeaderActionType ModifyResponseHeader -Action Append -HeaderName "content-security-policy" -Value "default-src https: 'self' *" $fpAction = New-AzCdnDeliveryRuleAction -HeaderActionType ModifyResponseHeader -Action Append -HeaderName "feature-policy" -Value "camera 'none'; geolocation 'none'; microphone 'none'; payment 'none' usb 'none'" $globalRule = New-AzCdnDeliveryRule -Name "Global" -Order $ruleOrder -Action $rpAction, $cspAction, $fpAction if ($SettingsObject.RedirectPublicIpAddress) { $ruleOrder++ # Only apply conditions and rules for provided ipAddress $ipRedirectCondition = New-AzCdnDeliveryRuleCondition -MatchVariable RemoteAddress -Operator IPMatch -MatchValue $SettingsObject.RedirectPublicIpAddress -NegateCondition $ipRedirectAction = New-AzCdnDeliveryRuleAction -RedirectType Found -CustomHostname $SettingsObject.RedirectUrl -CustomPath "/" $ipRedirectRule = New-AzCdnDeliveryRule -Name "IPRedirect" -Order $ruleOrder -Condition $ipRedirectCondition -Action $ipRedirectAction $cdnRules += $ipRedirectRule } $ruleOrder++ $httpRedirectCondition = New-AzCdnDeliveryRuleCondition -MatchVariable RequestScheme -Operator Equal -MatchValue "HTTP" $httpRedirectAction = New-AzCdnDeliveryRuleAction -RedirectType Found -CustomHostname $SettingsObject.CustomDomain -DestinationProtocol "Https" $httpRedirectRule = New-AzCdnDeliveryRule -Name "HttpRedirectRule" -Order $ruleOrder -Condition $httpRedirectCondition -Action $httpRedirectAction $ruleOrder++ $canonicalPathCondition = New-AzCdnDeliveryRuleCondition -MatchVariable UrlFileName -Operator Equal -MatchValue "index" $canonicalPathRedirectAction = New-AzCdnDeliveryRuleAction -RedirectType Found -CustomHostname $SettingsObject.CustomDomain -CustomPath "/" $canonicalPathRule = New-AzCdnDeliveryRule -Name "CanonicalUrl" -Order $ruleOrder -Condition $canonicalPathCondition -Action $canonicalPathRedirectAction $ruleOrder++ $anyPathCondition = New-AzCdnDeliveryRuleCondition -MatchVariable RequestScheme -Operator Equal -MatchValue "HTTPS" $xctoAction = New-AzCdnDeliveryRuleAction -HeaderActionType ModifyResponseHeader -Action Append -HeaderName "x-content-type-options" -Value "nosniff" $xfoAction = New-AzCdnDeliveryRuleAction -HeaderActionType ModifyResponseHeader -Action Append -HeaderName "x-frame-options" -Value "SAMEORIGIN" $stsAction = New-AzCdnDeliveryRuleAction -HeaderActionType ModifyResponseHeader -Action Append -HeaderName "strict-transport-security" -Value "max-age=31536000; includeSubDomains" $addHeadersRule = New-AzCdnDeliveryRule -Name "AdditonalSecurityHeaders" -Order $ruleOrder -Condition $anyPathCondition -Action $xctoAction, $xfoAction, $stsAction $cdnRules += @($globalRule, $addHeadersRule, $httpRedirectRule, $canonicalPathRule) $policy = New-AzCdnDeliveryPolicy -Description "DeliveryPolicy" -Rule $cdnRules Write-Verbose "Fetching storage context..." $storageContext = New-AzStorageContext -StorageAccountName $storageName Write-Verbose "Enabling static site setting..." Enable-AzStorageStaticWebsite -IndexDocument "index.html" -ErrorDocument404Path "404.html" -Context $storageContext > $null Write-Verbose "Fetching endpoint ($endpointName)..." $endpoint = Get-AzCdnEndpoint -EndpointName $endpointName -ProfileName $profileName -ResourceGroupName $resourceGroupName $endpoint.DeliveryPolicy = $policy Write-Verbose "Setting endpoint ($endpointName)..." Set-AzCdnEndpoint -CdnEndpoint $endpoint > $null Write-Verbose "Setting custom domain..." if((Test-AzCdnCustomDomain -CdnEndpoint $endpoint -CustomDomainHostName $SettingsObject.CustomDomain).CustomDomainValidated) { New-AzCdnCustomDomain -CustomDomainName $SettingsObject.CustomDomain -HostName $SettingsObject.CustomDomain -CdnEndpoint $endpoint -ErrorAction SilentlyContinue } Write-Verbose "Purging cdn..." Unpublish-AzCdnEndpointContent -EndpointName $endpointName -ProfileName $profileName -ResourceGroupName $resourceGroupName -PurgeContent "/*" Write-Verbose "Finished!" @{ ResourceGroupName = $resourceGroupName ProfileName = $profileName EndpointName = $endpointName StorageName = $storageName } } } |