Présentation de la CLI
Installez la CLI, connectez-vous, associez un dossier de projet à un site et mettez-le en ligne.
npm install -g @atelier201/cli
atelier201 auth login
atelier201 accountatelier201 auth login ouvre un navigateur, vous demande à quel espace de travail vous connecter et quelles
autorisations accorder, puis enregistre le jeton dans le trousseau de clés de votre système d’exploitation,
pas dans un fichier caché. Sur une machine sans navigateur, utilisez atelier201 auth login --device.
Du dossier de projet à la mise en ligne
atelier201 sites create "Maison Dupont" --link # crée le site et associe ce dossier
atelier201 site pull # récupère ici ses fichiers
# ...edit...
atelier201 site push --build --wait # envoie le dossier, lance la compilation et attend sa fin
atelier201 previews create # crée un lien privé vers cette compilation
atelier201 publish # affiche ce qui sera mis en ligne, demande confirmation, puis publieChaque commande de site accepte --site <id> ou utilise le site associé au dossier courant.
atelier201 site link --site <id> crée .atelier201/site.json. Ce fichier ne contient aucun secret et est ajouté à .gitignore.
Pour modifier des textes, des entrées et des informations sur l’entreprise, privilégiez les commandes de gestion du contenu aux modifications de fichiers : elles vérifient les données par rapport au modèle de contenu du site et ne peuvent pas casser la mise en page.
atelier201 content set business:/tagline "Fresh bread daily"Consultez Commandes pour découvrir toutes les commandes, et Modèle de contenu et médias pour savoir ce que contient un site.
Sortie
La sortie est automatiquement au format JSON lorsque stdout n’est pas un terminal. La redirection vers jq
fonctionne directement, et aucune commande ne nécessite l’option --json en intégration continue. Dans un terminal, vous obtenez un tableau. Choisissez le format avec --output json|table|ndjson.
Codes de sortie
Un script peut traiter chaque résultat sans analyser un message :
| Code | Signification |
|---|---|
| 0 | Réussite |
| 1 | Échec inattendu |
| 2 | Utilisation incorrecte ou requête rejetée comme non valide par le serveur |
| 3 | Problème d’authentification ou d’autorisation |
| 4 | Introuvable |
| 5 | Limite de requêtes atteinte |
| 6 | Conflit : conflit d’écriture, mise en ligne obsolète ou limite de l’offre |