ALZ

7.0.5

Private/Deploy-Accelerator-Helpers/New-Bootstrap.ps1

                                function New-Bootstrap {

    [CmdletBinding(SupportsShouldProcess = $true)]

    param (

        [Parameter(Mandatory = $false)]

        [string] $iac,

        [Parameter(Mandatory = $false)]

        [PSCustomObject] $bootstrapDetails,

        [Parameter(Mandatory = $false)]

        [PSCustomObject] $inputConfig,

        [Parameter(Mandatory = $false)]

        [string] $bootstrapTargetPath,

        [Parameter(Mandatory = $false)]

        [switch] $hasStarter,

        [Parameter(Mandatory = $false)]

        [string] $starterTargetPath,

        [Parameter(Mandatory = $false)]

        [PSCustomObject] $starterConfig = $null,

        [Parameter(Mandatory = $false)]

        [string] $bootstrapRelease,

        [Parameter(Mandatory = $false)]

        [string] $starterRelease,

        [Parameter(Mandatory = $false)]

        [switch] $autoApprove,

        [Parameter(Mandatory = $false)]

        [switch] $destroy,

        [Parameter(Mandatory = $false, HelpMessage = "An extra level of logging that is turned off by default for easier debugging.")]

        [switch]

        $writeVerboseLogs,

        [Parameter(Mandatory = $false)]

        [string]

        $hclParserToolPath,

        [Parameter(Mandatory = $false)]

        [switch]

        $convertTfvarsToJson,

        [Parameter(Mandatory = $false)]

        [string[]]

        $inputConfigFilePaths = @(),

        [Parameter(Mandatory = $false)]

        [string[]]

        $starterAdditionalFiles = @(),

        [Parameter(Mandatory = $false)]

        [switch]

        $cleanBootstrapFolder

    )

    if ($PSCmdlet.ShouldProcess("ALZ-Terraform module configuration", "modify")) {

        $bootstrapPath = Join-Path $bootstrapTargetPath $bootstrapRelease

        $starterPath = Join-Path $starterTargetPath $starterRelease

        $bootstrapModulePath = Join-Path -Path $bootstrapPath -ChildPath $bootstrapDetails.Value.location

        if($cleanBootstrapFolder.IsPresent) {

            Write-Verbose "Cleaning bootstrap folder of Terraform meta files as requested..."

            Remove-TerraformMetaFileSet -path $bootstrapModulePath -writeVerboseLogs:$writeVerboseLogs.IsPresent -terraformFilesOrFoldersToRemove @(

                "terraform.tfstate.backup",

                ".terraform",

                "terraform.tfvars",

                ".terraform.lock.hcl"

            )

        }

        Write-Verbose "Bootstrap Module Path: $bootstrapModulePath"

        # Get starter module

        $starterModulePath = ""

        $starterRootModuleFolder = ""

        $starterRootModuleFolderPath = ""

        $starterFoldersToRetain = @()

        if ($hasStarter) {

            if (!$inputConfig.starter_module_name.Value) {

                Write-ToConsoleLog "No starter module has been specified. Please supply the starter module you wish to deploy..." -IsError

                throw "No starter module has been specified. Please supply the starter module you wish to deploy..."

            }

            $starter_module_name = $inputConfig.starter_module_name.Value.Trim()

            $chosenStarterConfig = $starterConfig.starter_modules.Value.$($starter_module_name)

            if($null -eq $chosenStarterConfig ) {

                Write-ToConsoleLog "The starter module name '$($starter_module_name)' does not exist in the starter configuration. Please check your input and try again." -IsError

                throw "The starter module name '$($starter_module_name)' does not exist in the starter configuration. Please check your input and try again."

            }

            Write-Verbose "Selected Starter: $starter_module_name"

            $starterModulePath = (Resolve-Path (Join-Path -Path $starterPath -ChildPath $chosenStarterConfig.location)).Path

            $starterRootModuleFolderPath = $starterModulePath

            Write-Verbose "Starter Module Path: $starterModulePath"

            if ($chosenStarterConfig.PSObject.Properties.Name -contains "additional_retained_folders") {

                $starterFoldersToRetain = $chosenStarterConfig.additional_retained_folders

                Write-Verbose "Starter Additional folders to retain: $($starterFoldersToRetain -join ",")"

            }

            if ($chosenStarterConfig.PSObject.Properties.Name -contains "root_module_folder") {

                $starterRootModuleFolder = $chosenStarterConfig.root_module_folder

                # Retain the root module folder

                $starterFoldersToRetain += $starterRootModuleFolder

                # Add the root module folder to bootstrap input config

                $inputConfig | Add-Member -NotePropertyName "root_module_folder_relative_path" -NotePropertyValue @{

                    Value     = $starterRootModuleFolder

                    Source    = "calculated"

                    Sensitive = $false

                }

                # Set the starter root module folder full path

                $starterRootModuleFolderPath = Join-Path -Path $starterModulePath -ChildPath $starterRootModuleFolder

                Write-Verbose "Starter root module folder: $starterRootModuleFolder"

                Write-Verbose "Starter final folders to retain: $($starterFoldersToRetain -join ",")"

            }

        }

        # Getting configuration for the bootstrap module user input

        $bootstrapParameters = [PSCustomObject]@{}

        Write-Verbose "Getting the bootstrap configuration..."

        $terraformFiles = Get-ChildItem -Path $bootstrapModulePath -Filter "*.tf" -File

        foreach ($terraformFile in $terraformFiles) {

            $bootstrapParameters = Convert-HCLVariablesToInputConfig -targetVariableFile $terraformFile.FullName -hclParserToolPath $hclParserToolPath -appendToObject $bootstrapParameters

        }

        Write-Verbose "Bootstrap Parameters before setting config: $(ConvertTo-Json $bootstrapParameters -Depth 100)"

        # Getting the configuration for the starter module user input

        $starterParameters = [PSCustomObject]@{}

        if ($hasStarter) {

            Write-Verbose "Getting the starter configuration..."

            if ($iac -eq "terraform") {

                $terraformFiles = Get-ChildItem -Path $starterRootModuleFolderPath -Filter "*.tf" -File

                foreach ($terraformFile in $terraformFiles) {

                    $starterParameters = Convert-HCLVariablesToInputConfig -targetVariableFile $terraformFile.FullName -hclParserToolPath $hclParserToolPath -appendToObject $starterParameters

                }

            }

            if ($iac -like "bicep*") {

                $starterParameters = Convert-BicepConfigToInputConfig -bicepConfig $starterConfig.starter_modules.Value.$($inputConfig.starter_module_name.Value)

            }

        }

        # Set computed inputs

        $inputConfig | Add-Member -NotePropertyName "module_folder_path" -NotePropertyValue @{

            Value     = $starterModulePath

            Source    = "calculated"

            Sensitive = $false

        }

        if ($iac -eq "bicep-classic" -and $inputConfig.PSObject.Properties.Name -contains "starter_locations") {

            # Get the supported regions and availability zones

            Write-Verbose "Getting Supported Regions and Availability Zones with Terraform"

            $regionsAndZones = Get-AzureRegionData -toolsPath $toolsPath

            Write-Verbose "Supported Regions: $($regionsAndZones.supportedRegions)"

            $zonesSupport = $regionsAndZones.zonesSupport

            $availabilityZonesStarter = @()

            foreach ($region in $inputConfig.starter_locations.Value) {

                $availabilityZonesStarter += , @(Get-AvailabilityZonesSupport -region $region -zonesSupport $zonesSupport)

            }

            $inputConfig | Add-Member -NotePropertyName "availability_zones_starter" -NotePropertyValue @{

                Value     = $availabilityZonesStarter

                Source    = "calculated"

                Sensitive = $false

            }

        }

        Write-Verbose "Final Input config: $(ConvertTo-Json $inputConfig -Depth 100)"

        # Getting the input for the bootstrap module

        Write-Verbose "Setting the configuration for the bootstrap module..."

        $bootstrapConfiguration = Set-Config `

            -configurationParameters $bootstrapParameters `

            -inputConfig $inputConfig

        Write-Verbose "Final Bootstrap Parameters: $(ConvertTo-Json $bootstrapConfiguration -Depth 100)"

        # Getting the input for the starter module

        Write-Verbose "Setting the configuration for the starter module..."

        $starterConfiguration = Set-Config `

            -configurationParameters $starterParameters `

            -inputConfig $inputConfig `

            -copyEnvVarToConfig

        Write-Verbose "Final Starter Parameters: $(ConvertTo-Json $starterConfiguration -Depth 100)"

        # Creating the tfvars files for the bootstrap and starter module

        $tfVarsFileName = "terraform.tfvars.json"

        $bootstrapTfvarsPath = Join-Path -Path $bootstrapModulePath -ChildPath $tfVarsFileName

        $starterTfvarsPath = Join-Path -Path $starterRootModuleFolderPath -ChildPath "terraform.tfvars.json"

        $starterBicepVarsFileName = "parameters.json"

        $starterBicepAllVarsFileName = "template-parameters.json"

        $starterBicepVarsPath = Join-Path -Path $starterModulePath -ChildPath $starterBicepVarsFileName

        $starterBicepAllVarsPath = Join-Path -Path $starterModulePath -ChildPath $starterBicepAllVarsFileName

        # Write the tfvars file for the bootstrap and starter module

        Write-TfvarsJsonFile -tfvarsFilePath $bootstrapTfvarsPath -configuration $bootstrapConfiguration

        if ($iac -eq "terraform") {

            if ($starterFoldersToRetain.Length -gt 0) {

                Write-Verbose "Removing unwanted folders from the starter module..."

                $folders = Get-ChildItem -Path $starterModulePath -Directory

                foreach ($folder in $folders) {

                    if ($starterFoldersToRetain -notcontains $folder.Name) {

                        Write-Verbose "Removing folder: $($folder.FullName)"

                        Remove-Item -Path $folder.FullName -Recurse -Force

                    } else {

                        Write-Verbose "Retaining folder: $($folder.FullName)"

                        Remove-TerraformMetaFileSet -path $folder.FullName -writeVerboseLogs:$writeVerboseLogs.IsPresent

                    }

                }

            }

            Remove-TerraformMetaFileSet -path $starterModulePath -writeVerboseLogs:$writeVerboseLogs.IsPresent

            if ($convertTfvarsToJson) {

                Write-TfvarsJsonFile -tfvarsFilePath $starterTfvarsPath -configuration $starterConfiguration

            } else {

                $inputsFromTfvars = $inputConfig.PSObject.Properties | Where-Object { $_.Value.Source -eq ".tfvars" } | Select-Object -ExpandProperty Name

                Write-TfvarsJsonFile -tfvarsFilePath $starterTfvarsPath -configuration $starterConfiguration -skipItems $inputsFromTfvars

                foreach ($inputConfigFilePath in $inputConfigFilePaths | Where-Object { $_ -like "*.tfvars" }) {

                    $fileName = [System.IO.Path]::GetFileName($inputConfigFilePath)

                    $fileName = $fileName.Replace(".tfvars", ".auto.tfvars")

                    $destination = Join-Path -Path $starterRootModuleFolderPath -ChildPath $fileName

                    Write-Verbose "Copying tfvars file $inputConfigFilePath to $destination"

                    Copy-Item -Path $inputConfigFilePath -Destination $destination -Force

                }

            }

            # Copy additional files

            foreach ($additionalFile in $starterAdditionalFiles) {

                if (Test-Path $additionalFile -PathType Container) {

                    $folderName = ([System.IO.DirectoryInfo]::new($additionalFile)).Name

                    $destination = Join-Path -Path $starterRootModuleFolderPath -ChildPath $folderName

                    Write-Verbose "Copying folder $additionalFile to $destination"

                    Copy-Item -Path "$additionalFile/*" -Destination $destination -Recurse -Force

                } else {

                    $fileName = [System.IO.Path]::GetFileName($additionalFile)

                    $destination = Join-Path -Path $starterRootModuleFolderPath -ChildPath $fileName

                    Write-Verbose "Copying file $additionalFile to $destination"

                    Copy-Item -Path $additionalFile -Destination $destination -Force

                }

            }

        }

        if ($iac -like "bicep*") {

            if($iac -ne "bicep") {

                Copy-ParametersFileCollection -starterPath $starterModulePath -configFiles $starterConfig.starter_modules.Value.$($inputConfig.starter_module_name.Value).deployment_files

            }

            Set-ComputedConfiguration -configuration $starterConfiguration

            Edit-ALZConfigurationFilesInPlace -alzEnvironmentDestination $starterModulePath -configuration $starterConfiguration

            Write-JsonFile -jsonFilePath $starterBicepVarsPath -configuration $starterConfiguration

            Write-JsonFile -jsonFilePath $starterBicepAllVarsPath -configuration @($inputConfig, $starterConfiguration, $bootstrapConfiguration) -all

            # Remove unrequired files

            $foldersOrFilesToRetain = $starterConfig.starter_modules.Value.$($inputConfig.starter_module_name.Value).folders_or_files_to_retain

            $foldersOrFilesToRetain += $starterBicepVarsFileName

            $foldersOrFilesToRetain += $starterBicepAllVarsFileName

            $foldersOrFilesToRetain += "config"

            $foldersOrFilesToRetain += ".config"

            foreach ($deployment_file in $starterConfig.starter_modules.Value.$($inputConfig.starter_module_name.Value).deployment_files) {

                $foldersOrFilesToRetain += $deployment_file.templateParametersSourceFilePath

            }

            $subFoldersOrFilesToRemove = $starterConfig.starter_modules.Value.$($inputConfig.starter_module_name.Value).subfolders_or_files_to_remove

            Remove-UnrequiredFileSet -path $starterModulePath -foldersOrFilesToRetain $foldersOrFilesToRetain -subFoldersOrFilesToRemove $subFoldersOrFilesToRemove -writeVerboseLogs:$writeVerboseLogs.IsPresent

        }

        # Running terraform init and apply

        Write-ToConsoleLog "Thank you for providing those inputs, we are now initializing and applying Terraform to bootstrap your environment..." -IsSuccess

        # Get bootstrap_subscription_id from inputConfig if available

        $bootstrapSubscriptionId = ""

        if ($null -ne $inputConfig.bootstrap_subscription_id -and $null -ne $inputConfig.bootstrap_subscription_id.Value) {

            $bootstrapSubscriptionId = $inputConfig.bootstrap_subscription_id.Value

        }

        if ($autoApprove) {

            Invoke-Terraform -moduleFolderPath $bootstrapModulePath -autoApprove -destroy:$destroy.IsPresent -bootstrapSubscriptionId $bootstrapSubscriptionId

        } else {

            Write-ToConsoleLog "Once the plan is complete you will be prompted to confirm the apply." -IsSuccess

            Invoke-Terraform -moduleFolderPath $bootstrapModulePath -destroy:$destroy.IsPresent -bootstrapSubscriptionId $bootstrapSubscriptionId

        }

        Write-ToConsoleLog "Bootstrap has completed successfully! Thanks for using our tool. Head over to Phase 3 in the documentation to continue..." -IsSuccess

    }

}

# SIG # Begin signature block

# MIIoVwYJKoZIhvcNAQcCoIIoSDCCKEQCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCa1b/jaINLT6jz

# 0SCyzuIqQpKmUfTAXt1GUJcXm3s986CCDYUwggYDMIID66ADAgECAhMzAAAEhJji

# EuB4ozFdAAAAAASEMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjUwNjE5MTgyMTM1WhcNMjYwNjE3MTgyMTM1WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDtekqMKDnzfsyc1T1QpHfFtr+rkir8ldzLPKmMXbRDouVXAsvBfd6E82tPj4Yz

# aSluGDQoX3NpMKooKeVFjjNRq37yyT/h1QTLMB8dpmsZ/70UM+U/sYxvt1PWWxLj

# MNIXqzB8PjG6i7H2YFgk4YOhfGSekvnzW13dLAtfjD0wiwREPvCNlilRz7XoFde5

# KO01eFiWeteh48qUOqUaAkIznC4XB3sFd1LWUmupXHK05QfJSmnei9qZJBYTt8Zh

# ArGDh7nQn+Y1jOA3oBiCUJ4n1CMaWdDhrgdMuu026oWAbfC3prqkUn8LWp28H+2S

# LetNG5KQZZwvy3Zcn7+PQGl5AgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUBN/0b6Fh6nMdE4FAxYG9kWCpbYUw

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwNTM2MjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AGLQps1XU4RTcoDIDLP6QG3NnRE3p/WSMp61Cs8Z+JUv3xJWGtBzYmCINmHVFv6i

# 8pYF/e79FNK6P1oKjduxqHSicBdg8Mj0k8kDFA/0eU26bPBRQUIaiWrhsDOrXWdL

# m7Zmu516oQoUWcINs4jBfjDEVV4bmgQYfe+4/MUJwQJ9h6mfE+kcCP4HlP4ChIQB

# UHoSymakcTBvZw+Qst7sbdt5KnQKkSEN01CzPG1awClCI6zLKf/vKIwnqHw/+Wvc

# Ar7gwKlWNmLwTNi807r9rWsXQep1Q8YMkIuGmZ0a1qCd3GuOkSRznz2/0ojeZVYh

# ZyohCQi1Bs+xfRkv/fy0HfV3mNyO22dFUvHzBZgqE5FbGjmUnrSr1x8lCrK+s4A+

# bOGp2IejOphWoZEPGOco/HEznZ5Lk6w6W+E2Jy3PHoFE0Y8TtkSE4/80Y2lBJhLj

# 27d8ueJ8IdQhSpL/WzTjjnuYH7Dx5o9pWdIGSaFNYuSqOYxrVW7N4AEQVRDZeqDc

# fqPG3O6r5SNsxXbd71DCIQURtUKss53ON+vrlV0rjiKBIdwvMNLQ9zK0jy77owDy

# XXoYkQxakN2uFIBO1UNAvCYXjs4rw3SRmBX9qiZ5ENxcn/pLMkiyb68QdwHUXz+1

# fI6ea3/jjpNPz6Dlc/RMcXIWeMMkhup/XEbwu73U+uz/MIIHejCCBWKgAwIBAgIK

# YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm

# aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw

# OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD

# VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG

# 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la

# UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc

# 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D

# dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+

# lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk

# kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6

# A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd

# X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL

# 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd

# sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3

# T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS

# 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI

# bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL

# BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD

# uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv

# c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF

# BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h

# cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA

# YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn

# 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7

# v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b

# pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/

# KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy

# CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp

# mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi

# hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb

# BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS

# oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL

# gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX

# cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCGigwghokAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAASEmOIS4HijMV0AAAAA

# BIQwDQYJYIZIAWUDBAIBBQCggbAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIPRk

# Td3CbADBeCfHr/ro2EEmMi5m9Nde3g4vJSlIirGZMEQGCisGAQQBgjcCAQwxNjA0

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEcgBpodHRwczovL3d3dy5taWNyb3NvZnQu

# Y29tIDANBgkqhkiG9w0BAQEFAASCAQDbzWkf5MonkFafBFbA+mCX0O/Aku+uBnSd

# dOiaj2ThLK3IV3sQ2u/ssHBfoa7e7Qc03LS6w4HwnRPhW/TS75Efh9mXKTsdThGR

# V7Tm8bBs/cwgGyLfX+qDU5d+iag6eHm82mWCCNaYW+uEwD6TT73v6a6PNgE+UMu1

# gvxUkBCZ7EqMHcUrX6z4dLcOjTjTueBk21YfFV062/FKgQG20NSvStTiqEVduRPf

# Kvg+QskKbnrd2c+fGdtIEAXNaBVRAqiOYpJZkrvy8nnmLZzvQnZHJdOizt3Kg3oB

# G2cHNXva5XKqBKildNDArpXh9bpFhNceBySfy/P7Y/srCi9R30vXoYIXsDCCF6wG

# CisGAQQBgjcDAwExghecMIIXmAYJKoZIhvcNAQcCoIIXiTCCF4UCAQMxDzANBglg

# hkgBZQMEAgEFADCCAVoGCyqGSIb3DQEJEAEEoIIBSQSCAUUwggFBAgEBBgorBgEE

# AYRZCgMBMDEwDQYJYIZIAWUDBAIBBQAEII5aUyANgCmr2m7gQD6AVzHlAf2p8TlX

# R0shFPovmR0YAgZpvC7inTkYEzIwMjYwMzI2MTA1ODExLjg5OVowBIACAfSggdmk

# gdYwgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH

# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNV

# BAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UE

# CxMeblNoaWVsZCBUU1MgRVNOOjQzMUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNy

# b3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloIIR/jCCBygwggUQoAMCAQICEzMAAAId

# S8CShziFfjkAAQAAAh0wDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3Rh

# bXAgUENBIDIwMTAwHhcNMjUwODE0MTg0ODMzWhcNMjYxMTEzMTg0ODMzWjCB0zEL

# MAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v

# bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWlj

# cm9zb2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hp

# ZWxkIFRTUyBFU046NDMxQS0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC

# AQCitKBoADyg6XimHnvjPDb16BQ3wMN6lEctfwUzXMc0mZcboqtKpQrDNwpp+im5

# h09MRNMK9v1ol8RK4BTSIY1QUj8PpHSS91+l7ag9f4TextNC8aLgk8fmp0hhRonj

# lX/hup7x429tbOkL5kqMfX3cN6IjVcAj3XwmhCYGGURej9OifXvbWW5kmCKdyx/k

# uMxjeNfzhbJdRJfd2xLuH/vFUj7DXKODulr7TLej+Z7ZOy/pQlR1JNBqnk5EZJ8K

# dyWc/XPciKJYhavdWjtog9ayAnOrebkbGnFQcJCTyrNSGTnTL+4H4sYTdYgrYLvu

# LL2IWxJ9ItSfIwTMZENb2ZcdPg8fs7PPoIepASI2/BweqW+UKHWkdCHU1dBICo6h

# UGzmaLp5qx/rLFZN97kOtHv3nTevylTpWoLZj1cxFTjAf1BthdiwhRnfcmad3LbZ

# bUsEMBvEE9AcIGWdwYNTcGB2FVRUt7zSaCAU73wV2RaGjrvDiQ90JNGS92+Rjw+t

# BgT+dCMdcJrSDstwy21lvp6Mwd9D61RZe/r6dnhieSvY6RrFyUULDhEhg0xYPboB

# ZtCP9YR3OBrXx8q3DrovmDNc/NrqMUF88l4oTcfxAC7CmKuYfiaz7mdSM01A6Y2C

# omfRTX7difsKWzAPv1g3Svd91tgEwMCkFkmk2UrursddGwIDAQABo4IBSTCCAUUw

# HQYDVR0OBBYEFIRZ8HE0RqZm1ebyCX3ZirzSN/FdMB8GA1UdIwQYMBaAFJ+nFV0A

# XmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWlj

# cm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQ

# Q0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0

# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIw

# VGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYD

# VR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEB

# CwUAA4ICAQCR3B4HjLG8uyksqrQP6aLIPhDQRzFUWk1m4nGJHniBZGR5MMO7KY14

# HTcmGWwGlvBJgnm5lKAMEK/AcQPZUvyUmkWU6msnPGxdYLY1N8D47487kWTmPDos

# eHqN4EAMMR1ADHceqLtmbQnC9D3fPl/p23GSbb1ao5wdhdFd8BDDLWFKstfJ95uW

# pHrqOk//2fR8KRZTiCCxSNClDY2CPUNXT0nhjfLun013zX5ezqpij77tEqbyqIH/

# k0N6KA4uOUB4WCIRchFQlb6YnKqlDD445GVqpwWNHwe7Qb7/tsx16Trxhf6Q+kMG

# TtR74j/GCJgnXFwNEGf+9zMu03vb5EiUPhSBdgu4FIKT/+kMQ9fnPf0Kv6uRzoTh

# jbwU+TgGGWgDK+nrbw/jF8SVBjxNzGtpRtlKHKmhwTqfL3kPUrUGSW1masdUoLGa

# CWe46UzXk0oitcWVcLN2qkK0jBDjXvA0BUX9AM+/PNu6Y91OLp9vS0ttJxihtXrO

# 9sGwywoQwThOPVv2ghcLx3JsmridtugRdilHCLVABulI2uf4/EZb25/WrrcWcwm7

# iCbc6HreeNb+JV/vbeq7PIetKKNYyBjQeJGIdCLQnK7SHwx2FFSnubFuYtByQ+I4

# XACUhpQ3+TvbnL9otamRFTp+qYuUQ7IflanIt3bcBjL2vy/5ChtrqzCCB3EwggVZ

# oAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jv

# c29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4

# MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw

# MTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvX

# JHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa

# /rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AK

# OG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rbo

# YiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIck

# w+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbni

# jYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F

# 37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZ

# fD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIz

# GHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR

# /bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1

# Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUC

# AwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0O

# BBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yD

# fQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lv

# cHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkr

# BgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUw

# AwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBN

# MEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0

# cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoG

# CCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01p

# Y1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9

# /Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5

# bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvf

# am++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn

# 0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlS

# dYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0

# j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5

# JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakUR

# R6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4

# O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVn

# K+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoI

# Yn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNZMIICQQIBATCCAQGhgdmk

# gdYwgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH

# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNV

# BAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UE

# CxMeblNoaWVsZCBUU1MgRVNOOjQzMUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNy

# b3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQC6g74Ept9f

# OrJ+L0YsR1YeQIt5P6CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX

# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg

# Q29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAy

# MDEwMA0GCSqGSIb3DQEBCwUAAgUA7W8+djAiGA8yMDI2MDMyNjA1MTExOFoYDzIw

# MjYwMzI3MDUxMTE4WjB3MD0GCisGAQQBhFkKBAExLzAtMAoCBQDtbz52AgEAMAoC

# AQACAhaKAgH/MAcCAQACAhI4MAoCBQDtcI/2AgEAMDYGCisGAQQBhFkKBAIxKDAm

# MAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcN

# AQELBQADggEBAGh38beBe+cyv5z44bbPDfpoUTuEzdd+Xv7RAeAVnRhrVE2JAysj

# tEycLiirYmxVBbAjWRlktWj3naTY9rFTEj7clAQmO4LaJb/smh1Gnfjtywkbkegc

# 4KWsizE+x4ID5HHbj5My+dKsbHIpwfF32Gj3lxpWm/meAdWzhFcydiqXSeOvgVci

# I30Rt/Ge37dxXldBMHKahaDuZKlmzr8b96PEymlc+vG9TRaX2eXlzBel3gbA0PbF

# rhCFwwhqKMe/iSQyvb6Ya896FqYUE/hImr/ujiqfttkYQsXYKlXerXgqjktHEc2U

# cRRCsa7G3PwBlzkiw0HTFCZ/W6Ujn67ADigxggQNMIIECQIBATCBkzB8MQswCQYD

# VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe

# MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3Nv

# ZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAh1LwJKHOIV+OQABAAACHTANBglg

# hkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqG

# SIb3DQEJBDEiBCAO/1HDdUGlBpUHfdHM0yDCJukFWp5bWcmxyWG2E2qRcjCB+gYL

# KoZIhvcNAQkQAi8xgeowgecwgeQwgb0EILG2lcxcSIsnOuozvt6nitM3Csw6PqCl

# Y32Fm+mPlAVRMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAC

# EzMAAAIdS8CShziFfjkAAQAAAh0wIgQgcgzkbiCmLB0mZLeaLvF9592tXoAOfrig

# I7f8FqQsOSQwDQYJKoZIhvcNAQELBQAEggIAIdW4dOQBM1mOg4zS3AT/2WHlJ9hT

# roMO8yxszR3Qq4/8rGp/GYhZtIMMVs8YV06Ukat12nKjIjEt3Ae47Ee9pZ5O5rJG

# uW0Y+aYQiH45CG2o1zY4qWOSwe3/QMBWLjHJjbB2yFuFO/nqk976hhPQo/YglDz0

# 2XSehdEy8eC7lVsqpxRZSbSOoTMhvEyRWQmSQeJFgHe9On6I5YkKSe1XjqdL8JVz

# hpkJeaxdAwu8BtjKx5iobe/vkHtOXS/q8wyxlfFgrzFtDKv8VvrEkA1QLCfWt+o8

# LJMz+quMpBNeFIi+Iyvk0NxlHgxvY0vrRH8ahgNCwRfzVNGefsgokTUzUtgBwOQf

# WcQDqF4PjURcd+b2f8TJTHB68ZMQ9kASZ4cs5jFMRQNnOesr7hCcFG+U/33l/PMh

# YGM++wHANuVXUf3CKcuwg2DN/kKY+ewaixgasuV1InQfIjLnmfFcinLE4RuwOoWN

# WrPmP6PXjo9WvaPjIXwlgHK4wLmlKqoBgzui14ljPnE2ctgf92B/wD4G2Z04kWER

# XmI0sFqmZbZXG3hPyO8jeSGeYqli7nCQZyxrqp7s/qfFPr3zJx7zhCkUyPLIAiwH

# PJTplHOCbOOwlYKEy6fnQW5z2B/JnN8XHrDLNItkZsKYd242tP/aqX81dz7/0vwa

# ZRCFUY41ZXBEsfM=

# SIG # End signature block