Add custom action, reusable workflow, and manual deploy

Module 7: Create setup-python-env composite action and update
run-tests.yml to use it in both test-api and test-e2e jobs.

Module 8: Extract deploy logic into reusable-deploy.yml, update
azure-dev.yml to call it, and add manual-deploy.yml for rollbacks.

Also update 6-deploy-azure.md with Bicep file descriptions,
corrected line reference, azd pipeline config prompts table,
and azd show step.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: GeekTrainer

.github/actions/setup-python-env/action.yml

@@ -0,0 +1,41 @@
+name: 'Setup Python Environment'
+description: 'Sets up Python, installs dependencies, and seeds the test database'
+
+inputs:
+  python-version:
+    description: 'Python version to use'
+    required: false
+    default: '3.14'
+  database-path:
+    description: 'Path to the test database file'
+    required: false
+    default: './test_dogshelter.db'
+
+outputs:
+  database-file:
+    description: 'Path to the seeded database file'
+    value: ${{ steps.seed.outputs.database-file }}
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Install dependencies
+      run: pip install -r server/requirements.txt
+      shell: bash
+
+    - name: Seed the database
+      id: seed
+      run: python server/utils/seed_test_database.py
+      shell: bash
+      env:
+        DATABASE_PATH: ${{ inputs.database-path }}
+
+    - name: Set output
+      run: echo "database-file=${{ inputs.database-path }}" >> $GITHUB_OUTPUT
+      shell: bash
+      id: set-output

.github/workflows/azure-dev.yml

@@ -13,28 +13,6 @@ permissions:
 
 jobs:
   deploy:
-    runs-on: ubuntu-latest
     if: github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success'
-    concurrency:
-      group: deploy-production
-      cancel-in-progress: false
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install azd
-        uses: Azure/setup-azd@v2
-
-      - name: Log in with Azure (Federated Credentials)
-        run: |
-          azd auth login \
-            --client-id "${{ vars.AZURE_CLIENT_ID }}" \
-            --federated-credential-provider "github" \
-            --tenant-id "${{ vars.AZURE_TENANT_ID }}"
-
-      - name: Provision and deploy
-        run: azd up --no-prompt
-        env:
-          AZURE_SUBSCRIPTION_ID: ${{ vars.AZURE_SUBSCRIPTION_ID }}
-          AZURE_ENV_NAME: ${{ vars.AZURE_ENV_NAME }}
-          AZURE_LOCATION: ${{ vars.AZURE_LOCATION }}
+    uses: ./.github/workflows/reusable-deploy.yml
+    secrets: inherit

.github/workflows/manual-deploy.yml

@@ -0,0 +1,20 @@
+name: Manual Deploy
+
+on:
+  workflow_dispatch:
+    inputs:
+      deploy-ref:
+        description: 'Git ref to deploy (commit SHA, tag, or branch)'
+        required: true
+        default: 'main'
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  deploy:
+    uses: ./.github/workflows/reusable-deploy.yml
+    with:
+      deploy-ref: ${{ inputs.deploy-ref }}
+    secrets: inherit

.github/workflows/reusable-deploy.yml

@@ -0,0 +1,39 @@
+name: Reusable Deploy Workflow
+
+on:
+  workflow_call:
+    inputs:
+      deploy-ref:
+        description: 'Git ref to deploy (commit SHA, tag, or branch). Defaults to the caller workflow ref.'
+        required: false
+        type: string
+        default: ''
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    concurrency:
+      group: deploy-production
+      cancel-in-progress: false
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.deploy-ref || github.sha }}
+
+      - name: Install azd
+        uses: Azure/setup-azd@v2
+
+      - name: Log in with Azure (Federated Credentials)
+        run: |
+          azd auth login \
+            --client-id "${{ vars.AZURE_CLIENT_ID }}" \
+            --federated-credential-provider "github" \
+            --tenant-id "${{ vars.AZURE_TENANT_ID }}"
+
+      - name: Deploy application
+        run: azd up --no-prompt
+        env:
+          AZURE_SUBSCRIPTION_ID: ${{ vars.AZURE_SUBSCRIPTION_ID }}
+          AZURE_ENV_NAME: ${{ vars.AZURE_ENV_NAME }}
+          AZURE_LOCATION: ${{ vars.AZURE_LOCATION }}

.github/workflows/run-tests.yml

@@ -20,38 +20,30 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+      - name: Setup Python environment
+        id: seed
+        uses: ./.github/actions/setup-python-env
         with:
           python-version: ${{ matrix.python-version }}
-          cache: 'pip'
-
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -r server/requirements.txt
+          database-path: ${{ vars.TEST_DATABASE_PATH }}
 
       - name: Run tests
+        run: python -m unittest test_app -v
         working-directory: ./server
-        run: |
-          python -m unittest test_app -v
+        env:
+          DATABASE_PATH: ${{ steps.seed.outputs.database-file }}
 
   test-e2e:
     runs-on: ubuntu-latest
 
     steps:
       - uses: actions/checkout@v4
 
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - name: Setup Python environment
+        id: seed
+        uses: ./.github/actions/setup-python-env
         with:
-          python-version: '3.14'
-          cache: 'pip'
-
-      - name: Install Python dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -r server/requirements.txt
+          database-path: ${{ vars.TEST_DATABASE_PATH }}
 
       - name: Set up Node.js
         uses: actions/setup-node@v4
@@ -71,3 +63,5 @@ jobs:
       - name: Run e2e tests
         working-directory: ./client
         run: npx playwright test
+        env:
+          DATABASE_PATH: ${{ steps.seed.outputs.database-file }}

content/github-actions/6-deploy-azure.md

@@ -203,11 +203,15 @@ When you said **yes** to `azd pipeline config`'s commit prompt, it pushed your c
 1. Navigate to the **Actions** tab. The push will trigger the **Run Tests** workflow first.
 2. Once tests complete successfully, the **Deploy App** workflow will start automatically (via the `workflow_run` trigger).
 3. Watch the deploy job run — it will provision Azure resources and deploy both the client and server applications.
-4. Once the deployment completes, expand the **Provision and deploy** step logs to find the application URLs.
-5. Open the client URL in your browser — you should see the pet shelter application live!
+4. Once the deployment completes return to your codespace.
+5. Run the following in the terminal to list the details of your new Azure environment:
 
-> [!TIP]
-> You can also find your deployment URLs by running `azd show` in the terminal.
+    ```bash
+    azd show
+    ```
+
+6. Look for the **client** service endpoint in the output.
+7. Open the client URL in your browser — you should see the pet shelter application live!
 
 ## Summary and next steps