Skip to content

README.md

Latest commit

 

History

History
122 lines (96 loc) · 6.05 KB

README.md

File metadata and controls

122 lines (96 loc) · 6.05 KB
Raw

Avanade DevOps HOL - Getting Started

In this lab, we will be installing the required development components and verifying that the solution builds and is able to be pushed to Azure DevOps.

Pre-requisites

  1. An active Azure subscription
    Azure Portal
  2. An active Azure DevOps account.
    Sign up for Visual Studio Team Services
  3. Having your subscription linked with your own Azure Active Directory instance
    If you use your Avanade email address as a Micrsoft account, you may have problems related to write permissions into the Azure Active Directory managed by Avanade (avanade.onmicrosoft.com).
    As a result you won't be able to create multiple services in Azure that require registering a Service Principal account in the AD (e.g.: creating a Service Connection in Azure DevOps, creating a new Kubernetes cluster, etc.).
    To prevent that and save you lots of frustrations in the future, create a new Active Directory from the Azure Portal , "Create a resource" menu (search for Active directory).
    Once created, find the Subscriptions menu and select your "Visual Studio ********" subscription Overview blade (or the subscription you will use for this lab).
    A "Change directory" option in the upper bar will allow you to attach this subscription to the newly created Azure Active Directory instance.
    The migration process requires between 10 and 30 minutes so please be sure to perform this operation before the Lab.
    Associate or add an Azure subscription to your Azure Active Directory tenant

Set up your machine

  1. Install Visual Studio 2017
    Select ASP.NET and web development and Azure development tools on the installer.
  2. Install Azure Power Shell

Create MVC web application

  1. Open Visual Studio 2017

  2. Make sure GIT is the current source control plugin (under Tools -> Options -> Source Control -> Plug-in Selection)

  3. Go to File -> New -> Project... and create a new ASP.NET Core Web Application

    • Name: DevOpsHOL
    • Location: where ever you put project source
    • Create Directory for solution: Checked
    • Create new Git repository: Checked
    • Click OK
    • On the next dialog, choose Web Application (Model-View-Controller) as the application type, No Authentication
    • Configure for https: UnChecked (unless you are up for the challenge)
    • Click OK

  4. Build and run the solution to make sure everything is OK to this point.

    • Debug -> Start Debugging (F5)
      • If application doesn't start the first time, just run again.
    • Do a quick smoke test to verify that the solution built and runs correctly.
    • Close browser and stop debugging

  5. Choose File -> New -> Project... and add a MSTest Test Project (.NET Core) project, to the solution not the .NET Framework unit test project.

    • Name: DevOpsHOL.Tests
    • Solution: Add to solution

  6. Rename UnitTest.cs to HomeControllerTest.cs and replace the file contents with the content in the details section below.       

    Click here to expand the sample unit test code

     [TestClass]
 public class HomeControllerTest
 {
     [TestMethod]
     public void Index()
     {
         // Arrange
         HomeController controller = new HomeController();

         // Act
         ViewResult result = controller.Index() as ViewResult;

         // Assert
         Assert.IsNotNull(result);
     }

     [TestMethod]
     public void About()
     {
         // Arrange
         HomeController controller = new HomeController();

         // Act
         ViewResult result = controller.About() as ViewResult;

         // Assert
         Assert.IsNotNull(result);
         Assert.AreEqual("Your application description page.", result.ViewData["Message"]);
     }

     [TestMethod]
     public void Contact()
     {
         // Arrange
         HomeController controller = new HomeController();

         // Act
         ViewResult result = controller.Contact() as ViewResult;

         // Assert
         Assert.IsNotNull(result);
     }
 }

      NOTE: This source is also available here: HomeControllerTest.cs

  1. Add the "DevOpsHOL" as a reference to the DevOpsHOL.Tests project. Tip: Use quick refactoring.

  2. Add references to Microsoft.AspNetCore.Mvc.Abstractions and Microsoft.AspNetCore.Mvc.ViewFeatures as well. Use the NuGet package manager to add these libraries to the project.

  3. Build, run unit tests and run the solution to make sure everything is OK to this point.

    • Test -> Run -> All Tests (Ctrl+R,A)
    • Debug -> Start Debugging (F5)
    • Do another quick smoke test to verify that the solution built and runs correctly.
    • Close browser and stop debugging

  4. Add solution to VSTS project (Team Explorer -> Sync -> Publish Git Repo)

    • Push to Visual Studio Team Services
    • Repository name: DevOpsHOL
    • Publish repository will create a project in VSTS (NOTE: if you have multiple VSTS accounts, make sure this is published to the correct Team Services Domain).

  1. Create the first commit for your project (Team Explorer -> Changes -> Commit All and Push). NOTE: This could be automatically staged so choose Commit Staged and Push.

  2. Log in to VSTS with browser and verify that DevOpsHOL project was created and source code is uploaded.

Next steps