Flux de configuration

npm run setup s’exécute de façon interactive. Il pose des questions groupées, déduit certains défauts des réponses précédentes, puis écrit seulement les fichiers propres à l’instance selon les options choisies.

Utilisez cette page pour comprendre le flux de l’installateur avant de le lancer, ou pour améliorer un groupe de questions sans deviner le comportement des prompts voisins.

Chemin heureux

Le chemin heureux garde les zones optionnelles désactivées pendant la première configuration. Il crée une instance simple, écrit les fichiers de base et lance la vérification.

flowchart TD
A["Lancer
npm run setup"] --> C["Questions de base
de l'instance"]
C --> A0{"Configurer les analytics
maintenant?"}
A0 -->|"Non"| I["Access, langues
et fuseau horaire"]
I --> L{"Configurer juridiction
et pages liées?"}
L -->|"Non"| E{"Réviser les emails
de contact publics?"}
E -->|"Oui"| T["Contacts Trust, Safety
et sécurité"]
E -->|"Non"| T
T --> B{"Configurer
la marque?"}
B -->|"Non"| W["Écrire les fichiers
de l'instance"]
W --> V["Exécuter npm run check"]
V --> F["Afficher les
prochaines étapes"]

Instance de base

Les questions de base identifient le service de liens courts et préparent des valeurs utilisées par les groupes suivants.

flowchart LR
A["Questions de base
de l'instance"] --> D["Domaine court"]
D --> W["Nom du Worker"]
W --> O["Libellé propriétaire"]
O --> S["Écrire 3 pour la longueur
de slug aléatoire
si absente"]

L’installateur ne demande pas la longueur des slugs aléatoires. Les valeurs links.random_slug_length existantes sont conservées; les valeurs absentes sont écrites à 3.

Analytics

Les analytics commencent par une décision, pas par un choix de fournisseur obligatoire. Non reste sur le chemin heureux.

flowchart TD
A{"Configurer les analytics
maintenant?"}
A -->|"Non"| N["Utiliser le défaut
analytics désactivé"]
A -->|"Oui"| P["Fournisseur analytics"]
P --> O["Divulgation analytics
opérateur"]
O --> R["Rétention analytics
opérateur"]
N --> C["Continuer
la configuration"]
R --> C

Utilisez Analytics pendant la personnalisation lorsque vous êtes prêt à choisir les fournisseurs et le texte de rétention.

Access et localisation

Ces questions supportent les pages opérationnelles protégées, les variantes de langue générées et les horodatages des liens planifiés.

flowchart LR
A["Domaine d'équipe
Cloudflare Access"] --> L["Langues
supportées"]
L --> T["Fuseau horaire
opérateur"]
T --> N["Suite:
décision juridiction"]

Le fuseau horaire doit être un nom de fuseau IANA, comme America/Toronto.

Juridiction et contacts

Les pages légales peuvent rester désactivées pendant la première configuration. L’installateur demande tout de même le nom légal de l’opérateur et les contacts publics de signalement afin que les pages générées aient des défauts responsables.

flowchart TD
A{"Configurer juridiction
et pages liées?"}
A -->|"Non"| N["Nom légal
seulement"]
A -->|"Oui"| J["Juridiction"]
J --> G["Droit applicable"]
G --> P["Contacts opérateur
et confidentialité"]
N --> E{"Réviser les emails
de contact publics?"}
P --> E
E -->|"Oui"| D["Domaine opérateur
pour les emails"]
E -->|"Non"| C["Utiliser les contacts
existants ou défauts"]
D --> T["Contact Trust & Safety"]
C --> T
T --> R["Délai de réponse"]
R --> S["Contact sécurité"]
S --> U["Date de dernière
mise à jour"]

Utilisez Juridiction lorsque vous êtes prêt à activer et ajuster les pages légales publiques.

Marque

La marque peut rester désactivée pendant la première configuration. Si vous la configurez, les couleurs du logo texte sont indépendantes de la copie complète des pages publiques vers custom/public.

flowchart TD
A{"Configurer
la marque?"}
A -->|"Non"| D["Utiliser les défauts
de defaults/public"]
A -->|"Oui"| S{"Ajouter une ligne
de slogan?"}
S -->|"Oui"| L["Slogan de marque
par langue"]
S -->|"Non"| N["Aucun slogan"]
L --> W["Logo texte:
portion première couleur"]
N --> W
W --> G["Logo texte:
portion couleur accent"]
G --> P{"Avancé:
copier toutes les pages
par défaut vers custom/public?"}
P -->|"Non"| D
P -->|"Oui"| C["Copier defaults/public
pour modifier le HTML"]

Choisissez la copie avancée seulement lorsque vous voulez modifier manuellement les pages HTML publiques.

Écriture et vérification

Le dernier groupe écrit les fichiers propres à l’instance et vérifie le résultat.

flowchart TD
A["Réponses de setup
résolues"] --> L["custom/v8s-links.txt
créé si absent"]
L --> C["custom/v8s-site-config.json
mis à jour"]
C --> W["wrangler.toml
mis à jour"]
W --> V{"Vérification
activée?"}
V -->|"Oui"| R["Exécuter npm run check"]
V -->|"Non ou dry-run"| N["Afficher les
prochaines étapes"]
R --> N