You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: documentation/ManualAzureDeployment.md
+17-12Lines changed: 17 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,22 +1,26 @@
1
1
# Manual Azure Deployment
2
-
Manual Deployment differs from the ‘Quick Deploy’ option in that it will install an Azure Container Registry (ACR) service, and relies on the installer to build and push the necessary containers to this ACR. This allows you to build and push your own code changes and provides a sample solution you can customize based on your requirements.
2
+
3
+
Manual Deployment differs from the ‘Quick Deploy’ option in that it will install an Azure Container Registry (ACR) service, and relies on the installer to build and push the necessary containers to this ACR. This allows you to build and push your own code changes and provides a sample solution you can customize based on your requirements.
3
4
4
5
## Prerequisites
5
6
6
7
- Current Azure CLI installed
7
-
You can update to the latest version using ```az upgrade```
8
+
You can update to the latest version using `az upgrade`
8
9
- Azure account with appropriate permissions
9
10
- Docker installed
10
11
11
12
## Deploy the Azure Services
12
-
All of the necessary Azure services can be deployed using the /deploy/macae.bicep script. This script will require the following parameters:
13
+
14
+
All of the necessary Azure services can be deployed using the /deploy/macae.bicep script. This script will require the following parameters:
13
15
14
16
```
15
17
az login
16
18
az account set --subscription <SUBSCRIPTION_ID>
17
19
az group create --name <RG_NAME> --location <RG_LOCATION>
18
20
```
21
+
19
22
To deploy the script you can use the Azure CLI.
23
+
20
24
```
21
25
az deployment group create \
22
26
--resource-group <RG_NAME> \
@@ -26,9 +30,10 @@ az deployment group create \
26
30
27
31
Note: if you are using windows with PowerShell, the continuation character (currently ‘\’) should change to the tick mark (‘`’).
28
32
29
-
The template will require you fill in locations for Cosmos and OpenAI services. This is to avoid the possibility of regional quota errors for either of these resources.
33
+
The template will require you fill in locations for Cosmos and OpenAI services. This is to avoid the possibility of regional quota errors for either of these resources.
30
34
31
35
## Create the Containers
36
+
32
37
- Get admin credentials from ACR
33
38
34
39
Retrieve the admin credentials for your Azure Container Registry (ACR):
@@ -49,7 +54,7 @@ az acr login --name <e.g. macaeacr2t62qyozi76bs>
49
54
50
55
## Build and push the image
51
56
52
-
Build the frontend and backend Docker images and push them to your Azure Container Registry. Run the following from the src/backend and the src/frontend directory contexts:
57
+
Build the frontend and backend Docker images and push them to your Azure Container Registry. Run the following from the src/backend and the src/frontend directory contexts:
53
58
54
59
```sh
55
60
az acr build \
@@ -60,12 +65,13 @@ az acr build \
60
65
61
66
## Add images to the Container APP and Web App services
62
67
63
-
To add your newly created backend image:
68
+
To add your newly created backend image:
69
+
64
70
- Navigate to the Container App Service in the Azure portal
65
71
- Click on Application/Containers in the left pane
66
72
- Click on the "Edit and deploy" button in the upper left of the containers pane
67
-
- In the "Create and deploy new revision" page, click on your container image 'backend'. This will give you the option of reconfiguring the container image, and also has an Environment variables tab
68
-
- Change the properties page to
73
+
- In the "Create and deploy new revision" page, click on your container image 'backend'. This will give you the option of reconfiguring the container image, and also has an Environment variables tab
74
+
- Change the properties page to
69
75
- point to your Azure Container registry with a private image type and your image name (e.g. backendmacae:latest)
70
76
- under "Authentication type" select "Managed Identity" and choose the 'mace-containerapp-pull'... identity setup in the bicep template
71
77
- In the environment variables section add the following (each with a 'Manual entry' source):
@@ -75,8 +81,8 @@ To add your newly created backend image:
75
81
76
82
name: 'COSMOSDB_DATABASE'
77
83
value: 'macae'
78
-
Note: To change the default, you will need to create the database in Cosmos
79
-
84
+
Note: To change the default, you will need to create the database in Cosmos
85
+
80
86
name: 'COSMOSDB_CONTAINER'
81
87
value: 'memory'
82
88
@@ -88,7 +94,7 @@ To add your newly created backend image:
88
94
89
95
name: 'AZURE_OPENAI_API_VERSION'
90
96
value: '2024-08-01-preview'
91
-
Note: Version should be updated based on latest available
97
+
Note: Version should be updated based on latest available
92
98
93
99
name: 'FRONTEND_SITE_NAME'
94
100
value: 'https://<website Name>.azurewebsites.net'
@@ -106,4 +112,3 @@ az webapp config container set --resource-group <resource_group_name> \
0 commit comments