Add download pipeline file and openapi download script

Author: George Ndungu

.azure-pipelines/download-openapidocs.yml

@@ -0,0 +1,113 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+# Generates a release build artifact (nuget) from HEAD of master for auth module.
+name: $(BuildDefinitionName)_$(SourceBranchName)_$(Date:yyyyMMdd)$(Rev:.r)
+
+pool:
+  vmImage: "windows-latest"
+
+variables:
+  BRANCH: 'weeklyOpenApiDocsDownload'
+
+schedules:
+    - cron: "0 12 * * 5" # Run Every Friday at Midnight UTC Time
+      displayName: "Weekly OpenApiDocs Download and PR"
+      branches: 
+        include: 
+        - gn/generateOpenApiDocs
+        - dev
+      always: true
+
+steps:
+  - checkout: self
+    persistCredentials: true
+    clean: true
+  - task: securedevelopmentteam.vss-secure-development-tools.build-task-credscan.CredScan@2
+    displayName: 'Run CredScan'
+    inputs:
+      debugMode: false
+
+  - task: PowerShell@2
+    displayName: "Compute Branch"
+    inputs:
+      targetType: inline
+      script: |
+        $branch = "{0}.{1}" -f "weeklyOpenApiDocsDownload", (Get-Date -Format yyyyMMdd)
+        Write-Host "##vso[task.setvariable variable=BRANCH;]$branch"
+  - task: PowerShell@2
+    displayName: "Configure User"
+    inputs:
+      targetType: 'inline'
+      script: |
+        git config --global user.email "[email protected]"
+        git config --global user.name "Azure Devops"
+
+  - task: PowerShell@2
+    displayName: "Show Directory"
+    inputs:
+      targetType: 'inline'
+      script: |
+        Write-Host $(System.DefaultWorkingDirectory)
+        ls  $(System.DefaultWorkingDirectory)
+        ls  $(System.DefaultWorkingDirectory)/tools
+
+  - task: PowerShell@2
+    displayName: Download v1.0 OpenApiDocs
+    inputs:
+      filePath: '$(System.DefaultWorkingDirectory)/tools/UpdateOpenApi.ps1'
+      pwsh: true
+
+  - task: PowerShell@2
+    displayName: Download beta OpenApiDocs
+    inputs:
+      filePath: '$(System.DefaultWorkingDirectory)/tools/UpdateOpenApi.ps1'
+      arguments: '-BetaGraphVersion'
+      pwsh: true
+
+  - task: Bash@3
+    displayName : "Create PR $(BRANCH)"
+    inputs:
+      targetType: 'inline'
+      script: |
+          git status
+          git checkout dev
+          git branch $(BRANCH)
+          git checkout $(BRANCH)
+          git status
+
+  - task: Bash@3
+    displayName : "Commit Downloaded Files"
+    env: 
+      GITHUB_TOKEN: $(GITHUB_TOKEN)
+    inputs:
+      targetType: 'inline'
+      script: |
+        git status
+        git add .
+        git commit -m 'Weekly OpenApiDocs Download'
+        git status
+        git push --set-upstream origin $(BRANCH)
+        git status
+
+  -  task: Bash@3
+     displayName: "Create Pull Request"
+     env: 
+        GITHUB_TOKEN: $(GITHUB_TOKEN)
+        MESSAGE_TITLE: Weekly OpenApiDocs Download
+        MESSAGE_BODY: "This pull request was automatically created by Azure Devops, \n\n Contains Weekly OpenApiDocs Download files for v1.0 and beta"
+        REVIEWERS: peombwa,ddyett
+        ASSIGNEDTO: finsharp
+        LABELS: generated
+        BASE: dev
+        BRANCH: $(BRANCH)
+     inputs:
+        targetType: 'inline'
+        script: |
+          curl -fsSL https://github.com/github/hub/raw/master/script/get | bash -s 2.14.1
+          bin/hub pull-request -b "$BASE" -h "$BRANCH" -m "$MESSAGE_TITLE" -m "$MESSAGE_BODY" -r "$REVIEWERS" -a "$ASSIGNEDTO" -l "$LABELS"
+
+# References
+# [0] https://help.github.com/en/actions/configuring-and-managing-workflows/using-environment-variables
+# [1] https://hub.github.com/hub-pull-request.1.html
+# https://help.github.com/en/actions/configuring-and-managing-workflows/authenticating-with-the-github_token

tools/UpdateOpenApi.ps1

@@ -0,0 +1,45 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+Param(
+    [string] $ModuleMappingConfigPath = (Join-Path $PSScriptRoot "..\config\ModulesMapping.jsonc"),
+    [string] $OpenApiDocOutput = (Join-Path $PSScriptRoot "..\openApiDocs"),
+    [switch] $BetaGraphVersion
+)
+
+$ErrorActionPreference = 'Stop'
+$LASTEXITCODE = $null
+if ($PSEdition -ne 'Core') {
+    Write-Error 'This script requires PowerShell Core to execute. [Note] Generated cmdlets will work in both PowerShell Core or Windows PowerShell.'
+}
+# Install Powershell-yaml
+Install-Module powershell-yaml -Force
+
+$GraphVersion = "v1.0"
+if ($BetaGraphVersion) {
+    $GraphVersion = "beta"
+}
+
+$OpenApiDocOutput = Join-Path $OpenApiDocOutput $GraphVersion
+
+# PS Scripts
+$DownloadOpenApiDocPS1 = Join-Path $PSScriptRoot ".\DownloadOpenApiDoc.ps1" -Resolve
+
+if (-not (Test-Path $ModuleMappingConfigPath)) {
+    Write-Error "Module mapping file not be found: $ModuleMappingConfigPath."
+}
+
+[HashTable] $ModuleMapping = Get-Content $ModuleMappingConfigPath | ConvertFrom-Json -AsHashTable
+$ModuleMapping.Keys | ForEach-Object {
+    $ModuleName = $_
+
+        try {
+            # Download OpenAPI document for module.
+            & $DownloadOpenApiDocPS1 -ModuleName $ModuleName -ModuleRegex $ModuleMapping[$ModuleName] -OpenApiDocOutput $OpenApiDocOutput -GraphVersion $GraphVersion
+        }
+        catch {
+            Write-Error $_.Exception
+        }
+}
+
+
+Write-Host -ForegroundColor Green "-------------Done-------------"