ブログに戻る
一般記事

コンテナのユーザー切り替えツール gosu

エントリーポイントで gosu を使い、シグナルと TTY の境界を確認します。

コンテナのエントリーポイントでは、root 権限でディレクトリを作成したり、マウントしたファイルの所有者を調整したりすることがあります。アプリケーション自体は一般ユーザーで起動できます。gosu は UID/GID を切り替えた後、対象プロセスを直接実行します。

よくある問題

ファイルの所有者と対話端末

コンテナ内の root がホストのマウント先に書き込むと、生成されたファイルも root 所有になる場合があります。実行プロセスの UID/GID を合わせれば、後から所有者を修正する作業を減らせます。

エントリーポイントから sudo で対話型プログラムを起動する場合は、プロセス階層と TTY の扱いも確認します。挙動は設定によって変わるため、ユーザーを切り替えただけで端末制御が同じになるとは限りません。

シグナルの伝達

コンテナ停止時の SIGTERM はメインプロセスに届きます。親プロセスが残る構成では、その親が転送しなければアプリケーションにシグナルが届きません。exec gosu user server はシェルをサーバープロセスに置き換えます。

gosu とは?

gosu のプロジェクト説明によると、指定したユーザーとグループを解決し、身分を切り替えてからコマンドを実行します。シグナル転送用の別プロセスとしては残りません。

エントリーポイントの例

Dockerfile で gosu をインストールしてエントリーポイントを指定します。

Dockerfile
# 既存の基本イメージを基に作成
FROM some_base_image:latest

WORKDIR /app

# gosuをインストール
RUN apt-get update && apt-get install -y gosu && rm -rf /var/lib/apt/lists/*

# エントリーポイントスクリプトの準備
COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh

ENTRYPOINT ["/entrypoint.sh"]
CMD ["default_command"]

エントリーポイントでは指定された UID と GID に合わせてユーザーを作り、アプリケーションを起動します。

bash
#!/bin/bash
# USER_IDとGROUP_ID環境変数が設定されているか確認
if [ ! -z "$USER_ID" ] && [ ! -z "$GROUP_ID" ]; then
    # ユーザーグループとユーザーを作成
    groupadd -g "$GROUP_ID" usergroup
    useradd -u "$USER_ID" -g usergroup -m user
    # gosuを使ってコマンドを実行
    exec gosu user "$@"
else
    exec "$@"
fi

この例はプロセスの引き継ぎを示します。実際には UID/GID の入力を検証し、ベースイメージとマウント先の権限に合わせて設定します。

セキュリティ上の注意

gosu の TTY に関する議論では、権限境界を越えて同じ端末を保持する場合が扱われています。低権限のプロセスが開いた端末を引き継ぎ、環境によっては TIOCSTI で入力キューへ文字を注入できます。次の例は id と改行を注入します。

c
#include <unistd.h>
#include <sys/ioctl.h>
#include <stdio.h>

int main()
{
    for (char *cmd = "id\n"; *cmd; cmd++) {
        if (ioctl(STDIN_FILENO, TIOCSTI, cmd)) {
            fprintf(stderr, "ioctl failed\n");
            return 1;
        }
    }
    return 0;
}

この呼び出しは明示的な操作なしにキー入力を模倣します。影響は端末、カーネル設定、プロセスの権限によって変わります。コンテナに必ず新しい TTY が割り当てられるわけではありません。-t の有無、端末を保持するプロセス、引き継がれるファイル記述子を確認します。gosu は主にコンテナ起動時の root から一般ユーザーへの切り替えに使い、対話的な権限変更では TTY を別途確認してください。