Deploy your Astro Site to Zephyr Cloud

本頁內容尚未翻譯。

You can use Zephyr Cloud to deploy an Astro site with intelligent asset management, comprehensive build analytics, and first-class support for Module Federation architectures.

Zephyr operates on a Bring Your Own Cloud (BYOC) model, deploy to your choice of supported clouds through a unified interface without vendor lock-in. Switch providers anytime without changing your deployment workflow.

How to deploy

Automatic Installation

Add the Zephyr integration to your Astro project with the following command. This will install the integration and update your astro.config.mjs file automatically:
- npm
- pnpm
- Yarn
Terminal window
npx with-zephyr@latest
Terminal window
pnpm dlx with-zephyr@latest
Terminal window
yarn dlx with-zephyr@latest
Build and deploy your Astro site:
- npm
- pnpm
- Yarn
Terminal window
npm run build
Terminal window
pnpm run build
Terminal window
yarn run build
Your application is deployed! Zephyr will provide a deployment URL and comprehensive build analytics.

Manual Installation

Install the Zephyr Astro integration:

npm install zephyr-astro-integration

pnpm add zephyr-astro-integration

yarn add zephyr-astro-integration

Add the integration to your astro.config.mjs:

import { defineConfig } from 'astro/config';
import { withZephyr } from 'zephyr-astro-integration';

export default defineConfig({
  integrations: [
    withZephyr(),
  ],
});

Build and deploy your Astro site:
- npm
- pnpm
- Yarn
Terminal window
npm run build
Terminal window
pnpm run build
Terminal window
yarn run build
Your application is deployed! Zephyr will provide a deployment URL and comprehensive build analytics.

More details

For more detialed information refer to the Zephyr Cloud documentation on deploying with Astro.

What happens during deployment

When you build your Astro site with the Zephyr integration, the following process occurs:

Build Context Extraction: Zephyr captures Git information (commit, branch, author) and package metadata
Asset Hashing: All build outputs are hashed using SHA-256 for content-addressable storage
Delta Detection: Zephyr queries the CDN edge to identify which assets already exist
Optimized Upload: Only new or modified assets are uploaded
Snapshot Creation: An immutable deployment snapshot is created with all asset references
Analytics Upload: Build statistics, module graphs, and dependency information are sent to the dashboard
CDN Deployment: Assets are published to your configured CDN with permanent cache headers