> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Auth0 Deploy CLI

> Découvrez ce qu’est Auth0 Deploy CLI et comment il fonctionne.

<Card title="Avant de commencer">
  Configurez un [tenant Auth0](https://manage.auth0.com/).
</Card>

Auth0 Deploy CLI est un outil qui vous aide à gérer la configuration de votre tenant Auth0. Il s’intègre à vos flux de développement en tant que CLI autonome ou comme module Node.js.

Types de ressources pris en charge : `actions`, `branding`, `client grants`, `clients (applications)`, `connections`, `custom domains`, `email templates`, `emails`, `grants`, `guardian`, `hook secrets`, `log streams`, `migrations`, `organizations`, `pages`, `prompts`, `resource servers (APIs)`, `roles`, `tenant settings`, `themes`.

<div id="highlights">
  ## Points saillants
</div>

* **Conçu pour plusieurs environnements :** Pensé pour vous aider à tester les intégrations Auth0 de vos applications, de la branche de fonctionnalité jusqu’à la production.
* **Remplacement de mots-clés :** Configurations de ressources partagées entre tous les environnements, avec remplacement dynamique des mots-clés.
* **Polyvalent :** Intégrez-le à vos flux de travail CI/CD, que ce soit comme CLI ou comme module Node.

<div id="get-started">
  ## Pour commencer
</div>

Ce guide vous aidera à mettre en œuvre l’outil Deploy CLI en tant que CLI autonome. Trois grandes étapes sont nécessaires avant de pouvoir exécuter Deploy CLI :

1. [Créer une application Auth0 dédiée](#create-a-dedicated-auth0-application)
2. [Configurer Deploy CLI](#configure-the-deploy-cli)
3. [Appeler Deploy CLI](#call-the-deploy-cli)

<Warning>
  Cet outil peut entraîner des modifications destructrices dans votre tenant Auth0. Nous vous recommandons de bien comprendre la [configuration AUTH0\_ALLOW\_DELETE](/fr-CA/docs/deploy-monitor/deploy-cli-tool/configure-the-deploy-cli#auth0_allow_delete) et d’effectuer des tests sur des tenants de développement avant de l’utiliser en production.
</Warning>

<div id="install-the-deploy-cli">
  ### Installer l’outil Deploy CLI
</div>

Pour l’utiliser comme outil autonome en ligne de commande :

`npm install -g auth0-deploy-cli`

<div id="create-a-dedicated-auth0-application">
  ### Créer une application Auth0 dédiée
</div>

Pour que Deploy CLI puisse appeler la <Tooltip tip="Management API : un produit qui permet aux clients d’effectuer des tâches administratives." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=Management+API">Management API</Tooltip>, vous devez créer une application Auth0 dédiée afin qu’elle puisse effectuer des appels au nom de l’outil :

1. Accédez à **Auth0 Dashboard > Applications > Applications**.
2. Sélectionnez **+ Create Application**.

   1. Donnez-lui un nom descriptif (par exemple « Deploy CLI »).
   2. Sélectionnez **Machine to Machine Applications** comme **Application Type**.
   3. Sélectionnez **Create**.
3. Passez à la vue **Authorize Machine to Machine Application** :

   1. Sélectionnez **Auth0 Management API**.
   2. Sélectionnez les autorisations appropriées pour les ressources que vous souhaitez gérer. Consultez la section [Client Scopes](#client-scopes) pour en savoir plus.
   3. Sélectionnez **Authorize**.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Le client de Deploy CLI ne peut pas être configuré directement afin d’[éviter des modifications potentiellement destructrices](/fr-CA/docs/deploy-monitor/deploy-cli-tool/resource-specific-documentation#client-grants).
</Callout>

<div id="client-scopes">
  #### Portées du client
</div>

L’application désignée doit se voir accorder des portées afin de permettre au Deploy CLI d’exécuter des opérations de gestion.

Le principe du moindre privilège est respecté; il fonctionnera donc selon l’ensemble des autorisations accordées. Vous devrez sélectionner `read:clients`, mais il est recommandé de sélectionner les autorisations `read:*`, `create:*` et `update:*` pour tous les types de ressources visés par la gestion. Pour autoriser les suppressions, vous devez ajouter les portées `delete:*`.

<div id="configure-the-deploy-cli">
  ### Configurer le Deploy CLI
</div>

Vous pouvez configurer le Deploy CLI de deux façons :

1. Utiliser le fichier de configuration (`config.json`).
2. Définir des variables d’environnement.

Le choix d’utiliser l’une ou l’autre, ou les deux, dépend de votre cas d’usage et de vos préférences. Pour en savoir plus, consultez [Configurer le Deploy CLI](/fr-CA/docs/deploy-monitor/deploy-cli-tool/configure-the-deploy-cli).

Pour cet exemple, définissez les variables d’environnement suivantes :

* `AUTH0_DOMAIN`
* `AUTH0_CLIENT_ID`
* `AUTH0_CLIENT_SECRET`

Vous trouverez ces valeurs dans l’onglet **Settings** de l’application Auth0 dédiée que vous avez créée précédemment.

<div id="call-the-deploy-cli">
  ### Exécuter le Deploy CLI
</div>

Vous pouvez exécuter la commande `export` du Deploy CLI à l’aide de la commande suivante :

`a0deploy export --format=yaml --output_folder=local`

Une fois le processus terminé, examinez les fichiers de configuration des ressources générés dans le répertoire local. Exécutez ensuite la commande `import` pour envoyer la configuration de votre machine locale vers votre tenant Auth0 :

`a0deploy import --config_file=config.json --input_file local/tenant.yaml`

Pour obtenir la liste complète des indicateurs et des options, consultez [Utiliser comme CLI](/fr-CA/docs/deploy-monitor/deploy-cli-tool/use-as-a-cli).