enterprise deployment docs (#1418)

## Enterprise Deployment Documentation

Added comprehensive deployment guides for Bifrost Enterprise across major cloud platforms and on-premise environments. These guides provide detailed instructions for deploying Bifrost using cloud-native identity federation and secure authentication methods.

## Changes

- Added overview page explaining the enterprise deployment architecture and authentication options
- Created detailed deployment guides for AWS (using IRSA/IAM Task Roles)
- Added GCP deployment guide using Workload Identity
- Added Azure deployment guide using Workload Identity Federation to GCP
- Created on-premise deployment guide for air-gapped environments
- Improved OpenAPI bundle workflow to handle branch detection and Git configuration

## Type of change

- [ ] Bug fix
- [ ] Feature
- [ ] Refactor
- [x] Documentation
- [x] Chore/CI

## Affected areas

- [ ] Core (Go)
- [ ] Transports (HTTP)
- [ ] Providers/Integrations
- [ ] Plugins
- [ ] UI (Next.js)
- [x] Docs

## How to test

1. Review the deployment guides for accuracy and completeness
2. Verify the OpenAPI bundle workflow changes by triggering the workflow

```sh
# Test OpenAPI bundle workflow
cd docs/openapi
python bundle.py
```

## Breaking changes

- [x] No

## Related issues

Addresses the need for enterprise deployment documentation

## Security considerations

- Guides follow security best practices for each cloud platform
- Authentication methods prioritize keyless approaches (IRSA, Workload Identity)
- Includes credential rotation procedures and security recommendations

## Checklist

- [x] I read `docs/contributing/README.md` and followed the guidelines
- [x] I updated documentation where needed
- [x] I verified the CI pipeline passes locally if applicable

Author: akshaydeo

.github/workflows/openapi-bundle.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches: ["main"]
     paths:
+      - ".github/workflows/openapi-bundle.yml"
       - "docs/openapi/**"
       - "!docs/openapi/openapi.json"
   pull_request:
@@ -29,27 +30,26 @@ jobs:
         with:
           python-version: "3.11"
 
+      - name: Configure Git
+        run: |
+          git config user.name "GitHub Actions Bot"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
       - name: Install dependencies
         run: pip install pyyaml
 
       - name: Bundle OpenAPI spec
         working-directory: ./docs/openapi
         run: python bundle.py
 
-      - name: Check for changes
-        id: changes
+      - name: Commit and push changes
         run: |
-          if git diff --quiet docs/openapi/openapi.json; then
-            echo "changed=false" >> $GITHUB_OUTPUT
-          else
-            echo "changed=true" >> $GITHUB_OUTPUT
+          CURRENT_BRANCH="$(git rev-parse --abbrev-ref HEAD)"
+          if [ "$CURRENT_BRANCH" = "HEAD" ]; then
+            # In detached HEAD state (common in CI), use GITHUB_REF_NAME or default to main
+            CURRENT_BRANCH="${GITHUB_REF_NAME:-main}"
           fi
 
-      - name: Commit and push changes
-        if: steps.changes.outputs.changed == 'true' && github.event_name == 'push'
-        run: |
-          git config --local user.email "github-actions[bot]@users.noreply.github.com"
-          git config --local user.name "github-actions[bot]"
           git add docs/openapi/openapi.json
           git commit -m "chore: regenerate openapi.json --skip-pipeline"
-          git push
+          git push origin "$CURRENT_BRANCH"

.github/workflows/release-pipeline.yml

@@ -82,6 +82,7 @@ jobs:
         uses: actions/setup-go@v5
         with:
           go-version: "1.25.5"
+      
       - name: Configure Git
         run: |
           git config user.name "GitHub Actions Bot"