Passer au contenu principal
L’état des ressources Auth0 est exprimé dans deux formats de fichier de configuration : YAML et répertoire (JSON). Lorsque vous utilisez la commande export du Deploy CLI, vous êtes invité à choisir l’un ou l’autre.

YAML

Le format YAML se présente principalement sous la forme d’un fichier plat tenant.yaml, accompagné de fichiers de code complémentaires pour des ressources comme les Actions et les modèles de courriel. Ce fichier unique simplifie le suivi des modifications au fil du temps dans le contrôle de version. De plus, il élimine une certaine ambiguïté liée aux noms de répertoires et de fichiers, qui n’est pas toujours évidente au premier coup d’œil.

Répertoire (JSON)

Le format de répertoire répartit les types de ressources dans des répertoires distincts, chaque ressource étant stockée dans un fichier JSON dédié. Ce format permet de distinguer plus clairement chaque type de ressource, ainsi que les ressources individuelles elles-mêmes. De plus, le Deploy CLI reflète étroitement les structures de données définies dans la Auth0 Management API. Il peut donc être utile de consulter les exemples JSON de la documentation lorsque vous utilisez ce format.

Comment choisir

Le choix du format à utiliser devrait avant tout dépendre de votre préférence. Les deux formats sont des solutions viables qui permettent d’accomplir la même tâche, mais chacun présente des forces et des faiblesses légèrement différentes, comme décrit ci-dessus. Assurez-vous d’évaluer chaque option en fonction de votre contexte. Surtout, ce choix n’est pas définitif, et vous pouvez passer de l’un à l’autre avec la commande import.