Guides
Guides
Configuration pour le développement
Commandes et points de départ pour contribuer.
Sur cette page
Ce guide aide les contributeurs à lancer les vérifications et un serveur de développement. Pour configurer une chaîne, consultez le guide des diffuseurs. Ces parcours sont indépendants; aucun ne démarre une pile complète de services.
Prérequis
Installez les versions indiquées dans go.mod, web/package.json et, pour l’entrée Twitch, app/twitch/ingress/mix.exs. Certains tests d’intégration exigent NATS, Valkey, MySQL ou des variables propres au service; consultez le test et son context.md pour leur configuration.
1. Vérifier les services Go
Depuis la racine du dépôt, lancez :
go test ./...
La commande se termine sans erreur si les tests sélectionnés réussissent. Examinez les tests ignorés avant de considérer un parcours d’intégration couvert.
2. Vérifier et lancer l’espace web
Dans un terminal distinct, partez de la racine du dépôt :
cd web
bun install --frozen-lockfile
bun run check
bun run test
bun run dev:dashboard
Les vérifications doivent se terminer sans erreur. La dernière commande reste active et affiche une adresse locale; arrêtez-la avec Ctrl+C. Pour lancer plutôt la documentation, partez de la racine du dépôt dans un terminal distinct :
cd web/docs
bun run dev
Le serveur de documentation affiche son adresse locale et reste actif jusqu’à son arrêt.
3. Vérifier l’entrée Twitch
Dans un terminal distinct, partez de la racine du dépôt :
cd app/twitch/ingress
mix deps.get
mix test
La commande de test doit se terminer sans erreur. Cette étape n’est nécessaire que pour travailler sur l’entrée Elixir.
Dépannage et suite
Si l’installation des dépendances échoue, vérifiez les versions requises. Si un test d’intégration ne peut pas se connecter, vérifiez ses systèmes externes et ses variables; ces commandes ne les provisionnent pas. Voir Tests pour les vérifications ciblées et État du système pour trouver les services.