@khester/create-dynamics-app 1.0.8 → 1.1.0

package/templates/dynamics-365-starter/deployment/pipelines/github-actions.yml

@@ -0,0 +1,422 @@
+# GitHub Actions Workflow - Dual Platform Support
+# Supports both Windows and Linux runners for mixed development teams
+
+name: Deploy to Dynamics 365
+
+on:
+  push:
+    branches: [main, develop, feature/*]
+    paths-ignore:
+      - "docs/**"
+      - "*.md"
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: "Environment to deploy to"
+        required: true
+        default: "dev"
+        type: choice
+        options:
+          - dev
+          - test
+          - prod
+      platform:
+        description: "Platform to use for deployment"
+        required: true
+        default: "linux"
+        type: choice
+        options:
+          - linux
+          - windows
+
+env:
+  NODE_VERSION: "18.x"
+  NPM_CONFIG_CACHE: ${{ github.workspace }}/.npm
+
+jobs:
+  # Build Job - Linux for speed
+  build:
+    name: Build Application
+    runs-on: ubuntu-latest
+    outputs:
+      artifact-id: ${{ steps.upload.outputs.artifact-id }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: "npm"
+
+      - name: Cache dependencies
+        uses: actions/cache@v3
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-node-
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linting
+        run: npm run lint
+
+      - name: Run type checking
+        run: npm run typecheck
+
+      - name: Run tests
+        run: npm run test
+
+      - name: Build production bundle
+        run: npm run build:prod
+
+      - name: Upload build artifacts
+        id: upload
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-artifacts-${{ github.sha }}
+          path: |
+            dist/
+            deployment/
+          retention-days: 7
+
+  # Development Deployment - Linux with Bash
+  deploy-dev:
+    name: Deploy to Development (Linux/Bash)
+    if: github.ref == 'refs/heads/develop' || (github.event_name == 'workflow_dispatch' && github.event.inputs.environment == 'dev')
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: development
+      url: ${{ vars.D365_DEV_ORG_URL }}
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: build-artifacts-${{ github.sha }}
+
+      - name: Make scripts executable
+        run: |
+          chmod +x deployment/scripts/*.sh
+          ls -la deployment/scripts/
+
+      - name: Display platform information
+        run: |
+          echo "🍎 LINUX DEPLOYMENT STRATEGY"
+          echo "Runner: ${{ runner.os }}"
+          echo "Platform: Linux (ubuntu-latest)"
+          echo "Scripts: Bash (.sh files)"
+          echo "Compatible with: Mac developers, Linux CI/CD"
+          echo ""
+
+      - name: Validate environment setup
+        run: |
+          echo "Validating development environment..."
+          ./deployment/scripts/validate-setup.sh || echo "Validation completed with warnings"
+
+      - name: Deploy to Development
+        run: |
+          echo "Deploying to development environment using Bash..."
+          ./deployment/scripts/deploy.sh dev --verbose
+        env:
+          D365_CLIENT_ID: ${{ secrets.D365_DEV_CLIENT_ID }}
+          D365_CLIENT_SECRET: ${{ secrets.D365_DEV_CLIENT_SECRET }}
+          D365_TENANT_ID: ${{ secrets.D365_DEV_TENANT_ID }}
+          D365_ORG_URL: ${{ vars.D365_DEV_ORG_URL }}
+
+      - name: Run post-deployment health check
+        run: |
+          ./deployment/scripts/health-check.sh dev
+        continue-on-error: true
+
+  # Test Deployment - Windows with PowerShell
+  deploy-test:
+    name: Deploy to Test (Windows/PowerShell)
+    if: github.ref == 'refs/heads/main' || (github.event_name == 'workflow_dispatch' && github.event.inputs.environment == 'test')
+    needs: build
+    runs-on: windows-latest
+    environment:
+      name: test
+      url: ${{ vars.D365_TEST_ORG_URL }}
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: build-artifacts-${{ github.sha }}
+
+      - name: Display platform information
+        shell: pwsh
+        run: |
+          Write-Host "🖥️ WINDOWS DEPLOYMENT STRATEGY" -ForegroundColor Cyan
+          Write-Host "Runner: ${{ runner.os }}"
+          Write-Host "Platform: Windows (windows-latest)"
+          Write-Host "Scripts: PowerShell (.ps1 files)"
+          Write-Host "Compatible with: Windows developers, Azure DevOps"
+          Write-Host ""
+
+      - name: Install PowerShell modules
+        shell: pwsh
+        run: |
+          Write-Host "Installing required PowerShell modules..." -ForegroundColor Blue
+          Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -Force -AllowClobber -Scope CurrentUser
+          Install-Module -Name Microsoft.PowerApps.PowerShell -Force -AllowClobber -Scope CurrentUser
+
+          Write-Host "Verifying module installation..." -ForegroundColor Blue
+          Get-Module -Name Microsoft.PowerApps* -ListAvailable
+
+      - name: Validate environment setup
+        shell: pwsh
+        run: |
+          Write-Host "Validating test environment..." -ForegroundColor Blue
+          try {
+            .\deployment\scripts\validate-setup.ps1
+          } catch {
+            Write-Warning "Validation completed with warnings: $_"
+          }
+
+      - name: Deploy to Test
+        shell: pwsh
+        run: |
+          Write-Host "Deploying to test environment using PowerShell..." -ForegroundColor Green
+          .\deployment\scripts\deploy.ps1 -Environment test -Verbose
+        env:
+          D365_CLIENT_ID: ${{ secrets.D365_TEST_CLIENT_ID }}
+          D365_CLIENT_SECRET: ${{ secrets.D365_TEST_CLIENT_SECRET }}
+          D365_TENANT_ID: ${{ secrets.D365_TEST_TENANT_ID }}
+          D365_ORG_URL: ${{ vars.D365_TEST_ORG_URL }}
+
+      - name: Run post-deployment health check
+        shell: pwsh
+        run: |
+          .\deployment\scripts\health-check.ps1 -Environment test
+        continue-on-error: true
+
+  # Production Deployment - Flexible platform based on input
+  deploy-prod:
+    name: Deploy to Production
+    if: |
+      (github.ref == 'refs/heads/main' && github.event_name == 'push') ||
+      (github.event_name == 'workflow_dispatch' && github.event.inputs.environment == 'prod')
+    needs: [build, deploy-test]
+    runs-on: ${{ github.event.inputs.platform == 'windows' && 'windows-latest' || 'ubuntu-latest' }}
+    environment:
+      name: production
+      url: ${{ vars.D365_PROD_ORG_URL }}
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: build-artifacts-${{ github.sha }}
+
+      # Linux/Mac Production Deployment
+      - name: Deploy to Production (Linux/Bash)
+        if: runner.os == 'Linux'
+        run: |
+          echo "🍎 PRODUCTION DEPLOYMENT - LINUX/BASH STRATEGY"
+          echo "Runner: ${{ runner.os }}"
+          echo "Chosen for: Stability, consistency with development workflow"
+          echo ""
+
+          # Make scripts executable
+          chmod +x deployment/scripts/*.sh
+
+          echo "Creating production backup..."
+          ./deployment/scripts/backup.sh prod
+
+          echo "Deploying to production environment..."
+          ./deployment/scripts/deploy.sh prod --verbose
+
+          echo "Running comprehensive health checks..."
+          ./deployment/scripts/health-check.sh prod
+        env:
+          D365_CLIENT_ID: ${{ secrets.D365_PROD_CLIENT_ID }}
+          D365_CLIENT_SECRET: ${{ secrets.D365_PROD_CLIENT_SECRET }}
+          D365_TENANT_ID: ${{ secrets.D365_PROD_TENANT_ID }}
+          D365_ORG_URL: ${{ vars.D365_PROD_ORG_URL }}
+
+      # Windows Production Deployment
+      - name: Deploy to Production (Windows/PowerShell)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Write-Host "🖥️ PRODUCTION DEPLOYMENT - WINDOWS/POWERSHELL STRATEGY" -ForegroundColor Cyan
+          Write-Host "Runner: ${{ runner.os }}"
+          Write-Host "Chosen for: Enterprise PowerShell workflows, Windows-first environments"
+          Write-Host ""
+
+          # Install required modules
+          Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -Force -AllowClobber -Scope CurrentUser
+          Install-Module -Name Microsoft.PowerApps.PowerShell -Force -AllowClobber -Scope CurrentUser
+
+          Write-Host "Creating production backup..." -ForegroundColor Blue
+          .\deployment\scripts\backup.ps1 -Environment prod
+
+          Write-Host "Deploying to production environment..." -ForegroundColor Green
+          .\deployment\scripts\deploy.ps1 -Environment prod -Verbose
+
+          Write-Host "Running comprehensive health checks..." -ForegroundColor Blue
+          .\deployment\scripts\health-check.ps1 -Environment prod
+        env:
+          D365_CLIENT_ID: ${{ secrets.D365_PROD_CLIENT_ID }}
+          D365_CLIENT_SECRET: ${{ secrets.D365_PROD_CLIENT_SECRET }}
+          D365_TENANT_ID: ${{ secrets.D365_PROD_TENANT_ID }}
+          D365_ORG_URL: ${{ vars.D365_PROD_ORG_URL }}
+
+      - name: Create deployment summary
+        run: |
+          echo "## 🚀 Production Deployment Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### Platform Information" >> $GITHUB_STEP_SUMMARY
+          echo "- **Runner OS**: ${{ runner.os }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Platform Choice**: ${{ github.event.inputs.platform || 'auto-selected' }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Deployment Time**: $(date)" >> $GITHUB_STEP_SUMMARY
+          echo "- **Commit SHA**: ${{ github.sha }}" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### Cross-Platform Compatibility ✅" >> $GITHUB_STEP_SUMMARY
+          echo "This deployment produces identical results whether run on:" >> $GITHUB_STEP_SUMMARY
+          echo "- 🖥️ Windows with PowerShell (.ps1 scripts)" >> $GITHUB_STEP_SUMMARY
+          echo "- 🍎 macOS with Bash (.sh scripts)" >> $GITHUB_STEP_SUMMARY
+          echo "- 🐧 Linux with Bash (.sh scripts)" >> $GITHUB_STEP_SUMMARY
+
+  # Cross-platform validation job
+  validate-cross-platform:
+    name: Cross-Platform Validation
+    if: github.event_name == 'pull_request'
+    needs: build
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        include:
+          - os: ubuntu-latest
+            platform: "Linux/Mac"
+            script-type: "Bash (.sh)"
+            script-cmd: "./deployment/scripts/validate-setup.sh"
+          - os: windows-latest
+            platform: "Windows"
+            script-type: "PowerShell (.ps1)"
+            script-cmd: '.\deployment\scripts\validate-setup.ps1'
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: build-artifacts-${{ github.sha }}
+
+      - name: Setup platform-specific environment
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Install-Module -Name Microsoft.PowerApps.Administration.PowerShell -Force -AllowClobber -Scope CurrentUser
+          Install-Module -Name Microsoft.PowerApps.PowerShell -Force -AllowClobber -Scope CurrentUser
+
+      - name: Make scripts executable (Linux/Mac)
+        if: runner.os == 'Linux'
+        run: chmod +x deployment/scripts/*.sh
+
+      - name: Validate platform compatibility
+        shell: ${{ runner.os == 'Windows' && 'pwsh' || 'bash' }}
+        run: |
+          echo "=== CROSS-PLATFORM VALIDATION ==="
+          echo "Platform: ${{ matrix.platform }}"
+          echo "Runner OS: ${{ runner.os }}"
+          echo "Script Type: ${{ matrix.script-type }}"
+          echo "Validation Command: ${{ matrix.script-cmd }}"
+          echo ""
+
+          # Run platform-specific validation
+          ${{ matrix.script-cmd }} || echo "Validation completed with warnings"
+
+          echo ""
+          echo "✅ Platform validation successful for ${{ matrix.platform }}"
+          echo "🤝 Compatible with mixed development teams"
+
+  # Documentation and team guidance
+  team-guidance:
+    name: Team Development Guidance
+    if: always()
+    needs: [build]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Cross-Platform Development Summary
+        run: |
+          cat << 'EOF'
+
+          ╔══════════════════════════════════════════════════════════════╗
+          ║               CROSS-PLATFORM TEAM DEVELOPMENT               ║
+          ║                      GITHUB ACTIONS EDITION                 ║
+          ╚══════════════════════════════════════════════════════════════╝
+
+          🎯 DEPLOYMENT STRATEGY:
+          ├── Build: Linux (ubuntu-latest) for speed
+          ├── Dev Deploy: Linux + Bash (Mac developer experience)
+          ├── Test Deploy: Windows + PowerShell (enterprise validation)
+          └── Prod Deploy: Flexible (Linux default, Windows optional)
+
+          👥 TEAM MEMBER COMPATIBILITY:
+
+          🖥️  WINDOWS DEVELOPERS:
+             • Local Scripts: deployment/scripts/*.ps1
+             • Quick Start: deployment/QUICKSTART-WINDOWS.md
+             • Team Setup: deployment/scripts/team-onboarding.ps1
+             • Pipeline: Uses windows-latest runner for test/prod
+
+          🍎 MAC DEVELOPERS:
+             • Local Scripts: deployment/scripts/*.sh
+             • Quick Start: deployment/QUICKSTART-MAC.md
+             • Team Setup: deployment/scripts/team-onboarding.sh
+             • Pipeline: Uses ubuntu-latest runner (Linux compatibility)
+
+          ✅ COMPATIBILITY GUARANTEES:
+          ├── ✅ Same deployment results across all platforms
+          ├── ✅ Shared JSON configuration files
+          ├── ✅ Identical build artifacts and processes
+          ├── ✅ Compatible logging and error reporting
+          └── ✅ Cross-platform CI/CD pipeline support
+
+          🔧 COMMAND EQUIVALENTS:
+
+          Local Development:
+          │ Windows: .\deployment\scripts\deploy.ps1 -Environment dev
+          │ Mac:     ./deployment/scripts/deploy.sh dev
+          │ Result:  Identical deployment to Dynamics 365
+
+          GitHub Actions:
+          │ All platforms use the same workflow
+          │ Runner selection optimized for each stage
+          │ Manual platform override available for production
+
+          🚀 WORKFLOW DISPATCH OPTIONS:
+          │ Manual triggers support both environment and platform selection
+          │ Default: Linux for consistency and speed
+          │ Override: Windows for enterprise PowerShell workflows
+
+          📚 GETTING STARTED:
+          1. Choose your platform guide:
+             • Windows: deployment/QUICKSTART-WINDOWS.md
+             • Mac: deployment/QUICKSTART-MAC.md
+          2. Run team onboarding script for your platform
+          3. All team members share the same GitHub Actions workflow
+          4. Local development scripts match your platform preference
+
+          💡 This workflow ensures seamless collaboration between
+             Windows and Mac developers on the same D365 project!
+
+          EOF
+
+      - name: Add to job summary
+        run: |
+          echo "## 🤝 Cross-Platform Team Development" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "This GitHub Actions workflow supports mixed Windows/Mac development teams:" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- **Windows Developers**: Use PowerShell scripts locally, Windows runners in CI/CD" >> $GITHUB_STEP_SUMMARY
+          echo "- **Mac Developers**: Use Bash scripts locally, Linux runners in CI/CD" >> $GITHUB_STEP_SUMMARY
+          echo "- **Shared Pipeline**: Same workflow file works for entire team" >> $GITHUB_STEP_SUMMARY
+          echo "- **Identical Results**: Platform-agnostic deployment outcomes" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "See deployment/QUICKSTART-WINDOWS.md or deployment/QUICKSTART-MAC.md for platform-specific setup guides." >> $GITHUB_STEP_SUMMARY