Avm.Authoring

0.28.1

Private/Tests/Invoke-AvmBicepNativeTestCase.ps1

                                function Invoke-AvmBicepNativeTestCase {

    [CmdletBinding(SupportsShouldProcess)]

    [OutputType([pscustomobject])]

    param(

        [Parameter(Mandatory)] [pscustomobject] $Item,

        [Parameter(Mandatory)] [guid] $TenantId,

        [Parameter(Mandatory)] [string] $Location,

        [Parameter(Mandatory)] [string] $RepositoryRoot,

        [Parameter(Mandatory)] [string] $AzPath,

        [Parameter(Mandatory)] [hashtable] $CiInput,

        [string] $ManagementGroupId,

        [string] $ResourceGroupPrefix,

        [string] $ResourceLocation,

        [string] $StatePath,

        [ValidateSet('All', 'Deploy')] [string] $Phase = 'All',

        [ValidateRange(1, 3)] [int] $DeploymentRetryLimit = 3,

        [ValidateRange(1, 3)] [int] $ValidationRetryLimit = 3,

        [switch] $KeepResources

    )

    Set-StrictMode -Version 3.0

    $ErrorActionPreference = 'Stop'

    if (-not $PSCmdlet.ShouldProcess($Item.Case.RelativeDirectory, 'Run native Bicep deployment test')) {

        return [pscustomobject]@{

            Status = 'skipped'; AssertionResults = @(); PostResults = @(); Issues = @()

            CleanupPending = @(); CleanupDeferred = $false; StatePath = ''

        }

    }

    $executionOptions = @{

        Location = $Location; RepositoryRoot = $RepositoryRoot; AzPath = $AzPath; CiInput = $CiInput

        SubscriptionId = $Item.SubscriptionId; TenantId = $TenantId

        ManagementGroupId = $ManagementGroupId; ResourceGroupPrefix = $ResourceGroupPrefix

        ResourceLocation = $ResourceLocation; StatePath = $StatePath; Phase = $Phase

        DeploymentRetryLimit = $DeploymentRetryLimit; ValidationRetryLimit = $ValidationRetryLimit

        KeepResources       = [bool]$KeepResources

        RecoveryDeadlineUtc = (Get-Date -AsUTC).AddSeconds($Item.RetryPolicy['observation']['coordinatorTimeoutSeconds'])

    }

    Invoke-AvmBicepAzureContext -SubscriptionId $Item.SubscriptionId -TenantId $TenantId -ScriptBlock {

        Assert-AvmBicepAzureIdentity -AzPath $executionOptions.AzPath -SubscriptionId $Item.SubscriptionId -TenantId $TenantId

        $assertRegistrationIdentity = {

            Assert-AvmBicepAzureIdentity -AzPath $executionOptions.AzPath `

                -SubscriptionId $executionOptions.SubscriptionId -TenantId $executionOptions.TenantId

        }

        foreach ($kind in @('Feature', 'Provider')) {

            $requirements = @(Get-AvmPropertyValue -InputObject $Item -Name "Required$($kind)s")

            if ($requirements.Count -eq 0) { continue }

            try {

                $null = Invoke-AvmSubscriptionRegistration -Cli (Resolve-AvmAzureCli) -Root $executionOptions.RepositoryRoot `

                    -SubscriptionId ([guid]$Item.SubscriptionId).ToString('D') -Kind $kind -Requirement $requirements `

                    -AssertIdentity $assertRegistrationIdentity -Confirm:$false

            }

            catch [AvmException] {

                $registrationIssues = [System.Collections.Generic.List[object]]::new()

                Add-AvmBicepTestIssue -Issues $registrationIssues -File $Item.Case.RelativePath `

                    -Code "$($kind.ToLowerInvariant())-registration-failed" -Message $_.Exception.Message

                return [pscustomobject]@{

                    Status = 'fail'; AssertionResults = @(); PostResults = @(); Issues = $registrationIssues.ToArray()

                    CleanupPending = @(); CleanupDeferred = $false; StatePath = ''

                }

            }

        }

        foreach ($preparedInput in $Item.AttemptInputs) {

            $preparedInput.TemplateContent = Resolve-AvmBicepTestToken -Content $preparedInput.TemplateContent `

                -SourcePath $Item.Case.Path -Tokens $preparedInput.Tokens -DeferResourceLocation

        }

        $Item.Template = ConvertFrom-AvmStrictJson -Json $Item.AttemptInputs[0].TemplateContent

        $environment = Get-AvmPropertyValue -InputObject (Get-AzContext -ErrorAction Stop) -Name 'Environment'

        $environmentName = [string](Get-AvmPropertyValue -InputObject $environment -Name 'Name')

        $handle = New-AvmBicepCleanupState -SubscriptionId $Item.SubscriptionId -TenantId $TenantId `

            -Environment $environmentName -RunId $Item.RunId -Path $executionOptions.StatePath -Confirm:$false

        $state = $handle.State

        $state['attempts'] = @()

        $groupName = if ($Item.Scope -eq 'group') { '{0}-{1}' -f $executionOptions.ResourceGroupPrefix, $Item.RunId } else { '' }

        $state['case'] = [ordered]@{

            path = $Item.Case.RelativePath; scope = $Item.Scope; resourceGroupName = $groupName

            managementGroupId = if ($Item.Scope -eq 'mg') { $executionOptions.ManagementGroupId } else { '' }

            metadataLocation = $executionOptions.Location; sourceHash = $Item.SourceHash; completionStarted = $false

        }

        Save-AvmBicepCleanupState -State $state -Path $handle.Path -Confirm:$false

        Write-AvmLog -Level Info -Message "Bicep cleanup state for '$($Item.Case.RelativeDirectory)': $($handle.Path)"

        $issues = [System.Collections.Generic.List[object]]::new()

        $completion = $null

        $interrupted = $false

        $deployed = $null

        try {

            $definitions = $Item.Template['definitions']

            if ($null -eq $definitions) { $definitions = @{} }

            $declared = $Item.Template['parameters']

            if ($null -eq $declared) { $declared = @{} }

            $ciParameters = [ordered]@{}

            foreach ($name in $declared.psbase.Keys) {

                if (-not $Item.Parameters.ContainsKey($name) -and -not $Item.ReferenceParameters.ContainsKey($name)) {

                    $ciParameters[$name] = $declared[$name]

                }

            }

            $baseParameters = Get-AvmBicepCiParameter -TemplateParameters $ciParameters -TemplateDefinitions $definitions `

                -Variables $executionOptions.CiInput.Variables -Secrets $executionOptions.CiInput.Secrets `

                -KeyVaultName $executionOptions.CiInput.KeyVaultName

            $baseTime = [datetime]::UtcNow.ToString('u', [cultureinfo]::InvariantCulture)

            $unavailableRegions = @()

            $mode = 'Initial'

            $namingIndex = -1

            $retryBlocked = $false

            $freshChangesRegion = $Item.RetryPolicy['modes']['Fresh']['location'] -ceq 'NextEligible'

            $attemptLimit = [Math]::Min($executionOptions.DeploymentRetryLimit, $Item.RetryPolicy['limits']['deploymentAttempts'])

            for ($attempt = 1; $attempt -le $attemptLimit; $attempt++) {

                if ($mode -ne 'InPlace') {

                    $namingIndex++

                    $attemptInput = $Item.AttemptInputs[$namingIndex]

                    $parameters = $baseParameters.Clone()

                    foreach ($key in $attemptInput.Parameters.psbase.Keys) { $parameters[$key] = $attemptInput.Parameters[$key] }

                    if ($declared.Contains('resourceLocation') -and -not $parameters.ContainsKey('resourceLocation')) {

                        $parameters['resourceLocation'] = ''

                    }

                    if ($declared.Contains('baseTime') -and -not $parameters.ContainsKey('baseTime')) { $parameters['baseTime'] = $baseTime }

                    $references = [System.Collections.Generic.HashSet[string]]::new([System.StringComparer]::OrdinalIgnoreCase)

                    $parameters = Resolve-AvmBicepParameterToken -Value $parameters -Tokens $attemptInput.Tokens `

                        -DeferResourceLocation -ReferencedTokens $references

                    $parameters = Get-AvmBicepNativeParameter -Parameters $parameters

                    foreach ($key in $attemptInput.ReferenceParameters.psbase.Keys) {

                        $parameters[$key] = Resolve-AvmBicepParameterToken -Value $attemptInput.ReferenceParameters[$key] `

                            -Tokens $attemptInput.Tokens -DeferResourceLocation -ReferencedTokens $references

                    }

                    if ($null -ne $parameters['resourceLocation'] -and $parameters['resourceLocation'] -isnot [string]) {

                        throw [AvmConfigurationException]::new('Regional placement requires a non-secure string resourceLocation value.')

                    }

                    $selectedLocation = $executionOptions.ResourceLocation

                    if ($mode -eq 'Fresh' -and -not $freshChangesRegion) { $selectedLocation = $validated.Location }

                    $groupCanRelocate = $false

                    if ($Item.Scope -eq 'group') {

                        $groupName = '{0}-{1}' -f $executionOptions.ResourceGroupPrefix, $attemptInput.NamingId

                        $pinned = @(@($executionOptions.ResourceLocation, $Item.TokenResourceLocation, $parameters['resourceLocation']) |

                                Where-Object { -not [string]::IsNullOrWhiteSpace([string]$_) -and $_ -cne '#_resourceLocation_#' } |

                                ForEach-Object { ([string]$_ -replace '\s', '').ToLowerInvariant() } | Sort-Object -Unique)

                        if ($pinned.Count -gt 1) {

                            throw [AvmConfigurationException]::new('Conflicting resource locations were supplied by parameters, CI inputs or tokens.')

                        }

                        if ($mode -eq 'Fresh' -and -not $freshChangesRegion) { $selectedLocation = $validated.Location }

                        elseif ($pinned.Count -eq 1) { $selectedLocation = $pinned[0] }

                        else {

                            $selection = Get-AvmBicepResourceLocation -ResourceType $Item.ResourceType `

                                -MetadataLocation $executionOptions.Location -UnavailableRegions $unavailableRegions

                            $selectedLocation = $selection.Location

                            $groupCanRelocate = -not $selection.IsGlobal

                        }

                        New-AvmBicepAttemptGroup -State $state -StatePath $handle.Path -Name $groupName `

                            -Location $selectedLocation -Confirm:$false

                    }

                    $options = @{

                        Scope = $Item.Scope; TemplatePath = $Item.TemplatePath; MetadataLocation = $executionOptions.Location

                        DeploymentName = 'avm-e2e-{0}-t{1}' -f $Item.RunId, $attempt

                        Parameters = $parameters; ResourceGroupName = $groupName; ManagementGroupId = $executionOptions.ManagementGroupId

                    }

                    $validated = Test-AvmBicepNativeDeployment -DeploymentInput $options -SubscriptionId $Item.SubscriptionId `

                        -TemplateContent $attemptInput.TemplateContent -ResourceType $Item.ResourceType `

                        -ResourceLocation $selectedLocation -TokenResourceLocation $Item.TokenResourceLocation `

                        -ParameterResourceLocationToken:($references.Contains('resourceLocation')) `

                        -UnavailableRegions $unavailableRegions -RetryLimit $executionOptions.ValidationRetryLimit

                    $canFresh = -not $freshChangesRegion -or

                    (($validated.CanRelocate -or $groupCanRelocate) -and

                    $validated.AttemptedRegions.Count -lt $executionOptions.ValidationRetryLimit)

                }

                $deployed = New-AvmBicepNativeDeployment -State $state -StatePath $handle.Path `

                    -DeploymentInput $validated.DeploymentInput -Attempt $attempt -Mode $mode -NamingId $attemptInput.NamingId `

                    -RecoveryDeadlineUtc $executionOptions.RecoveryDeadlineUtc `

                    -ClassifyRetry:($attempt -lt $attemptLimit) -ResourceLocation $validated.Location -Confirm:$false

                if ($deployed.Status -eq 'pass' -or $attempt -eq $attemptLimit -or -not $deployed.RetryMode -or

                    ($deployed.RetryMode -eq 'Fresh' -and -not $canFresh)) { break }

                # ARM can overwrite nested operation history even when the next root name changes.

                $snapshot = Get-AvmBicepDeploymentCleanupTarget -DeploymentIds @($deployed.DeploymentId) `

                    -RequireCompleteRemoval -SearchRetryLimit 1 -SearchRetryInterval 0

                $state['resources'] = @(Get-AvmBicepCleanupResourceRecord -Existing $state['resources'] -ResourceIds $snapshot.ResourceIds)

                Save-AvmBicepCleanupState -State $state -Path $handle.Path -Confirm:$false

                if ($snapshot.Issues.Count -gt 0) {

                    foreach ($issue in $snapshot.Issues) { Write-AvmLog -Level Warning -Message $issue.Message }

                    Add-AvmBicepTestIssue -Issues $issues -File $Item.Case.RelativePath -Code 'retry-evidence-incomplete' `

                        -Message "The failed attempt's resource history could not be preserved completely; retry stopped. Cleanup state: '$($handle.Path)'."

                    $retryBlocked = $true

                    break

                }

                $mode = $deployed.RetryMode

                if ($mode -eq 'Fresh' -and $freshChangesRegion) { $unavailableRegions = $validated.AttemptedRegions }

                Write-AvmLog -Level Warning -Message "Retrying '$($deployed.DeploymentName)' in $mode mode ($attempt/$attemptLimit); all resources remain until finalization."

                Start-Sleep -Seconds $Item.RetryPolicy['limits']['delaySeconds']

            }

            if ($deployed.Status -ne 'pass' -and -not $retryBlocked) {

                $authorizationDetail = if ($deployed.ErrorKind -eq 'Forbidden') {

                    ' Submission returned HTTP 403; authorization failures never permit replay.'

                }

                else { '' }

                Add-AvmBicepTestIssue -Issues $issues -File $Item.Case.RelativePath -Code 'deployment-failed' `

                    -Message "Deployment '$($deployed.DeploymentId)' ended with '$($deployed.Outcome)' outcome.$authorizationDetail Cleanup state is retained at '$($handle.Path)'."

            }

        }

        catch {

            if ((Get-AvmBicepDeploymentErrorKind -ErrorRecord $_) -eq 'Cancellation' -or

                $_.FullyQualifiedErrorId.Split(',')[0] -eq 'AvmBicepContextRestoreFailed') {

                $interrupted = $true

                throw

            }

            $detail = if ($_.Exception -is [AvmConfigurationException]) { $_.Exception.Message } else {

                $codes = @(Get-AvmBicepSafeErrorCode -ErrorRecord $_)

                $codeText = if ($codes.Count -gt 0) { " Azure error codes: $($codes -join ', ')." } else { '' }

                "Native preparation, validation or submission failed.$codeText Raw parameters and Azure responses are not logged."

            }

            Add-AvmBicepTestIssue -Issues $issues -File $Item.Case.RelativePath -Code 'native-execution-failed' `

                -Message "$detail Cleanup state: '$($handle.Path)'."

        }

        finally {

            if ($executionOptions.Phase -eq 'All' -and -not $interrupted) {

                $completion = Complete-AvmBicepTestCase -Item $Item -StatePath $handle.Path `

                    -SubscriptionId $Item.SubscriptionId -TenantId $TenantId -RepositoryRoot $executionOptions.RepositoryRoot `

                    -AzPath $executionOptions.AzPath -KeepResources:$executionOptions.KeepResources -Confirm:$false

            }

        }

        if ($null -ne $completion) {

            foreach ($issue in $completion.Issues) { $issues.Add($issue) }

        }

        $passed = $null -ne $deployed -and $deployed.Status -eq 'pass' -and $issues.Count -eq 0 -and

        ($executionOptions.Phase -eq 'Deploy' -or ($null -ne $completion -and $completion.Status -eq 'pass'))

        [pscustomobject]@{

            Status           = if ($passed) { 'pass' } else { 'fail' }

            AssertionResults = @(if ($null -ne $completion) { $completion.AssertionResults })

            PostResults      = @(if ($null -ne $completion) { $completion.PostResults })

            CleanupPending   = @(if ($null -ne $completion) { $completion.CleanupPending })

            CleanupDeferred  = $executionOptions.Phase -eq 'Deploy' -or $executionOptions.KeepResources -or

            ($null -ne $completion -and $completion.CleanupDeferred)

            StatePath        = $handle.Path

            Issues           = $issues.ToArray()

        }

    } -Confirm:$false

}

# SIG # Begin signature block

# MIInRAYJKoZIhvcNAQcCoIInNTCCJzECAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCUdmizNBlCTTds

# 9z49DgEnaQVCeI+Vk5QYJs0iaWMOiKCCDLowggX1MIID3aADAgECAhMzAAACHU0Z

# yE7XD1dIAAAAAAIdMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD

# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQzWhcNMjcwNDE1MTg1

# OTQzWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD

# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB

# DwAwggEKAoIBAQDQvewXxx9gZZFC6Ys1WBay8BJ8kGA4JQnH5CMafqOASlTpK9H8

# o5ZXTXt0caVQTNMUPt445wXYD+dFtaKWTwDn1I52oUSrC9vJin1Gsqt+zyKJL5Dg

# 3eQXbQNR61DmMy20GLTIO3SFed9Rfi/ophgCLGFLDR3r0KvHjwMb/jYWS0celV/4

# Lz27LfAekm8v9E5IXaeiXbAUYZKK090n4CVl3JBtbN+9DtI9SNu/yjvozW52/u7R

# X/Ttpa/KDlpuokZ+Zcbvmtd9ur9gFLvZzh41o9MsE/clQtdaFWGvuo6Jua/ntpgk

# ey3E5/vBFe+MJPG6phdnuo6r57ZudCudiI1bAgMBAAGjggGbMIIBlzAOBgNVHQ8B

# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O

# BBYEFH6QuMwqcPG0hQlQ6c5jCtTTLrVeMEUGA1UdEQQ+MDykOjA4MR4wHAYDVQQL

# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xFjAUBgNVBAUTDTIzMDAxMis1MDc1NTkw

# HwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEwYAYDVR0fBFkwVzBVoFOg

# UYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0

# JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNybDBtBggrBgEFBQcBAQRh

# MF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# Y2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy

# dDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQBKTbYOjzwTG/DXGaz9

# s6+fQeaTtDcFmMY+5UyVFCyj7Pv+5i37qfX8lSL/tBIfYQfWsMuBQlfZurJD6r4H

# VJ2CeH+1fgiq8dcHdVKoZ3Sa2qXoX3cq9iS8cVb06B7+5/XJ7I0OxHH9fDsvJ3T3

# w5V/ZtAIFmLrl+P0CtG+92uzRsn0nTbdFjOkLMLWPLAU3THohKRlSEMgFJpPkm5n

# 5UAZ35xX6FWCrDLsSKb555bTifwa8mJBwdlof0bmfYidH+dxZ1FdDxvLnNl9zeKs

# A4kejaaIqqIPguhwAti5Ql7BlTNoJNwxCvBmqW2MQLnCkYN/VVUsR3V2x/rcTNzo

# Bf/Z/SpROvdaA2ZOOd1uioXJt3tdLQ7vHpqpib0KfWr/FWXW10q38VxfCnRQBqzb

# SuztR7nEMuzX7Ck+B/XaPDXd1qh72+QYyB0Z2VzWmO9zsnb9Uq/dwu8LGeQqnyu6

# 7SDGACvnXii2fb9+US492VTnXSnFKyqwgzUyFMtZK1/sHYTv6bG4TtQUygQxTN+Z

# V+aJIlKO2MqZ7bKrAnOzS9m6NgoTdWOq11bTOZwKlIEV/EhV9SWkDmdpR/hPPT2v

# 6TEj4F8PT/zHjRezIU5c/DGlt/VhY/pK0XkJtEyMmmS1BMtjU/rqBZVMIm3dnxQs

# /TBByr+Cf8Z1r7aifQVQ+WSqzjCCBr0wggSloAMCAQICEzMAAAA5O7Y3Gb8GHWcA

# AAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX

# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg

# Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl

# IEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoXDTM2MDMyMjIyMTMwNFow

# VzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEo

# MCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAyNDCCAiIwDQYJ

# KoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeqlRYHNa265v4IY9fH8TKh

# emHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo0dtS/EW6I/yEL/bLSY8h

# KpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATvQVL4tcf03aTycsz8QeCd

# M0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a1uv1zerOYMnsneRRwCbp

# yW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1FyQfK0fVkaya8SmVHQ/t

# Of23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfOGSWHIIV4YrTJTT6PNty5

# REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7ttOu1bVnXfHaqPYl2rPs

# 20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJuz2MXMCt7iw7lFPG9LXK

# Gjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxSCwyoGIq0PhaA7Y+VPct5

# pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOmVQop36wUVUYklUy++vDW

# eEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3SkE/xIkgpfl22MM1itkZ

# 35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8EBAMCAYYwEAYJKwYBBAGC

# NxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPXLQaUEggxMBkGCSsGAQQB

# gjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU

# ci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2Ny

# bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0MjAx

# MV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0

# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAx

# MV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOCAgEAFJQfOChP7onn6fLI

# MKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D5W4wMwYeLystcEqfkjz4

# NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBYnbu0+THSuVHTe0VTTPVh

# ily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSIvgn0JksVBVMYVI5QFu/q

# hnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6aR9y34aiM1qmxaxBi6OU

# nyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4wPKC5OmHm1DQIt/MNokbb

# H3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7RTX8AdBPo0I6OEojf39z

# uFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK/fg8B2qjW88MT/WF5V5u

# vZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSKYBv0VisCzfxgeU+dquXW

# 9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkwYTu/9dLeH2pDqeJZAABV

# DWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVTQl0v4q8J/AUmQN5W4n10

# 1cY2L4A7GTQG1h32HHAvfQESWP0xghngMIIZ3AIBATBuMFcxCzAJBgNVBAYTAlVT

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv

# c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w

# DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ

# KoZIhvcNAQkEMSIEILQcyn4KTteREDID/rFhjT+al6JlYwD7hCVuGqsLcronMEIG

# CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAfEnbBbeaTLHDfRJc

# iZEQGSaHtFPFj/d6hgQuhYQm//KT/yNy1dwhJFA5hT3ql2RY3GADxJB5c5QmUgA5

# pIvUvH/iCgFMRO29g1QNuR3iclowsf7+1hEiGqmd87StPZmJVvM82uNaqLz/iZbJ

# hAmdIGTURb3zfgNlLybWg2NkQAHag8CVlZ8imyzKrYCoXzF2NfgunOrA/1oCdGxI

# iHC02d1FfQGiQdRnbuvAIv4u87IODYe/lB6oHvvrYbEfucR2WvdPz3//pEVp1b9f

# aNktE2gILhLnBg4ITNMX5+n6EdcF9+CwkhqO6hm2p81jgnH/4PyfMJ2nFbEZNCjV

# DIjg1aGCF7AwghesBgorBgEEAYI3AwMBMYIXnDCCF5gGCSqGSIb3DQEHAqCCF4kw

# gheFAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFF

# MIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCDw21Z/asjEbx8G

# dI1H/XjfRknoaU9kyKBTdnIrY0ewWgIGargInFmKGBMyMDI2MTAyMTA4NTExNy4y

# MTdaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExp

# bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo1MjFBLTA1RTAtRDk0NzEl

# MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEf4wggcoMIIF

# EKADAgECAhMzAAACF3H7LqWvAR3qAAEAAAIXMA0GCSqGSIb3DQEBCwUAMHwxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv

# c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI1MDgxNDE4NDgyM1oXDTI2MTEx

# MzE4NDgyM1owgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# LTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEn

# MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjUyMUEtMDVFMC1EOTQ3MSUwIwYDVQQD

# ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEF

# AAOCAg8AMIICCgKCAgEAwM82sEw+39vYR7iGCIFDnYNhRM+BzF2AYiq5dUpZpJFP

# RjCcipQ6RUbI+RAYNRApExx5ygrXbaWtuwvqsqAVSWbU/W6fecujjILkPqn9pngt

# WRkfQgbYgvaXALl6PY2yOH9f72MD+6AyxQenSpAMdUzY/Qk/jtjsHdFXVBe+tshl

# IkSJ3GZw8VVKqTg3GZElztwbJWNtrhBEvhf6anxMegQMJP7tO8/BJ7ITs4/AV3D2

# bv8eHk81Y+fOmQ8mQ61WLq2wItvlzIT5bzelK9LvEycf5x1lXxAwEw5a7dpS+CKT

# anhtv+Q2mwebAybjf9io4k48stTaq1rtcrOiDwddqVm1S9e8h1TszXFzjLLvE9Em

# jnNfIewsY+RChUaHnY4FFwwJEnEv/JS76oHT0oGdy7+J60fGOl7A1UoUyAkhpb2B

# ja+SwSIiHbQ4FDyJiLlZ6drZZ84MoJ852JSxM0hBjGO6FZlPO8iuNyk680Di8Vnb

# SNpIdJN+DhlepeTUMBDHqCmd0mVWRWZPm1pvgty93asNt/Ng6o4m2dnooWOdM3yK

# sJaWjyHqic9gfTrZBM+PCXqeTaO1oEiaQ+h4w0nHVdV+XSvI2m1yN4iibqjm5HPa

# AO3OJ+OmNLftNVmr4Z6U2T6pIcLBysoKcDUvCqycXj4C/+n1KFBpDGdDMw9gmu8C

# AwEAAaOCAUkwggFFMB0GA1UdDgQWBBRQrN9jlwNOoeE5ZQqnF5x8S1bJQzAfBgNV

# HSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5o

# dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBU

# aW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG

# CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRz

# L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNV

# HRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIH

# gDANBgkqhkiG9w0BAQsFAAOCAgEARmgFdhB7xIAIHEEg5I/5S+gx67aR6RiW8ZAw

# tE3mz8o0dyn+pIP+lidNR1IKQQ0r+RjYgI9cZ6mbvAyvh3e2q/BV8rjHE3ud9PyY

# yq32euFgdZ3vX4b5QXePWlpBAYrdziR27rHz6WwpH5dZsSypbXDBbQkWkNl6g82y

# Ty3AbBbKDXBdzxZsEauaOplatK7Er4dhglKBex8JQ2dMSkSZweCNDXqd9r/9W2Vd

# RZsDJKP/Xc4UyQlVsboBotKtYESXFkjwR1HVsH+Q0C69/N5CP/Tq3YgI1ub4b9+3

# MJFKWhJXCcJGFZkcLwUmYwoFg1XLo7DLJdGjrIH1jsI2NFXJFQHef6AdRe1ERvYQ

# eqtyrBvxIvR+P/83FNYyzx04inUT9TF2AwTOuqCC6Z67oNwR4pEEJyAIEREvkdhj

# jfWcgsk/nGTlfahvNY/SOHrNRKo49KDlccNzRCJQyQ+D59r7/qebNSyQPTfwI9++

# jEY0Q/UWKVNLhio55GYBseJ99s7NzkdxOr9Uftp597HEovbA69qGlZ3OpUE3H1RB

# GDVp/FvM2uXTum8LrMkPXx5Ap/kbPASsC9ju9oMCe2IEXO2SeD1aD3IqvAOdHFKH

# g1vpbPUQSWb6g2xfBV30wFcqaPYgzcbxPWPyZqK+S8l7zw64aO5hmJ7eQwoMfTu0

# Vay6r48wggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3

# DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G

# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIw

# MAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAx

# MDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVT

# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK

# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1l

# LVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA

# 5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/

# XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1

# hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7

# M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3K

# Ni1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy

# 1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF80

# 3RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQc

# NIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahha

# YQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkL

# iWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV

# 2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIG

# CSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUp

# zxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBT

# MFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jv

# c29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYI

# KwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGG

# MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186a

# GMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3Br

# aS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsG

# AQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29t

# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcN

# AQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1

# OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYA

# A7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbz

# aN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6L

# GYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3m

# Sj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0

# SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxko

# JLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFm

# PWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC482

# 2rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7

# vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDWTCC

# AkECAQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExp

# bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo1MjFBLTA1RTAtRDk0NzEl

# MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsO

# AwIaAxUAabKAFaKt2haUdqkHfFYzAzfgSMuggYMwgYCkfjB8MQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAO6C0QkwIhgPMjAyNjEw

# MjEwNTUwMDFaGA8yMDI2MTAyMjA1NTAwMVowdzA9BgorBgEEAYRZCgQBMS8wLTAK

# AgUA7oLRCQIBADAKAgEAAgIPkgIB/zAHAgEAAgIWKzAKAgUA7oQiiQIBADA2Bgor

# BgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAID

# AYagMA0GCSqGSIb3DQEBCwUAA4IBAQBg73V4UHnsJDFu91eOb+uzIHm4AOzsWMha

# t2LSIbgfkBscV08JhhL/3Mm4aZ72TZmKzid2sC6YHLbnkm9SlEonUqvhk2twvJye

# MFEgGyY9IR++1WsdFUCBtuiEAuFnmGvJo1YJ5dsGc96pepCWd7Jdh1qSVFIVLFzS

# OM7pg6SOD2wv1cYBjNzkM3xXyKaC65RAEmyHzV5A+Nuqr9k4ovsHoJjLW3S4aoLq

# X8QkAub8EO6xlQZik6fZRqPeXrOZc60w1UblJmrJi4ZgsDTvo/aLvuIXloG5tHU/

# qV9Erscsg/gxvdrR1wyRJaiIHBGHDZEkDQUysFuhoUXKKihBqiwVMYIEDTCCBAkC

# AQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV

# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG

# A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIXcfsupa8B

# HeoAAQAAAhcwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG

# 9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQg9ixRKU0VyqUjC+F/lLcwJwb26kjf4tUP

# UuF+bQJWYVkwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCDQ8lBgPl23yZ0S

# zUSt5phOIegHPywrkNwevxe2k+RaWzCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0

# YW1wIFBDQSAyMDEwAhMzAAACF3H7LqWvAR3qAAEAAAIXMCIEIGZUHFw2f79w4NmL

# Yh9DmZ0laW1GYbA2AiQpRj80QbOXMA0GCSqGSIb3DQEBCwUABIICAH2QiZKcHm/Y

# lJrilAk5KRGQqXsigusNQ1you+fC/IhpMD/803CxPGi41Viut/jLtP1ozNprlMLB

# mAJFjwdgcGvaXpPEUpPpUqgCesF3M4Ow9kf84Wu8fmpOCyYg4aEEn1H7FvcUX1w5

# MJxHVV1cIy59Gz6shvs2u581pVJ1nopVGdnV3EEjOxwA3S4KnkIv0zsa6oIO1nf+

# w/y9FwqDZSg9bkF+kFaQ+VLY/N1qZj6bFit/HtdzSOzIrhUkZfpLCKmj5kzWcjlm

# JRs0LiicXmCpJB3yaVkB5GuP/fZXeYqmtRoh/mV92GijeaFbLZF7GKlKe3aaYkWz

# 40Gk+NBPodDvn7mqRrhv55N52+jTvkHQ6DsshIBQMrOvpYyHgyAZgjdwF6YNRYM6

# +eBxqPBGQxckJaBlBCEiBUW/luPvITY3/ey923ogkvkaiBN5Tn7q3ILVzGFaB8aW

# O0e3yoeV1QcXR7HplmqqE46dQj66KCvcjN5QsdmE4NxFxpH6rxtjjd1zRxtytEcu

# PWFR0O/aHe+PmPSvLHP/yO7KJ3Vhsv+i0xZGvWtUjFnnJJKN+qlKdIs0BTPur69M

# lw05+3n18sUvHxRFIjxCU+k1dy9RbuJB8G+ZPkxztqvOWoQWfr9yPhKzI+vR/vdk

# jc2zRfWI0MU6mEAlTJRtHDatkd9Ke7iC

# SIG # End signature block