Selective task execution
========================

タスクセレクターを使用する
--------------------------

``tpaexec deploy`` への\ ``--excluded_tasks``
および\ ``--included_tasks``
オプションを使用して、完全な展開を構成するタスクのサブセットのみを実行するようにTPAに指示できます。これらの引数はそれぞれ、セレクターのコンマ区切りリストとして扱われる文字列です。同様に、クラスター全体または個別のインスタンスに対して、
``config.yml`` の\ ``excluded_tasks`` および\ ``included_tasks``
変数を設定できます。 ``config.yml``
では、コンマ区切り文字列またはyamlリストを使用できます。

``excluded_tasks`` によって一致するタスクは常に除外されます。
``included_tasks``
を指定すると、一致しないタスクは暗黙的に除外されます。

以下に詳細を示すように、一部のセレクターはどちらのリストでも使用でき、一部は\ ``excluded_tasks``
リストでのみ使用できます。 ``tpaexec test``
には、別のセレクターセットが使用できます。

例
--

バーマン関連のタスクを実行せずに展開するには

.. code:: shell

   tpaexec deploy <clustername> --excluded_tasks=barman

repmgr関連のタスクのみを実行しているを展開するには

.. code:: shell

   tpaexec deploy <clustername> --included_tasks=repmgr

インスタンスにホスト名を設定せずに展開するには

.. code:: shell

   tpaexec deploy <clustername> --excluded_tasks=hostname

ブートストラップおよびsshタスクが実行されないようにするには、次を\ ``config.yml``
に追加します。

.. code:: yaml

   cluster_vars:
       excluded_tasks:
       - bootstrap
       - ssh

``tpaexec deploy`` でサポートされているセレクター
-------------------------------------------------

次のセレクターは、包含または除外のいずれかがサポートされています。

- バーテンダー

Barmanに関連するタスク 。

- bdr

BDRのセットアップに関連するタスクPGDクラスター内で使用される場合を含むこのセレクターが除外された場合、TPAはconfig.ymlで指定されたとおりに拡張機能をインストールおよび構成しますが、ノードグループを作成せず、ノードに参加しようとしません。

- create_pgd_proxy_system_user

pgd_proxyのシステムユーザーを作成するタスク

- create_postgres_system_user

postgresのシステムユーザーを作成するタスク

- efm

EFMに関連するタスク。

- etcd

etcdに関連するタスク

- first-backup

最小限のバーマンバックアップが存在することを保証するタスク。

- ハプロキシ

haproxyに関連するタスク。

- ハープ

harpに関連するタスク。

- パトローニ

パトローニに関連するタスク。

- pem-agent

PEMエージェントに関連するタスク。

- pem-server

PEMサーバーに関連するタスク。

- pem-webserver

PEMサーバーでのWebサーバーの構成に関連するタスク。

- pg-backup-api

BarmanのPostgresバックアップAPIに関連するタスク。

- pgbouncer

PgBouncerに関連するタスク。

- pgd-proxy

PGDプロキシに関連するタスク。

- pglogical

pglogicalに関連するタスク。

- pkg

システムパッケージマネージャーを使用してパッケージをインストールするタスク。

- 展開後

展開後フックが定義されている場合。

- postgres

postgresに関連するタスク。

- レプリカ

実行されるタスクとpostgresレプリカとして機能するインスタンス。

- repmgr

repmgrに関連するタスク

- リスタート

サービスを再起動するタスク

- sys

postgresまたは関連ソフトウェアに固有のタスクの前のシステムセットアップに関連するタスク。

- zabbix-agent

zabbixエージェントに関連するタスク。

次のセレクターは、除外の場合にのみサポートされています。

- アーティファクト

:ref:`Uploading artifacts <Uploading artifacts>`  に関連するタスク

- バーマン-クリーン

Barmanがソースからビルドされている場合、
Barmanビルドディレクトリをクリーンアップするタスク。

- barman-pre-config

barman-pre-configフックが定義されている場合。

- bdr-pre-node-creation

bdr-pre-node-creationフックが定義されている場合。

- bdr-post-group-creation

bdr-post-group-creationフックが定義されている場合。

- bdr-pre-group-join

bdr-pre-group-joinフックが定義されている場合。

- ブートストラップ

残りの展開が実行される前に、Pythonおよびその他の最小限の依存関係が存在することを確認するタスク。関連する要件を手動でインストールしたことが確かな場合にのみ、これを除外します。

- ビルドクリーン

ソースからビルドされているソフトウェアのビルドディレクトリをクリーンアップするタスク。

- build-configure

ソースからビルドされているソフトウェアを構成するタスク。

- Cloudinit

Cloud-initによって管理されるホストでのみ実行されるタスク。

- コミットスコープ

BDRコミットスコープの構成に関連するタスク。

- config

構成ファイルを作成するタスク。

- efm-pre-config

efm-pre-configフックが定義されている場合。

- efm-post-config

efm-post-configフックが定義されている場合。

- fs

インスタンスでの追加の :ref:`Filesystem configuration <Filesystem configuration>` のセットアップに関連するタスク。

- ホストキー

:ref:`Managing SSH host keys <Managing SSH host keys>`  を設定するタスク

- ホスト名

ホスト名を設定するタスク。

- ホスト

:ref:`Configuring /etc/hosts <Configuring /etc/hosts>` のタスク

- initdb

initdbを実行するタスク

- ローカルリポジトリ

:ref:`Creating and using a local repository <Creating and using a local repository>`  を設定するタスク

- ロケール

:ref:`Locale <Locale>`  をインストールするタスク

- openvpn

OpenVPNを設定するタスク。

- pg-backup-api-clean

PostgresバックアップAPIがソースからビルドされている場合、ビルドディレクトリをクリーンアップするタスク。

- pgbouncer-config

pgbouncerの構成ファイルを作成するタスク。

- pgpass

:ref:`Configuring .pgpass <Configuring .pgpass>` ファイルを作成するタスク。

- リポ後

リポ後フックが定義されている場合。

- postgres-clean

postgresがソースからビルドされている場合、buildディレクトリをクリーンアップするタスク。

- postgres-config

postgres-configフックが定義されている場合。

- postgres-config-final

postgres-config-finalフックが定義されている場合。

- 事前展開

展開前フックが定義されている場合。

- pre-initdb

pre-initdbフックが定義されている場合。

- レプリケーションセット

BDR3クラスター上の監視専用レプリケーションセットに関連するタスク。

- repmgr-clean

repmgrがソースからビルドされている場合、ビルドディレクトリをクリーンアップするタスク。

- repmgr-configure

repmgrがソースからビルドされている場合に構成するタスク。

- リポジトリ

パッケージリポジトリを設定するタスク。

- rsyslog

rsyslogに関連するタスク。

- サービス

構成や再起動を含むシステムサービスに関連するタスク。

- src

ソースからパッケージをビルドおよびインストールするタスク。

- ssh

インスタンス間のsshの設定に関連するタスク。

- ssh-cluster-key-config

クラスターSSH公開キーを\ ``ansible_user``
のデフォルトrootのauthorized_keysファイルに追加するタスク。これは、authorized_keysが外部で管理されているプラットフォームまたは読み取り専用であるプラットフォームでは除外できます。

- sysctl

sysctl設定を設定およびリロードするタスク。

- sysstat

sysstatサービスに関連するタスク。

- tpa

インスタンスにインストールされるTPA独自のファイルに関連するタスク。

- ユーザー

システムユーザーの設定に関連するタスク。

- ウォッチドッグ

パトロニクラスター上のカーネルウォッチドッグに関連するタスク。

``tpaexec test`` でサポートされているセレクター
-----------------------------------------------

次のセレクターは、\ ``tpaexec test`` の実行にのみ適用されます。

- 迷彩柄

BDRまたはPGDクラスターでのCAMOのテストに関連するタスク。

- ddl

BDRまたはPGDクラスターでのDDLのテストに関連するタスク。

- 失敗

問題が検出されたかどうかを中止するタスク。障害に関係なくテストを実行するには、このセレクターを除外します。

- pgbench

pgbenchを実行するタスク

- sys

システムレベルのテストを実行するタスク。

- barman、bdr、haproxy、pg-backup-api、pgbouncer、pgd-proxy、postgres、repmgr、

さまざまなソフトウェアコンポーネントをテストするタスク。
