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:
Mettre à jour Homebrew :
Installer Python :
Consultez la sortie d’installation de Homebrew et lancez les commandes additionnelles suggérées par le script si nécessaire.
Vérifiez que le binaire Python est installé sur votre site PATH
et que vous avez installé la bonne version :
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
- Téléchargez le programme d’installation 64 bits de Python 3.12 et lancez-le.
- Sélectionnez l’option permettant d’ajouter Python à votre PATH.
- Cliquez sur Install Now.
- Une fois l’installation terminée, redémarrez votre machine.
- 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
- Dans votre navigateur, téléchargez le fichier
.pkg
: ddev-12.2.0.pkg - Exécutez le fichier téléchargé et suivez les instructions à l’écran.
- Redémarrez votre terminal.
- 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
:
- Dans votre navigateur, téléchargez l’un des fichiers
.msi
suivants : - Exécutez le fichier téléchargé et suivez les instructions à l’écran.
- Redémarrez votre terminal.
- 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
:
Installation à partir de la ligne de commande
- 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
- 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 /
- Redémarrez votre terminal.
- Pour vérifier que le shell peut trouver et exécuter la commande
ddev
dans votre PATH
, utilisez la commande suivante.
- 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
- Redémarrez votre terminal.
- Pour vérifier que le shell peut trouver et exécuter la commande
ddev
dans votre PATH
, utilisez la commande suivante.
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
.