Aller au contenu

Déployer votre site Astro depuis Zerops

Zerops est une plateforme cloud axée sur le développement qui peut être utilisée pour déployer des sites Astro statiques et SSR.

Ce guide vous guidera dans la configuration et le déploiement de sites Astro statiques et SSR sur Zerops.

:::tip[Démarrage rapide Astro x Zerops]

Vous voulez tester Astro sur Zerops sans rien installer ni configurer ? En utilisant les dépôts Zerops x Astro - Static ou Zerops x Astro - SSR avec Node.js, vous pouvez déployer un exemple de site Astro en un seul clic.

:::

L'exécution d'applications sur Zerops nécessite deux étapes :

  1. Création d'un projet
  2. Déclenchement du pipeline de compilation et de déploiement

:::noteUn projet Zerops peut contenir plusieurs sites Astro.:::

Site Astro Static sur Zerops

Création d'un projet et d'un service pour Astro Static

Les projets et les services peuvent être ajoutés soit par un assistant Project add, soit importés en utilisant une structure yaml :

# voir https://docs.zerops.io/references/import pour la référence complète
project:
  name: recipe-astro
services:
  - hostname: app
    type: static

Cela va créer un projet appelé recipe-astro avec un service Zerops Static appelé app.

Déploiement de votre site Astro Static

Pour indiquer à Zerops comment construire et exécuter votre site, ajoutez un zerops.yml à votre dépôt :

 # voir https://docs.zerops.io/zerops-yml/specification pour la référence complète
 zerops:
 - setup: app
 build:
 base: nodejs@20
 buildCommands:
 - npm i
 - npm build
 deployFiles:
 - dist/~
 run:
 base: static

Maintenant, vous pouvez déclencher le pipeline de compilation et de déploiement en utilisant la CLI de Zerops ou en connectant le service app à votre dépôt GitHub / GitLab depuis le détail du service.

Site Astro SSR sur Zerops

Mettre à jour les scripts

Mettez à jour votre script start pour exécuter la sortie serveur de l'adaptateur Node.

"scripts": {
  "start": "node ./dist/server/entry.mjs",
}

Création d'un projet et d'un service pour Astro SSR (Node.js)

Les projets et les services peuvent être ajoutés soit par un assistant Project add, soit importés en utilisant une structure yaml :

# voir https://docs.zerops.io/references/import pour la référence complète
project:
  name: recipe-astro
services:
  - hostname: app
    type: nodejs@20

Cela créera un projet appelé recipe-astro avec un service Node.js Zerops appelé app.

Déploiement de votre site Astro SSR

Pour indiquer à Zerops comment compiler et exécuter votre site en utilisant l'adaptateur officiel Node.js d'Astro en mode standalone, ajoutez un fichier zerops.yml à votre dépôt :

 # voir https://docs.zerops.io/zerops-yml/specification pour la référence complète
 zerops:
 - setup: app
 build:
 base: nodejs@20
 buildCommands:
 - npm i
 - npm run build
 deployFiles:
 - dist
 - package.json
 - node_modules
 run:
 base: nodejs@20
 ports:
 - port: 3000
 httpSupport: true
 envVariables:
 PORT: 3000
 HOST: 0.0.0.0
 start: npm start

Maintenant, vous pouvez déclencher le pipeline de compilation et de déploiement en utilisant la CLI de Zerops ou en connectant le service app à votre dépôt GitHub / GitLab depuis le détail du service.

Déclencher le pipeline en utilisant la CLI de Zerops (zcli)

  1. Installez la CLI de Zerops.

    # Pour télécharger le binaire zcli directement,
# utilisez https://github.com/zeropsio/zcli/releases
npm i -g @zerops/zcli

  2. Ouvrez Settings > Access Token Management dans l'application Zerops et générez un nouveau jeton d'accès.

  3. Connectez-vous en utilisant votre jeton d'accès avec la commande suivante :

    zcli login <token>

  4. Naviguez jusqu'à la racine de votre application (où se trouve zerops.yml) et exécutez la commande suivante pour déclencher le déploiement :

    zcli push

Ressources

Officielles

Communautaires

Plus de guides de déploiement

Contribuer Communauté Parrainer