Déployez votre site Astro sur Deno

Vous pouvez déployer un site Astro rendu côté serveur sur Deno Deploy, un système distribué qui exécute JavaScript, TypeScript et WebAssembly à la pointe de la technologie, dans le monde entier.

Ce guide comprend des instructions pour le déploiement vers Deno Deploy via les actions sur GitHub ou la CLI de Deno Deploy.

Prérequis

Titre de la section Prérequis

Ce guide suppose que vous avez déjà installé Deno.

Configuration du projet

Titre de la section Configuration du projet

Votre projet Astro peut être déployé sur Deno Deploy en tant que site statique, ou en utilisant le rendu côté serveur (SSR).

Site statique

Titre de la section Site statique

Votre projet Astro est un site statique par défaut. Vous n’avez besoin d’aucune configuration supplémentaire pour déployer un site Astro statique dans Deno Deploy.

Adaptateur pour le SSR

Titre de la section Adaptateur pour le SSR

Pour activer SSR dans votre projet Astro et le déployer sur Deno Deploy :

Ajoutez l’adaptateur Deno pour activer SSR dans votre projet Astro avec la commande astro add suivante. Cela installera l’adaptateur et apportera les changements appropriés à votre fichier astro.config.mjs en une seule étape.

npx astro add deno

Si vous préférez installer l’adaptateur manuellement, suivez les deux étapes suivantes :

1. Installez l’adaptateur @deno/astro-adapter aux dépendances de votre projet en utilisant votre gestionnaire de paquets préféré. Si vous utilisez npm ou si vous n’êtes pas sûr, exécutez ceci dans le terminal :

   npm install @deno/astro-adapter

2. Mettez à jour votre fichier de configuration du projet astro.config.mjs avec les changements ci-dessous.

   astro.config.mjs

   import { defineConfig } from 'astro/config';
   import deno from '@deno/astro-adapter';
   
   export default defineConfig({
    output: 'server',
    adapter: deno(),
   });

   Ensuite, mettez à jour votre script preview dans package.json avec le changement ci-dessous.

   package.json

   {
     // ...
     "scripts": {
       "dev": "astro dev",
       "start": "astro dev",
       "build": "astro build",
       "preview": "astro preview"
       "preview": "deno run --allow-net --allow-read --allow-env ./dist/server/entry.mjs"
     }
   }

   Vous pouvez maintenant utiliser cette commande pour prévisualiser votre site Astro de façon locale avec Deno.

   npm run preview

Comment déployer un site Astro

Titre de la section Comment déployer un site Astro

Vous pouvez déployer Deno Deploy via les actions GitHub ou en utilisant l’interface de ligne de commande (CLI) de Deno Deploy.

Déploiement des actions GitHub

Titre de la section Déploiement des actions GitHub

Si votre projet est stocké sur GitHub, le site Deno Deploy vous guidera dans la mise en place des actions GitHub pour déployer votre site Astro.

1. Poussez votre code vers un dépôt GitHub public ou privé.

2. Connectez-vous sur Deno Deploy avec votre compte GitHub, et cliquez sur New Project.

3. Sélectionnez votre dépôt, la branche à partir de laquelle vous voulez déployer, et sélectionnez le mode GitHub Action. (Votre site Astro nécessite une étape de compilation, et ne peut pas utiliser le mode Automatique).

4. Dans votre projet Astro, créez un nouveau fichier .github/workflows/deploy.yml et collez le YAML ci-dessous. Ceci est similaire au YAML donné par Deno Deploy, avec les étapes supplémentaires nécessaires pour votre site Astro.

   Static

   .github/workflows/deploy.yml

   name: Déploiement
   on: [push]
   
   jobs:
     deploy:
       name: Déploiement
       runs-on: ubuntu-latest
       permissions:
         id-token: write # Nécessaire pour l'authentification avec Deno Deploy
         contents: read # Nécessaire pour cloner le dépôt
   
       steps:
         - name: Clonage du dépôt
           uses: actions/checkout@v4
   
         # Vous n'utilisez pas npm ? Remplacez `npm ci` par `yarn install` ou `pnpm i`
         - name: Installation des dépendances
           run: npm ci
   
         # Vous n'utilisez pas npm ? Remplacez `npm run build` par `yarn build` ou `pnpm run build`.
         - name: Construction du site Astro
           run: npm run build
   
         - name: Téléchargement vers Deno Deploy
           uses: denoland/deployctl@v1
           with:
             project: my-deno-project # TODO : remplacer par le nom du projet Deno Deploy
             entrypoint: jsr:@std/http/file-server
             root: dist

   SSR

   .github/workflows/deploy.yml

   name: Déploiement
   on: [push]
   
   jobs:
     deploy:
       name: Déploiement
       runs-on: ubuntu-latest
       permissions:
         id-token: write # Nécessaire pour l'authentification avec Deno Deploy
         contents: read # Nécessaire pour cloner le dépôt
   
       steps:
         - name: Clonage du dépôt
           uses: actions/checkout@v4
   
         # Vous n'utilisez pas npm ? Remplacez `npm ci` par `yarn install` ou `pnpm i`
         - name:Installation des dépendances
           run: npm ci
   
         # Vous n'utilisez pas npm ? Remplacez `npm run build` par `yarn build` ou `pnpm run build`.
         - name: Construction du site Astro
           run: npm run build
   
         - name: Téléchargement vers Deno Deploy
           uses: denoland/deployctl@v1
           with:
             project: my-deno-project # TODO : remplacer par le nom du projet Deno Deploy
             entrypoint: server/entry.mjs
             root: dist

5. Après avoir validé ce fichier YAML et l’avoir poussé sur GitHub sur la branche de déploiement configurée, le déploiement devrait commencer automatiquement !

   Vous pouvez suivre la progression en utilisant l’onglet “Actions” sur votre page de dépôt GitHub, ou sur Deno Deploy.

Déploiement CLI

Titre de la section Déploiement CLI

1. Installez le Deno Deploy CLI.

   deno install -gArf jsr:@deno/deployctl

2. Exécutez l’étape de compilation de votre Astro.

   npm run build

3. Exécutez deployctl pour déployer !

   Dans la commande ci-dessous, remplacez <ACCESS-TOKEN> par votre Personal Access Token et <MY-DENO-PROJECT> par le nom de votre projet Deno Deploy.

   Static

   cd dist && DENO_DEPLOY_TOKEN=<ACCESS-TOKEN> deployctl deploy --project=<MY-DENO-PROJECT> jsr:@std/http/file-server

   SSR

   DENO_DEPLOY_TOKEN=<ACCESS-TOKEN> deployctl deploy --project=<MY-DENO-PROJECT> --no-static --include=./dist ./dist/server/entry.mjs

   Vous pouvez suivre tous vos déploiements sur Deno Deploy.

4. (Optionnel) Pour simplifier la construction et le déploiement en une seule commande, ajoutez un script deploy-deno dans package.json.

   Static

   package.json

   {
     // ...
     "scripts": {
     "dev": "astro dev",
     "start": "astro dev",
     "build": "astro build",
     "preview": "astro preview",
     "deno-deploy": "npm run build && cd dist && deployctl deploy --project=<MY-DENO-PROJECT> jsr:@std/http/file-server"
     }
   }

   SSR

   package.json

   {
     // ...
     "scripts": {
       "dev": "astro dev",
       "start": "astro dev",
       "build": "astro build",
       "preview": "deno run --allow-net --allow-read --allow-env ./dist/server/entry.mjs",
       "deno-deploy": "npm run build && deployctl deploy --project=<MY-DENO-PROJECT> --no-static --include=./dist ./dist/server/entry.mjs"
     }
   }

   Vous pouvez alors utiliser cette commande pour construire et déployer votre site Astro en une seule étape.

   DENO_DEPLOY_TOKEN=<ACCESS-TOKEN> npm run deno-deploy

Plus de guides de déploiement

• 

  Netlify

• 

  Vercel

• 

  Deno Deploy

• 

  GitHub Pages

• 

  GitLab Pages

• 

  Cloudflare Pages

• 

  AWS

• 

  AWS via Flightcontrol

• 

  AWS via SST

• 

  Clever Cloud

• 

  Azion

• 

  Google Cloud

• 

  Firebase Hosting

• 

  Heroku

• 

  Microsoft Azure

• 

  Buddy

• 

  Edgio

• 

  Fleek

• 

  Fly.io

• 

  Render

• 

  Stormkit

• 

  Surge

• 

  Cleavr

• 

  Kinsta

• 

  Zeabur

• 

  Zerops