dockerfile の exec 形式の CMD 内で環境変数を展開する方法

Question

dockerfile の exec 形式の CMD で環境変数を使用する方法を探しています。

CMD hoge --port $PORT

の意味合いとなるような記述を

CMD ["hoge","--port","$PORT"]

のように記述したいのですが、環境変数を展開することができません。
exec 形式がシェルを呼び出さないためと認識していますが、うまい方法があったりするのでしょうか？

背景

ざっくりと言ってしまうと、既存で動作している docker image を heroku に持っていきたいと考えたためです。

元の image では、ENTRYPOINTに exec 形式で起動コマンドが記述されていたのですが、heroku に移すにあたって、CMDへ変更、かつportオプションが必要であることがわかりました。

(portオプションを与えないと、heroku 指定以外の固定ポートで立ち上がるため、crush してしまうようで、オプションで$PORTを指定してやる必要があるようです。)

ワークアラウンドとしては、exec 形式ではなく、シェル形式を使用することが一般的なようなので、そちらが本命なのですが、別の問題があって exec 形式の方法も捨てきれていません。

ご存知またはヒントになりそうな情報をお持ちの方、よろしくおねがいします。

(余談)
exec 形式ってドキュメント内で連呼されているんですけど、一般的な呼称なのでしょうか？配列で与えられた値を連結させて実行させるものと適当に読み替えて設定していますが、もし仕様が記述されている箇所があれば教えていただけると助かります。

指摘を受けての追記

申し訳ない。重要な情報が漏れていました＾＾；

ワークアラウンドとしては、exec 形式ではなく、シェル形式を使用することが一般的なようなので、そちらが本命なのですが、別の問題があって exec 形式の方法も捨てきれていません。

シェルを通すと発生する問題があり、現在切り分けているところです。
そちらが本命なのですが、もし、シェルを通さず、環境変数を展開できるような仕組みがあればと思い質問しました。

よろしくおねがいします。

シェルを通すこと発生する問題の切り分け状況

Dockerfile のENTRYPOINTを削除して、CMDへ記述変更していたのですが、別の層で定義したENTRYPOINTが浮かび上がっていました。
気がつくのが遅れ、大回りをしてしまいましたが、シェルを通すことの問題は解決の目処が付きました。ただ、思っていたよりportの指定がめんどくさい仕様になっているので、heroku での動作は諦めるかもしれません＾＾；

Comments

[unoSSkR]

How bout using ENV command? There are many other ways to resolve your problem in https://stackoverflow.com/questions/40454470/how-can-i-use-a-variable-inside-a-dockerfile-cmd

[退会済みユーザー]

指摘ありがとうございます。重要な情報が漏れていたので追記しました。
ご確認いただけると幸いです。

[bsdfan]

実行するプログラムは自分で触れるものですか？
だったらプログラムの中で環境変数を展開するのも一つの方法ではあると思います。

[退会済みユーザー]

はい。触ることも変更することも可能です。
ただ、それをやってしまうと、それなりの工数と、今後の継続的なメンテが発生するので、悩ましいところです。

Answer 1

軽い気持ちで始めた heroku への基盤移行ですが、対象のアプリが「portオプションは用意してるけど、動くとは言ってない！」って状態であることがわかったので、今後はそちらの修正に移ります。。。

本件からは離れた修正になるので、こちらは一旦クローズします。

追記欄にてヒントもいただきましたので、タイトルに対しての一応の回答を記述しておきます。

前提

Dockerfile reference - CMD

Unlike the shell form, the exec form does not invoke a command shell. This means that normal shell processing does not happen. For example, CMD [ "echo", "$HOME" ] will not do variable substitution on $HOME. If you want shell processing then either use the shell form or execute a shell directly, for example: CMD [ "sh", "-c", "echo $HOME" ]. When using the exec form and executing a shell directly, as in the case for the shell form, it is the shell that is doing the environment variable expansion, not docker.

結論

私の試した範囲では、シェルを使用しない方法は見つけられませんでした。(環境変数の仕様としてはごく自然なことですが＾＾；)

シェルを使用する方法は、unoSSkR さんの紹介してくれたリンク先にいくつか載っています。
How can I use a variable inside a Dockerfile CMD?

タイトルに対しての最も素直な記述だと

CMD ["sh", "-c", "hoge --port $PORT"]

余談

heroku だと、上記の方法以外に、heroku.ymlに記述する方法が取れます。
Building Docker Images with heroku.yml

build:
  docker:
    web: Dockerfile
run:
  web: hoge --port $PORT

この方法でも環境変数は展開されます。(処理としては、CMD を上書きする挙動のようです。)

現状

ENTRYPOINTを上書きして無効化し、シェル形式で実行させています。

ENTRYPOINT []
CMD hoge --port $PORT

環境変数 $PORT を正しく読めるようになり、無事 port に関するエラーがガンガン上がるようになりました＾＾；
お騒がせしました。

Comments

[unoSSkR]

Take care definitely too old version of the referenced document in docs.docker.jp.

[退会済みユーザー]

さんきゅ。差し替えました。