Skip to content

Latest commit

 

History

History
156 lines (96 loc) · 5.91 KB

README.md

File metadata and controls

156 lines (96 loc) · 5.91 KB
Raw

Dev Experience with Microsoft DevBox

Welcome to the Dev Experience with Microsoft DevBox repository! This repository demonstrates how to deploy Microsoft DevBox for Contoso's Software Development Engineers to expedite their onboarding process and streamline project integration.

Build and Deploy Status

Build Deploy
Test Login To Azure DevBox as a Service CI DevBox as a Service CI and CD Clean UP Dev Experience with Microsoft DevBox Deployment Dev Experience with Microsoft DevBox New Release

Table of Contents

Overview

Contoso

Contoso aims to enhance the developer experience by leveraging Microsoft DevBox. This repository provides a comprehensive guide and resources to deploy and manage Microsoft DevBox environments efficiently.

Microsoft DevBox Overview

Microsoft DevBox is a cloud-based service that provides pre-configured, secure, and scalable development environments. It allows developers to quickly set up and start coding without worrying about the underlying infrastructure. DevBox integrates seamlessly with Azure services, providing a robust platform for development and testing.

For more information, please refer to the official Microsoft DevBox documentation:

Solution Architecture

Solution Architecture

Getting Started

Follow these instructions to get a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

Deployment

  1. Fork the repository:

    Navigate to the GitHub repository page and click on the "Fork" button at the top right corner of the page. This will create a copy of the repository under your GitHub account.

  2. Clone your forked repository:

    On Windows, open the Terminal App.

    alt text

    Type the following command line:

    Bash or PowerShell

    git clone https://github.com/<your-username>/MicrosoftDevBox.git
cd MicrosoftDevBox
code .

    Visual Studio Code will open as showed below.

    Visual Studio Code

  3. Login to Azure:

    Click on "Terminal" menu and start a new Terminal.

    New Terminal

    A new terminal will be started according with your terminal preferences. If you running VS Code on Windows, you problably will get a PowerShell Terminal but don't worry, I will explay how to set up the environment using PowerShell and Bash scripts.

    Bash or PowerShell

    az login --use-device-code

gh auth login

    Select the GitHub.com option and press enter:

    GitHub.com

    Select HTTPS and press enter:

    HTTPS

    Type Y and press enter:

    Yes

    Select the "Login with a web browser" option and press enter:

    login web

    Copy the code generated to your clipboard and press enter to open the browser:

    Code

    In the browser, click on the "Continue" button and paste the code on the text boxes:

    Continue

    Clique on the "Continue" button and you will be authenticated.

    auth

  4. Set up your credentials for the GitHub Actions

    Bash

    cd src/deploy/setup/bash/
./setUp.sh

    Outcome:

    PowerShell

    cd src\deploy\setup\powershell
.\setUp.ps1

    Outcome:

    The outcome must see like the following:

    cd evi

Contributing

We welcome contributions to enhance the Dev Experience with Microsoft DevBox. Please follow the contributing guidelines to submit your changes.

License

This project is licensed under the MIT License - see the LICENSE file for details.