Instalar la herramienta de desarrollo de la integración de Datadog Agent

Este documento explica cómo configurar un entorno de Python para que funcione en integraciones basadas en el Agent, incluida la instalación del intérprete y la herramienta de desarrollo.

Instalar Python

Muchos sistemas operativos vienen con una versión preinstalada de Python. Sin embargo, la versión de Python instalada por defecto puede no ser la misma que la utilizada por la última versión del Agent. Para asegurarte de que dispones de todo lo necesario para poner en marcha una integración, instala un intérprete dedicado al Python.

Instala Python 3.11 usando Homebrew:

  1. Actualizar Homebrew:

    brew update
    
  2. Instalar Python:

    brew install python@3.11
    
  3. Comprueba la salida de la instalación de Homebrew y ejecuta cualquier comando adicional recomendado por el script de instalación.

  4. Comprueba que el binario de Python está instalado en tu PATH y que se ha instalado la versión correcta:

    which python3.11
    

    Deberías ver la siguiente salida según la arquitectura de tu Mac:

    • Máquinas ARM (M1+):
      /opt/homebrew/bin/python3.11
      
    • MacOS en máquinas Intel:
      /usr/local/bin/python3.11
      
  1. Descarga el instalador ejecutable para Python 3.11 64 bit y ejecútalo.
  2. Selecciona la opción para añadir Python a tu PATH.
  3. Haz clic en Install Now (Instalar ahora).
  4. Una vez finalizada la instalación, reinicia el equipo.
  5. Comprueba que el binario de Python está instalado en tu PATH:
    > where python
    
    C:\Users\<USER>\AppData\Local\Programs\Python\Python39\python.exe
    

Para instalaciones de Linux, evita modificar tu sistema Python. Datadog recomienda instalar Python 3.11 usando pyenv o miniconda.

Instalar herramientas para desarrolladores

Tienes 2 opciones para instalar la CLI ddev.

Instalación mediante una GUI

  1. En tu navegador, descarga el archivo .pkg file: ddev-10.2.0.pkg
  2. Ejecuta el archivo descargado y sigue las instrucciones que aparecen en pantalla.
  3. Reinicia tu terminal.
  4. Para verificar que el comando ddev ha sido añadido a tu PATH, ejecuta el siguiente comando para recuperar la versión ddev:
    ddev --version
    10.2.0
    
  1. En tu navegador, descarga uno de los siguientes archivos .msi:
  2. Ejecuta el archivo descargado y sigue las instrucciones que aparecen en pantalla.
  3. Reinicia tu terminal.
  4. Para verificar que el comando ddev ha sido añadido a tu PATH, ejecuta el siguiente comando para recuperar la versión ddev:
    ddev --version
    10.2.0
    

Instalación desde la línea de comandos

  1. En tu navegador, descarga el archivo curl. El -o option specifies the file name that the downloaded package is written to. In this example, the file is written to ddev-10.2.0.pkg en el directorio actual.
    curl -o ddev-10.2.0.pkg https://github.com/DataDog/integrations-core/releases/download/ddev-v10.2.0/ddev-10.2.0.pkg
    
  2. Ejecute el programa estándar de macOS installer, especificando el archivo descargado .pkg como la fuente. Usa -pkg parameter to specify the name of the package to install, and the -target / parameter for the drive in which to install the package. The files are installed to /usr/local/ddev, and an entry is created at /etc/paths.d/ddev that instructs shells to add the /usr/local/ddev directory to. You must include sudo en el comando para conceder permiso de escritura a esas carpetas.
    sudo installer -pkg ./ddev-10.2.0.pkg -target /
    
  3. Reinicia tu terminal.
  4. Para verificar que el shell puede encontrar y ejecutar el comando ddev en tu PATH, utiliza el siguiente comando.
    ddev --version
    10.2.0
    
  1. Descarga y ejecuta el instalador mediante el programa estándar de Windows msiexec, especificando uno de los archivos .msi como la fuente. Utiliza los parámetros /passive y /i para solicitar una instalación independiente y normal.
    • x64:
      msiexec /passive /i https://github.com/DataDog/integrations-core/releases/download/ddev-v10.2.0/ddev-10.2.0-x64.msi
      
    • x86:
      msiexec /passive /i https://github.com/DataDog/integrations-core/releases/download/ddev-v10.2.0/ddev-10.2.0-x86.msi
      
  2. Reinicia tu terminal.
  3. Para verificar que el shell puede encontrar y ejecutar el comando ddev en tu PATH, utiliza el siguiente comando.
    ddev --version
    10.2.0
    

Instalar desde un binario independiente

Tras descargar el archivo correspondiente a tu plataforma y arquitectura, extrae el binario en un directorio que esté en tu PATH y renombra el binario como ddev.