次の項では、PHP エージェントの Ansible ロールの使用例を示します。

Example 1:以下は、Linux に PHP エージェントをインストールするための Ansible® ロールの例です。

---
- hosts: all
  tasks:
    - include_role:
        name: appdynamics.agents.php
      vars:
        agent_version: latest
        agent_type: php
        agent_action: upgrade 
        application_name: e-commerce 
        controller_account_access_key: "123key" 
        controller_host_name: "fieldlab.saas.appdynamics.com" 
        controller_account_name: "customer1"
        enable_ssl: false
        controller_port: 8090
        tier_name: tier1 
        node_name: node1 
        log_directory: "/opt/appdynamics/php-agent/ecommerce_logs" 
        zts_support: false 
        
        # proxy configs
        proxy_host: master.ecommerce-proxy.com 
        proxy_port: 8080
        proxy_user: ecommerce-user 
        proxy_password_file: /etc/ecommerce/passwd
        proxy_ctrl_dir: /ecommerce/proxy_dir/
YML

Example 2:以下は、エージェントがすでにインストールされている Linux で PHP エージェントをアップグレードするための Ansible ロールの例です。

---
- hosts: all
  tasks:
    - include_role:
        name: appdynamics.agents.php
      vars:
        agent_version: latest
        agent_type: php
        agent_action: upgrade 
        application_name: e-commerce 
        controller_account_access_key: "123key" 
        controller_host_name: "fieldlab.saas.appdynamics.com" 
        controller_account_name: "customer1"
        enable_ssl: false
        controller_port: 8090
        tier_name: tier1 
        node_name: node1 
        log_directory: "/opt/appdynamics/php-agent/ecommerce_logs" 
        zts_support: false 
        linux_custom_agent_install_path: "/home/ubuntu/ecommerce_agent/" #this path should contain the agent files (eg: install.sh ,php etc)
        custom_agent_ini_file: "/etc/php/7.4/cli/conf.d/appdynamics_agent.ini" #this file should contain your agent controller details
YML

PHP エージェントの変数

変数説明使用可能な値必須デフォルト
custom_agent_ini_fileappdynamics_agent.ini ファイルの絶対パスを設定します。<カスタムパス>
デフォルトでは、PHP 設定で設定されたデフォルトの .ini ファイルパスを取ります		はい（linux_custom_agent_install_path が定義されている場合）None
enable_cliCLI モードを有効にする場合は、true に設定します。true または falseオプションNone
enable_cli_long_runningtrue に設定すると、長期実行 CLI アプリケーションで PHP を保護します。「PHP CLI アプリケーション用エージェントの構成」を参照してください。true または falseオプションfalse
ignore_permissionsファイルとディレクトリのアクセス許可の問題を無視する場合は、true に設定します。true または falseオプションNone
log_directoryログディレクトリを指定します。デフォルトでは、エージェントディレクトリ内に logs フォルダが作成されます。<agent-directory>/logsオプション<agent-directory>/logs
php_executable_pathPHP バイナリのパスを指定します。/usr/bin/phpオプションglobal php path set
php_ini_dirappdynamics_agent.ini ファイルのディレクトリ。/etc/php/Ubuntu およびデフォルトの PHP CLI バイナリを特定できない場合に必要です。global php ini path set
php_extension_dirappdynamics_agent.so ファイルの拡張ディレクトリ。 /etc/php/extensions/Ubuntu およびデフォルトの PHP CLI バイナリを特定できない場合に必要です。global php extension path set
php_versionインストゥルメント化する PHP のバージョン。有効な形式は、1 つまたは 2 つの小数点があるバージョン番号です。たとえば、7.4 や 7.4.29 です。7.4.29デフォルトの PHP CLI バイナリを特定できない場合、または PHP CLI バイナリがない場合に必要です。global php verdsion set
zts_supportPHP ZTS エージェントをインストールするには、true に設定します。true または falseオプションfalse

重要

  1. php -i|grep appdynamics_agent.ini コマンドを使用して appdynamics_agent.ini パスを取得します。エージェントがデフォルトの場所にインストールされていない場合、または linux_custom_agent_install_path. を使用している場合は、custom_agent_ini_file を絶対ファイルパスで設定します。
  2. グローバルに設定されていない PHP バージョンでエージェントをインストールする場合は、以下の変数を定義する必要があります。これらはすべての agent_action の必須変数です。
    • php_executable_path
    • php_ini_dir
    • php_extension_dir
    • php_version

カスタムプロキシ設定の変数

変数説明使用可能な値必須デフォルト
proxy_hostプロキシサーバーを通じてコントローラにデータをルーティングするためのプロキシホスト。master.ecommerce-proxy.comオプションNone
proxy_portプロキシサーバーを通じてコントローラにデータをルーティングするためのプロキシポート。8090オプションNone
proxy_userプロキシサーバーホストにログインするために必要なプロキシユーザー。ecommere-userオプションNone
proxy_password_fileプロキシサーバーホストにログインするためのプロキシパスワードファイル。/etc/ecommerce/passwdオプションNone
proxy_ctrl_dirプロキシ制御ディレクトリ。指定しない場合、インストーラは一時的なディレクトリを作成します。/ecommerce/proxy_dir/オプションNone


Ansible® は米国およびその他の国における Red Hat, Inc. の登録商標です。