首頁·報錯訊息

runc · Docker

報錯原文

OCI runtime create failed: exec: "bash": executable file not found in $PATH: unknown

這是什麼意思

容器建出來了,但你讓它執行的程式在容器內部的 $PATH 裡找不到。基於 alpine 的映像只帶 sh 而沒有 bash,所以 docker run -it myapp bash 或者 CMD ["bash", ...] 恰好就以這個錯誤收場——你以為映像裡有、其實只存在於主機上的任何工具也一樣。docker run --rm -it myapp sh 能先給你一個 shell,看清這個映像裡到底有什麼。如果確實需要 bash,在 Dockerfile 裡 RUN apk add --no-cache bash 就能裝上,代價是映像變大。

怎麼修

docker run --rm -it myapp sh
來自
runc
Docker
12

docker 的錯誤要先歸到某一層才讀得懂——用戶端連不上守護行程、映像檔倉庫拒絕你、建置過程中某條 RUN 失敗、容器一起來就死掉,是四種不同的問題——而在建置和執行這兩層,那行字本身並不是原因:原因在裡面那條命令留下的輸出裡,各層修復的代價也不一樣。

怎麼讀報錯

  • 從第一行往下讀。越往下越是工具內部的事,起因通常寫在最上面。
  • 有檔名和行號就從那裡查——不是堆疊最上面那一格,而是最上面那條提到你自己寫的檔案的行。
  • 把報錯原文照樣去搜,但先去掉你自己的路徑和變數名,正是那些讓搜尋比對不上。
  • 同一種情況在不同版本裡措辭不同。結果不對頭,就把版本號一起加進查詢。
  • 貼上修法之前,先確認它會丟掉什麼。這裡面有些是不能收回的。

常見問題

Q. “OCI runtime create failed: exec: "bash": executable file not found in $PATH: unknown” 是什麼意思?

容器建出來了,但你讓它執行的程式在容器內部的 $PATH 裡找不到。基於 alpine 的映像只帶 sh 而沒有 bash,所以 docker run -it myapp bash 或者 CMD ["bash", ...] 恰好就以這個錯誤收場——你以為映像裡有、其實只存在於主機上的任何工具也一樣。docker run --rm -it myapp sh 能先給你一個 shell,看清這個映像裡到底有什麼。如果確實需要 bash,在 Dockerfile 裡 RUN apk add --no-cache bash 就能裝上,代價是映像變大。

Q. 怎麼修?

docker run --rm -it myapp sh —— 執行前先看上面的說明,確認這條命令會丟掉什麼。

Q. 這是哪個工具報的?

runc。它屬於Docker,報錯原文有 13 個詞。

相關報錯