getting_started_codespaces.md

Getting stated with Azure Cloud Adoption Framework landing zones on Visual Studio Codespaces

Introduction

Visual Studio Codespaces is a browser-based editor with support for Git repos, extensions, and a built-in command line interface so you can edit, run, and debug your applications from any device. For more details on Visual Studio Codespace, you can visit the product page here

Prerequisites

In order to start deploying your with CAF landing zones on VS Codespaces, you need:

• an Azure subscription (Trial, MSDN, etc.)

Create your account

Let's authenticate first: https://aka.ms/vso-login

Create the repository in Visual Studio Code

Create the landing zones Codespaces clicking here:

The create process will look something like that:

Once ready, you should have your Visual Studio Interface as follow:

Open a Terminal using CTRL + J or Command + J

You are ready to use landing zones by launching the rover as below:

/tf/rover/rover.sh

Deploying your first landing zone

You must be authenticated first: For that we will rely on Azure authentication as completed by Azure Cli, via browser method:

/tf/rover/rover.sh login

We recommend that you verify the output of the login and make sure the subscription selected by default is the one you want to work on. If not, you can use the following switch:

az account set --subscription <subscription_GUID>

On the first run, you need to apply the launchpad as the first landing zone:

/tf/rover/rover.sh -lz /tf/caf/landingzones/launchpad -a apply -launchpad

You can specify a location for the launchpad using the following command:

/tf/rover/rover.sh -lz /tf/caf/landingzones/launchpad -a apply -launchpad -var location=westus

You can then launch your first landing zone!

Please note that each landing zone come with its own deployment settings, which may deploy resources in different region than where you set the foundations.

You are ready to start:

/tf/rover/rover.sh -lz /tf/caf/landingzones/landingzone_caf_foundations -a plan

/tf/rover/rover.sh -lz /tf/caf/landingzones/landingzone_caf_foundations -a apply

/tf/rover/rover.sh -lz /tf/caf/landingzones/landingzone_caf_foundations -a destroy

Happy deployment with Azure landing zones, let us know your feedback and how you need it to evolve.