Skip to content

Commit b340bba

Browse files
updated the readme
1 parent 71af9c7 commit b340bba

1 file changed

Lines changed: 24 additions & 12 deletions

File tree

docs/DeploymentGuide.md

Lines changed: 24 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -280,6 +280,22 @@ azd config set provision.preflight off
280280
azd up
281281
```
282282
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+
283299
**During deployment, you'll be prompted for:**
284300
1. **Environment name** (e.g., "cmsaapp") - Must be 3-16 characters long, alphanumeric only
285301
2. **Azure subscription** selection
@@ -288,38 +304,34 @@ azd up
288304

289305
**Expected Duration:** 9-14 minutes for default configuration (includes remotely building and pushing the container images)
290306

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-
295307
**⚠️ 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).
296308

297-
### 4.3 Get Application URL
309+
### 5.2 Get Application URL
298310

299311
After successful deployment:
300312
1. Open [Azure Portal](https://portal.azure.com/)
301313
2. Navigate to your resource group
302314
3. Find the Container App with "frontend" in the name
303315
4. Copy the **Application URI**
304316

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.
306318

307-
## Step 5: Post-Deployment Configuration
319+
## Step 6: Post-Deployment Configuration
308320

309-
### 5.1 Configure Authentication (Required)
321+
### 6.1 Configure Authentication (Required)
310322

311323
**This step is mandatory for application access:**
312324

313325
1. Follow [App Authentication Configuration](./AddAuthentication.md)
314326
2. Wait up to 10 minutes for authentication changes to take effect
315327

316-
### 5.2 Verify Deployment
328+
### 6.2 Verify Deployment
317329

318-
1. Access your application using the URL from Step 4.3
330+
1. Access your application using the URL from Step 5.2
319331
2. Confirm the application loads successfully
320332
3. Verify you can sign in with your authenticated account
321333

322-
### 5.3 Test the Application
334+
### 6.3 Test the Application
323335

324336
Follow the detailed workflow to test the migration functionality:
325337

@@ -333,7 +345,7 @@ Follow the detailed workflow to test the migration functionality:
333345

334346
📖 **Detailed Instructions:** See the complete [Sample Workflow](./SampleWorkflow.md) guide for step-by-step testing procedures.
335347

336-
## Step 6: Clean Up (Optional)
348+
## Step 7: Clean Up (Optional)
337349

338350
### Remove All Resources
339351
```shell

0 commit comments

Comments
 (0)