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

Table of Contents

• Overview
  • Contoso
  • Microsoft DevBox Overview
• Solution Architecture
• Getting Started
  • Prerequisites
  • Deployment
• Contributing
• License

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:

• Microsoft DevBox Overview
• Getting Started with Microsoft DevBox
• Microsoft DevBox Pricing

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

• Azure Subscription
• Azure CLI
• Bicep CLI
• GitHub CLI
• Azure Developer CLI
• Visual Studio Code
• Git

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.

   

   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.

   

3. Login to Azure:

   Click on "Terminal" menu and start a 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:

   

   Select HTTPS and press enter:

   

   Type Y and press enter:

   

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

   

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

   

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

   

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

   

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.