Avm.Authoring

0.27.0

Public/Invoke-AvmTestE2e.ps1

                                function Invoke-AvmTestE2e {

    <#

    .SYNOPSIS

        Run Bicep or Terraform deployment tests with ordinary cleanup.

    .DESCRIPTION

        Bicep discovers tests/e2e/**/main.test.bicep and compiles temporary

        ARM templates without editing source. Existing Azure PowerShell and

        Azure CLI sign-ins must identify the same account, tenant, cloud and

        selected subscription. Required Az modules are checked, not installed.

        Native ARM validation and deployment support resource-group,

        subscription, management-group and tenant scope, including nested

        and cross-scope module deployments. Select authorized test targets:

        resources created or updated by the test can be removed afterwards.

        Bicep registry modules read repository-root .required-features.json and

        .required-resource-providers.json maps using the exact module Path.

        Validate each whole map before dependency preparation or Azure calls.

        After compilation and identity verification, register features and

        propagate their providers, then register required provider namespaces,

        before token replacement, validation or deployment. Missing, empty or

        unrelated maps skip registration. WhatIf validates configuration without

        Azure access. Complete and cleanup never register prerequisites, and

        registrations are never undone. No additional caller input is needed.

        Packaged Resources/bicep/retry-policy.json selects bounded retries

        from complete structured failure evidence. InPlace reuses the exact

        deployment, template and parameters. Fresh generates a new external

        naming context and deployment identity, using another eligible region

        by default. Fixed caller inputs and names authored inside Bicep are

        not rewritten, so Fresh does not guarantee all resource names differ.

        No resources are deleted between attempts. Resource evidence is saved

        before another attempt can overwrite deployment-operation history.

        Status recovery shares one configured four-hour deadline across all

        attempts in a case; it never starts a read or accepts a terminal result

        at or after that deadline.

        Successful deployments run their case-local Pester assertions, then

        post.ps1, then native cleanup adapted from the registry workflow.

        Assertions and hooks run in the same PowerShell process to retain

        process-only sign-ins. Caller or workflow cancellation applies;

        no separate-process timeout or credential transfer is used. A failed

        assertion or hook still runs ordinary cleanup. An authored assertion

        suite must have passing tests and no failed, skipped, filtered,

        inconclusive or setup-failed tests. Absent suites are 'not-present'.

        Cleanup follows recorded Create deployment operations recursively,

        not Read references or a subscription-wide inventory. Resource-group

        cases use unique groups and verified ownership tags. All attempt IDs and

        required post-removal metadata are saved in an atomic local JSON file

        before submission or removal. The state contains no credentials,

        parameters or outputs, and survives temporary-template removal.

        Final cleanup covers every attempt, including failed attempts.

        Incomplete cleanup reports pending IDs and stops subsequent cases.

        The reaper is a fallback, not the normal cleanup mechanism.

        All runs the complete lifecycle. Deploy retains all attempts and state

        for a separate Complete call after caller-owned sign-in renewal.

        Complete requires matching direct case/module source, assertion files

        and post hook, plus explicit subscription/tenant. It rereads outputs by

        exact deployment ID and never submits a deployment. The source check

        does not fingerprint every imported helper or dependency.

        Interrupted completion must use avm test cleanup rather than replaying

        authored scripts. Actions callers may upload state as an artifact;

        recovery requires that the upload finished before runner loss.

        KeepResources runs assertions but deliberately skips post.ps1 and

        cleanup for every attempt. This is an explicit debugging exception.

        The saved file can later be passed to avm test cleanup,

        which does not need the checkout and never runs assertions or hooks.

        Terraform runs init, apply, idempotency plan and destroy for runnable

        examples/. MaxRetry controls Terraform transient apply retries.

        No deployment tests belong in avm pr-check or the local build gate.

        Listing does not resolve tools or credentials. An absent tier is

        'skipped', not a pass; .e2eignore excludes a case.

    .PARAMETER Path

        Module directory, or an enclosing context. Defaults to the current location.

        Required provider declarations use only the exact Bicep registry module

        key in the root .required-resource-providers.json, without inheritance.

    .PARAMETER Ecosystem

        Explicit ecosystem, or auto-detection.

    .PARAMETER AllowPathFallback

        Accept a PATH tool only when it reports the lock-pinned version.

    .PARAMETER Example

        Select case names or root-relative Bicep paths. Explicit ignored,

        absent or ambiguous selections are errors.

    .PARAMETER List

        Return a JSON array of runnable example names without cloud access.

    .PARAMETER MaxRetry

        Terraform-only transient apply retry budget, default two retries.

    .PARAMETER Recurse

        Bicep-only: include child-module test cases.

    .PARAMETER SubscriptionId

        Bicep-only: explicit test subscription GUID. Ambient defaults are not used.

    .PARAMETER TenantId

        Bicep-only: explicit tenant GUID required for every deployment scope.

    .PARAMETER ManagementGroupId

        Bicep-only: existing target management-group name for that scope.

        With UseCiInputs, omitting this parameter uses the configured CI target.

        An explicitly supplied value always takes precedence and is validated;

        an invalid or empty explicit value is never replaced by a CI fallback.

    .PARAMETER Location

        Bicep deployment-metadata location, fixed across regional retries.

        Also the placement fallback for explicitly global resource types.

    .PARAMETER ResourceLocation

        Pin Bicep resource placement. Must agree with parameter/token locations.

    .PARAMETER ResourceGroupPrefix

        Required for resource-group Bicep cases; up to 57 safe name characters.

    .PARAMETER TokenFile

        JSON string-valued tokens, relative to the module root or absolute.

        Mutually exclusive with Tokens. Explicit scope parameters own scope tokens.

    .PARAMETER Tokens

        Bicep token dictionary instead of TokenFile. Generated avmE2eRunId and

        avmE2eSuffix tokens provide a unique default namePrefix per fresh context.

        In-place retries preserve these values; explicit caller values stay fixed.

    .PARAMETER ParameterFile

        ARM JSON parameter file, preserving values and vault references.

        Mutually exclusive with Parameters; source is not changed.

    .PARAMETER Parameters

        Bicep parameter values. SecureString values remain in memory.

        Explicit values or files take precedence over CI inputs.

    .PARAMETER UseCiInputs

        Opt into AVM_CI_VARIABLES and AVM_CI_SECRETS JSON, localToken_*,

        TOKEN_NAMEPREFIX and deprecated CI_KEY_VAULT_NAME inputs. CI secrets

        beat variables; CI_ aliases beat CI__ aliases within a source.

        Missing explicit IDs may use VALIDATE_SUBSCRIPTION_ID and

        VALIDATE_TENANT_ID. Pools resolve VALIDATE_SUBSCRIPTION_IDS then

        TEST_SUBSCRIPTION_IDS from variables, then secrets, then environment.

        When ManagementGroupId is omitted, the same source order resolves

        VALIDATE_MANAGEMENT_GROUP_ID before ARM_MGMTGROUP_ID within each source.

        Management-group cases still require a valid resolved target.

        Nothing logs in.

    .PARAMETER TestSubscriptionIds

        Optional Bicep JSON array of id/name objects with an optional tag.

        Missing tags mean General. Cases use only General subscriptions in a

        stable seeded ordering, independent of JSON ordering. Registry-layout

        modules require the exact root .reserved-test-subscriptions.json map.

        Non-General reservations require the protected registry workflow, not

        native e2e, so its environment lock covers preparation through cleanup.

    .PARAMETER SubscriptionSelectionSeed

        Shared nonnegative seed for deterministic subscription ordering.

    .PARAMETER SubscriptionJobIndex

        Nonnegative initial case index for round-robin subscription selection.

    .PARAMETER Phase

        Bicep All (default), Deploy, or Complete for caller-owned sign-in renewal.

    .PARAMETER CleanupStatePath

        Optional new state file for one selected case. Complete requires an

        existing file and the explicitly matching subscription and tenant.

    .PARAMETER KeepResources

        Bicep-only: run assertions but retain every attempt, skipping post and cleanup.

    .PARAMETER DeploymentRetryLimit

        Bicep total submission attempts, one to three, capped by packaged policy.

        Only exact Failed deployments with complete eligible evidence can retry;

        unknown outcomes and preflight rejection alone never authorize resubmission.

    .PARAMETER ValidationRetryLimit

        Bicep regional validation budget, one to three, capped by packaged policy.

        Only wholly regional validation failures move an unpinned, non-global,

        non-resource-group case. Fresh deployment retries share the region budget

        and validate their new context; in-place retries reuse prior validation.

    .PARAMETER SkipModuleVersionCheck

        Skip the advisory module-version check.

    .OUTPUTS

        Engine result with Status, Issues and run counts. Bicep also returns

        Phase, AssertionResults, PostResults, CleanupPending, CleanupDeferred

        and CleanupStatePaths. Deployment outputs and parameters are not returned.

    .EXAMPLE

        avm test e2e --list

    .EXAMPLE

        avm test e2e --subscription-id $testSubscriptionId --tenant-id $testTenantId --location eastus --resource-group-prefix avm-e2e

    .EXAMPLE

        avm test e2e --example defaults --subscription-id $testSubscriptionId --tenant-id $testTenantId --location eastus --phase Deploy --cleanup-state-path cleanup.json

    .EXAMPLE

        avm test e2e --phase Complete --cleanup-state-path cleanup.json --subscription-id $testSubscriptionId --tenant-id $testTenantId

    .EXAMPLE

        avm test e2e --max-retry 0 --ecosystem terraform

    #>

    [CmdletBinding(SupportsShouldProcess)]

    [OutputType([pscustomobject])]

    param(

        [Parameter(Position = 0)]

        [string] $Path = $PWD.Path,

        [ValidateSet('auto', 'bicep', 'terraform')]

        [string] $Ecosystem = 'auto',

        [switch] $AllowPathFallback,

        [AllowEmptyCollection()]

        [string[]] $Example = @(),

        [switch] $List,

        [ValidateRange(0, 10)]

        [int] $MaxRetry = 2,

        [switch] $Recurse,

        [string] $SubscriptionId,

        [string] $TenantId,

        [string] $ManagementGroupId,

        [string] $Location,

        [string] $ResourceLocation,

        [string] $ResourceGroupPrefix,

        [string] $TokenFile,

        [Alias('AdditionalTokens')]

        [System.Collections.IDictionary] $Tokens = @{},

        [string] $ParameterFile,

        [System.Collections.IDictionary] $Parameters = @{},

        [switch] $UseCiInputs,

        [string] $TestSubscriptionIds,

        [ValidateRange(0, [int]::MaxValue)]

        [int] $SubscriptionSelectionSeed = 0,

        [ValidateRange(0, [int]::MaxValue)]

        [int] $SubscriptionJobIndex = 0,

        [ValidateSet('All', 'Deploy', 'Complete')]

        [string] $Phase = 'All',

        [string] $CleanupStatePath,

        [switch] $KeepResources,

        [ValidateRange(1, 3)]

        [int] $DeploymentRetryLimit = 3,

        [ValidateRange(1, 3)]

        [int] $ValidationRetryLimit = 3,

        [switch] $SkipModuleVersionCheck

    )

    Set-StrictMode -Version 3.0

    $ErrorActionPreference = 'Stop'

    if (-not $List) {

        Test-AvmModuleVersion -SkipModuleVersionCheck:$SkipModuleVersionCheck

    }

    $context = Get-AvmModuleContextInternal -Path $Path -Ecosystem $Ecosystem

    $bicepOptions = @(

        'Recurse', 'SubscriptionId', 'TenantId', 'ManagementGroupId', 'Location',

        'ResourceLocation', 'ResourceGroupPrefix', 'TokenFile', 'Tokens', 'ParameterFile', 'Parameters',

        'UseCiInputs', 'TestSubscriptionIds', 'SubscriptionSelectionSeed', 'SubscriptionJobIndex',

        'Phase', 'CleanupStatePath', 'KeepResources', 'DeploymentRetryLimit', 'ValidationRetryLimit'

    )

    switch ($context.Ecosystem) {

        'bicep' {

            if ($PSBoundParameters.ContainsKey('MaxRetry')) {

                throw [AvmConfigurationException]::new('-MaxRetry is only supported for Terraform e2e tests.')

            }

            $inputOptions = @{ Context = $context; AllowPathFallback = $AllowPathFallback; Example = $Example; List = $List }

            foreach ($name in $bicepOptions) {

                if ($PSBoundParameters.ContainsKey($name)) { $inputOptions[$name] = $PSBoundParameters[$name] }

            }

            if ($List) {

                Invoke-AvmBicepTestE2e @inputOptions

            }

            elseif ($PSCmdlet.ShouldProcess($context.Root, "Run Bicep e2e phase $Phase in explicit test targets")) {

                Invoke-AvmBicepTestE2e @inputOptions -Confirm:$false -WhatIf:$false

            }

            else {

                Invoke-AvmBicepTestE2e @inputOptions -WhatIf

            }

        }

        'terraform' {

            foreach ($name in $bicepOptions + @('WhatIf', 'Confirm')) {

                if ($name -eq 'Recurse' -and -not $Recurse) { continue }

                if ($PSBoundParameters.ContainsKey($name)) {

                    throw [AvmConfigurationException]::new(

                        'Bicep scope, input, phase, cleanup and ShouldProcess options are not supported for Terraform e2e tests.')

                }

            }

            Invoke-AvmTerraformTestE2e -Context $context -AllowPathFallback:$AllowPathFallback `

                -Example $Example -List:$List -MaxRetry $MaxRetry

        }

        default {

            throw [AvmContextException]::new("Cannot run e2e tests: unknown ecosystem '$($context.Ecosystem)'.")

        }

    }

}

# SIG # Begin signature block

# MIInRAYJKoZIhvcNAQcCoIInNTCCJzECAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBdubLzlzebz9L1

# 78gPJgYvNAiVGQ45LK3yEPdAhfPn6qCCDLowggX1MIID3aADAgECAhMzAAACHU0Z

# 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

# KoZIhvcNAQkEMSIEIMMfqPv0nidvEv7ow0FzWa/wU6OROJ7Cr5gVE+c7ILwiMEIG

# CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAVZWFdagXO1WrQ8hF

# TC1jhGvQM1omETG6AcNIf9aqplnSD4qduo6E9kRQ19D/AQltQUeAypn/+hgYtkWG

# oOPzmTAUzlQgyfEU9EHdyUqosXhj1KY//24iGmCYMur+p/umdBUZYCrNW1az0/I+

# 0qDg0wwd0OoUp2s1TEyO7KdIlIRUDo7PSJ+H39yupx9GPpsGmOWQ3AAVf5dvNGWD

# JKYW9mAxLpPZKeCbe0Y67lQ8+LXFTeVzhzq4QBujzo4hT0Pt3dqKM4yAzGvG646P

# RYjWFmYU0zYCqgmEZZAtW3uis6vmS6QS+K5dUTUezrgO8FN7UTEybLrIKaHyrOZN

# glm5H6GCF7AwghesBgorBgEEAYI3AwMBMYIXnDCCF5gGCSqGSIb3DQEHAqCCF4kw

# gheFAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFF

# MIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCAzfb5l/gAgoliY

# T/YX/ilgMcwVw01xs0P5EB/xGWTdpQIGargIe5sTGBMyMDI2MTAyMDE0MTIwOS4z

# NzRaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# 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

# ZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAO6Bf4kwIhgPMjAyNjEw

# MjAwNTUwMDFaGA8yMDI2MTAyMTA1NTAwMVowdzA9BgorBgEEAYRZCgQBMS8wLTAK

# AgUA7oF/iQIBADAKAgEAAgIq/QIB/zAHAgEAAgISXzAKAgUA7oLRCQIBADA2Bgor

# BgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAID

# AYagMA0GCSqGSIb3DQEBCwUAA4IBAQB6J0o9e7Sz1pdYrKhB7BDepRxYyQKM74YB

# ky+uCSvF4j6OI8yf51/sleNu67O7fH9ql2A41kGZ6CYFH+kzZRwg7WOsBTp7gkSW

# TIqIBiT/3RHH4Z/HX7Z5Yyr5JE2fyz/yjuGCDnxdmSLpGXWO/QXuZ8xl0cCPWZMT

# JNXBz3WOQ4LcqoBAlGr+cImROeyPXLKPThuaWpu/fgrbT1uJ8DSPcDikJ+8qKC3V

# 3HzgMGJObK/EdxzA7LbTCC4xvQmHsnQrOFD15frInhsG9A13QCfbyX9mG6fyYuZm

# 3Tzqye/tIvafjubeLZCEUAGhksVEHlKyDOpzNzDEwPxO0oDsBrh9MYIEDTCCBAkC

# AQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV

# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG

# A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIXcfsupa8B

# HeoAAQAAAhcwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG

# 9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgSRWrqFYSsaV8cu2ZXAPhWZhmgRTeEtk7

# FQooraYVfg4wgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCDQ8lBgPl23yZ0S

# zUSt5phOIegHPywrkNwevxe2k+RaWzCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0

# YW1wIFBDQSAyMDEwAhMzAAACF3H7LqWvAR3qAAEAAAIXMCIEINPDGjut9kEVQwur

# +S5OSR6zM/sChVejdttpSv4zQIlNMA0GCSqGSIb3DQEBCwUABIICAHBb+ujcyZWz

# bpD2SdPR+SWHr2L0ME75nGb20VLakcWUwjznynJO1+IIn++qsc5bQZLvulTpmQ7g

# JcyZpt0Kmoihaz0eJe+AaZ1JoNIRsyQRubRmJE0Yt6Tuw6yaGGXMc9i375EB8w+I

# Ut++oh4KxVcvkCp2ouLxDDCXocAsFKFJqcV3x62XhNililxODEj60uiwSgYDMcev

# LK4O6Cln/3wCDmfHLfZRLZnrP3GNfWQvsfOO/MA7ZIDrb6nBKbloN/+FOLdw7wkm

# iK58tSxYGJQTIjgEyXZmw6b7XVqBz+Bk9B9i9UDSQyvWZN1SYh+JFGxm6Wr6xEhh

# VwrnrTroGAg4In/1s8NHniLFmzDvXQnuAnnDR23upAuMmDmggtksDLLAP25x/gLO

# HORIQOXknv4VASN+BjNQD/V9Cn93lvyAc6Q+Jx6vKUSxYqPfCYKqzDfwLRzRFOhM

# 7lEKtaoIoQurPi9Ox6JKVffUZLxPCGEWFsb42EoPkO9w6MSa/1W74lXEfu+y8sxv

# PM1iRS7kd64LI3WV+xxSTWmsdtCPtei7zrd7WLvrMptsY3KNaP8DSNKS02DOqdrN

# GZ1nF+wzquNlmfXHRA2oDlA5vfWMSMEsZsjz+jU+JTe6aI7UNvz0iJJFDDvNMoVT

# bp2fLEnuaOmBGkau9wG6PApXOGJqZc6G

# SIG # End signature block