「Automation Action」の Ansible センサーを有効化および設定する

このセンサーを有効にする前に、以下の手順を完了してください：

1. 「自動化フレームワークの安全な使用方法」 に記載されている情報を確認してください。
2. センサーを自社管理（オンプレミス）環境で使用する場合は、 自動化機能フラグが有効になっていることを確認してください。

「Automation Action」の Ansible センサーは、デフォルトでは無効になっています。 センサーを有効にするには、次の例に示すようにエージェントの設定ファイルを更新してください。

com.instana.plugin.action.ansible:
  enabled: true # by default is false
  url: <ansible_url> # Ansible Automation Controller url
  apiPath: <api_path> # Optional, default path is /api/v2. For Ansible Automation Controller 2.5+, use /api/controller/v2
  token: # the token to connect to Ansible Automation Controller
    configuration_from:
      type: vault
      secret_key:
        path: <secret_path>
        key: <secret_key>
 

以下の例は、コンフィギュレーションにおけるプレーン・テキスト・トークンの使用例を示すものであり、あくまで参考用である。

com.instana.plugin.action.ansible:
  enabled: true # by default is false
  url: <ansible_url> # Ansible Automation Controller url
  apiPath: <api_path> # Optional, default path is /api/v2. For Ansible Automation Controller 2.5+, use /api/controller/v2
  token: <ansbile_token> # the token to connect to Ansible Automation Controller
 

Ansible センサーは、デフォルトで 10 個の Ansible アクションを並行して実行できます。 並行 Ansible アクションの最大数を変更するには、以下の例に示すように、エージェント構成ファイル内の Ansible センサー構成に maxConcurrentActions 属性を追加します。

com.instana.plugin.action.ansible:
  enabled: true
  maxConcurrentActions: 5  # optional, default value is 10
 

デフォルトでは、 Ansible アクションは300秒後にタイムアウトします。 Ansible アクションの実行におけるデフォルトのタイムアウトを変更したい場合は、エージェント設定ファイル内の Ansible センサー設定セクションに、次のように属 defaultTimeout 性を追加してください：

com.instana.plugin.action.ansible:
  enabled: true
  defaultTimeout: 30 # optional, default timeout is 300 seconds
 

アクションカタログ内の Ansible アクションで Vault パラメータを使用する場合、ホストエージェントをシークレットマネージャー と連携させる必要があります。

この手順は、 1.0.56 以前のバージョンを使用している場合のみ必要です。

「Automation Action」の Ansible センサーの以前のバージョンでは、 Ansible のオートメーションコネクタイメージが使用されています。 このセンサーを使用するには、 Instana エージェント上でコンテナ管理エンジン（ Docker または Podman ）が利用可能であることを確認してください。

センサーは、 Ansible 自動化コネクター・イメージを使用して Ansible 自動化コントローラーに接続し、そこでジョブを実行します。 センサーがアクティブ化されると、自動化コネクター・イメージが icr.io/instana/actions レジストリーからプルされます。

エージェント・マシンが icr.io イメージ・レジストリーにアクセスできない場合は、センサー構成で offline=true を設定し、エージェント・システム上の ローカル・レジストリーに自動化コネクター・イメージをロードします 。

自動化コネクターを構成するには、以下の例に示すようにエージェント構成ファイルを更新します。

com.instana.plugin.action.ansible:
  enabled: true
  url: <ansible_url>
  token:
    configuration_from:
      type: vault
      secret_key:
        path: <secret_path>
        key: <secret_key>
  connector:
    container_mgmt_engine: docker|podman # the container management engine
    host_port: 9080 # the port on the host to bind the connector container to
    ready_timeout: 60 # optional, default timeout is 300 seconds
    offline: false|true # optional, default is false