Merge pull request #219321 from juliakm/users/jukullam/addyaml-cosmoscicd

Add YAML option to CosmosDB article

Author: JamesJBarnett

articles/cosmos-db/tutorial-setup-ci-cd.md

@@ -3,7 +3,7 @@ title: Set up CI/CD pipeline with Azure Cosmos DB Emulator build task
 description: Tutorial on how to set up build and release workflow in Azure DevOps using the Azure Cosmos DB emulator build task
 ms.service: cosmos-db
 ms.topic: how-to
-ms.date: 01/28/2020
+ms.date: 11/22/2022
 ms.author: esarroyo
 author: StefArroyo 
 ms.reviewer: mjbrown
@@ -18,6 +18,9 @@ ms.custom: devx-track-csharp, ignite-2022
 The Azure Cosmos DB Emulator provides a local environment that emulates the Azure Cosmos DB service for development purposes. The emulator allows you to develop and test your application locally, without creating an Azure subscription or incurring any costs.
 
 ## PowerShell Task for Emulator
+
+### [Classic](#tab/classic)
+
 A typical PowerShell based task that will start the Azure Cosmos DB emulator can be scripted as follows:
 
 Example of a job configuration, selecting the "windows-2019" agent type.
@@ -57,7 +60,56 @@ IPAddress = $IPAddress.IPAddress
 }
 ```
 
-For agents that do not come with the Azure Cosmos DB emulator preinstalled, you can instead download the latest emulator's MSI package from https://aka.ms/cosmosdb-emulator using 'curl' or 'wget', then leverage ['msiexec'](/windows-server/administration/windows-commands/msiexec) to 'quiet' install it. After the install, you can run a similar PowerShell script as the one above to start the emulator.
+You also have the option of building your own [self-hosted Windows agent](/azure/devops/pipelines/agents/v2-windows) if you need to use an agent that doesn't come with the Azure Cosmos DB emulator preinstalled. On your self-hosted agent, you can download the latest emulator's MSI package from https://aka.ms/cosmosdb-emulator using 'curl' or 'wget', then use ['msiexec'](/windows-server/administration/windows-commands/msiexec) to 'quiet' install it. After the install, you can run a similar PowerShell script as the one above to start the emulator.
+
+### [YAML](#tab/yaml)
+
+
+You can use the `windows-2019` agent and a PowerShell script task to run the Azure Cosmos DB Emulator. 
+
+```yaml
+trigger:
+- main
+
+pool:
+  vmImage: windows-2019
+
+steps:
+- task: PowerShell@2
+  inputs:
+    targetType: 'inline'
+    script: |
+      # Write your PowerShell commands here.
+      
+      dir "C:\Program Files\Azure Cosmos DB Emulator\"
+      
+      Import-Module "$env:ProgramFiles\Azure Cosmos DB Emulator\PSModules\Microsoft.Azure.CosmosDB.Emulator"
+      
+      $startEmulatorCmd = "Start-CosmosDbEmulator -NoFirewall -NoUI"
+      Write-Host $startEmulatorCmd
+      Invoke-Expression -Command $startEmulatorCmd
+      
+      # Pipe an emulator info object to the output stream
+      
+      $Emulator = Get-Item "$env:ProgramFiles\Azure Cosmos DB Emulator\Microsoft.Azure.Cosmos.Emulator.exe"
+      $IPAddress = Get-NetIPAddress -AddressFamily IPV4 -AddressState Preferred -PrefixOrigin Manual | Select-Object IPAddress
+      
+      New-Object PSObject @{
+      Emulator = $Emulator.BaseName
+      Version = $Emulator.VersionInfo.ProductVersion
+      Endpoint = @($(hostname), $IPAddress.IPAddress) | ForEach-Object { "https://${_}:8081/" }
+      MongoDBEndpoint = @($(hostname), $IPAddress.IPAddress) | ForEach-Object { "mongodb://${_}:10255/" }
+      CassandraEndpoint = @($(hostname), $IPAddress.IPAddress) | ForEach-Object { "tcp://${_}:10350/" }
+      GremlinEndpoint = @($(hostname), $IPAddress.IPAddress) | ForEach-Object { "http://${_}:8901/" }
+      TableEndpoint = @($(hostname), $IPAddress.IPAddress) | ForEach-Object { "https://${_}:8902/" }
+      IPAddress = $IPAddress.IPAddress
+      }
+```
+
+
+You also have the option of building your own [self-hosted Windows agent](/azure/devops/pipelines/agents/v2-windows) if you need to use an agent that doesn't come with the Azure Cosmos DB emulator preinstalled. On your self-hosted agent, you can download the latest emulator's MSI package from https://aka.ms/cosmosdb-emulator using 'curl' or 'wget', then use ['msiexec'](/windows-server/administration/windows-commands/msiexec) to 'quiet' install it. After the install, you can run a similar PowerShell script as the one above to start the emulator.
+
+---
 
 ## Next steps