Skip to content

Commit f7a3122

Browse files
author
Seth
committed
Azure CLI dependency documentation
1 parent 01af097 commit f7a3122

5 files changed

Lines changed: 26 additions & 21 deletions

File tree

.github/workflows/azure-dev.yml

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,14 +25,19 @@ jobs:
2525
uses: actions/checkout@v4
2626
- name: Install azd
2727
uses: Azure/setup-azd@v2
28-
- name: Log in with Azure (Federated Credentials)
28+
- name: Azure Developer CLI Login
2929
run: |
3030
azd auth login `
3131
--client-id "$Env:AZURE_CLIENT_ID" `
3232
--federated-credential-provider "github" `
3333
--tenant-id "$Env:AZURE_TENANT_ID"
3434
shell: pwsh
35-
35+
- name: Azure CLI Login
36+
uses: azure/login@v2
37+
with:
38+
client-id: ${{ vars.AZURE_CLIENT_ID }}
39+
tenant-id: ${{ vars.AZURE_TENANT_ID }}
40+
subscription-id: ${{ vars.AZURE_SUBSCRIPTION_ID }}
3641
- name: Provision Infrastructure
3742
run: azd provision --no-prompt
3843
env:

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ Offers ability to [start with an existing Azure AI Project](docs/transfer_projec
4747
1. Have access to an Azure subscription and Entra ID account with Contributor permissions.
4848
2. Confirm the subscription you are deploying into has the [Required Roles and Scopes](docs/Required_roles_scopes_resources.md).
4949
3. The solution ensures secure access to the private VNET through a jump-box VM with Azure Bastion. By default, Bastion does not require an inbound NSG rule for network traffic. However, if your environment enforces specific policy rules, you can resolve access issues by entering your machine's IP address in the `allowedIpAddress` parameter when prompted during deployment. If not specified, all IP addresses are allowed to connect to Azure Bastion.
50-
4. If deploying from your [local environment](docs/local_environment_steps.md), install the [Azure Developer CLI (AZD)](https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/install-azd?tabs=winget-windows%2Cbrew-mac%2Cscript-linux&pivots=os-windows).
50+
4. If deploying from your [local environment](docs/local_environment_steps.md), install the [Azure CLI (AZ)](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest) and the [Azure Developer CLI (AZD)](https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/install-azd?tabs=winget-windows%2Cbrew-mac%2Cscript-linux&pivots=os-windows).
5151
5. If deploying via [GitHub Codespaces](docs/github_code_spaces_steps.md) - requires the user to be on a GitHub Team or Enterprise Cloud plan.
5252
6. If leveraging [One-click deployment](#quick-deploy).
5353
7. If leveraging [GitHub Actions](docs/github_actions_steps.md).

docs/github_code_spaces_steps.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -36,27 +36,29 @@ You can run this solution using GitHub Codespaces. The button will open a web-ba
3636

3737
![Image showing the pop up window in the web browser for azd auth](../img/provisioning/azdauthpopup.png)
3838

39-
7. Return to the codespaces window now. In the terminal window, begin by initializing the environment by typing the command “azd init”
39+
7. Repeat the same process in #6 using the “az login” command. The [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/what-is-azure-cli?view=azure-cli-latest) is used to validate available AI model quota.
40+
41+
8. Return to the codespaces window now. In the terminal window, begin by initializing the environment by typing the command “azd init”
4042

4143
![image showing the initial screen in the vs code terminal](../img/provisioning/azd_init_terminal.png)
4244

43-
8. Enter the name for your environment
45+
9. Enter the name for your environment
4446

4547
![aImage showing entering a new environment name](../img/provisioning/enter_evn_name.png)
4648

47-
9. Now start the deployment of the infrastructure by typing the command “azd provision”
49+
10. Now start the deployment of the infrastructure by typing the command “azd provision”
4850

4951
![image showing the terminal in vs code](../img/provisioning/azd_provision_terminal.png)
5052

51-
This step will allow you to choose from the subscriptions you have available, based on the account you logged in with in the azd auth login step. Next it will prompt you for the region to deploy the resources into.
53+
This step will allow you to choose from the subscriptions you have available, based on the account you logged in with in the login step. Next it will prompt you for the region to deploy the resources into.
5254

5355
![image showing region selection](../img/provisioning/azdprovision_select_location.png)
5456

55-
10. Next you will be prompted for values to enable additional features outside of the AI Foundry required features. They are false by default.
57+
11. Next you will be prompted for values to enable additional features outside of the AI Foundry required features. They are false by default.
5658
![image of prompts](../img/provisioning/prompts.png)
5759
**Be sure to remember the vm password and vm username. This will be used in a later step. Because we are using FDPO subscriptions, we do not have access to Entra to create the SSO to the jump box at this time. You are still required to log into Azure once you connect to the virtual machine.
5860

59-
11. After completeing the required paramters that you were prompted for, the provisioning of resources will run and deploy the Network Isolated AI hub, project and dependent resources in about 20 minutes.
61+
12. After completeing the required paramters that you were prompted for, the provisioning of resources will run and deploy the Network Isolated AI hub, project and dependent resources in about 20 minutes.
6062

6163
# Post Deployment Steps:
6264
These steps will help to check that the isolated environment was set up correctly.

docs/local_environment_steps.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,22 @@ git clone https://github.com/microsoft/Deploy-Your-AI-Application-In-Production.
77
cd Deploy-Your-AI-Application-In-Production
88
```
99

10-
### Establish AZD Environment
10+
### Establish Environment
1111

12-
This solution uses the [Azure Developer CLI](https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/overview) to quickly provision and deploy infrastructure and applications to Azure.
12+
This solution uses the [Azure CLI](https://learn.microsoft.com/en-us/cli/azure/what-is-azure-cli?view=azure-cli-latest) and the [Azure Developer CLI](https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/overview) to quickly provision and deploy infrastructure and applications to Azure.
1313

1414
To get started, authenticate with an Azure Subscription ([details](https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/reference#azd-auth-login)):
1515

1616
```powershell
1717
azd auth login
1818
```
1919

20+
Also authenticate with the Azure CLI ([details](https://learn.microsoft.com/en-us/cli/azure/authenticate-azure-cli?view=azure-cli-latest)):
21+
22+
```powershell
23+
az login
24+
```
25+
2026
Establish a new environment. Provide a name that represents the application domain:
2127

2228
```powershell

docs/quota_check.md

Lines changed: 2 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Before deploying the accelerator, **ensure sufficient quota availability** for t
55
66
## Login if you have not done so already
77
```
8-
azd auth login
8+
az login
99
```
1010

1111
## 📌 Default Models & Capacities:
@@ -88,12 +88,4 @@ The final table lists regions with available quota. You can select any of these
8888
```sh
8989
./quota_check.sh
9090
```
91-
- Refer to [Input Formats](#input-formats) for detailed commands.
92-
93-
5. If you see the error `_bash: az: command not found_`, install Azure CLI:
94-
95-
```sh
96-
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash
97-
az login
98-
```
99-
6. Rerun the script after installing Azure CLI.
91+
- Refer to [Input Formats](#input-formats) for detailed commands.

0 commit comments

Comments
 (0)