src/ALZ/Private/Deploy-Accelerator-Helpers/Get-BootstrapAndStarterConfig.ps1

function Get-BootstrapAndStarterConfig {
    [CmdletBinding(SupportsShouldProcess = $true)]
    param(
        [Parameter(Mandatory = $false)]
        [string]$iac,
        [Parameter(Mandatory = $false)]
        [string]$bootstrap,
        [Parameter(Mandatory = $false)]
        [string]$bootstrapPath,
        [Parameter(Mandatory = $false)]
        [string]$bootstrapConfigPath,
        [Parameter(Mandatory = $false)]
        [string]$toolsPath
    )

    if ($PSCmdlet.ShouldProcess("Get Configuration for Bootstrap and Starter", "modify")) {
        $hasStarterModule = $false
        $starterModuleUrl = ""
        $starterModuleSourceFolder = ""
        $starterReleaseArtifactName = ""
        $starterConfigFilePath = ""

        $bootstrapDetails = $null
        $validationConfig = $null
        $zonesSupport = $null

        # Get the bootstap configuration
        $bootstrapConfigFullPath = Join-Path $bootstrapPath $bootstrapConfigPath
        Write-Verbose "Bootstrap config path $bootstrapConfigFullPath"
        $bootstrapConfig = Get-ALZConfig -configFilePath $bootstrapConfigFullPath
        $validationConfig = $bootstrapConfig.validators.Value

        # Get the supported regions and availability zones
        Write-Verbose "Getting Supported Regions and Availability Zones with Terraform"
        $regionsAndZones = Get-AzureRegionData -toolsPath $toolsPath
        Write-Verbose "Supported Regions: $($regionsAndZones.supportedRegions)"
        $zonesSupport = $regionsAndZones.zonesSupport
        $azureLocationValidator = $validationConfig.PSObject.Properties["azure_location"].Value
        $azureLocationValidator.AllowedValues.Values = $regionsAndZones.supportedRegions

        # Get the available bootstrap modules
        $bootstrapModules = $bootstrapConfig.bootstrap_modules.Value

        # Get the bootstrap details and validate it exists (use alias for legacy values)
        $bootstrapDetails = $bootstrapModules.PsObject.Properties | Where-Object { $_.Name -eq $bootstrap -or $bootstrap -in $_.Value.aliases }
        if($null -eq $bootstrapDetails) {
            Write-InformationColored "The bootstrap type '$bootstrap' that you have selected does not exist. Please try again with a valid bootstrap type..." -ForegroundColor Red -InformationAction Continue
            throw
        }

        # Get the starter modules for the selected bootstrap if it has any
        $bootstrapStarterModule = $bootstrapDetails.Value.PSObject.Properties | Where-Object { $_.Name -eq  "starter_modules" }

        if($null -ne $bootstrapStarterModule) {
            # If the bootstrap has starter modules, get the details and url
            $hasStarterModule = $true
            $starterModules = $bootstrapConfig.starter_modules.Value
            $starterModuleType = $bootstrapStarterModule.Value
            $starterModuleDetails = $starterModules.PSObject.Properties | Where-Object { $_.Name -eq $starterModuleType }
            if($null -eq $starterModuleDetails) {
                Write-InformationColored "The starter modules '$($starterModuleType)' for the bootstrap type '$bootstrap' that you have selected does not exist. This could be an issue with your custom configuration, please check and try again..." -ForegroundColor Red -InformationAction Continue
                throw
            }

            $starterModuleUrl = $starterModuleDetails.Value.$iac.url
            $starterModuleSourceFolder = $starterModuleDetails.Value.$iac.release_artifact_root_path
            $starterReleaseArtifactName = $starterModuleDetails.Value.$iac.release_artifact_name
            $starterConfigFilePath = $starterModuleDetails.Value.$iac.release_artifact_config_file
        }

        return @{
            bootstrapDetails           = $bootstrapDetails
            hasStarterModule           = $hasStarterModule
            starterModuleUrl           = $starterModuleUrl
            starterModuleSourceFolder  = $starterModuleSourceFolder
            starterReleaseArtifactName = $starterReleaseArtifactName
            starterConfigFilePath      = $starterConfigFilePath
            validationConfig           = $validationConfig
            zonesSupport               = $zonesSupport
        }
    }
}