イメージの取得とプロセスの実行は別の仕事
コンテナイメージをダウンロードする処理と、その内容からプロセスを起動する処理は同じではありません。OCIのイメージ仕様は配布する内容の表現を扱い、ランタイム仕様は設定された実行環境とライフサイクルを扱います。利用者向けの一つのコマンドが、裏で複数の役割をまとめて呼び出す場合があります。
例えばイメージの取得に成功しても、実行時に指定した作業ディレクトリやコマンドが存在しなければ起動できません。「イメージがあるので動くはず」と考えず、取得・展開・設定・実行という段階を分けて確認します。OCIに準拠するという言葉だけで、ネットワークやボリュームの管理方法まですべて共通になるわけではありません。
バンドルは実行に必要な設定をまとめる
ランタイムへ渡すバンドルには、config.jsonなどの設定と、設定が参照するルートファイルシステムなどを用意します。プロセスの引数、環境変数、作業ディレクトリ、実行ユーザーは、アプリケーションの振る舞いに直接関わります。環境変数を変えたことと、コンテナ内のファイルを書き換えたことも区別してください。
例えば同じプログラムを、作業ディレクトリ/appと/dataで起動すると、相対パスconfig.jsonが指すファイルは異なります。バンドルの場所、コンテナから見えるルート、その中の作業ディレクトリを一枚の表へ書き出すと、パスの取り違えを調べやすくなります。設定ファイルが読めることだけでは、その意味や権限が適切だとは判断できません。
createdとrunningを分ける
OCIのライフサイクルでは、creating、created、running、stoppedなどの状態を区別します。作成の準備ができた状態と、指定した利用者プロセスを実行し始めた状態は同じではありません。作成後に開始操作が失敗する場合には、準備段階まで成功したことと、アプリケーションが起動したことを分けて記録します。
説明例として、作成成功、開始失敗、状態確認、必要な後始末という順序を考えます。この場合に「作成が成功したのでサービスは稼働中」と表示すると、利用者へ誤った状態を伝えます。削除の可否や実行中の操作は仕様に従い、失敗を無視して同じ識別子で無条件に作り直すのではなく、残っている状態と資源を確認します。
隔離と権限は設定の中身で決まる
Linuxの実行環境では、名前空間、資源制御、ケイパビリティ、システムコールの制限などが関わります。新しいPID名前空間を用意することと、CPU時間の上限を設定することは別の目的です。ホストのどのパスをどの権限で渡すかによって、ファイルへ触れられる範囲も変わります。
たとえばホストの重要なディレクトリを読書き可能でマウントすれば、コンテナという名前だけではその内容を保護できません。アプリケーションの実行ユーザー、マウント、追加した権限を合わせて確認します。設定の指定可能範囲と、実際のカーネルや権限で実現できる範囲が異なる場合には、エラーや状態を確かめ、黙って保護できたことにしないようにします。
起動後の準備完了は別に確認する
プロセスがrunningでも、アプリケーションが設定を読み終え、接続先へ到達し、要求を受け付けられるとは限りません。起動直後にデータ移行やキャッシュの準備を行うサーバーなら、その間はまだ利用者へ応答できない場合があります。ランタイムの状態と、アプリケーションの準備状況を別の観測で確認します。
調査では、設定の妥当性、実行ファイルの起動、標準出力とエラー、終了コード、後始末の順に記録すると、どこまで進んだかが分かります。秘密を環境変数へ渡す場合も、ログや診断出力へそのまま出さない配慮が必要です。ランタイムは実行の土台を用意しますが、アプリケーションの正しさやサービス全体の可用性を自動的に保証するものではありません。