Astro sites, served from the edge

Deploy

From astro build to live in five steps

The first three steps are the whole story for a static site. Steps four and five are there when you need them.

~/acme-docs — zsh

$ npx astro build

✓ 214 page(s) built in 6.83s

$ edge storage sync --delete \

./dist acme-docs/

✓ 1,482 objects in sync

$ edge cdn domains add cdn-7a19f2 \

--domain docs.acme.dev \

--origin-type storage \

--storage-bucket acme-docs --jit-image

$ edge cdn purge cdn-7a19f2

Origin servers0

docs.acme.devLive

Originbucket · acme-docs

Pages214 prerendered

1. 01

   Build and sync to a bucket

   The CDN serves index.html for directory paths, so Astro's default directory output works as-is.

   shellCopy

   $ npx astro build
   $ edge storage create acme-docs
   $ edge storage sync --delete ./dist acme-docs/

2. 02

   Serve the bucket through the CDN

   Point the domain's CNAME at cdn.edge.network. A certificate is issued within about a minute.

   shellCopy

   $ edge cdn create --name acme-docs
   $ edge cdn domains add cdn-7a19f2 \
       --domain docs.acme.dev \
       --origin-type storage \
       --storage-bucket acme-docs \
       --jit-image

3. 03

   Deploy on every push

   Build, sync, purge. The CLI reads EDGE_API_KEY from the environment, so a dedicated CI key is all it needs.

   .github/workflows/deploy.ymlCopy

   on:
     push:
       branches: [main]
   jobs:
     deploy:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v4
         - run: npm ci && npx astro build
         - run: curl -fsSL https://edge.network/install.sh | sh
         - env:
             EDGE_API_KEY: ${{ secrets.EDGE_API_KEY }}
           run: |
             edge storage sync --delete ./dist acme-docs/
             edge cdn purge cdn-7a19f2

4. 04

   Point <Image /> at the CDN

   Register this as image.service.entrypoint in astro.config.mjs. The <Image /> API stays the same; transforms happen at the edge.

   src/edge-image.tsCopy

   import type { ExternalImageService } from 'astro'
   
   const service: ExternalImageService = {
     getURL(options) {
       const { src: img } = options
       const src = typeof img === 'string' ? img : img.src
       const q = new URLSearchParams({ format: 'auto', quality: '75' })
       if (options.width) q.set('width', String(options.width))
       if (options.height) q.set('height', String(options.height))
       return `https://docs.acme.dev${src}?${q}`
     },
   }
   
   export default service

5. 05

   Optional: add on-demand routes

   Pages with export const prerender = false run on a VM. Serve dist/client from the bucket and the server entry from the VM.

   shellCopy

   $ npx astro add node
   $ edge compute create --name astro-ssr --size s-2vcpu-4gb \
       --image ubuntu-24 --region london --script nodejs
   
   $ npx astro build
   $ rsync -a dist/ root@<vm-ip>:/srv/site/
   $ ssh root@<vm-ip> "pm2 start /srv/site/server/entry.mjs"

Prefer to hand it off? Give the job to your AI agent or have our engineers do it.