publish to azure storage

[newbe36524]

Summary by CodeRabbit

Release Notes

• New Features

  • Automatic synchronization of release artifacts to Azure Storage with versioned organization
  • Manual workflow trigger option for release synchronization

• Documentation

  • Updated README with CI/CD and release sync information
  • Added comprehensive Azure Storage configuration guide with setup instructions and best practices

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This PR establishes an automated release artifact synchronization pipeline from GitHub Releases to Azure Storage. It introduces a new GitHub Actions workflow, comprehensive setup documentation, design specifications, and task checklists for managing cross-platform release assets via SAS-based authentication with automatic index generation.

Changes

Cohort / File(s)	Summary
GitHub Actions Workflow .github/workflows/sync-azure-storage.yml	New workflow that triggers on release publication or manual dispatch. Validates AZURE_BLOB_SAS_URL secret, downloads release assets via gh CLI, parses SAS URL to extract storage credentials, uploads versioned assets to Azure Storage, generates and uploads index.json catalog, and handles error scenarios with diagnostic messaging.
Documentation & Configuration README.md, README.zh-CN.md, docs/azure-storage-sync.md	README files updated to document CI/CD pipeline and link to Azure Storage sync configuration. New comprehensive setup guide covering quick start, storage account/container creation, SAS URL generation, GitHub secret configuration, file organization, index structure, workflow triggers, CDN setup, security best practices, and troubleshooting.
Design & Specifications openspec/changes/archive/2025-02-07-azure-storage-release-sync/design.md, proposal.md, specs/ci-cd/spec.md, tasks.md	Design document detailing file distribution pipeline architecture, SAS authentication, and workflow orchestration with diagrams. Proposal outlining rationale and UX benefits. CI/CD specification defining artifact types (platform-specific formats), authentication methods, and status reporting. Task checklist for implementation and validation steps.

Sequence Diagram

sequenceDiagram
    participant GitHub as GitHub Platform
    participant Workflow as GitHub Actions
    participant GHCli as GitHub CLI
    participant AzureCli as Azure CLI
    participant Storage as Azure Storage

    GitHub->>Workflow: Release published or manual_dispatch
    Workflow->>Workflow: Validate AZURE_BLOB_SAS_URL secret
    Workflow->>GHCli: Get release tag & download assets
    GHCli-->>Workflow: Release assets (executables, archives)
    Workflow->>Workflow: Parse SAS URL (account, container, token)
    Workflow->>AzureCli: Upload assets to versioned path
    AzureCli->>Storage: Store files (version-based organization)
    Storage-->>AzureCli: Upload confirmation
    Workflow->>Workflow: Generate index.json (version + metadata)
    Workflow->>AzureCli: Upload index.json to container
    AzureCli->>Storage: Store catalog
    Storage-->>AzureCli: Confirmation
    Workflow->>AzureCli: Verify uploaded index
    AzureCli->>Storage: HEAD/GET index.json
    Storage-->>Workflow: Verification complete

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~65 minutes

Poem

🐰 A rabbit's ode to the Azure skies!

Release the assets, watch them fly,
To Azure clouds way up high,
With SAS tokens, safe and sound,
Versioned treasures, storage-bound,
Index catalogs, oh what delight!
Cross-platform sync done just right! 🚀

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch azuresync

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}