Skip to content

docs: Update Deployment Guide with Azure authentication steps #90

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Thanusree-Microsoft wants to merge 1 commit into
base: dev
Choose a base branch
from
Open

docs: Update Deployment Guide with Azure authentication steps #90

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 10 additions & 2 deletions docs/DeploymentGuide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -120,6 +120,8 @@ Select one of the following options to deploy the Container Migration Solution A
<details>
<summary><b>Option C: Visual Studio Code Web</b></summary>

### VS Code Web
Copy link

Copilot AI Jan 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This heading appears redundant since the parent collapsible section is already titled "Option C: Visual Studio Code Web". Consider removing this heading or renaming it to something more specific like "Steps" to avoid duplication.

Suggested change
### VS Code Web
### Steps

Copilot uses AI. Check for mistakes.

[![Open in Visual Studio Code Web](https://img.shields.io/static/v1?style=for-the-badge&label=Visual%20Studio%20Code%20(Web)&message=Open&color=blue&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/azure/?vscode-azure-exp=foundry&agentPayload=eyJiYXNlVXJsIjogImh0dHBzOi8vcmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbS9taWNyb3NvZnQvQ29udGFpbmVyLU1pZ3JhdGlvbi1Tb2x1dGlvbi1BY2NlbGVyYXRvci9yZWZzL2hlYWRzL21haW4vaW5mcmEvdnNjb2RlX3dlYiIsICJpbmRleFVybCI6ICIvaW5kZXguanNvbiIsICJ2YXJpYWJsZXMiOiB7ImFnZW50SWQiOiAiIiwgImNvbm5lY3Rpb25TdHJpbmciOiAiIiwgInRocmVhZElkIjogIiIsICJ1c2VyTWVzc2FnZSI6ICIiLCAicGxheWdyb3VuZE5hbWUiOiAiIiwgImxvY2F0aW9uIjogIiIsICJzdWJzY3JpcHRpb25JZCI6ICIiLCAicmVzb3VyY2VJZCI6ICIiLCAicHJvamVjdFJlc291cmNlSWQiOiAiIiwgImVuZHBvaW50IjogIiJ9LCAiY29kZVJvdXRlIjogWyJhaS1wcm9qZWN0cy1zZGsiLCAicHl0aG9uIiwgImRlZmF1bHQtYXp1cmUtYXV0aCIsICJlbmRwb2ludCJdfQ==)

1. Click the badge above (may take a few minutes to load)
Expand All @@ -132,13 +134,19 @@ Select one of the following options to deploy the Container Migration Solution A
sh install.sh
```
During this process, you’ll be prompted with the message:
<br> Choose “**Overwrite with versions from template**” and provide a unique environment name when prompted.
Copy link

Copilot AI Jan 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The indentation is inconsistent here. This line uses 3 spaces for indentation while the surrounding lines use 4 spaces. This should be adjusted to maintain consistent formatting with the rest of the code block.

Suggested change
<br> Choose “**Overwrite with versions from template**” and provide a unique environment name when prompted.
<br> Choose “**Overwrite with versions from template**” and provide a unique environment name when prompted.

Copilot uses AI. Check for mistakes.
```
What would you like to do with these files?
- Overwrite with versions from template
- Keep my existing files unchanged
```
Choose “**Overwrite with versions from template**” and provide a unique environment name when prompted.
6. Proceed to [Step 3: Configure Deployment Settings](#step-3-configure-deployment-settings)
7. **Authenticate with Azure** (VS Code Web requires device code authentication):
Copy link

Copilot AI Jan 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The step numbering is inconsistent. The sequence goes from step 5 (line 131) to step 7 (this line), skipping step 6. This should be renumbered as step 6 to maintain sequential ordering.

Suggested change
7. **Authenticate with Azure** (VS Code Web requires device code authentication):
6. **Authenticate with Azure** (VS Code Web requires device code authentication):

Copilot uses AI. Check for mistakes.

```shell
az login --use-device-code
```
> **Note:** In VS Code Web environment, the regular `az login` command may fail. Use the `--use-device-code` flag to authenticate via device code flow. Follow the prompts in the terminal to complete authentication.
8. Proceed to [Step 3: Configure Deployment Settings](#step-3-configure-deployment-settings)
Copy link

Copilot AI Jan 8, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The step numbering is inconsistent. This should be step 7 instead of step 8, following the renumbering of the previous authentication step.

Suggested change
8. Proceed to [Step 3: Configure Deployment Settings](#step-3-configure-deployment-settings)
7. Proceed to [Step 3: Configure Deployment Settings](#step-3-configure-deployment-settings)

Copilot uses AI. Check for mistakes.

</details>

Expand Down