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
には、別のセレクターセットが使用できます。
例#
バーマン関連のタスクを実行せずに展開するには
tpaexec deploy <clustername> --excluded_tasks=barman
repmgr関連のタスクのみを実行しているを展開するには
tpaexec deploy <clustername> --included_tasks=repmgr
インスタンスにホスト名を設定せずに展開するには
tpaexec deploy <clustername> --excluded_tasks=hostname
ブートストラップおよびsshタスクが実行されないようにするには、次をconfig.yml
に追加します。
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エージェントに関連するタスク。
次のセレクターは、除外の場合にのみサポートされています。
アーティファクト
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
インスタンスでの追加の Filesystem configuration のセットアップに関連するタスク。
ホストキー
Managing SSH host keys を設定するタスク
ホスト名
ホスト名を設定するタスク。
ホスト
initdb
initdbを実行するタスク
ローカルリポジトリ
Creating and using a local repository を設定するタスク
ロケール
Locale をインストールするタスク
openvpn
OpenVPNを設定するタスク。
pg-backup-api-clean
PostgresバックアップAPIがソースからビルドされている場合、ビルドディレクトリをクリーンアップするタスク。
pgbouncer-config
pgbouncerの構成ファイルを作成するタスク。
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、
さまざまなソフトウェアコンポーネントをテストするタスク。