View a markdown version of this page

Déployez une Astro.js application pour Amplify Hosting - AWS Amplify Hébergement

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Déployez une Astro.js application pour Amplify Hosting

Suivez les instructions suivantes pour déployer une Astro.js application sur Amplify Hosting. Vous pouvez utiliser une application existante ou créer une application de démarrage à l'aide de l'un des exemples officiels fournis par Astro. Pour créer une application de démarrage, voir Utiliser un thème ou un modèle de démarrage dans la documentation Astro.

Pour déployer un site Astro avec SSR sur Amplify Hosting, vous devez ajouter un adaptateur à votre application. Nous ne disposons pas d'un adaptateur appartenant à Amplify pour le framework Astro. Ce didacticiel utilise l'astro-aws-amplifyadaptateur créé par un membre de la communauté. Cet adaptateur est disponible sur github. com/alexnguyennz/astro-aws-amplify sur le site web. GitHub AWS ne maintient pas cet adaptateur.

Pour déployer une application Astro pour Amplify Hosting

  1. Sur votre ordinateur local, accédez à l'application Astro à déployer.

  2. Pour installer l'adaptateur, ouvrez une fenêtre de terminal et exécutez la commande suivante. Cet exemple utilise l'adaptateur communautaire disponible sur github. com/alexnguyennz/astro-aws-amplifier. Vous pouvez le astro-aws-amplify remplacer par le nom de l'adaptateur que vous utilisez.

    npm install astro-aws-amplify

  3. Dans le dossier de projet de votre application Astro, ouvrez le astro.config.mjs fichier. Mettez à jour le fichier pour ajouter l'adaptateur. Le fichier doit ressembler à ce qui suit.

    import { defineConfig } from 'astro/config';
import mdx from '@astrojs/mdx';
import awsAmplify from 'astro-aws-amplify';
 
import sitemap from '@astrojs/sitemap';
 
// https://astro.build/config
export default defineConfig({
  site: 'https://example.com',
  integrations: [mdx(), sitemap()],
  adapter: awsAmplify(),
  output: 'server',
});

  4. Validez la modification et transférez le projet vers votre dépôt Git.

    Vous êtes maintenant prêt à déployer votre application Astro sur Amplify.

  5. Connectez-vous à la console https://console.aws.amazon.com/amplify/ Amplify Console de gestion AWS et ouvrez-la.

  6. Sur la page Toutes les applications, choisissez Créer une nouvelle application.

  7. Sur la page Commencer à créer avec Amplify, choisissez votre fournisseur de référentiel Git, puis choisissez Next.

  8. Sur la page Ajouter une branche de référentiel, procédez comme suit :

    1. Sélectionnez le nom du référentiel auquel vous souhaitez vous connecter.

    2. Sélectionnez le nom de la branche du référentiel à connecter.

    3. Choisissez Suivant.

  9. Sur la page des paramètres de l'application, recherchez la section Paramètres de création. Pour Créer le répertoire de sortie, entrez.amplify-hosting.

  10. Vous devez également mettre à jour les commandes de génération du frontend de l'application dans la spécification de génération. Pour ouvrir la spécification de compilation, choisissez Modifier le fichier YML.

  11. Dans le amplify.yml fichier, localisez la section des commandes de génération du frontend. Saisissez mv node_modules ./.amplify-hosting/compute/default.

    Votre fichier de paramètres de compilation devrait ressembler à ce qui suit.

    version: 1
frontend:
    phases:
        preBuild:
            commands:
                - 'npm ci --cache .npm --prefer-offline'
        build:
            commands:
                - 'npm run build'
                - 'mv node_modules ./.amplify-hosting/compute/default'
    artifacts:
        baseDirectory: .amplify-hosting
        files:
            - '**/*'
    cache:
        paths:
            - '.npm/**/*'

  12. Choisissez Enregistrer.

  13. Si vous souhaitez qu'Amplify puisse transmettre les journaux des applications à Amazon CloudWatch Logs, vous devez l'activer explicitement dans la console. Ouvrez la section Paramètres avancés, puis choisissez Activer les journaux des applications SSR dans la section Déploiement du Server-Side rendu (SSR).

  14. Choisissez Suivant.

  15. Sur la page Révision, choisissez Enregistrer et déployer.