Installer l'outil de développement d'intégrations avec l'Agent de Datadog

Ce document explique comment configurer un environnement Python pour travailler sur des intégrations basées sur l’Agent, y compris l’installation de l’interpréteur et de l’outil de développement.

Installation de Python

La plupart des systèmes d’exploitation disposent d’une version de Python préinstallée, mais celle-ci peut différer de celle requise par la dernière version de l’Agent. Pour garantir le bon fonctionnement d’une intégration, installez un interpréteur Python spécifique.

Install Python 3.12 using Homebrew:

  1. Mettre à jour Homebrew :

    brew update
    
  2. Installer Python :

    brew install python@3.12
    
  3. Consultez la sortie d’installation de Homebrew et lancez les commandes additionnelles suggérées par le script si nécessaire.

  4. Vérifiez que le binaire Python est installé sur votre site PATH et que vous avez installé la bonne version :

    which python3.12
    

    En fonction de l’architecture de votre Mac, vous devriez obtenir les résultats suivants :

    • Machines ARM (M1+) :
      /opt/homebrew/bin/python3.12
      
    • MacOS sur les machines Intel :
      /usr/local/bin/python3.12
      
  1. Téléchargez le programme d’installation 64 bits de Python 3.12 et lancez-le.
  2. Sélectionnez l’option permettant d’ajouter Python à votre PATH.
  3. Cliquez sur Install Now.
  4. Une fois l’installation terminée, redémarrez votre machine.
  5. Vérifiez que le binaire Python est installé dans votre PATH :
    > where python
    
    C:\Users\<USER>\AppData\Local\Programs\Python\Python39\python.exe
    

For Linux installations, avoid modifying your system Python. Datadog recommends installing Python 3.12 using pyenv or miniconda.

Installer les outils de développement

Vous avez deux options pour installer la CLI ddev.

Installation à l’aide d’une interface graphique

  1. Dans votre navigateur, téléchargez le fichier .pkg : ddev-12.2.0.pkg
  2. Exécutez le fichier téléchargé et suivez les instructions à l’écran.
  3. Redémarrez votre terminal.
  4. Pour vérifier que la commande ddev a été ajoutée à votre PATH, exécutez la commande suivante pour récupérer la version ddev :
    ddev --version
    12.2.0
    
  1. Dans votre navigateur, téléchargez l’un des fichiers .msi suivants :
  2. Exécutez le fichier téléchargé et suivez les instructions à l’écran.
  3. Redémarrez votre terminal.
  4. Pour vérifier que la commande ddev a été ajoutée à votre PATH, exécutez la commande suivante pour récupérer la version ddev :
    ddev --version
    12.2.0
    

Installation à partir de la ligne de commande

  1. Téléchargez le fichier à l’aide de la commande curl. L’option -L autorise les redirections et l’option -o permet de spécifier le nom du fichier dans lequel le paquet téléchargé sera enregistré. Dans cet exemple, le fichier est enregistré sous le nom ddev-12.2.0.pkg dans le répertoire courant.
    curl -L -o ddev-12.2.0.pkg https://github.com/DataDog/integrations-core/releases/download/ddev-v12.2.0/ddev-12.2.0.pkg
    
  2. Exécutez le programme installer standard de macOS en indiquant le fichier .pkg téléchargé comme source. Utilisez le paramètre -pkg pour spécifier le nom du package à installer, et le paramètre -target / pour désigner le disque sur lequel installer le package. Les fichiers sont installés dans /usr/local/ddev, et une entrée est créée dans /etc/paths.d/ddev pour que les shells ajoutent automatiquement le répertoire /usr/local/ddev au PATH. Vous devez inclure sudo dans la commande pour obtenir les droits d’écriture nécessaires sur ces dossiers.
    sudo installer -pkg ./ddev-12.2.0.pkg -target /
    
  3. Redémarrez votre terminal.
  4. Pour vérifier que le shell peut trouver et exécuter la commande ddev dans votre PATH, utilisez la commande suivante.
    ddev --version
    12.2.0
    
  1. Téléchargez le fichier .msi et lancez l’installation avec l’utilitaire msiexec de Windows, en ajoutant les options /i et /passive pour une installation silencieuse standard.
    • x64 :
      msiexec /passive /i https://github.com/DataDog/integrations-core/releases/download/ddev-v12.2.0/ddev-12.2.0-x64.msi
      
    • x86 :
      msiexec /passive /i https://github.com/DataDog/integrations-core/releases/download/ddev-v12.2.0/ddev-12.2.0-x86.msi
      
  2. Redémarrez votre terminal.
  3. Pour vérifier que le shell peut trouver et exécuter la commande ddev dans votre PATH, utilisez la commande suivante.
    ddev --version
    12.2.0
    

Installation depuis un binaire autonome

Après avoir téléchargé l’archive correspondant à votre plateforme et à votre architecture, extrayez le binaire dans un répertoire présent dans votre PATH et renommez-le en ddev.