Public/New-ALZEnvironment.ps1
|
function New-ALZEnvironment { <# .SYNOPSIS This function prompts a user for configuration values and modifies the ALZ Bicep configuration files accordingly. .DESCRIPTION This function will prompt the user for commonly used deployment configuration settings and modify the configuration in place. .PARAMETER alzBicepSource The directory containing the ALZ-Bicep source repo. .PARAMETER alzEnvironmentDestination The directory where the ALZ environment will be created. .PARAMETER alzBicepVersion The version of the ALZ-Bicep module to use. .PARAMETER alzIacProvider The IaC provider to use for the ALZ environment. .PARAMETER userInputOverridePath A json file containing user input overrides for the user input prompts. This will cause the tool to by pass requesting user input for that field and use the value(s) provided. E.g { "starter_module": "basic", "azure_location": "uksouth" } .PARAMETER autoApprove Automatically approve the terraform apply. .PARAMETER destroy Destroy the terraform environment. .EXAMPLE New-ALZEnvironment .EXAMPLE New-ALZEnvironment .EXAMPLE New-ALZEnvironment -alzEnvironmentDestination "." .EXAMPLE New-ALZEnvironment -alzEnvironmentDestination "." -alzBicepVersion "v0.16.4" #> [CmdletBinding(SupportsShouldProcess = $true)] param ( [Parameter(Mandatory = $false)] [Alias("Output")] [Alias("OutputDirectory")] [Alias("O")] [string] $alzEnvironmentDestination = ".", [Parameter(Mandatory = $false)] [Alias("alzBicepVersion")] [Alias("version")] [Alias("v")] [string] $alzVersion = "latest", [Parameter(Mandatory = $false)] [ValidateSet("bicep", "terraform")] [Alias("Iac")] [Alias("i")] [string] $alzIacProvider = "bicep", [Parameter(Mandatory = $false)] [ValidateSet("github", "azuredevops")] [Alias("Cicd")] [Alias("c")] [string] $alzCicdPlatform = "github", [Parameter(Mandatory = $false)] [Alias("inputs")] [string] $userInputOverridePath = "", [Parameter(Mandatory = $false)] [switch] $autoApprove, [Parameter(Mandatory = $false)] [switch] $destroy ) Write-InformationColored "Getting ready to create a new ALZ environment with you..." -ForegroundColor Green -InformationAction Continue if ($PSCmdlet.ShouldProcess("Accelerator setup", "modify")) { if ($alzIacProvider -eq "bicep") { New-ALZEnvironmentBicep -alzEnvironmentDestination $alzEnvironmentDestination -alzVersion $alzVersion -alzCicdPlatform $alzCicdPlatform } if($alzIacProvider -eq "terraform") { New-ALZEnvironmentTerraform -alzEnvironmentDestination $alzEnvironmentDestination -alzVersion $alzVersion -alzCicdPlatform $alzCicdPlatform -userInputOverridePath $userInputOverridePath -autoApprove:$autoApprove.IsPresent -destroy:$destroy.IsPresent } } return } |