Aller au contenu

Déployez votre site Astro sur Clever Cloud

Clever Cloud est une plateforme cloud européenne qui fournit des services automatisés et évolutifs.

Configuration du projet

Titre de la section Configuration du projet

Vous pouvez déployer à la fois des projets Astro entièrement statiques ou rendus à la demande sur Clever Cloud. Quel que soit votre mode de sortie (pré-rendu ou à la demande), vous pouvez choisir de déployer en tant qu’application statique qui s’exécute à l’aide d’un hook de post-construction, ou en tant qu’application Node.js, qui fonctionne immédiatement avec votre fichier package.json.

Port et hôte

Titre de la section Port et hôte

Les applications sur Clever Cloud écoutent sur le port 8080. Si votre projet nécessite cette configuration, définissez votre port et votre hôte dans Astro à l’un des deux emplacements suivants :

  1. Dans les scripts package.json :

    package.json
    "scripts": {
      "dev": "astro dev",
      "start": "astro dev",
      "build": "astro check && astro build",
      "preview": "astro preview --host 0.0.0.0 --port 8080",
      "astro": "astro"
    }

  2. Dans astro.config.mjs :

    astro.config.mjs
    import { defineConfig } from 'astro/config';
    

    export default defineConfig({
      server: {
        port: 8080,
        host: true
      }
    });

Déployer Astro depuis la console

Titre de la section Déployer Astro depuis la console

Pour déployer votre projet Astro sur Clever Cloud, vous devez créer une nouvelle application. L’assistant d’application vous guidera tout au long des étapes de configuration nécessaires.

  1. Dans la barre de menu latérale, cliquez sur Créer > Une application

  2. Choisissez comment déployer :

    • Créer une toute nouvelle application : pour déployer à partir d’un dépôt local avec Git

    ou

    • Sélectionnez un dépôt GitHub : pour déployer à partir de GitHub

  3. Sélectionnez une application Node.js ou une application statique.

  4. Définissez la taille minimale de votre instance et les options d’évolutivité. Les sites Astro peuvent généralement être déployés à l’aide de l’instance Nano. En fonction des spécifications et des dépendances de votre projet, vous devrez peut-être effectuer des ajustements en conséquence lorsque vous consultez les métriques de la page Présentation.

  5. Sélectionnez une région pour déployer votre instance.

  6. Ignorez la connexion des modules complémentaires à votre application Clever sauf si vous utilisez une base de données ou Keycloak.

  7. Injectez des variables d’environnement :

    • Pour Node.js, aucune variable d’environnement spécifique n’est nécessaire pour déployer Astro si vous utilisez npm. Si vous utilisez yarn ou pnpm, définissez les variables d’environnement suivantes :
    Fenêtre du terminal
    CC_NODE_BUILD_TOOL="custom"
    CC_PRE_BUILD_HOOK="npm install -g pnpm && pnpm install"
    CC_CUSTOM_BUILD_TOOL="pnpm run astro telemetry disable && pnpm build"
    CC_RUN_COMMAND="pnpm run preview"
    • Pour une application statique, ajoutez ces variables :
    Fenêtre du terminal
    CC_POST_BUILD_HOOK="npm run build"
    CC_PRE_BUILD_HOOK="npm install && npm run astro telemetry disable"
    CC_WEBROOT="/dist"

  8. Déployer ! Si vous effectuez un déploiement à partir de GitHub, votre déploiement doit démarrer automatiquement. Si vous utilisez Git, copiez le dépôt distant et effectuez un push sur la branche master.

Ressources officielles

Titre de la section Ressources officielles

Plus de guides de déploiement

Contribuer

Comment pouvons-nous vous aider ?

Créer une issue GitHub

Le moyen le plus rapide d'alerter notre équipe d'un problème.

Communauté