Datadog Agent Integration Developer Tool をインストールする

このドキュメントでは、インタープリターのインストール、必要な依存関係がすべて存在することの確認など、Agent ベースのインテグレーションを開発するための Python 環境の設定方法について説明します。または、各リリースで提供されているスタンドアロンバイナリやインストーラーを使用することもできます。

GitHub リリース

リリースでは、以下を提供しています。

  • Linux、Windows、macOS 用スタンドアロンバイナリ
  • Windows AMD64 (64-bit) MSI インストーラー
  • Windows x86 (32-bit) MSI インストーラー
  • Windows ユニバーサル (AMD64+x86) EXE インストーラー
  • macOS DMG インストーラー

Python のインストール

多くのオペレーティングシステムには、Python のプレインストール版が搭載されています。しかし、デフォルトでインストールされている Python のバージョンは、Agent で使用するバージョンよりも古い場合があり、必要なツールや依存関係が不足している場合があります。インテグレーションを実行するために必要なものがすべて揃っていることを確認するために、専用の Python インタプリターをインストールしてください。

Homebrew を使って Python 3.9 をインストールします。

  1. Homebrew を更新します。

    brew update
    
  2. Python をインストールします。

    brew install python@3.9
    
  3. Homebrew のインストール出力を確認し、インストールスクリプトが推奨する追加のコマンドを実行します。

  4. Python のバイナリが PATH にインストールされていることと、正しいバージョンがインストールされていることを確認します。

    which python3.9
    

    お使いの Mac のアーキテクチャに応じて、以下の出力が表示されるはずです。

    • ARM (M1+) マシン:
      /opt/homebrew/bin/python3.9
      
    • Intel マシンの MacOS:
      /usr/local/bin/python3.9
      
  1. Python 3.9 64-bit 実行形式インストーラーをダウンロードし、実行します。
  2. Python を PATH に追加するオプションを選択します。
  3. Install Now をクリックします。
  4. インストールが完了したら、マシンを再起動します。
  5. Python のバイナリが PATH にインストールされていることを確認します。
    > where python
    
    C:\Users\<USER>\AppData\Local\Programs\Python\Python39\python.exe
    

Linux のインストールでは、システムの Python を変更することは避けてください。Datadog は、pyenv または miniconda を使用して Python 3.9 をインストールすることを推奨します。

pipx のインストール

pipx python パッケージは ddev コマンドラインツールに必要です。

  1. pipx をインストールします。

    brew install pipx
    
  2. Homebrew のインストール出力を確認し、インストールスクリプトが推奨する追加のコマンドを実行します。

  3. pipx がインストールされていることを確認します。

    which pipx
    

    お使いの Mac のアーキテクチャに応じて、以下の出力が表示されるはずです。

    • ARM (M1+) マシン:
      /opt/homebrew/bin/pipx
      
    • Intel マシンの MacOS:
      /usr/local/bin/pipx
      
  1. pipx をインストールします。

    python -m pip install pipx
    
  2. pipx がインストールされていることを確認します。

    > where pipx
    C:\Users\<USER>\AppData\Local\Programs\Python\Python39\Scripts\pipx.exe
    
  1. pipx をインストールします。
    python -m pip install pipx
    
  2. pipx がインストールされていることを確認します。
    pipx --version
    

Datadog Agent Integration Developer Tool をインストールする

  1. 以下のコマンドを実行し、出力に表示されている実行ファイルをすべて削除します。

    which -a ddev
    
  2. 仮想環境が起動していないことを確認します。

    1. 次のコマンドを実行します。

      echo $VIRTUAL_ENV
      
    2. コマンドが出力を返した場合、仮想環境は実行されています。仮想環境を終了するには、deactivate を実行します。

  3. ddev をインストールします。

    このコマンドは sudo で実行しないでください。
    • ARM (M1+) マシン:

      pipx install ddev --python /opt/homebrew/bin/python3.9
      
    • Intel マシンの MacOS:

      pipx install ddev --python /usr/local/bin/python3.9
      
  4. インストール出力を確認し、インストールスクリプトが推奨する追加のコマンドを実行します。

  1. ddev をインストールするには、以下を実行します。
    pipx install ddev
    
  1. ddev をインストールするには、以下を実行します。

    このコマンドは `sudo` で実行しないでください。
    pipx install ddev