Engines/Bicep/Invoke-AvmBicepCheckConvention.ps1
|
function Invoke-AvmBicepCheckConvention { <# .SYNOPSIS Run convention checks against a Bicep module. .DESCRIPTION Checks layout, versions, changelogs, compiled ARM templates, checked-in main.json drift, e2e test sources, and applicable workflows across root and child modules without modifying them. The separate required docs step in pr-check checks README regeneration and render completeness. .PARAMETER Context Module context produced by Get-AvmModuleContext. Must have Ecosystem='bicep'. .PARAMETER AllowPathFallback Permit a PATH-resolved Bicep CLI matching the pinned version. .OUTPUTS pscustomobject with Engine, Tool, ToolPath, ToolSource, Status, UncoveredFamilies, and Issues. #> [CmdletBinding()] [OutputType([pscustomobject])] param( [Parameter(Mandatory)] $Context, [switch] $AllowPathFallback, [switch] $PreparationOnly, [AllowEmptyCollection()] [object[]] $SelectedScope ) Set-StrictMode -Version 3.0 $ErrorActionPreference = 'Stop' if ($Context.Ecosystem -ne 'bicep') { throw [System.ArgumentException]::new( "Invoke-AvmBicepCheckConvention requires a bicep context (got Ecosystem='$($Context.Ecosystem)').") } $issues = [System.Collections.Generic.List[object]]::new() $scopes = [System.Collections.Generic.List[object]]::new() $moduleScopes = @(if ($PSBoundParameters.ContainsKey('SelectedScope')) { $SelectedScope } else { Get-AvmMetadataScope -Context $Context -IncludeModuleDirectories }) foreach ($module in @($moduleScopes)) { $scope = Get-AvmBicepConventionScope -Path $module.Path if ($null -eq $scope) { $issues.Add((New-AvmBicepConventionIssue -Root $Context.Root ` -Path (Join-Path $module.Path 'main.bicep') -Code 'avm.bicep.scope' ` -Message 'Bicep convention checks require modules under avm/res, avm/ptn, or avm/utl.')) continue } $scopes.Add($scope) } if ($scopes.Count -eq 0 -and $issues.Count -eq 0) { $issues.Add((New-AvmBicepConventionIssue -Root $Context.Root ` -Path $Context.Root -Code 'avm.bicep.scope' ` -Message 'No Bicep module scopes were discovered for convention checks.')) } $serviceShortIndex = @{} if ($scopes.Count -gt 0) { $testFiles = @() try { $testFiles = @(Get-AvmBicepRepositoryTestFile -RepositoryRoot $scopes[0].RepositoryRoot) } catch [System.IO.IOException], [System.UnauthorizedAccessException], [System.Management.Automation.ActionPreferenceStopException] { $issues.Add((New-AvmBicepConventionIssue -Root $Context.Root ` -Path $scopes[0].RepositoryRoot -Code 'avm.bicep.test-discovery' ` -Message "Repository-wide e2e test discovery failed; serviceShort uniqueness cannot be checked: $($_.Exception.Message)")) } foreach ($testFile in $testFiles) { $source = Get-AvmBicepCommentFreeSource -Source ([System.IO.File]::ReadAllText($testFile.FullName)) $short = [regex]::Match( $source, "(?m)^[ \t]*param[ \t]+serviceShort[ \t]+string[ \t]*=[ \t]*'(?<value>[^'\r\n]*)'") if (-not $short.Success) { continue } $value = $short.Groups['value'].Value if (-not $serviceShortIndex.ContainsKey($value)) { $serviceShortIndex[$value] = [System.Collections.Generic.List[string]]::new() } $serviceShortIndex[$value].Add($testFile.FullName) } } $sources = [System.Collections.Generic.List[object]]::new() $compiledModules = [System.Collections.Generic.List[object]]::new() $compiledTests = [System.Collections.Generic.Dictionary[string, object]]::new( [System.StringComparer]::Ordinal) foreach ($scope in $scopes) { $main = @(Get-ChildItem -LiteralPath $scope.Path -Force | Where-Object { $_.Name -ceq 'main.bicep' }) if ($main.Count -eq 1 -and -not $main[0].PSIsContainer -and -not ($main[0].Attributes -band [System.IO.FileAttributes]::ReparsePoint)) { $sources.Add([pscustomobject]@{ Path = $main[0].FullName Scope = $scope IsTest = $false }) } elseif (@($main | Where-Object { $_.Attributes -band [System.IO.FileAttributes]::ReparsePoint }).Count -gt 0) { $issues.Add((New-AvmBicepConventionIssue -Root $Context.Root ` -Path (Join-Path $scope.Path 'main.bicep') ` -Code 'avm.bicep.compiled-source-file' ` -Message 'Linked main.bicep files cannot be compiled for convention checks.')) } $testsPath = Join-Path $scope.Path 'tests' if (-not (Test-Path -LiteralPath $testsPath -PathType Container)) { continue } foreach ($testFile in @(Get-ChildItem -LiteralPath $testsPath -File -Recurse -Filter 'main.test.bicep')) { if ($testFile.Name -cne 'main.test.bicep' -or ($testFile.Attributes -band [System.IO.FileAttributes]::ReparsePoint)) { $issues.Add((New-AvmBicepConventionIssue -Root $Context.Root ` -Path $testFile.FullName -Code 'avm.bicep.test-source-file' ` -Message 'An e2e test source must be a regular main.test.bicep with exact casing.')) continue } $sources.Add([pscustomobject]@{ Path = $testFile.FullName Scope = $scope IsTest = $true }) } } $tool = $null $compiledCount = 0 if ($sources.Count -gt 0) { try { $tool = Resolve-AvmTool -Name 'bicep' -ModuleRoot $Context.Root -AllowPathFallback:$AllowPathFallback } catch [AvmToolException] { $issues.Add((New-AvmBicepConventionIssue -Root $Context.Root ` -Path $Context.Root -Code 'avm.bicep.compiler-unavailable' ` -Message "Compiled checks could not run: $($_.Exception.Message)")) } catch [AvmConfigurationException] { $issues.Add((New-AvmBicepConventionIssue -Root $Context.Root ` -Path $Context.Root -Code 'avm.bicep.compiler-unavailable' ` -Message "Compiled checks could not run: $($_.Exception.Message)")) } } if ($null -ne $tool) { foreach ($sourceFile in $sources) { $template = $null try { $json = Get-AvmBicepCompiledJson -SourcePath $sourceFile.Path -ToolPath $tool.Path $template = $json | ConvertFrom-Json -AsHashtable -Depth 1024 -ErrorAction Stop } catch [AvmConfigurationException] { $issues.Add((New-AvmBicepConventionIssue -Root $Context.Root ` -Path $sourceFile.Path -Code 'avm.bicep.compile' ` -Message $_.Exception.Message)) continue } catch [AvmProcessException] { $issues.Add((New-AvmBicepConventionIssue -Root $Context.Root ` -Path $sourceFile.Path -Code 'avm.bicep.compile' ` -Message $_.Exception.Message)) continue } $compiledCount++ if ($sourceFile.IsTest) { $compiledTests[$sourceFile.Path] = $template continue } $compiledModules.Add([pscustomobject]@{ Path = $sourceFile.Path Scope = $sourceFile.Scope Template = $template Json = $json }) } } $apiSpecs = $null $apiSpecsUnavailableReason = '' if ($compiledModules.Count -gt 0) { try { $apiSpecs = Get-AvmBicepApiSpecList } catch [AvmConfigurationException] { $apiSpecsUnavailableReason = $_.Exception.Message } } $repositoryRoot = if ($scopes.Count -gt 0) { $scopes[0].RepositoryRoot } else { $Context.Root } $reservationMap = @(Get-ChildItem -LiteralPath $repositoryRoot -Force | Where-Object { $_.Name -ieq '.reserved-test-subscriptions.json' }).Count -gt 0 $workflows = @(foreach ($scope in $scopes) { if ($scope.IsTopLevel) { $required = $false if ($reservationMap) { $required = (Get-AvmBicepTestSubscriptionTag -RepositoryRoot $repositoryRoot ` -ModulePath $scope.ModuleRelativePath -AllowNonCanonicalModulePath) -cne 'General' } $workflowInput = Get-AvmBicepConventionWorkflowInput -Scope $scope -Required:$required if ($null -ne $workflowInput) { [pscustomobject]@{ Scope = $scope; Input = $workflowInput } } } }) $publication = if ($scopes.Count -gt 0) { Get-AvmBicepPublicationInput -RepositoryRoot $repositoryRoot -Scopes $scopes.ToArray() } $convention = @{ Root = $Context.Root RepositoryRoot = $repositoryRoot Scopes = $scopes.ToArray() CompiledModules = $compiledModules.ToArray() ApiSpecs = $apiSpecs ApiSpecsUnavailableReason = $apiSpecsUnavailableReason ServiceShortIndex = $serviceShortIndex CompiledTests = $compiledTests TestSources = @($sources | Where-Object IsTest) Workflows = $workflows Publication = $publication } if ($PreparationOnly) { return [pscustomobject]@{ Convention = $convention; Issues = $issues.ToArray() } } foreach ($issue in @(Invoke-AvmBicepConventionSuite -Convention $convention)) { $issues.Add($issue) } $status = if (@($issues | Where-Object { $_.Severity -eq 'error' }).Count -gt 0) { 'fail' } else { 'pass' } return [pscustomobject][ordered]@{ Engine = 'bicep' Tool = 'avm-bicep-convention/1' ToolPath = $null ToolSource = 'builtin' Status = $status ScopesChecked = $scopes.Count CompiledFiles = $compiledCount CompilerSource = if ($null -ne $tool) { $tool.Source } else { 'not-run' } UncoveredFamilies = @() Issues = $issues.ToArray() } } # SIG # Begin signature block # MIInRAYJKoZIhvcNAQcCoIInNTCCJzECAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCADLP8sqJaD1pQB # 1T7GgM76/V+7IP9klC+Gu9QzITqkkKCCDLowggX1MIID3aADAgECAhMzAAACHU0Z # 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 # KoZIhvcNAQkEMSIEIBeySPI2FgIwgHw4h38jPH3dzlhtWCwRc4voE1mkafnNMEIG # CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAEVLnp/K1kemK1thD # XnwpYtLYnDeUQ0Z2gQ103IDb8VrL1jw8cBj7zUdhuM/4yYqnLjCsOgXyazuTg2Xo # gyPxUNvzV5v3KydMdmam3B1ZyWQ5FhD7iMpm5gZMUoiB1eygTVtW3nFxChITGmOQ # CLZQC1Uddw3pnDbb+iJLhzLE7y3q+UI+DFfsnWZk5DHDcDT3S0/gHL1scD/OJHg7 # DIhGp504TJwAuR2q1N6uDg+xJgR3tlszEELT5RfgLFmPudXbCNxFHG+ccNMA51o7 # mykj3pVx8F7XgUhlCEuStd7rNSTsqiSKAmodfYnN95J1vdsiFRocdzUJAiA637x/ # /To8b6GCF7AwghesBgorBgEEAYI3AwMBMYIXnDCCF5gGCSqGSIb3DQEHAqCCF4kw # gheFAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFF # MIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCDGKhn0z3GpwOdv # BiwJSeILBjI/tmm0xSMDkEaeAZhuDQIGavNsx/peGBMyMDI2MTExODE0MDQ0OC4y # NzJaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExp # bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo1OTFBLTA1RTAtRDk0NzEl # MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEf4wggcoMIIF # EKADAgECAhMzAAACOPeExYQrvuTkAAEAAAI4MA0GCSqGSIb3DQEBCwUAMHwxCzAJ # BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv # c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI2MTAxNTE4Mzc0N1oXDTI4MDEx # MTE4Mzc0N1owgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # LTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEn # MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjU5MUEtMDVFMC1EOTQ3MSUwIwYDVQQD # ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEF # AAOCAg8AMIICCgKCAgEA2MOivQEGtNYbHgPy00WxDXNmTiCuVc4GmuX93fCp++un # uNZbJiapk46/m7ew099uVq+gGyxjONiUyhtz2RT7nUeZJfH+XRdestUV+ARUZKwf # za81YtaoCggv2b6G74j2xjv+Vlzjghxm52ur6th3/O3x/QP01fU48MNYhzmWSt89 # Poo8RfazS22BbccRgznMI//jSlcj9O3EnmJiwvN2WYpdJQ11nKZlJv8P+kBPdDp8 # 0IT5ew1ESWdIVol/IdOQ0RiMEkLG9dEU2LyAj/DUDLw3DHrjev+TdhJJ3UloT0or # v/0Dic2onOLqKtV56HC/tzrEYNMbJU6PCfQ4jmd6S+wfp+QP0xk95evu7OJ331eY # mKCeANmI/vkFS1R72sEcQr5kUKLgY+7ZgLVTm88hHb7W3bLVn+2mPta49ZYQoap2 # mJHTWA8EaMVUh8hX/WTAvDyCD6ImqPWtEQFS40ZyTIrZkCiwnhY+3Pg1HmEfrFHs # BuHvAVQlKel6x/NPAHPnysDtlLlJWfFbVPZ76pCA9X0DKMQZq9a/wJtdK7ij7TVX # n+3FDPt3h1PPJbazRkrkNfI/ZxG+0ZsRXHhZ+LjgMaIfNru6h70Qis5p9shoXniw # DBqE6FLM44OUyYCaIdu7lR61s0QPD4zxoudVtMSK9Trzi/St5ljBwIpoUKv1wTEC # AwEAAaOCAUkwggFFMB0GA1UdDgQWBBRNlXqM3IU6RTBleg/8dkZfV0LsujAfBgNV # HSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5o # dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBU # aW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG # CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRz # L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNV # HRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIH # gDANBgkqhkiG9w0BAQsFAAOCAgEAYOPgwQS3fsWuTAjWtVEfANixy5SxCbC0tCBE # uTHHr17RVpCrxUtLq+medVrelcLCe2nlnCtsb8wAmt8S0A7NjTBUp8TAMgqTTeW+ # ILamzRZhAtCtk9mvlzPGn29flXKNiV7Ag39A5LH97/2MbKG2KprF6F1BUtQO0Lw6 # Vg0TU9tZh3weqDzBp5M+WY0tV9cj9hTO9A9RnJNWjLkVW5+a1igErtUaPEj7j6jt # T7MJiecBO7Me1uMf8dU1lzdyX60S2nsVlHgSi/g6LQbZvIUYNwcWPWDIBloPxXS5 # uXdrHen4nd33GYsszLBUo/WNy+rxdWwGkPyMFeZDMEnMfFpW6U2S+rWvY2cTGkOi # 0x7K6b24eHNXBXJDahLfwV4g+11y2uKVJqhlpJrrCJb6FtCb8TMuzaDh5LVPkjVw # hRJWdCbJ4NuqRawgVQ0uejIFdqQtkFXRq3ZoePoNym1vAm0P1/r2rmpiXlTuk8B/ # sUxaf/9VCa0VV3lBeoYZh+1j6ODgbZpymM8FcZtkDt4NDzXTQTbhceBZR0Og0v50 # IIALinMkFfOehpsHA6YAHQTaAZja3VXs0GWuCfguVo3S7gXiFJGij34VSfreEZHN # ocpOrj6mKmDto+Wn4m2KQFPJn5fZAe3b2i2/WNnIroOCxRMI24NkJpRc+9e/vSk2 # ai1SpiEwggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3 # 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 # bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo1OTFBLTA1RTAtRDk0NzEl # MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsO # AwIaAxUAXPgoYQ+rQcHbG0c5gV8e8Qwz2+WggYMwgYCkfjB8MQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt # ZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAO6nzYgwIhgPMjAyNjEx # MTgwNzA4NTZaGA8yMDI2MTExOTA3MDg1NlowdzA9BgorBgEEAYRZCgQBMS8wLTAK # AgUA7qfNiAIBADAKAgEAAgIHCQIB/zAHAgEAAgISVTAKAgUA7qkfCAIBADA2Bgor # BgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAID # AYagMA0GCSqGSIb3DQEBCwUAA4IBAQAXRhDrbjGeXwImyU/pcxsNyvQ5ep5kIUDo # PJH3uGppKVyyfWzxnar2WqCfCx6A99Xf6Cj9jMr8qt4NQuphF2i/IRG14TfhqsRP # I71OvV2/YK0Nvb5riJOWCY4Z+THXOauJ+B/UXeq2zbyWbCSaW1Qn0oyqjENWf8yv # KUY9PCla7vRo6fcqwq0yX2dZnPkn+Y+ZhfN3tq5ufGHqJy+hvJqjQHxFOh9kUDwp # DVcq1wxpooD4ocLh5KhvbkRNEvfhnEErHBXiWZXYfLYYQGMRWXOV5+5XIaoJ/TVo # 8GNmVT3WqKruGCd4O269fNKMzOn/7g72fpfcfkZxXUJpn7gLtZYBMYIEDTCCBAkC # AQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV # BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG # A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAI494TFhCu+ # 5OQAAQAAAjgwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG # 9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgGoCc8H1A/tifKt8qijEZmSKDu8pOBTm4 # dV1RgtHI49IwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCAOesQgNA6qoTu3 # 9dvD8EPut6/Kf62NgdKuWPGLWwnitTCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0 # YW1wIFBDQSAyMDEwAhMzAAACOPeExYQrvuTkAAEAAAI4MCIEILUPmMwJKtWW1W/z # h65LeTGMIzSJ0ZgWnv7P6t+8tdvoMA0GCSqGSIb3DQEBCwUABIICAMngagq18uhU # 30Gma9aJEoOME3WTyW+Z9CjGNsYqYhqgXuerrIy6ho/+UMChqEdm7OvEReglpUix # 28foBIKBrxfCth5c+mF4oc9yTcR8O1iGeIHpB6VKu0bzSD9Ai/Xjud64fxST4r6q # mT7UXVppFpsUXjBrEf0rMzOZsUgoyX2gfE8pIp2rrW4XhMEHFDAbtsD46m21Sk+i # sHH4aOjqmiPpnE0240hn0HeJNeiJUodBAbLFDwPy07vze17wusRjEKdj6zKjPWWV # NaxYYDtyPUiaPyOrmynPOLHJ+lKX8Cy6efkLe+uaF0sc36UgBL0YoXM21J3kI+W1 # hwI5NBYvTu0XiIXanQ05v+Axa9kRA25BtTv9ryT5dOMGABUDsi9hg9zhFKnpVUVV # 2N+Wc5f3ZvO1IfEsjGDuyOotuYhvWYM6YBtGNsAKHafRfzhWM9KY4v8PosT+32xL # 3On5VIn1EhBNLsUWvUDaaDAsdNM5VM3D1alQmGtQyvy9ioewgJKd+5LABbqSlazg # fKy11sybuSsuWP1MQlqPacqyenGtRU6uZgRCPyelI6ComD2pc+4SY4JrcmBEROzK # dSxZYc9M/jlb7/UQO6C2c4dZN1QiLU1d2ilu+JQyoNmp/KnelZE0eBwYZS2f1oNm # pk2Yhw+CvOBh8aoMSACBk6yAf9gyc5qR # SIG # End signature block |