Microsoft.PowerPlatform.DevOps

0.0.0.24

Microsoft.PowerPlatform.DevOps.psm1

Write-Verbose "Importing Functions"

# Import everything in these folders
foreach ($folder in @('private', 'public', 'classes')) {
    
    $root = Join-Path -Path $PSScriptRoot -ChildPath $folder
    if (Test-Path -Path $root) {
        Write-Verbose "processing folder $root"
        $files = Get-ChildItem -Path $root -Filter *.ps1

        # dot source each file
        $files | where-Object { $_.name -NotLike '*.Tests.ps1' } | 
        ForEach-Object { Write-Verbose $_.name; . $_.FullName }
    }
}

if (!(Test-Path "$env:APPDATA\Microsoft.PowerPlatform.DevOps")) {
    New-Item -Path "$env:APPDATA\Microsoft.PowerPlatform.Devops" -ItemType Directory
}
if (!(Test-Path "$env:APPDATA\Microsoft.PowerPlatform.DevOps\devopsConfig.json")) {
    Copy-Item (Join-Path $PSScriptRoot "\devopsConfig.json") -Destination "$env:APPDATA\Microsoft.PowerPlatform.DevOps\devopsConfig.json"
}
$global:configFile = Get-Content ("$env:APPDATA\Microsoft.PowerPlatform.DevOps\devopsConfig.json") | ConvertFrom-Json
$global:version = Get-ManifestValue (Join-Path $PSScriptRoot "\Microsoft.PowerPlatform.DevOps.psd1") -PropertyName 'ModuleVersion' -Passthru
$global:projectFile = "False"
$global:gitRepo = ""

if ($global:projectFile -eq "False") {
    $global:projectTitle = "(No Project Selected)"
}
else {
    $global:projectTitle = $global:projectFile.gitRepo
}

$global:logo = @"
____ ____ _ _ __ ____ ___
| _ \ _____ _____ _ __ | _ \| | __ _| |_ / _| ___ _ __ _ __ ___ | _ \ _____ __/ _ \ _ __ ___
| |_) / _ \ \ /\ / / _ \ '__| | |_) | |/ _` | __| |_ / _ \| '__| '_ ` _ \ | | | |/ _ \ \ / / | | | '_ \/ __|
| __/ (_) \ V V / __/ | | __/| | (_| | |_| _| (_) | | | | | | | | | |_| | __/\ V /| |_| | |_) \__ \
|_| \___/ \_/\_/ \___|_| |_| |_|\__,_|\__|_| \___/|_| |_| |_| |_| |____/ \___| \_/ \___/| .__/|___/
                                                                                                  |_|
 
"@

$global:message = @"
 
Welcome to the Power Platform DevOps configuration script.
 
 ver: $global:version
 project: $global:projectTitle
 
"@

function Install-PreReqs {
    $message = "Checking Pre-requisites"
    Write-Host $message

    try {
        Invoke-InstallPreRequisites
        $global:configfile.PreReqsComplete = "True"
    }
    catch {
        $global:configfile.PreReqsComplete = "Error"
        pause
    }
    $global:configfile | ConvertTo-Json | Set-Content ("$env:APPDATA\Microsoft.PowerPlatform.DevOps\devopsConfig.json")
   
}

function Connect-AzureDevOps {
    $message = "Configuring Azure DevOps"
    Write-Host $message

    try {
        Invoke-AzureDevOps
        $global:projectFile.ADOConfigured = "True"
    }
    catch {
        $global:projectFile.ADOConfigured = "Error"
        pause
    }
    $global:projectFile | ConvertTo-Json | Set-Content ("$env:APPDATA\Microsoft.PowerPlatform.Devops\$global:gitRepo\$global:gitRepo.json") 
   
}

function Add-Solution {
    $message = "Adding D365 / CDS Solution"
    Write-Host $message

    try {
        Invoke-AddSolution
        $global:projectFile.SolutionAdded = "True"
    }
    catch {
        $global:projectFile.SolutionAdded = "Error"
        pause
    }
    $global:projectFile | ConvertTo-Json | Set-Content ("$env:APPDATA\Microsoft.PowerPlatform.Devops\$global:gitRepo\$global:gitRepo.json")
   
}

function Add-CICDEnvironment {
    $message = "Configuring CI/CD Environment"
    Write-Host $message

    try {
        Invoke-ConfigureCICD
    }
    catch {
        $global:projectFile.CICDEnvironmentName = "Error"
        pause
    }
    $global:projectFile | ConvertTo-Json | Set-Content ("$env:APPDATA\Microsoft.PowerPlatform.Devops\$global:gitRepo\$global:gitRepo.json")
   
}

function Add-Project {
    $message = "Adding PowerPlatform DevOps Project"
    Write-Host $message
    if ($global:configfile.Projects.Count -gt 1 -or $global:configfile.Projects[0].ID -ne "placeholder") {
        do {
            $createOrSelect = Read-Host "Do you want to [S]elect and Existing Project or [C]reate a new one? ([Q]uit)"
            switch ($createOrSelect) {
                'C' { Add-GitRepo }
                'S' { Select-GitRepo }
            }
        } until (($createOrSelect -eq 'q') -or ($createOrSelect -eq 'c') -or ($createOrSelect -eq 's'))
    }
    else {
        Add-GitRepo
    }
    try {
    }
    catch {
        $global:projectFile.SolutionAdded = "Error"
        pause
    }
    #$global:projectFile | ConvertTo-Json | Set-Content ("$env:APPDATA\Microsoft.PowerPlatform.Devops\$global:gitRepo\$global:gitRepo.json")
    $global:configfile | ConvertTo-Json | Set-Content ("$env:APPDATA\Microsoft.PowerPlatform.DevOps\devopsConfig.json")
   
}

function Export-Solution {
    if ($global:projectFile.CDSSolutions.Count -gt 0) {
        $options = $global:projectFile.CDSSolutions | ForEach-Object { $_.SolutionName }

        do {
            $sel = Invoke-Menu -MenuTitle "---- Please Select the Solution to Export and Unpack ------" -MenuOptions $options
            $selectedSolution = $global:projectFile.CDSSolutions[$sel].SolutionName
        } until ($selectedSolution -ne "")

        Write-Host $selectedSolution
        Write-Host $global:projectFile.ProjectLocation
        Set-Location -Path "$($global:projectFile.ProjectLocation)\$selectedSolution\Scripts"
        if ($global:projectFile.ADOConfigured -eq "True") {
            try {
                git pull origin
            }
            catch {
                pause
            }            
        }
        & .\SolutionExport.ps1
        Set-Location -Path $global:projectFile.ProjectLocation
    }
}

function Sync-Solution{
    $commitMessage = Read-Host "Enter a description for your Commit"
        git add -A
        git commit -m $commitMessage    
    if ($global:projectFile.ADOConfigured -eq "True") {
            git push origin
    }
    pause
}

function Show-SolutionChanges{
    git status
    pause
}

function Enable-AzureDeploy{
    if ($global:projectFile.ARMAdded -ne "True") {
        Copy-Item -Path (Join-Path $PSScriptRoot Snippets\AzureResources\.) -Destination $global:projectFile.ProjectLocation -Recurse -Force
        $buildYAML = Get-Content -Path "$($global:projectFile.ProjectLocation)\Build.yaml"
        $azureYAML = Get-Content -Path  (Join-Path $PSScriptRoot Snippets\AzureDeploy.yaml)
        $azureYAML = $azureYAML.Replace('replaceRepo', $global:projectFile.gitRepo)
        $buildYAML + $azureYAML | Set-Content -Path  "$($global:projectFile.ProjectLocation)\Build.yaml"

        $azureParams = Get-Content -Path "$($global:projectFile.ProjectLocation)\AzureResources\azuredeploy.parameters.json"
        $azureParams = $azureParams.Replace('AddName', $global:projectFile.gitRepo)
        $azureParams |  Set-Content -Path "$($global:projectFile.ProjectLocation)\AzureResources\azuredeploy.parameters.json"

        $adoOrg = $global:projectFile.ADOOrgName
        $adoProject = $global:projectFile.ADOProject
        $adoRepo = $global:projectFile.gitRepo.ToLower()
        $varGroupAzure = az pipelines variable-group create --organization https://dev.azure.com/$adoOrg --project $adoProject --name "$($global:projectFile.gitRepo).AzureEnvironment"  --variables AzureResourceGroup="" --authorize $true | ConvertFrom-Json
        az pipelines variable-group variable create --organization https://dev.azure.com/$adoOrg --project $adoProject --name AzureAppInsightsName --value "$adoRepo-staging-ai" --group-id $varGroupAzure.id
        az pipelines variable-group variable create --organization https://dev.azure.com/$adoOrg --project $adoProject --name AzureLocation --value "australiaeast" --group-id $varGroupAzure.id
        az pipelines variable-group variable create --organization https://dev.azure.com/$adoOrg --project $adoProject --name AzureStorageAccountName --value "$adoRepo-staging" --group-id $varGroupAzure.id
        az pipelines variable-group variable create --organization https://dev.azure.com/$adoOrg --project $adoProject --name AzureFunctionAppName --value "$adoRepo-staging-fna" --group-id $varGroupAzure.id
        az pipelines variable-group variable create --organization https://dev.azure.com/$adoOrg --project $adoProject --name AzureWebAppName --value "$adoRepo-staging-wba" --group-id $varGroupAzure.id
        az pipelines variable-group variable create --organization https://dev.azure.com/$adoOrg --project $adoProject --name WorkspaceName --value "$adoRepo-staging-log" --group-id $varGroupAzure.id
        az pipelines variable-group variable create --organization https://dev.azure.com/$adoOrg --project $adoProject --name AzureKeyVaultName --value "$adoRepo-staging-kv" --group-id $varGroupAzure.id
        $global:projectFile.ARMAdded = "True"
        $global:projectFile | ConvertTo-Json | Set-Content ("$env:APPDATA\Microsoft.PowerPlatform.Devops\$global:gitRepo\$global:gitRepo.json")
        Write-Host "Please make sure you follow the instructions for configuring a Service Connection in Azure DevOps, as detailed in $($global:projectFile.ProjectLocation)\AzureResources\Instructions.md" -ForegroundColor Yellow
        pause
    }
    else {
        Write-Host "Azure Deployment Already Enabled for this Project"
        pause
    }   
}

function Enable-FunctionApp{
    if ($global:projectFile.FunctionAppAdded -ne "True") {
        Copy-Item -Path (Join-Path $PSScriptRoot Snippets\FunctionApp\.) -Destination $global:projectFile.ProjectLocation -Recurse -Force
        dotnet sln $global:gitRepon.sln add FunctionApp\FunctionApp.csproj
        $global:projectFile.FunctionAppAdded = "True"
        $global:projectFile | ConvertTo-Json | Set-Content ("$env:APPDATA\Microsoft.PowerPlatform.Devops\$global:gitRepo\$global:gitRepo.json")
        pause
    }
    else {
        Write-Host "Function App Already Enabled for this Project"
        pause
    }   
}

function Show-Menu {
    param (
        [string]$Title = 'Power Platform DevOps'
    )
    $devopsConfigMessage = "(ADO Org : $($global:projectFile.ADOOrgName) | ADO Project : $($global:projectFile.ADOProject) | git Repo : $($global:projectFile.gitRepo))"
    $CICDConfigMessage = "(CI/CD Environment : $($global:projectFile.CICDEnvironmentName) | CI/CD URL : $($global:projectFile.CICDEnvironmentURL))"
    if ($global:projectFile -eq "False") {
        $Title = "Power Platform DevOps (No Project Selected)"
    }
    else {
        $Title = "Power Platform DevOps ($($global:projectFile.gitRepo))"
        $global:projectTitle = $global:projectFile.gitRepo
        Set-Location $global:projectFile.ProjectLocation
    }
    [console]::ForegroundColor = "White"
    Clear-Host
    Write-Host $global:logo -ForegroundColor Magenta
    Write-Host $global:message -ForegroundColor White
    $Repeater = "=" * $Title.Length
    Write-Host "================ $Title ================" -ForegroundColor White
    
    Write-Host "1: Run Pre-requisite checks (Install / Update)." -ForegroundColor (Set-Colour $global:configfile.PreReqsComplete)
    if (($global:configfile.PreReqsComplete -eq "True")) {
        Write-Host "2: Create a New Project or Select and Existing One" -ForegroundColor (Set-Colour $global:projectFile)    
    }    
    if (!($global:projectFile -eq "False") -and ($global:configfile.PreReqsComplete -eq "True")) {
        Write-Host "3: Configure Azure DevOps" $devopsConfigMessage -ForegroundColor (Set-Colour $global:projectFile.ADOConfigured)
        Write-Host "4: Add New D365 / CDS Solution." -ForegroundColor (Set-Colour $global:projectFile.SolutionAdded)
        if ($global:projectFile.ADOConfigured -eq "True" -and $global:projectFile.SolutionAdded -eq "True") {
            Write-Host "5: Configure Continuous Deployment" $CICDConfigMessage -ForegroundColor (Set-Colour $global:projectFile.CICDEnvironmentName)        
        }
        Write-Host "A: Enable [A]zure Resource Management Deployment." -ForegroundColor (Set-Colour $global:projectFile.ARMAdded)
        Write-Host "F: Add Azure [F]unction App Project." -ForegroundColor (Set-Colour $global:projectFile.FunctionAppAdded)
        if ($global:projectFile.SolutionAdded -eq "True") {
            Write-Host "D: Add Additional [D]365 / CDS Solutions" -ForegroundColor Cyan
            Write-Host "E: [E]xport & Unpack Solution to Source Control" -ForegroundColor Cyan
            Write-Host "S: Commit and [S]ync changes to Source Control" -ForegroundColor Cyan
            Write-Host "V: [V]iew current change log for Source Control" -ForegroundColor Cyan
        }
        if ($global:projectFile.CICDEnvironmentName -ne "False") {
            Write-Host "T: Add Additional Deployment Environment [T]arget" -ForegroundColor Cyan
        }
    }
    Write-Host "Q: Press 'Q' to quit." -ForegroundColor White
    Write-Host "=================$Repeater=================" -ForegroundColor White
    Write-Host ""
    Write-Host "* (White items still need to be completed)" -ForegroundColor White
    Write-Host "* (Green items are successful)" -ForegroundColor Green
    Write-Host "* (Red items have Errors)" -ForegroundColor Red
    Write-Host "* (Purple items are optional)" -ForegroundColor Magenta
    Write-Host "* (Blue Items are used for Day-to-Day ALM)" -ForegroundColor Cyan
    Write-Host ""
}

function Invoke-PowerPlatformDevOps {
    Write-Host ""
    [console]::ForegroundColor = "White"
    do {
        $global:configFile = Get-Content ("$env:APPDATA\Microsoft.PowerPlatform.DevOps\devopsConfig.json") | ConvertFrom-Json
        if ($global:projectFile -ne "False") {
            $global:gitRepo = $($global:projectFile.gitRepo)
            Set-Location $global:projectFile.ProjectLocation
        }
        Show-Menu

        $selection = Read-Host "Please make a selection"
        switch ($selection) {
            '1' {
                Install-PreReqs
            } '2' {
                Add-Project
            } '3' {
                Connect-AzureDevOps
            } '4' {
                Add-Solution
            } '5' {
                Add-CICDEnvironment
            } 'D' {
                Add-Solution
            } 'E' {
                Export-Solution
            } 'S' {
                Sync-Solution
            } 'V' {
                Show-SolutionChanges
            } 'T' {
                Add-TargetEnvironment
            } 'A' {
                Enable-AzureDeploy
            } 'F' {
                Enable-FunctionApp
            }
        }
            Write-Host ""
        }
        until ($selection -eq 'q')
    }

    Export-ModuleMember -Function 'Invoke-PowerPlatformDevOps'
    #, 'Add-CICDEnvironment', 'Add-Solution', 'Connect-AzureDevOps', 'Install-PreReqs'