Skip to content
AMN Docs

02 - Lancement des Services

02 - Lancement des Services

Documentation technique

Audience : Développeurs
Durée estimée : 5-10 minutes
Prérequis : 01 - Configuration Environnement Local terminé

1. Vue d’ensemble

Le projet nécessite 4 services actifs pour le développement local :

  1. Astro Web (apps/web) - Frontend SSR
  2. Sanity Studio (apps/studio) - Interface d’édition CMS
  3. Form Handler (services/form-handler) - Worker de validation de formulaires
  4. Submission Processor (services/submission-processor) - Worker de traitement des soumissions

Important : Chaque service doit être lancé dans un terminal séparé car ils sont tous bloquants en mode interactif.

2. Lancement des services

2.1. Option 1 : Lancement manuel (4 terminaux)

Ouvrez 4 terminaux séparés et lancez les commandes suivantes :

Terminal 1 - Astro Web

Terminal window
task dev

Terminal 2 - Sanity Studio

Terminal window
task dev:studio

Terminal 3 - Form Handler

Terminal window
task dev:form-handler

Terminal 4 - Submission Processor

Terminal window
task dev:submission-processor

2.2. Option 2 : Lancement via task dev:services

Terminal window
task dev:services

Cette commande affiche les instructions pour lancer les 4 services, mais vous devez toujours les lancer manuellement dans des terminaux séparés.

2.3. Option 3 : Lancement via task dev:all

Terminal window
task dev:all

Cette commande affiche un rappel des 4 services à lancer avec leurs ports et leurs utilisations.

3. Vérification du démarrage

3.1. Vérifier Astro Web

Terminal window
curl http://localhost:4321

Attendu : Page HTML avec contenu “Hello, Astronaut!”

3.2. Vérifier Sanity Studio

Terminal window
curl http://localhost:3333

Attendu : Page HTML du Sanity Studio

3.3. Vérifier Form Handler

Terminal window
curl http://localhost:8787/health

Attendu : JSON avec status: "healthy"

3.4. Vérifier Submission Processor

Terminal window
curl http://localhost:8789/health

Attendu : JSON avec status: "healthy" et infos Sanity

4. Configuration des endpoints

4.1. Configuration locale

Dans le fichier .env à la racine du projet :

Terminal window
# Pour le développement local
WORKER_FORM_HANDLER_URL=http://localhost:8787/api/submit

4.2. Configuration production

Pour la production, l’endpoint sera automatiquement configuré via le Service Binding Cloudflare FORM_HANDLER.

5. Arrêt des services

Pour arrêter les services, utilisez Ctrl+C dans chaque terminal.

5.1. Arrêt sélectif

Vous pouvez arrêter uniquement les services dont vous n’avez plus besoin. Par exemple, si vous ne travaillez que sur le frontend, vous pouvez arrêter les Workers Cloudflare.

5.2. Arrêt complet

Pour arrêter tous les services, utilisez Ctrl+C dans les 4 terminaux.

6. Dépannage

6.1. Problèmes courants

Symptôme Cause probable Solution
Port déjà utilisé Service déjà lancé Vérifier avec lsof -i :4321 et arrêter le service
Wrangler login échoue Session expirée Relancer wrangler login
Sanity login échoue Session expirée Relancer sanity login
Variables d’environnement non chargées Fichier .env manquant Vérifier que .env existe à la racine

6.2. Logs

Pour voir les logs des services en temps réel :

Terminal window
# Logs Astro Web
# Visible dans le terminal où `task dev` est lancé


# Logs Workers
# Visible dans les terminaux où `task dev:form-handler` et `task dev:submission-processor` sont lancés

7. Checklist de validation

Avant de commencer le développement, vérifier :

8. Prochaine étape

Une fois les services lancés, passer à : 03 - Workflow de Développement

9. Historique des modifications

Date Version Description Auteur
2026-09-16 1.0 Création initiale Devin
Switch to normal mode

Contents

Built with StarlightPowered by Cloudflare