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: docs/DeploymentGuide.md
+24-12Lines changed: 24 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -280,6 +280,22 @@ azd config set provision.preflight off
280
280
azd up
281
281
```
282
282
283
+
## Step 5: Post-Deployment Configuration
284
+
### 5.1 Run Post Deployment Script
285
+
286
+
1. You can run the ACR build and push script from the project root. Use the appropriate command for your shell:
287
+
288
+
- For Bash (Linux/macOS/WSL):
289
+
290
+
```bash
291
+
bash infra/scripts/build_and_push_images.sh
292
+
```
293
+
294
+
- For PowerShell (Windows):
295
+
296
+
```powershell
297
+
infra\scripts\build_and_push_images.ps1
298
+
283
299
**During deployment, you'll be prompted for:**
284
300
1. **Environment name** (e.g., "cmsaapp") - Must be 3-16 characters long, alphanumeric only
285
301
2. **Azure subscription** selection
@@ -288,38 +304,34 @@ azd up
288
304
289
305
**Expected Duration:** 9-14 minutes for default configuration (includes remotely building and pushing the container images)
290
306
291
-
>**ℹ️ How the application images are built:** Every deployment provisions its own **Azure Container Registry (ACR)**. The container apps are first created with a public "hello world" placeholder image, then a `postprovision` hook runs [`scripts/build_and_push_images.sh`](../scripts/build_and_push_images.sh) (or [`scripts/build_and_push_images.ps1`](../scripts/build_and_push_images.ps1) on Windows). This script builds the backend and frontend images **remotely**in your ACR using `az acr build` (no local Docker required), pushes them, and updates the container apps to run the freshly built images.
292
-
>
293
-
>**Azure CLI sign-in required:** The post-provision hook uses the Azure CLI. In addition to `azd auth login`, make sure you are signed in with `az login` (and `az account set --subscription <id>`if you have multiple subscriptions) before running `azd up`. In GitHub Codespaces and Dev Containers the Azure CLI is preinstalled.
294
-
295
307
**⚠️ Deployment Issues:** If you encounter errors or timeouts, try a different region as there may be capacity constraints. For detailed error solutions, see our [Troubleshooting Guide](./TroubleShootingSteps.md).
296
308
297
-
### 4.3 Get Application URL
309
+
### 5.2 Get Application URL
298
310
299
311
After successful deployment:
300
312
1. Open [Azure Portal](https://portal.azure.com/)
301
313
2. Navigate to your resource group
302
314
3. Find the Container App with "frontend"in the name
303
315
4. Copy the **Application URI**
304
316
305
-
⚠️ **Important:** Complete [Post-Deployment Steps](#step-5-post-deployment-configuration) before accessing the application.
317
+
⚠️ **Important:** Complete [Post-Deployment Steps](#step-6-post-deployment-configuration) before accessing the application.
306
318
307
-
## Step 5: Post-Deployment Configuration
319
+
## Step 6: Post-Deployment Configuration
308
320
309
-
### 5.1 Configure Authentication (Required)
321
+
### 6.1 Configure Authentication (Required)
310
322
311
323
**This step is mandatory for application access:**
0 commit comments