Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Docker で CAP_IPC_LOCK および CAP_SYS_NICE ケーパビリティを設定する

View as MarkdownEdit this pageReport an issueSet up docs MCP

質問

Docker で ClickHouse を実行すると、システムに CAP_IPC_LOCK および CAP_SYS_NICE の ケーパビリティ がないという警告が Docker から表示されます。これを解消するにはどうすればよいですか？

CAP_SYS_NICE または CAP_SYS_NICE capability がない場合のログメッセージは、次のようになります。

docker run -d --name clickhouse-server \
    --ulimit nofile=262144:262144 \
    --network clickhouse-net \
    -p 8123:8123 -p 9000:9000 -p 9009:9009 -p 9363:9363 \
    clickhouse/clickhouse-server:23.2
2023.04.19 08:04:10.022720 [ 1 ] {} <Information> Application: It looks like the process has no CAP_IPC_LOCK capability, binary mlock will be disabled. It could happen due to incorrect ClickHouse package installation. You could resolve the problem manually with 'sudo setcap cap_ipc_lock=+ep /usr/bin/clickhouse'. Note that it will not work on 'nosuid' mounted filesystems.

2023.04.19 08:04:10.065860 [ 1 ] {} <Information> Application: It looks like the process has no CAP_SYS_NICE capability, the setting 'os_thread_priority' will have no effect. It could happen due to incorrect ClickHouse package installation. You could resolve the problem manually with 'sudo setcap cap_sys_nice=+ep /usr/bin/clickhouse'. Note that it will not work on 'nosuid' mounted filesystems.

回答

  1. コンテナーにIPC_LOCKおよびSYS_NICEのケーパビリティを付与するため、--cap-add引数を2つ追加します：
docker run -d --name clickhouse-server \
   --cap-add=SYS_NICE \
   --cap-add=IPC_LOCK \
   --ulimit nofile=262144:262144 \
   --network clickhouse-net \
   -p 8123:8123 -p 9000:9000 -p 9009:9009 -p 9363:9363 \
   clickhouse/clickhouse-server:23.2
  1. 次のコマンドを使用して、コンテナー内で ケーパビリティ を確認できることを確認します。
apt-get update > /dev/null && apt-get install -y libcap2-bin > /dev/null && capsh --print

レスポンスは次のようになります:

debconf: delaying package configuration, since apt-utils is not installed
WARNING: libcap needs an update (cap=40 should have a name).
Current: = cap_chown,cap_dac_override,cap_fowner,cap_fsetid,cap_kill,cap_setgid,cap_setuid,cap_setpcap,cap_net_bind_service,cap_net_raw,cap_ipc_lock,cap_sys_chroot,cap_sys_nice,cap_mknod,cap_audit_write,cap_setfcap+ep
Bounding set =cap_chown,cap_dac_override,cap_fowner,cap_fsetid,cap_kill,cap_setgid,cap_setuid,cap_setpcap,cap_net_bind_service,cap_net_raw,cap_ipc_lock,cap_sys_chroot,cap_sys_nice,cap_mknod,cap_audit_write,cap_setfcap
Ambient set =
Securebits: 00/0x0/1'b0
 secure-noroot: no (unlocked)
 secure-no-suid-fixup: no (unlocked)
 secure-keep-caps: no (unlocked)
 secure-no-ambient-raise: no (unlocked)
uid=0(root) euid=0(root)
gid=0(root)
groups=0(root)
Guessed mode: UNCERTAIN (0)
  1. ClickHouse の 2 つの ケーパビリティ を手動で設定する
setcap "cap_ipc_lock=+ep cap_sys_nice=+ep" /usr/bin/clickhouse
  1. ケーパビリティ が適用されていることを確認します。
getcap -v /usr/bin/clickhouse

次のように表示されます。

/usr/bin/clickhouse = cap_ipc_lock,cap_sys_nice+ep
  1. ClickHouse serverを再起動すると、ログメッセージは表示されなくなるはずです。

詳細については、Linux capabilities に関するこちらの記事を参照してください。

Navigation