SSD Nodes Learn Hosting plans →
คู่มือ Matt Connorโดย Matt Connor

วิธีเข้าถึง Interactive Shell ใน Docker Compose

เรียนรู้วิธีใช้คำสั่ง docker compose exec เพื่อเปิด shell ในคอนเทนเนอร์ที่กำลังทำงานอยู่ และความแตกต่างในการใช้ docker compose run เมื่อต้องการสร้างคอนเทนเนอร์ใหม่

เข้าถึง interactive shell ด้วย docker compose exec

docker compose exec web bash จะเปิด interactive shell ภายในคอนเทนเนอร์ที่กำลังทำงานอยู่ของบริการ web ชื่อที่ระบุหลัง exec คือชื่อบริการจากไฟล์ compose.yaml ของคุณ ไม่ใช่ชื่อคอนเทนเนอร์ หากอิมเมจไม่มี bash ให้เรียกใช้ sh แทน

docker compose ps
docker compose exec web bash

ให้รัน docker compose ps ก่อน คำสั่งนี้ควรแสดงรายการ web ที่มีสถานะเป็น running จากนั้นคำสั่งที่สองจะนำคุณเข้าสู่พรอมต์ภายในคอนเทนเนอร์ และใช้คำสั่ง exit หรือกด Ctrl-D เพื่อกลับออกมายังโฮสต์ บริการจะยังคงทำงานต่อไปหลังจากที่คุณออกจากคอนเทนเนอร์ เนื่องจาก exec เป็นการเริ่มกระบวนการที่สองแยกจากกระบวนการหลัก การปิด shell ของคุณจะไม่ส่งผลกระทบต่อ PID 1 (process id 1) ซึ่งเป็นกระบวนการที่คอนเทนเนอร์ถูกสร้างขึ้นมาเพื่อรัน

นี่เป็นหนึ่งในสองวิธีในการเข้าถึงคอนเทนเนอร์ โดย exec จะเป็นการเชื่อมต่อเข้าไปยังคอนเทนเนอร์ที่มีอยู่แล้ว ส่วน docker compose run จะเป็นการสร้างคอนเทนเนอร์ใหม่จากนิยามบริการเดียวกัน เนื้อหาส่วนที่เหลือเกือบทั้งหมดในคู่มือนี้ล้วนมีพื้นฐานมาจากความแตกต่างเพียงจุดเดียวนี้

เหตุใด -it จึงเป็นทางเลือกใน Compose แต่จำเป็นสำหรับ docker แบบปกติ

มีแฟล็ก 2 ตัวที่ควบคุมการโต้ตอบของเซสชัน -i ทำหน้าที่เปิด stdin ค้างไว้เพื่อให้สิ่งที่คุณพิมพ์ส่งไปถึงกระบวนการทำงานได้ ส่วน -t ทำหน้าที่จัดสรร pseudo terminal หรือที่เรียกว่า TTY เพื่อให้เชลล์แสดงพรอมต์และรองรับการใช้งานปุ่มลูกศร โดยปกติแล้ว docker exec จะปิดการทำงานทั้งสองอย่างนี้ไว้เป็นค่าเริ่มต้น จึงเป็นเหตุผลว่าทำไมตัวอย่างที่คุณเคยเห็นทั้งหมดจึงเขียนว่า docker exec -it ทั้งนี้ docker compose exec จะเปิดการทำงานทั้งสองอย่างให้คุณโดยอัตโนมัติ ดังนั้น docker compose exec -it web bash และ docker compose exec web bash จึงให้ผลลัพธ์เหมือนกัน Compose ยังคงยอมรับ -it เพื่อให้ความคุ้นเคยเดิมยังคงใช้งานได้ต่อไป

คุณจะสังเกตเห็นว่า TTY หายไปภายในเวลาไม่กี่วินาที เชลล์จะทำงานแต่ไม่แสดงพรอมต์ และคำสั่ง Ctrl-C จะไม่ส่งไปถึงกระบวนการทำงาน ในกรณีตรงกันข้ามที่คุณต้องสั่งให้ Compose ไม่ต้อง จัดสรร TTY นั้นจะมีแฟล็กเฉพาะและหัวข้ออธิบายแยกไว้ในส่วนถัดไป

สิ่งที่ควรทำเมื่ออิมเมจไม่มี bash

เมื่อสั่งให้อิมเมจที่ใช้ Alpine รัน bash แล้วคำสั่ง exec ล้มเหลวดังนี้:

OCI runtime exec failed: exec failed: unable to start container process: exec: "bash": executable file not found in $PATH: unknown

ข้อความดังกล่าวไม่ใช่ปัญหาของคำสั่ง exec แต่เป็นการแจ้งว่าไม่พบ bash ในไดเรกทอรีที่ระบุไว้ใน PATH ของคอนเทนเนอร์ ซึ่งสำหรับ shell แล้ว มักหมายความว่าอิมเมจนั้นไม่มีโปรแกรมดังกล่าวติดตั้งอยู่ Alpine ใช้ BusyBox ซึ่งมี ash ในรูปแบบของ /bin/sh แต่ไม่มี bash ให้ใช้งาน ดังนั้นให้ลองใช้ sh แทน:

docker compose exec web sh

อิมเมจที่ใช้ Debian และ Ubuntu รวมถึงแท็ก -slim จะมี bash ติดตั้งมาให้ ซึ่ง bash จะช่วยให้คุณใช้งานประวัติคำสั่ง (command history) และการเติมคำสั่งอัตโนมัติ (completion) ได้ดีกว่า ดังนั้นควรลองใช้ bash ก่อนแล้วค่อยเปลี่ยนไปใช้ sh หากจำเป็น โดย sh จะมีอยู่ในอิมเมจทั่วไปเกือบทุกตัว

อิมเมจบางตัวไม่มี shell เลย อิมเมจแบบ Distroless และอิมเมจที่สร้างแบบ FROM scratch จะบรรจุเฉพาะ binary ของแอปพลิเคชันและไลบรารีที่จำเป็นเท่านั้น โดยตั้งใจให้เป็นเช่นนั้นเพราะ shell ที่ไม่มีอยู่จริงย่อมไม่สามารถถูกนำมาใช้โจมตีคุณได้ ในกรณีนี้ sh จะล้มเหลวด้วยข้อความเดียวกันและไม่มีทางเลือกอื่นให้ลองอีก มีแนวทางแก้ไข 2 วิธี คือ อิมเมจแบบ distroless ของ Google จะมีแท็ก :debug ที่เพิ่ม BusyBox shell เข้ามาให้ ดังนั้นการเปลี่ยนแท็กชั่วคราวจะช่วยให้คุณเข้าไปในคอนเทนเนอร์ได้ หรืออีกวิธีคือการเริ่มคอนเทนเนอร์แยกต่างหากภายใน namespace ของเป้าหมาย:

CID=$(docker compose ps -q web)
docker run --rm -it --network "container:$CID" --pid "container:$CID" nicolaka/netshoot

ตอนนี้คุณมีเครื่องมือของ netshoot ที่ชี้ไปยัง network ของแอปพลิเคชันแล้ว ดังนั้น curl localhost:8080 และ ss -lntp จะทำงานเสมือนว่าคุณอยู่ภายในคอนเทนเนอร์นั้น ระบบไฟล์ที่คุณเห็นจะเป็นของ netshoot ไม่ใช่ของแอปพลิเคชัน เนื่องจากมีการแชร์ process namespace ร่วมกัน /proc/1/root/ จึงชี้ไปยังระบบไฟล์ของ process เป้าหมาย แต่ ls /proc/1/root/ จะต้องผ่านการตรวจสอบสิทธิ์ ptrace ของ kernel การที่ทั้งสอง process รันด้วยสิทธิ์ root นั้นไม่เพียงพอ เพราะการตรวจสอบจะพิจารณาถึง credentials, capabilities, dumpable attribute ของเป้าหมาย และ security modules ด้วย ค่า dumpable ที่ไม่ใช่ 1 จะบล็อกการเข้าถึงเว้นแต่ผู้เรียกจะมี CAP_SYS_PTRACE ใน user namespace ของเป้าหมาย Docker ไม่ได้ให้สิทธิ์ SYS_PTRACE มาโดยค่าเริ่มต้น การเพิ่ม --cap-add SYS_PTRACE ลงในบรรทัด docker run จะช่วยแก้ไขปัญหาเรื่อง credential และการตรวจสอบ dumpability ได้ แต่ security modules ก็ยังอาจปฏิเสธการเข้าถึงได้อยู่ดี

เมื่อบริการไม่ทำงาน ให้ใช้ docker compose run --rm

คำสั่ง exec จำเป็นต้องใช้ container ที่กำลังทำงานอยู่ หากระบุไปยังบริการที่หยุดทำงาน คำสั่งจะปฏิเสธการทำงาน:

service "web" is not running

คำสั่งดังกล่าวจะไม่เริ่มการทำงานใดๆ ให้คุณ แต่ docker compose run จะทำหน้าที่นั้น:

docker compose run --rm web bash

คำสั่ง run จะสร้าง container ใหม่จากนิยามบริการ web โดยใช้ image, environment, volumes และ networks เดียวกัน และจะแทนที่คำสั่งของบริการด้วยคำสั่งที่คุณพิมพ์ลงไป --rm จะลบ container นั้นทิ้งเมื่อคุณออกจากโปรแกรม หากไม่ใส่ --rm ทิ้งไว้ container ที่เหลือจะสะสมอยู่ภายใต้ชื่ออย่างเช่น myproject-web-run-4f1c2b คุณสามารถใช้ docker compose ps -a เพื่อดูรายการเหล่านี้ และใช้ docker compose rm เพื่อลบ container เหล่านั้นพร้อมกับ container อื่นๆ ของบริการที่หยุดทำงานอยู่

พฤติกรรมสองอย่างของ run ที่มักทำให้ผู้ใช้ประหลาดใจคือ มันจะไม่เผยแพร่พอร์ตของบริการเว้นแต่คุณจะเพิ่ม --service-ports หรือกำหนดพอร์ตด้วยตนเองผ่าน -p ซึ่งเป็นความตั้งใจในการออกแบบ เพราะหาก container ที่สองพยายามผูกพอร์ต 8080 ของโฮสต์ในขณะที่ container แรกยังใช้งานอยู่ จะทำให้เกิดข้อผิดพลาด bind: address already in use นอกจากนี้ run จะเริ่มการทำงานทุกอย่างที่บริการระบุไว้ภายใต้ depends_on ก่อนที่ shell ของคุณจะปรากฏขึ้น ดังนั้นการตรวจสอบภายในอย่างรวดเร็วอาจทำให้ database และ cache เริ่มทำงานได้ คุณสามารถใช้ --no-deps เพื่อข้ามขั้นตอนดังกล่าว

คำสั่ง run จะทำงานผ่าน ENTRYPOINT ของ image ในขณะที่ exec จะไม่ทำเช่นนั้น exec จะเริ่มคำสั่งของคุณโดยตรงใน container ที่มีอยู่เดิม ทำให้สคริปต์ entrypoint ไม่ได้รับคำสั่งนั้น ในขณะที่การใช้ run คำสั่ง bash ของคุณจะถูกส่งไปเป็นอาร์กิวเมนต์ของสคริปต์นั้น image ทางการจำนวนมากจะจบสคริปต์ entrypoint ด้วย exec "$@" เพื่อให้คำสั่งส่งผ่านไปได้โดยตรงและคุณจะได้รับ shell ของคุณ แต่หากสคริปต์มีการตีความอาร์กิวเมนต์ของตัวเอง สคริปต์จะจัดการกับอาร์กิวเมนต์เหล่านั้นในรูปแบบอื่น ในกรณีนี้คุณต้องแทนที่ entrypoint สำหรับการรันครั้งนั้น:

docker compose run --rm --entrypoint sh web

นี่เป็นสาเหตุที่พบบ่อยที่สุดที่ทำให้คำสั่งที่ทำงานได้ภายใต้ exec มีพฤติกรรมต่างออกไปเมื่อใช้ run และ ความแตกต่างระหว่าง command และ entrypoint จะอธิบายว่าคุณกำลังแทนที่ส่วนใดของการตั้งค่า image ในแต่ละครั้ง

การเลือกใช้ exec หรือ run

  • exec จำเป็นต้องมีคอนเทนเนอร์ที่กำลังทำงานอยู่ ส่วน run ไม่จำเป็นต้องมี และ run อาจเริ่มการทำงานของ dependency ต่างๆ ได้
  • exec จะเห็นรายการ process และไฟล์ในสถานะปัจจุบัน รวมถึงสิ่งที่แอปพลิเคชันเขียนลงไปตั้งแต่เริ่มทำงาน ส่วน run จะได้รับ writable layer ที่สะอาดจาก image แต่ named volumes และ bind mounts จะยังคงแสดงข้อมูลที่มีอยู่เดิมของบริการนั้นๆ
  • exec จะข้าม entrypoint ไป แต่ run จะเรียกใช้งาน entrypoint
  • run จะทิ้งคอนเทนเนอร์ไว้หลังจากทำงานเสร็จ เว้นแต่คุณจะใส่แฟล็ก --rm

ใช้ exec เพื่อตรวจสอบสิ่งที่กำลังเกิดขึ้นจริง ใช้ run --rm สำหรับการสร้างสำเนาสภาพแวดล้อมเดียวกันแบบชั่วคราว เพื่อใช้รันคำสั่ง migration ครั้งเดียว หรือในกรณีที่บริการหลักไม่สามารถทำงานได้นานพอที่จะให้คุณใช้ exec เข้าไปได้

แฟล็กที่มีประโยชน์สำหรับการสั่ง exec: ผู้ใช้, ไดเรกทอรีทำงาน และจำนวนรีพลิกา

อิมเมจส่วนใหญ่จะเปลี่ยนสิทธิ์ไปเป็นผู้ใช้ที่ไม่ใช่ root ดังนั้นการติดตั้งเครื่องมือวินิจฉัยภายในเชลล์ที่คุณ exec เข้าไปจึงทำไม่ได้:

E: Could not open lock file /var/lib/dpkg/lock-frontend - open (13: Permission denied)

-u root ช่วยให้คุณเข้าถึง root shell ในคอนเทนเนอร์เดียวกันได้:

docker compose exec -u root web sh

-w /srv/app กำหนดไดเรกทอรีทำงานสำหรับคำสั่งนั้นๆ เท่านั้น -e KEY=value เพิ่มตัวแปรสภาพแวดล้อมให้กับเซสชันของคุณโดยไม่ส่งผลต่อตัวบริการ เมื่อบริการรันมากกว่าหนึ่งรีพลิกา --index 2 จะเป็นตัวกำหนดว่าคุณจะเข้าไปที่คอนเทนเนอร์ใด หากคุณกำลังตรวจสอบความเป็นเจ้าของไฟล์บนไดเรกทอรีที่ mount ไว้ PUID และ PGID ในอิมเมจคอนเทนเนอร์ จะอธิบายว่าเหตุใด ID ที่เป็นตัวเลข ไม่ใช่ชื่อผู้ใช้ จึงเป็นตัวตัดสินว่าใครสามารถเขียนไฟล์ในตำแหน่งนั้นได้

การเข้าใช้งาน psql หรือ mysql shell ภายในคอนเทนเนอร์ฐานข้อมูล

เนื่องจากไคลเอนต์ถูกรวมอยู่ในอิมเมจฐานข้อมูลอยู่แล้ว คุณจึงไม่จำเป็นต้องติดตั้งไคลเอนต์บนโฮสต์และไม่จำเป็นต้องเปิดพอร์ต (publish port) แต่อย่างใด:

docker compose exec db psql -U postgres -d app
docker compose exec db mariadb -u root -p

อิมเมจของ Postgres จะมี psql ติดมาด้วย ส่วนอิมเมจของ MySQL จะมี mysql และ MariaDB จะมี mariadb การเชื่อมต่อจะเกิดขึ้นจากภายในคอนเทนเนอร์ วิธีนี้จึงใช้งานได้แม้ในกรณีที่ไฟล์ compose ไม่ได้เปิดพอร์ตฐานข้อมูลไว้เลย ซึ่งถือเป็นวิธีที่ปลอดภัยกว่าบนเครือข่ายแบบ bridge เริ่มต้นของ Docker เพราะโฮสต์ภายนอกจะไม่สามารถเข้าถึงพอร์ตฐานข้อมูลที่ไม่ได้เปิดไว้ได้โดยตรง ในขณะที่โฮสต์ Docker และคอนเทนเนอร์ที่อยู่ในเครือข่ายเดียวกันยังคงเข้าถึงได้

มีข้อผิดพลาดหนึ่งจุดที่มักทำให้เสียเวลาไปทั้งบ่าย คือการที่เชลล์ของคุณจะขยายค่าตัวแปร (expand variables) บนโฮสต์ก่อนที่ Docker จะได้รับคำสั่ง ส่งผลให้ -U "$POSTGRES_USER" ส่งค่าเป็นสตริงว่างเปล่าในกรณีที่ตัวแปรนั้นมีอยู่เฉพาะภายในคอนเทนเนอร์เท่านั้น การใช้เครื่องหมายคำพูดเดี่ยว (single quotes) และการเรียกใช้เชลล์ภายในคอนเทนเนอร์จะช่วยให้การขยายค่าตัวแปรเกิดขึ้นในตำแหน่งที่ถูกต้อง:

docker compose exec db sh -c 'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB"'

อย่าพยายามใช้ docker compose run --rm db โดยไม่มีคำสั่งกำกับ เพราะจะเป็นการเริ่มเซิร์ฟเวอร์ Postgres ตัวที่สองขึ้นมาบน data volume เดียวกัน ซึ่งจะทำให้เซิร์ฟเวอร์ปฏิเสธการทำงาน:

FATAL:  lock file "postmaster.pid" already exists

ไฟล์ lock กำลังทำหน้าที่ของมันอย่างถูกต้อง เพราะหากมีเซิร์ฟเวอร์สองตัวเขียนข้อมูลลงในไดเรกทอรีเดียวกันจะทำให้ข้อมูลเสียหาย ในขณะที่ฐานข้อมูลกำลังทำงานอยู่ ให้ใช้คำสั่ง exec เข้าไปยังคอนเทนเนอร์ที่รันอยู่ สำหรับประเด็นที่ว่าควรนำฐานข้อมูลมาไว้ใน Compose หรือไม่นั้นเป็นการตัดสินใจแยกต่างหาก ซึ่งเนื้อหาใน การรันฐานข้อมูลใน Docker หรือบนโฮสต์ ได้อธิบายข้อดีและข้อเสียไว้แล้ว

บริการที่ต้องการคอนโซลขณะเริ่มต้น: stdin_open และ tty

exec และ run ครอบคลุมถึงเชลล์ที่คุณเปิดใช้งานด้วยตนเอง บริการที่มีกระบวนการหลักเป็นแบบโต้ตอบโดยธรรมชาติจำเป็นต้องมีสองคีย์ในไฟล์ compose:

services:
  console:
    image: python:3.12-slim
    command: python
    stdin_open: true
    tty: true

stdin_open: true คือ docker run -i และ tty: true คือ docker run -t หากไม่มีคีย์เหล่านี้ คอนเทนเนอร์จะเริ่มทำงานและหยุดทันทีด้วยรหัส 0 และ docker compose ps -a จะแสดง Exited (0) โดยไม่มีการขัดข้องใดๆ python ที่ไม่มีเทอร์มินัลบน stdin จะอ่านจุดสิ้นสุดของไฟล์ (EOF) ทันทีและปิดตัวลงตามปกติ ซึ่งเป็นพฤติกรรมที่ถูกต้องสำหรับโปรแกรมที่ไม่มีผู้ใช้งานพิมพ์คำสั่งโต้ตอบ

เมื่อตั้งค่าทั้งสองคีย์แล้ว ให้เชื่อมต่อกับกระบวนการที่กำลังทำงานอยู่:

docker attach $(docker compose ps -q console)

การแยกตัวออกมา (detach) ให้กด Ctrl-P ตามด้วย Ctrl-Q ซึ่งจะทำให้กระบวนการยังคงทำงานอยู่ ลำดับการกดนี้จะใช้ได้ก็ต่อเมื่อคอนเทนเนอร์เปิดทั้ง TTY และ stdin ไว้เท่านั้น ในทางกลับกัน Ctrl-C จะส่งสัญญาณขัดจังหวะ (SIGINT) ไปยัง PID 1 ซึ่งจะหยุดบริการก็ต่อเมื่อโปรแกรมถูกเขียนมาให้ปิดตัวลงเมื่อได้รับ SIGINT เท่านั้น เนื่องจาก Linux ไม่มีการจัดการสัญญาณเริ่มต้นสำหรับ PID 1 ดังนั้นอย่าใช้ Ctrl-C เป็นวิธีในการแยกตัวออกมา

ให้ปิดคีย์ทั้งสองไว้สำหรับบริการทั่วไป เว็บเซิร์ฟเวอร์ไม่เคยอ่าน stdin และ tty: true จะทำให้โปรแกรมจำนวนมากเปลี่ยนไปใช้การแสดงผลแบบมีสีและ line buffering เพราะโปรแกรมเหล่านั้นเข้าใจว่ามีคนกำลังเฝ้าดูอยู่ ซึ่งจะทำให้ docker compose logs เต็มไปด้วยรหัส escape

เหตุใดการสั่ง exec ผ่านสคริปต์ใน cron และ CI ถึงล้มเหลว: การใช้ flag -T

คำสั่ง exec ที่ทำงานได้ปกติใน terminal ของคุณอาจล้มเหลวเมื่อถูกเรียกใช้ผ่านสคริปต์ ในงาน cron job, ในระบบ continuous integration (CI) runner หรือเมื่อมีการใช้ pipe:

the input device is not a TTY

Compose จะร้องขอ pseudo terminal ทุกครั้งที่ output ของมันถูกส่งไปยัง terminal และคำขอนั้นจะล้มเหลวก่อนที่คำสั่งของคุณจะเริ่มทำงานหาก stdin ไม่ใช่ terminal เช่นกัน Docker CLI รุ่นใหม่ๆ จะแสดงข้อความแจ้งความล้มเหลวแบบเดียวกันกับ cannot attach stdin to a TTY-enabled container because stdin is not a terminal โดยปกติแล้ว Compose รุ่นปัจจุบันจะข้ามการร้องขอนี้โดยอัตโนมัติเมื่อ output ถูก redirect หรือ pipe ซึ่งเป็นสถานการณ์ปกติที่เกิดขึ้นใน cron แต่ Compose รุ่นก่อนหน้านี้จะร้องขอโดยไม่สนใจสภาวะดังกล่าว และการพิมพ์ cat dump.sql | docker compose exec db psql ที่ prompt ของคุณเองในปัจจุบันก็ยังคงกระตุ้นให้เกิดการร้องขอนี้อยู่ การใช้ -T จะเป็นการปิดการร้องขอนี้ในทุกกรณี ดังนั้นควรใส่ flag นี้ไว้ในสคริปต์แทนที่จะพึ่งพาระบบตรวจจับอัตโนมัติ:

0 3 * * * docker compose -f /srv/app/compose.yaml exec -T db pg_dump -U postgres -Fc app > /srv/backups/app.dump

-T มีความสำคัญด้วยเหตุผลประการที่สอง คือ TTY จะเขียนทับ byte stream ระหว่างทางที่ส่งออกไป ดังนั้นข้อมูล dump ที่ถูกบีบอัดซึ่งผ่าน TTY จะได้รับความเสียหายเมื่อไปถึงปลายทาง ให้ส่ง flag -T อย่างชัดเจนสำหรับ output ใดๆ ที่มีการ redirect หรือ pipe

รายละเอียดเพิ่มเติมอีกสองประการสำหรับ cron คือ ให้ส่ง flag -f พร้อมระบุ absolute path เสมอ เนื่องจาก cron จะรันงานจาก home directory ซึ่งไม่มีไฟล์ compose อยู่ ทำให้ Compose หยุดทำงานพร้อมข้อความ no configuration file provided: not found และเนื่องจาก exec จะส่งคืน exit code ของคำสั่งที่มันรัน ดังนั้นหาก pg_dump ล้มเหลว สคริปต์ของคุณก็จะล้มเหลวภายใต้เงื่อนไข set -e แทนที่จะเขียนไฟล์ backup เปล่าๆ แล้วรายงานว่าสำเร็จ คำสั่งอื่นๆ ที่ใช้ในชีวิตประจำวันได้ถูกรวบรวมไว้ใน ตารางสรุปคำสั่ง Compose ซึ่งควรเก็บไว้ใช้งานคู่กับสคริปต์เหล่านั้น

เหตุใดการเปลี่ยนแปลงที่คุณทำภายในคอนเทนเนอร์จึงหายไป

คุณติดตั้งเครื่องมือผ่าน exec แก้ไขไฟล์คอนฟิก และแก้ไขปัญหาได้สำเร็จ แต่หนึ่งสัปดาห์ต่อมาการแก้ไขนั้นกลับหายไป นี่คือพฤติกรรมปกติของ writable layer ในคอนเทนเนอร์ docker compose up -d หลังจากมีการเปลี่ยนแปลงใดๆ กับ image tag หรือ service definition จะเป็นการทำลายคอนเทนเนอร์เก่าและสร้างคอนเทนเนอร์ใหม่จาก image นั้น ทำให้การแก้ไขด้วยมือทั้งหมดหายไปพร้อมกับคอนเทนเนอร์เก่า

docker compose restart มีการทำงานที่ต่างออกไป โดยจะหยุดและเริ่มคอนเทนเนอร์เดิมใหม่ ทำให้การแก้ไขด้วยมือยังคงอยู่ นั่นคือเหตุผลว่าทำไมการแก้ไขด้วยมืออาจดูเหมือนใช้งานได้นานหลายสัปดาห์แล้วจึงหายไปในระหว่างการอัปเดตที่ไม่เกี่ยวข้อง ทั้งนี้ Named volumes และ bind mounts จะคงอยู่ผ่านการดำเนินการทั้งสองรูปแบบเนื่องจากข้อมูลถูกจัดเก็บไว้นอกคอนเทนเนอร์ โดย bind mounts และ named volumes จะอธิบายถึงวิธีการเลือกใช้งานสำหรับข้อมูลที่คุณต้องการเก็บรักษาไว้

ดังนั้น ให้ถือว่าการใช้ exec shell เป็นเพียงพื้นที่สำหรับการอ่านและทดสอบเท่านั้น เมื่อคุณทราบวิธีแก้ไขแล้ว ให้บันทึกการแก้ไขนั้นในที่ที่ข้อมูลจะคงอยู่ถาวร เช่น การเพิ่มแพ็กเกจลงใน Dockerfile หรือการเพิ่มการตั้งค่าลงใน compose file จากนั้นใช้ docker compose up -d เพื่อนำการเปลี่ยนแปลงไปใช้ และตรวจสอบอีกครั้งด้วย exec เพื่อยืนยันว่าคอนเทนเนอร์ใหม่มีการแก้ไขนั้นจริง

FAQ

docker compose exec กับ docker compose run ต่างกันอย่างไร

exec ใช้รันคำสั่งภายในคอนเทนเนอร์ที่ทำงานอยู่แล้ว โดยรันควบคู่ไปกับกระบวนการหลักและข้ามการทำงานของ entrypoint ใน image ส่วน run จะสร้างคอนเทนเนอร์ใหม่จากนิยามบริการเดียวกัน โดยใช้ image, environment, volumes และ networks ชุดเดียวกัน พร้อมทั้งส่งคำสั่งของคุณผ่าน entrypoint และเริ่มบริการ depends_on ทั้งหมดก่อน นอกจากนี้ run จะไม่เปิดพอร์ตของบริการเว้นแต่คุณจะเพิ่ม --service-ports หรือการทำ mapping ด้วย -p ให้ใช้ exec เมื่อต้องการตรวจสอบบริการที่กำลังทำงานอยู่ และใช้ run --rm เมื่อบริการหยุดทำงานหรือเมื่อคุณต้องการคอนเทนเนอร์แยกต่างหาก แต่โปรดจำไว้ว่า named volumes และ bind mounts จะถูกใช้งานร่วมกัน

ทำไม docker compose exec ถึงแจ้งว่าบริการไม่ได้ทำงานอยู่

exec จะเชื่อมต่อกับคอนเทนเนอร์ที่มีอยู่เท่านั้นและไม่สามารถสร้างคอนเทนเนอร์ใหม่ได้ ดังนั้นหากบริการหยุดทำงานหรือขัดข้องจะได้รับข้อผิดพลาด service "web" is not running ให้ตรวจสอบด้วย docker compose ps -a ซึ่งจะแสดงรายการคอนเทนเนอร์ที่หยุดทำงานพร้อมสถานะ เช่น Exited (1) และอ่าน docker compose logs web เพื่อหาสาเหตุที่หยุดทำงาน หากต้องการเข้าใช้งาน shell ให้รัน docker compose run --rm --entrypoint sh web แทน ซึ่งจะเป็นการสร้างคอนเทนเนอร์ใหม่จากนิยามบริการเดิมโดยไม่รันคำสั่งเริ่มต้นที่ผิดพลาด

จะเปิด shell ได้อย่างไรหาก image ไม่มี bash

การที่ docker compose exec web bash ล้มเหลวพร้อมข้อผิดพลาด exec: "bash": executable file not found in $PATH หมายความว่าไม่พบ bash ในไดเรกทอรีที่ระบุใน PATH ของคอนเทนเนอร์ ซึ่งมักหมายความว่า image นั้นไม่ได้ติดตั้ง bash มาด้วย ซึ่งเป็นเรื่องปกติสำหรับ image ที่สร้างบน Alpine ให้ใช้ docker compose exec web sh แทน เนื่องจาก BusyBox มี /bin/sh ให้ใช้งาน ในกรณีที่ image ไม่มี shell เลย exec จะไม่สามารถเปิด shell ได้ แต่ยังคงสามารถรันไฟล์ executable ที่มีอยู่ใน image ได้ ให้เปลี่ยนไปใช้ tag :debug ของ image นั้นหากผู้จัดทำมีให้ หรือเริ่มคอนเทนเนอร์สำหรับ debug ใน namespace ของเป้าหมายด้วย docker run --rm -it --network "container:$CID" --pid "container:$CID" nicolaka/netshoot โดยที่ $CID มาจาก docker compose ps -q web

ทำไมคำสั่ง exec ถึงล้มเหลวด้วยข้อความ "the input device is not a TTY" ใน cron

docker compose exec จะร้องขอ pseudo terminal เมื่อ output ถูกส่งไปยัง terminal และคำสั่งจะล้มเหลวหาก stdin ไม่ใช่ terminal เช่นกัน ปัจจุบัน Compose จะข้ามการร้องขอนี้โดยอัตโนมัติเมื่อมีการ redirect output ซึ่งมักเกิดขึ้นใน cron แต่ในรุ่นก่อนหน้าจะมีการร้องขอเสมอ และการส่ง input เข้าสู่ exec จาก interactive shell ก็ทำให้เกิดปัญหานี้ได้เช่นกัน ให้เพิ่ม -T เพื่อปิดการใช้งาน: docker compose exec -T db pg_dump -U postgres app นอกจากนี้ให้ใช้ -T สำหรับ output ที่มีการ redirect หรือ pipe เนื่องจาก TTY จะปรับเปลี่ยน byte stream และทำให้ข้อมูล binary เสียหาย ใน cron คุณต้องระบุ -f พร้อม path แบบเต็มไปยังไฟล์ compose ของคุณ มิฉะนั้น Compose จะหยุดทำงานด้วย no configuration file provided: not found

การเปลี่ยนแปลงที่ทำภายในคอนเทนเนอร์ด้วย exec จะคงอยู่หลังการ restart หรือไม่

การเปลี่ยนแปลงจะคงอยู่หลังการ docker compose restart ซึ่งเป็นการใช้คอนเทนเนอร์เดิมซ้ำ แต่จะสูญหายไปเมื่อมีการ docker compose up -d หลังจากมีการเปลี่ยนแปลง image หรือ configuration เนื่องจากกระบวนการนี้จะสร้างคอนเทนเนอร์ใหม่จาก image และทิ้ง writable layer เดิมไป ข้อมูลที่เขียนลงใน named volumes หรือ bind mounts จะคงอยู่ทั้งสองกรณีเนื่องจากข้อมูลเหล่านั้นอยู่นอกคอนเทนเนอร์ ให้ทำการเปลี่ยนแปลงเพื่อวินิจฉัยปัญหาด้วย exec จากนั้นจึงนำเวอร์ชันที่ถาวรไปใส่ไว้ใน Dockerfile หรือไฟล์ compose แทน

บทความนี้มีประโยชน์หรือไม่