AzureDevOpsDemoGenerator/docs/Local-Development.md

Running the Azure DevOps Demo Generator locally

To run this locally, you will need:

• Microsoft Visual Studio 2017 or higher;
• Internet Information Server and ASP.NET 4.5 or above installed;
• SQL Server 2016 Express LocalDB

Steps

1. Clone the solution to your local repository or fork it to your GitHub repo first and clone it from there.

2. Open the solution (src\VSTSDemoGeneratorV2.sln ) in Visual Studio and restore the required packages.

3. This application uses OAuth for authorization. In order to register the app, you will need to provide a callback URL. However, App registration does not allow localhost (http) to be the hostname in your callback URL. You can edit the hosts file (C:\Windows\System32\Drivers\etc\hosts) on your local computer to map a hostname to 127.0.0.1. Then use this hostname when you register your app.

4. Using an elevated command prompt, open the Hosts file on your machine and add a new mapping to your hostname. For instance, let's say we will use azuredevopsdemogen-mylocal.com domain name.

   127.0.0.1 azuredevopsdemogen-mylocal.com

   

5. You can register the app using this domain but you will need to provide a secure connection (https) for the callback URL. Create a new website azuredevopsdemogen-mylocal.com and enable HTTPS with a self-signed certificate on IIS by following the instructions provided in this article

6. Next, go to (https://app.vsaex.visualstudio.com/app/register) to register your app. Specify the domain name (azuredevopsdemogen-mylocal.com) for the Application website and the Application Callback URL must be https://<<domain name>>/Environment/Create

7. Select the following scopes and submit. If the submission is successful, the application settings page is displayed. You will need these information.

   

   

8. Go to IIS Manager, select the wesbiste you created. Open the Configuration Editor by double-clicking it. Open the Collections. Add the following entries to the collection ( Note: If you want to view the settings for the app that you registered, you can get it from here.:

   • RedirectUri - https://<<domain name>>/Environment/Create
   • ClientId - App ID from the application settings
   • ClientSecret - Client Secret from the application settings
   • AppScope - Authorized Scopes from the application settings (Encode the Authorized scopes and copy)

   

9. Update the Web | Server information in the Project properties file. Make sure you are running using the Local IIS and not IIS Express and your Project URL matches the web server name created in IIS.

   

10. Save the file and run the application

Extractor

When you are using extractor make sure you have given the Read & Write permissions for IIS_IUSRS group on the folder ExtractedTemplate