add info for using modules in Azure Devops pipeline

docs/using-in-azure-devops-pipeline.md

@@ -0,0 +1,16 @@
+## Using In Azure Devops
+
+The recommended way to test newly generated Azurestack modules in Azure Devops is to upload them to a storage accessible by your Azure Devops pipeline. For example, the following code downloads, installs, and imports the required Az.Accounts and Az.Resources modules.
+
+```
+Unregister-PSRepository -Name local -ErrorAction SilentlyContinue
+$psrepo="$env:systemdrive\psrepo"
+New-Item -Path $psrepo -ItemType Directory -force
+Invoke-WebRequest -Uri <URI_TO_AZ_ACCOUNTS_DOWNLOAD> -OutFile <AZ_ACCOUNTS_MODULE_DOWNLOADED_FILE>
+Invoke-WebRequest -Uri <URI_TO_AZ_RESOURCES_DOWNLOAD> -OutFile <AZ_RESOURCES_MODULE_DOWNLOADED_FILE>
+Register-PSRepository -Name local -SourceLocation $psrepo -InstallationPolicy Trusted
+Install-Module Az.Accounts -Repository Local
+Install-Module Az.Resources -Repository Local
+Import-Module Az.Accounts
+Import-Module Az.Resources
+```

tools/New-AzureSampleResources.ps1

@@ -0,0 +1,141 @@
+param
+(
+    [Parameter(Mandatory = $true)]
+    [string] $AzureSubscriptionId,
+    [Parameter(Mandatory = $false)]
+    [switch] $NodeJS,
+    [Parameter(Mandatory = $false)]
+    [switch] $Golang,
+    # This variable is used to load existing service principal details from another powershell script. For the existing details, the .ps1 file needs to contain
+    # a hashtable for the service principal application and certificate hashtable with the following keys accessible from this script:
+    # $azureAppSpInfo["ClientId"]
+    # $azureAppSpInfo["ClientSecret"]
+    # $azureAppSpInfo["ObjectId"]
+    # $azureCertSpInfo["ClientId"]
+    # $azureCertSpInfo["CertificateThumbprint"]
+    # $azureCertSpInfo["ObjectId"]
+    [Parameter(Mandatory = $false)]
+    [string] $ExistingServicePrincipalDetails
+)
+
+. "C:\CloudDeployment\BVTs\BVTSettingUtils.ps1"
+Import-Module $([io.path]::combine($PSScriptRoot, "Common.psm1"))
+Import-AzModules -AzVersion "0.10.0" 
+
+# Retrieve BVTSettings.xml settings.
+$adminName = Get-Setting -key ServiceAdminUpn
+$adminPassSecureString = ConvertTo-SecureString -String (Get-Setting -key ServiceAdminPassword) -AsPlainText -Force
+$deploymentId = Get-Setting -key DeploymentId
+$adfs = ([System.String](Get-Setting -key AadLoginUri)).EndsWith("/adfs")
+$azureTenantId = Get-Setting -key AADTenantID
+if ($adfs)
+{
+    $azureTenantId = "adfs"
+}
+$azureLocation = Get-Setting -Key AzureStackLocation
+$azureAdminArmEndpoint = Get-Setting -key ARMEndpoint
+
+# Log into Azure admin context
+Add-AzEnvironment -Name AzureSampleEnvironment -ARMEndpoint $azureAdminArmEndpoint
+$username = $adminName
+$password = $adminPassSecureString
+$credential = [System.Management.Automation.PSCredential]::new($username, $password)
+Connect-AzAccount -Environment AzureSampleEnvironment -Credential $credential -Tenant $azureTenantId
+
+# Undocumented 16 character limit for application names for creating service principals.
+$uniqueId = ($deploymentId -replace "-", "").Substring(0,6)
+$azureAppSpName = "sampappsp${uniqueId}"
+$azureCertSpName = "sampcertsp${uniqueId}"
+$certName = "azureSampleCert"
+
+if (!$ExistingServicePrincipalDetails)
+{
+    if ($adfs)
+    {
+        $azureAppSpInfo = New-AzureAppSp -ApplicationName $azureAppSpName -AzureAdminCredential $credential
+        $azureCertSpInfo = New-AzureCertSp -ApplicationName $azureCertSpName -CertificateName $certName -AzureAdminCredential $credential
+    }
+    else 
+    {
+        $azureAppSpInfo = New-AzureAppSp -ServicePrincipalName $azureAppSpName
+        $azureCertSpInfo = New-AzureCertSp -ServicePrincipalName $azureCertSpName -CertificateName $certName
+    }
+}
+else
+{
+    . $ExistingServicePrincipalDetails
+}
+
+$appSpSecret = ConvertTo-SecureString $azureAppSpInfo["ClientSecret"]
+$BSTR = [System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($appSpSecret)
+
+# Warning: the following code does not work on unix systems as of 5/28/2021 because [System.Environment]::SetEnvironmentVariable is unimplemented for unix.
+[System.Environment]::SetEnvironmentVariable('AZURE_TENANT_ID', $azureTenantId, [System.EnvironmentVariableTarget]::Machine)
+# Service principal application details
+[System.Environment]::SetEnvironmentVariable('AZURE_SP_APP_ID', $azureAppSpInfo["ClientId"], [System.EnvironmentVariableTarget]::Machine)
+[System.Environment]::SetEnvironmentVariable('AZURE_SP_APP_SECRET', [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($BSTR), [System.EnvironmentVariableTarget]::Machine)
+[System.Environment]::SetEnvironmentVariable('AZURE_SP_APP_OBJECT_ID', $azureAppSpInfo["ObjectId"], [System.EnvironmentVariableTarget]::Machine)
+# Service principal certificate details
+[System.Environment]::SetEnvironmentVariable('AZURE_SP_CERT_ID', $azureCertSpInfo["ClientId"], [System.EnvironmentVariableTarget]::Machine)
+[System.Environment]::SetEnvironmentVariable('AZURE_SP_CERT_THUMBPRINT', $azureCertSpInfo["CertificateThumbprint"], [System.EnvironmentVariableTarget]::Machine)
+[System.Environment]::SetEnvironmentVariable('AZURE_SP_CERT_OBJECT_ID', $azureCertSpInfo["ObjectId"], [System.EnvironmentVariableTarget]::Machine)
+[System.Environment]::SetEnvironmentVariable('AZURE_SUBSCRIPTION_ID', $AzureSubscriptionId, [System.EnvironmentVariableTarget]::Machine)
+[System.Environment]::SetEnvironmentVariable('AZURE_ARM_ENDPOINT', $azureAdminArmEndpoint, [System.EnvironmentVariableTarget]::Machine)
+[System.Environment]::SetEnvironmentVariable('AZURE_LOCATION', $azureLocation, [System.EnvironmentVariableTarget]::Machine)
+
+######################
+# SDK SPECIFIC SETUP
+######################
+
+switch ($env:PROCESSOR_ARCHITECTURE) 
+{
+    "AMD64" { $architecture = "x64" }
+    "x86" { $architecture = "x86" }
+    default { throw "PowerShell package for OS architecture '$_' is not supported." }
+}
+
+$logFolder = $([io.path]::combine($env:HOMEPATH, "AzureSampleLogs"))
+If (-not (Test-Path -Path $logFolder))
+{
+    New-Item $logFolder -Type Directory -ErrorAction Stop
+}
+
+if ($NodeJS)
+{
+    # Install NodeJS
+    $nodeJSVersion = "v14.17.0"
+    $nodeJSDownloadURL = "https://nodejs.org/dist/${nodeJSVersion}/node-${nodeJSVersion}-${architecture}.msi"
+    $nodeJSInstallLogFilePath = Join-Path -Path $logFolder -ChildPath "nodejsInstall.log"
+    Install-SoftwareFromURL -DownloadURL $nodeJSDownloadURL `
+        -RegistryDisplayNameLike "Node.js" `
+        -InstallLogFilePath $nodeJSInstallLogFilePath `
+        -ForceInstall
+
+    # Set up Azure Stack local certificate for NodeJS.
+    $certFolder = [System.IO.Path]::Combine($env:HOMEPATH, "certs")
+    if (!(Test-Path -Path $certFolder))
+    {
+        New-Item -ItemType "directory" -Path $certFolder
+    }
+
+    New-NodeJSEnvPem -PemFolder $certFolder
+}
+
+if ($Golang)
+{
+    # Install Golang
+    # To get the latest Golang version use:
+    #     $wc = New-Object System.Net.WebClient
+    #     [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
+    #     $latestVersion = $wc.DownloadString("https://golang.org/VERSION?m=text")
+    # WARNING: Golang updates usually have breaking changes, becareful when updating.
+    $golangVersion = "go1.15.8"
+    $downloadFileName = "${golangVersion}.windows-amd64.msi"
+    $golangDownloadURL = "https://golang.org/dl/${downloadFileName}"
+    $GoSDKInstallLogFilePath = Join-Path -Path $logFolder -ChildPath "goInstall.log"
+    Install-SoftwareFromURL -DownloadURL $golangDownloadURL `
+        -RegistryDisplayNameLike "Go Programming Language*" `
+        -InstallLogFilePath $GoSDKInstallLogFilePath `
+        -ForceInstall
+
+}