Public/Invoke-AvmReleaseBranch.ps1
|
function Invoke-AvmReleaseBranch { <# .SYNOPSIS Prepare a reviewed external fork pull request for credentialed E2E testing. .DESCRIPTION For an external fork pull request that requires credentialed E2E tests, an authorized FTE must first review all code, workflows, and dependencies that could access credentials on the current pull request head. The command cannot verify which commit was reviewed. It snapshots the head when invoked and refuses to merge if it changes during the handoff. Restrict write access to the release branch and review any later changes. Using the installed GitHub CLI and its existing github.com authentication, this command creates a release branch from upstream main, retargets the fork pull request, merges the captured head, and opens a follow-up pull request to main. The follow-up links to the original pull request, thanks its author, and preserves its description. For Azure/bicep-registry-modules, it adds the PR: Run Required E2E Tests label to the follow-up. It does not approve reviews or bypass protections. Ordinary checks do not require this handoff. A failure can leave a branch or retargeted or merged pull request behind. Inspect their state before recovering manually; do not blindly rerun. .PARAMETER Repository Upstream github.com repository in owner/name form. .PARAMETER PullRequest Number of an open external fork pull request in the upstream repository. .PARAMETER SkipModuleVersionCheck Skip the PowerShell Gallery check for a newer Avm.Authoring release. .PARAMETER WhatIf Validate and display the planned handoff without changing GitHub state. .PARAMETER Confirm Prompt before performing the handoff. .OUTPUTS PSCustomObject with Repository, OriginalPullRequest, ReleaseBranch, HeadCommit, and FollowUpPullRequestUrl. .EXAMPLE Invoke-AvmReleaseBranch ` -Repository 'Azure/example' ` -PullRequest 123 ` -WhatIf .EXAMPLE avm release-branch ` --repository Azure/example ` --pull-request 123 #> [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Medium')] [OutputType([pscustomobject])] param( [Parameter(Mandatory)] [ValidatePattern('^[A-Za-z0-9][A-Za-z0-9-]*/[A-Za-z0-9_.-]+$')] [string] $Repository, [Parameter(Mandatory)] [ValidateRange(1, [int]::MaxValue)] [int] $PullRequest, [switch] $SkipModuleVersionCheck ) Set-StrictMode -Version 3.0 $ErrorActionPreference = 'Stop' if ($env:AVM_OFFLINE -eq '1') { throw [AvmConfigurationException]::new('AVM_OFFLINE=1 prevents the GitHub pull request handoff.') } Test-AvmModuleVersion -SkipModuleVersionCheck:$SkipModuleVersionCheck $repo = Invoke-AvmGitHubApi -Endpoint "repos/$Repository" if ($repo['fork'] -ne $false -or $repo['default_branch'] -cne 'main' -or $repo['permissions']['push'] -ne $true) { throw [System.InvalidOperationException]::new( "The authenticated GitHub account must have write access to the non-fork upstream $Repository with default branch main.") } $mergeMethod = if ($repo['allow_squash_merge'] -eq $true) { 'squash' } elseif ($repo['allow_merge_commit'] -eq $true) { 'merge' } elseif ($repo['allow_rebase_merge'] -eq $true) { 'rebase' } else { throw [System.InvalidOperationException]::new("No supported merge method is enabled for $Repository.") } $endpoint = "repos/$Repository/pulls/$PullRequest" $pr = Invoke-AvmGitHubApi -Endpoint $endpoint if ($pr['state'] -cne 'open' -or $pr['draft'] -ne $false -or $pr['base']['repo']['full_name'] -ine $Repository -or $null -eq $pr['head']['repo'] -or $pr['head']['repo']['fork'] -ne $true -or $pr['head']['repo']['owner']['login'] -ieq $repo['owner']['login']) { throw [System.InvalidOperationException]::new( "Pull request $PullRequest must be open, ready for review, target the upstream repository, and originate from an external fork.") } $headCommit = [string]$pr['head']['sha'] if ($headCommit -notmatch '^[a-fA-F0-9]{40}$') { throw [System.InvalidOperationException]::new('GitHub did not return a valid pull request head commit.') } $originalPullRequestUrl = [string]$pr['html_url'] $expectedPullRequestUrl = "https://github.com/$Repository/pull/$PullRequest" if ($originalPullRequestUrl -ine $expectedPullRequestUrl) { throw [System.InvalidOperationException]::new('GitHub did not return the expected pull request URL.') } $originalAuthor = [string]$pr['user']['login'] if ($originalAuthor -cnotmatch '^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?(?:\[bot\])?$') { throw [System.InvalidOperationException]::new('GitHub did not return a valid pull request author.') } $main = Invoke-AvmGitHubApi -Endpoint "repos/$Repository/git/ref/heads/main" $mainSha = [string]$main['object']['sha'] if ($mainSha -notmatch '^[a-fA-F0-9]{40}$') { throw [System.InvalidOperationException]::new('GitHub did not return a valid main commit.') } $branch = 'release/fork-pr-{0}-{1}' -f $PullRequest, $headCommit.Substring(0, 12).ToLowerInvariant() if (-not $PSCmdlet.ShouldProcess("$Repository pull request #$PullRequest", "Create $branch, retarget and merge fork head $headCommit, and open a pull request to main")) { return } $stage = 'creating the release branch' $followUpUrl = '' try { $null = Invoke-AvmGitHubApi -Endpoint "repos/$Repository/git/refs" -Method POST -Body @{ ref = "refs/heads/$branch" sha = $mainSha } $stage = 'retargeting the fork pull request' $null = Invoke-AvmGitHubApi -Endpoint $endpoint -Method PATCH -Body @{ base = $branch } $stage = 'checking the retargeted pull request' for ($attempt = 0; $attempt -lt 10; $attempt++) { $current = Invoke-AvmGitHubApi -Endpoint $endpoint if ($current['state'] -cne 'open' -or $current['base']['ref'] -cne $branch -or $current['head']['sha'] -ine $headCommit) { throw [System.InvalidOperationException]::new( 'The pull request state, target, or captured head changed during the handoff.') } if ($current['mergeable_state'] -cne 'unknown') { break } if ($attempt -lt 9) { Start-Sleep -Seconds 2 } } # Unstable means mergeable with pending or failed statuses; the merge endpoint still enforces required protections. if ($current['mergeable'] -ne $true -or $current['mergeable_state'] -cnotin @('clean', 'unstable')) { throw [System.InvalidOperationException]::new( "GitHub reports mergeable_state '$($current['mergeable_state'])'. Resolve required checks, reviews, or conflicts without bypassing protections.") } $releaseRef = "repos/$Repository/git/ref/heads/$branch" $release = Invoke-AvmGitHubApi -Endpoint $releaseRef if ($release['object']['sha'] -ine $mainSha) { throw [System.InvalidOperationException]::new('The release branch changed before the fork merge.') } $stage = 'merging the fork pull request' $merge = Invoke-AvmGitHubApi -Endpoint "$endpoint/merge" -Method PUT -Body @{ sha = $headCommit merge_method = $mergeMethod } if ($merge['merged'] -ne $true -or $merge['sha'] -notmatch '^[a-fA-F0-9]{40}$') { throw [System.InvalidOperationException]::new('GitHub did not confirm the fork pull request was merged.') } $stage = 'verifying the merged release branch' $release = Invoke-AvmGitHubApi -Endpoint $releaseRef if ($release['object']['sha'] -ine $merge['sha']) { throw [System.InvalidOperationException]::new('The release branch no longer points to the reported merge commit.') } $stage = 'opening the follow-up pull request' $followUpBody = @( "Credentialed E2E follow-up for [$Repository#$PullRequest]($originalPullRequestUrl)" "(fork commit ``$headCommit``)." ) -join ' ' $followUpBody += "`n`nThank you @$originalAuthor for your contribution." $originalBody = [string]$pr['body'] if (-not [string]::IsNullOrEmpty($originalBody)) { $followUpBody += "`n`n$originalBody" } $followUp = Invoke-AvmGitHubApi -Endpoint "repos/$Repository/pulls" -Method POST -Body @{ title = "E2E: $($pr['title'])" head = $branch base = 'main' body = $followUpBody } if ([string]::IsNullOrWhiteSpace([string]$followUp['html_url'])) { throw [System.InvalidOperationException]::new('GitHub did not return the follow-up pull request URL.') } $followUpUrl = [string]$followUp['html_url'] if ($Repository -ieq 'Azure/bicep-registry-modules') { $number = $followUp['number'] if ($number -isnot [int] -and $number -isnot [long] -or $number -lt 1) { throw [System.InvalidOperationException]::new('GitHub did not return a valid follow-up pull request number.') } $stage = "adding the E2E label to $followUpUrl" $null = Invoke-AvmGitHubApi -Endpoint "repos/$Repository/issues/$number/labels" -Method POST ` -Body @{ labels = @('PR: Run Required E2E Tests') } } return [pscustomobject]@{ Repository = $Repository OriginalPullRequest = $PullRequest ReleaseBranch = $branch HeadCommit = $headCommit FollowUpPullRequestUrl = $followUpUrl } } catch { throw [System.InvalidOperationException]::new( "Handoff stopped while $stage. Inspect $Repository pull request #$PullRequest and branch $branch before manual recovery; do not blindly rerun. $($_.Exception.Message)", $_.Exception) } } # SIG # Begin signature block # MIInKAYJKoZIhvcNAQcCoIInGTCCJxUCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAHE99JRatCgJm6 # SvqVjGKESH+TFRUZ02SDqHF/WPLlLKCCDLowggX1MIID3aADAgECAhMzAAACHU0Z # 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 # 1cY2L4A7GTQG1h32HHAvfQESWP0xghnEMIIZwAIBATBuMFcxCzAJBgNVBAYTAlVT # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv # c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w # DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ # KoZIhvcNAQkEMSIEIAAbXNAM0BWD/keijm2b5EZWxCxFjJEI/pbr+V8rEA5fMEIG # CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAF336sFhhwwjVYQIv # xnMacwtJvIOh2VjhdwDgn/0VMe0dVrAGOI8K08mwUfy9gXLgOnWcSOyEppGV2+Rt # NNy+D0vTVGT0AwHmcyPvtVo7aZqBKQcp1FweG3r4Vn1FbEy95gMjcaXF95FzwZUS # EkobEopjjCwi7bNyHAhwNJgwAiqRWvR8Q+0PScCrtTTXK3ygo0Z9ldwhnkXb3/Hr # jCjFrnoORtIkpjjnSwoO3FLpKFYGXeRUsFz1hKIWxTYWf8tYMLO7wp1VIn1e+WfR # tZpfbdRD1ygHV8R8OsLxyDqVGmJ/lXhdWWE+1dltw4jhBBAa/qZ7KVBWJQXOgrJA # mp1z0qGCF5QwgheQBgorBgEEAYI3AwMBMYIXgDCCF3wGCSqGSIb3DQEHAqCCF20w # ghdpAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9 # MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCDKMqeOXRaW0oTC # 0eBuqhvAIIOhPY1BOtI5PuHY3ziLzwIGavNM29I8GBMyMDI2MTExOTE2Mjc1Mi42 # NTJaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScw # JQYDVQQLEx5uU2hpZWxkIFRTUyBFU046MzcwMy0wNUUwLUQ5NDcxJTAjBgNVBAMT # HE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WgghHqMIIHIDCCBQigAwIBAgIT # MwAAAh86cGnkojAulQABAAACHzANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt # ZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNjAyMTkxOTM5NTFaFw0yNzA1MTcxOTM5NTFa # MIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQL # ExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxk # IFRTUyBFU046MzcwMy0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l # LVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDL # O8XFOcfGqAqgiz0+AmQmFl3dZ0aTG4UFJkqqNdMHy28DaheCBs6ONufukye5x42C # WkzgRIy9kE2VWwEntZ8ZkgyrykC0bIqsID7+6FxguseTXf1Vwvm1D8104VmetoBJ # lJ4uGbuyJZUvXDx55nVh50ygLTzZ24WkQsnPpvRZv2kPc39f3bhLyHVtnHsa/W/8 # 6Vrftd+AfFveA+qN/EY+XGj5c/DPMXCYECb0arYb92dDJWtwzpyBrp4gfHlgY1UE # pc4l4AGELrf2J4wrxTzTW+SM8XhV1dOOPrYjD080IbZqL8B+IF0RCdn269YXrGK6 # QIHipznKZcCS8jN30YAHnTJVN5Zzs6t/2YsqBGDquvDad7934FFTwzvUcO3VoIyd # 93XWwvP8/SCFVJh21W8oGQTptGHyly+Fl4henVMVZF1v6osOtirX8GFTiEhnf8nR # dOg7yZYAJ0xy9CtDfbXaTn/cf3Lq3N/GCYKFjC+5mUCE+AJhmxMuMdvSUGmKiAFd # iPAjUTqsWWBBZJm0eCwgeGJFmmQA+V7/98BKcE+gUL7O9eWRDQwKeAcvo6rxNv2Y # 4jKrHA6Z/wi3a/fKUhLCNZES8qGdrpDAm7qh+6FjYxytAbkiKM6uTNy/ULPlwtlY # ZoAJDDQP7eYCywwVbNTbHXRBSS+NccC0sSB4W7U67wIDAQABo4IBSTCCAUUwHQYD # VR0OBBYEFNk72sGDlH0r5DwvfGR5XwJI8B7bMB8GA1UdIwQYMBaAFJ+nFV0AXmJd # g/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9z # b2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El # MjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6 # Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGlt # ZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0l # AQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUA # A4ICAQBlbu3IoynnPz0K1iPbeNnsej2b15l5sdl2FAFBBGT9lRdc2gNV8LAIusPY # HHhUvRDcsx4lbMNhVKPGu4TDLaqNt/CI+SFtGuqdRLpVP1XE9cCLyKrKPpcJFJCq # PpV+efoAtYBmIUQcxxwT7WIQ7gag8+rkKvrMkCoRqKS0mKv8J1sKfi85+G2uhZ/1 # RteSVdYZOZOj+Sb4wzonTCTj7EtgMN/BX35W5dTzd7wJdGepYkVi871dSrC2Tr1Z # FzAR7S44drCWZpJ6phJabVNOsNxFJKgSykugOGWzQ318Rr3MTPg2s3Bns+pUPVgM # ijd4bUOH2BlEsLMMwOcolTTZqg1HYrdY1jxpUAI9ipjBQRINL/O705Z+/f2LjNmJ # QooCVJVX24adpZ519SsfazGoqXGt91bmqKo0fI09Il4sUHh4ih6rpiQDBlyL7vmv # CejwVxYevY4qVwTZ/o3gvl+R0lFxYS9feIM4NeG0+WsDZ7jLci5MFeuNwosQY3z2 # 6Xg1oj0U9u+ncR9uTU+xBmJ8BtlCdhQ13RNMX5P+krRYPB3XCp9Jm6XaO1995q32 # AIZm1mzBGI6yHlviXaEC5TzGiO1LXuPtXZU2X93oQJbMoe3v8+5CPKrQalGWyYuh # 2a3V1pwbj+W0FEmEFPpu8TI+qYO1IIQWUSRvFjXth5Ob02hMMjCCB3EwggVZoAMC # AQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNV # BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w # HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29m # dCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIy # NVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp # bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw # b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAw # ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9 # DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2 # Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N # 7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXc # ag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJ # j361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjk # lqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37Zy # L9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M # 269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLX # pyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLU # HMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode # 2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEA # ATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYE # FJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEB # MEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv # RG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEE # AYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB # /zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEug # SaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9N # aWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsG # AQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jv # b0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt # 4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsP # MeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++ # Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9 # QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2 # wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aR # AfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5z # bcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nx # t67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3 # Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+AN # uOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/Z # cGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNNMIICNQIBATCB+aGB0aSBzjCB # yzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl # ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMc # TWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBU # U1MgRVNOOjM3MDMtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1T # dGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQBLIMg1P7sNuCXpmbH2IXT2tXeE # EKCBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3 # DQEBCwUAAgUA7qj+dTAiGA8yMDI2MTExOTA0NDk1N1oYDzIwMjYxMTIwMDQ0OTU3 # WjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDuqP51AgEAMAcCAQACAgSuMAcCAQAC # AhQ7MAoCBQDuqk/1AgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKg # CjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAK53MB5F # r/5+LxWbBX3a6k6llFpI3eYJZx6cm3Bg5Iyz47fxT9QFFyKEBQsJg1j77qvsGAfY # C+PO0GOnAAtkxZgzsgaI+hM561nCm0pJ6pwYC2lmY0KmCrNtci2vO/JysviDHxqG # uf4jOB45I/gRM7yDkRspcfjfQaO53H28XgPYGGEwz4lwwSjJ71/tZcS+p9Qjklrn # OvMACA38TjKMKFb8P4RKWeVbiMk/PcBxeMgA4uMoUtkrjWlirVEejtp4wHV0uuvp # 5WM2XwuszQct95dgYsLvmFoKaq1guy9+cJS+3nWek8TLkENusUg9j/fmhcYe2HzP # IFwtQqqhWg7v6cgxggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UE # CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z # b2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQ # Q0EgMjAxMAITMwAAAh86cGnkojAulQABAAACHzANBglghkgBZQMEAgEFAKCCAUow # GgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCC2DIZ5 # d1IkdCkYWZwe/zPeIfRaVjlEf989sRBLhyo9aDCB+gYLKoZIhvcNAQkQAi8xgeow # gecwgeQwgb0EILAkCt9WkCsMtURkFu6TY0P3UXdRnCiYuPZhe3ykLfwUMIGYMIGA # pH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT # B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE # AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIfOnBp5KIwLpUA # AQAAAh8wIgQgWiJQs/nEhVA2zl8b7w2hMGkhOTIiKPtGicYo/8nGjZUwDQYJKoZI # hvcNAQELBQAEggIAQBEfwsz31HHcLgH/v7dGO3wC5bWm1txo9XegbEvxfw9krb6y # HHrFlZELnExncdcVJKOeEkz5JL2OqfM0bZk7Tj0Btju68hGtfkTH+HZ1tiSgXhQ8 # r6CXFeJN9dvSz7W0LAr4N7bBbB75E49SnkSOfTIv7jU8zSb+Pujg6881ZEUPMe02 # Uq6f6cm19Hc52sbTMR9I/lHOSTl2WXh6zjbLF4jzkV7LA9zfCcn/FZm5Z1JUu9NU # hVPZNR7JFJkD2YQxgp1XGIB5ILzVW8hIKzjN+wHRQqyuLOjL5Ybdd9kqane/PPpQ # N4W6wVEiRav+8T+bs5+xJEaH+DLL34lPtFHiLjjdhTI1soxSXoMx4cPDKcgHLML9 # uPcorOtVbMIjfIKLMH0Ws5ZBtbHUMZZWghlEdsUX7IT+7K5SvWoD3Ao0ZhJhAuwc # g6eCFw6s3/yBTcgnsl7OETmtFHW9zC4MgZpC7XtlhQeaLTVLLw/OuQ5AGPREqaXx # tcdeo+ER3XRufzdv+LHaRpuL/Sv3q7W4hZfdaDc3fl/KEO6qMiBCfDW4/HwEZtWV # Yn/R2GMUijwI+CgtlHT8LKniPnogZ39N5nwqNdhQhpluDcqI0Ud6EDhlV/ZUrwLd # jYQk9mvSNceQLe0EXCJAtUU5//E4Q5RlJSDf4tHPNnTTg4ZqK134jSwVGws= # SIG # End signature block |