การ Pull และ Push Docker Image

บทนี้จะพาคุณฝึกใช้งาน docker pull และ docker push แบบทีละขั้น เข้าใจ output ที่เห็นใน terminal, จัดการ tag อย่างเป็นระบบ และส่ง image ระหว่างเครื่องได้จริง

แผนภาพ pipeline การ build tag push และ pull Docker image ระหว่างเครื่องกับ registry

ภาพจำ: ตั้งชื่อ tag ให้ชัดก่อน push แล้วใช้ชื่อเดียวกัน pull บนเครื่องปลายทางเพื่อให้ deployment ทำซ้ำได้

ภาพจำสำคัญบทนี้

pull คือดึง image ลงเครื่องเรา ส่วน push คือส่ง image จากเครื่องเราขึ้น registry

Diagram: Developer > Build/Tag > Push Registry > Pull on Another Machine

ใช้ flow นี้เป็น mental model หลัก: ฝั่งนักพัฒนาสร้างและติด tag image, push ขึ้น registry, แล้วเครื่องปลายทาง pull ด้วยชื่อและ tag เดียวกัน

1. Developer

build image ในเครื่องตัวเอง

2. Tag

ตั้งชื่อ image ตาม registry/repo:tag

3. Push

อัปโหลดขึ้น registry กลาง

4. Pull

เครื่องอื่นดึง image เดิมไปรัน

ส่วนที่ 1

Step 1: docker pull — ดึง image มาใช้งาน

คำสั่ง pull ใช้ดาวน์โหลด image จาก registry มายังเครื่องเรา ถ้า image ยังไม่มีใน local Docker จะดึงทุก layer ที่จำเป็นมาเก็บไว้ในเครื่องก่อน

Syntax และตัวอย่าง docker pullbash

ทุกบรรทัดมีคอมเมนต์เพื่ออธิบายรูปแบบและความหมายของ tag ที่ใช้งาน

# syntax พื้นฐาน: ระบุชื่อ image และ tag
docker pull <image>:<tag>

# ถ้าไม่ระบุ tag Docker จะตีความเป็น :latest อัตโนมัติ
docker pull nginx

# ระบุ tag ชัดเจนเพื่อให้ควบคุมเวอร์ชันได้แน่นอน
docker pull node:20-alpine

pull โดยไม่ระบุ tag จะใช้ latest โดยปริยาย
การระบุ tag ชัดเจนช่วยให้ environment ตรงกันทุกเครื่อง

ส่วนที่ 2

Step 2: อ่าน output ระหว่าง pull ให้เป็น

ตอน pull คุณจะเห็น Docker ดาวน์โหลดทีละ layer พร้อมสถานะ Download complete และ Pull complete เมื่อครบทุกชั้นจึงจะพร้อมใช้งาน

Terminal mockup: docker pull nginx (full output)bash

ตัวอย่างนี้เป็นรูปแบบ output ที่พบบ่อยเมื่อดึง nginx ครั้งแรกบนเครื่องใหม่

$ docker pull nginx
Using default tag: latest
latest: Pulling from library/nginx
2d35ebdb57d9: Pulling fs layer
f80aba050ead: Pulling fs layer
621a51978ed7: Pulling fs layer
03e63548f209: Pulling fs layer
23c1f94a30c9: Pulling fs layer
f6b9f8d8f3fa: Pulling fs layer
6f7f6d2df0b0: Pulling fs layer
03e63548f209: Waiting
23c1f94a30c9: Waiting
f6b9f8d8f3fa: Waiting
6f7f6d2df0b0: Waiting
2d35ebdb57d9: Download complete
f80aba050ead: Download complete
621a51978ed7: Download complete
03e63548f209: Download complete
23c1f94a30c9: Download complete
f6b9f8d8f3fa: Download complete
6f7f6d2df0b0: Download complete
2d35ebdb57d9: Pull complete
f80aba050ead: Pull complete
621a51978ed7: Pull complete
03e63548f209: Pull complete
23c1f94a30c9: Pull complete
f6b9f8d8f3fa: Pull complete
6f7f6d2df0b0: Pull complete
Digest: sha256:2d9f5c6f8b52b9d8f98a0b0fbc6f34f84a0c353f4d8b8a6dc8a1d2cf1880b1d1
Status: Downloaded newer image for nginx:latest
docker.io/library/nginx:latest

ส่วนที่ 3

Step 3: pull จาก registry อื่นที่ไม่ใช่ Docker Hub

ถ้าดึงจาก registry อื่น ต้องระบุ hostname ของ registry ให้ครบ เช่น ghcr.io หรือ registry ภายในองค์กร

ตัวอย่าง pull จาก non-Docker Hub registrybash

ระบุ registry host นำหน้าชื่อ repository เสมอ

# pull จาก GitHub Container Registry
docker pull ghcr.io/example-org/example-app:1.2.0

# pull จาก private registry ภายในองค์กร
docker pull registry.company.local/platform/api:v1.8.3

ส่วนที่ 4

Step 4: docker push — อัปโหลด image ขึ้น registry

ก่อน push ต้อง login และตั้งชื่อ image ให้อยู่ในรูปแบบที่ registry เข้าใจ จากนั้นจึง push ตามชื่อเต็ม registry/repository:tag

ลำดับหลักของ docker pushbash

ทำตามลำดับนี้เสมอเพื่อลด error เรื่องสิทธิ์และชื่อ image

# 1) login เพื่อยืนยันตัวตนกับ registry ปลายทาง
docker login

# 2) tag image local ให้เป็นชื่อปลายทางที่ถูกต้อง
# รูปแบบ: docker tag <local-image:tag> <registry/repo:tag>
docker tag my-node-app:local YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0

# 3) push image ไปยัง repository ที่ตั้งชื่อไว้
docker push YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0

ส่วนที่ 5

Step 5: Terminal mockup ของ docker push (full output)

ระหว่าง push จะเห็นแต่ละ layer ถูกอัปโหลด หรือบางชั้นถูก reuse ด้วยข้อความ Layer already exists เมื่อ push เสร็จจะได้ digest กลับมา

Terminal mockup: docker push (full output)bash

ตัวอย่างนี้เป็น output ที่พบบ่อยเมื่อ push image ไป Docker Hub

$ docker push YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0
The push refers to repository [docker.io/YOUR_DOCKERHUB_USERNAME/my-node-app]
8f3c7a9f6e10: Pushing [==================================================>]  15.36MB/15.36MB
5a7b2f4e8d22: Pushed
9d1e3c6a4b77: Layer already exists
31f8d4c2e911: Pushed
65e1c93b8d44: Layer already exists
v1.0.0: digest: sha256:4f6e2f4ad6f6919a10d0c5b978bd3f2f7b9e1d1c3f2f7a4c9e8f6d7b1a3c2d4e size: 1578

ส่วนที่ 6

Step 6: จัดการ tag ให้เป็นระบบ

docker tag ไม่ได้คัดลอกไฟล์ใหม่ทันที แต่เป็นการเพิ่มชื่ออ้างอิงใหม่ให้ image เดิมใน local cache ของคุณ จึงใช้สร้างชื่อ release ได้รวดเร็วมาก

ตัวอย่างการตั้งชื่อ tagbash

แนะนำใช้หลาย tag เพื่อรองรับทั้งการอ้างอิงแบบมนุษย์อ่านง่ายและแบบ trace กลับไปยัง commit ได้

# tag เวอร์ชันปล่อยใช้งานจริง (semantic version)
docker tag my-node-app:local YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0

# tag latest สำหรับ default consumer (ระวังอย่าใช้ latest เดี่ยวใน production)
docker tag my-node-app:local YOUR_DOCKERHUB_USERNAME/my-node-app:latest

# tag ด้วย git commit hash เพื่อ trace เวอร์ชันได้แม่น
docker tag my-node-app:local YOUR_DOCKERHUB_USERNAME/my-node-app:git-a1b2c3d

Tag	ใช้เมื่อไร	ข้อควรระวัง
v1.0.0	release แบบชัดเจน, deploy ซ้ำได้	ต้องมีวินัยในการ bump version
latest	ใช้เป็นค่าเริ่มต้นสำหรับผู้เริ่มต้น	ไม่ควรใช้เดี่ยวใน production
git-a1b2c3d	ต้องการ trace ย้อนกลับถึง source commit	อ่านยากสำหรับคนที่ไม่ดู git

ส่วนที่ 7

Step 7: End-to-end flow ตั้งแต่ build > tag > push > pull

ตัวอย่างนี้เป็น flow ครบวงจรที่ใช้สอนทีมใหม่ได้ดี เพราะเห็นภาพตั้งแต่สร้าง image จนถึงเครื่องปลายทางที่ดึงไปใช้งาน

End-to-end workflowbash

ใช้คำสั่งชุดนี้ใน workshop ได้ทันที โดยแก้ชื่อผู้ใช้และชื่อ image ให้ตรงโปรเจกต์จริง

# build image จาก Dockerfile ในโฟลเดอร์ปัจจุบัน
docker build -t my-node-app:local .

# tag เพื่อเตรียมชื่อปลายทางบน Docker Hub
docker tag my-node-app:local YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0

# push ขึ้น Docker Hub
docker push YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0

# (เครื่องอื่น) pull image เดิมลงมาใช้งาน
docker pull YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0

ส่วนที่ 8

Step 8: Workshop จริง (ทำตามทีละข้อ)

ทำ workshop นี้ให้ครบ คุณจะย้าย image ข้ามเครื่องได้จริงและเข้าใจการทำงานของ registry แบบใช้งานได้ทันที

สร้างบัญชีที่ hub.docker.com และยืนยันอีเมลให้เรียบร้อย

สร้าง Docker Hub repository ชื่อ my-node-app (เลือก public หรือ private ตามโจทย์)

build image อย่างง่ายจากโปรเจกต์ Node.js

tag และ push image ไปยัง repository ของตัวเอง

ไปอีกเครื่องหนึ่งแล้ว pull image เดิมลงมาเพื่อยืนยันว่าใช้งานข้ามเครื่องได้

การ Pull และ Push Docker Image

Diagram: Developer > Build/Tag > Push Registry > Pull on Another Machine

1. Developer

build image ในเครื่องตัวเอง

2. Tag

ตั้งชื่อ image ตาม registry/repo:tag

3. Push

อัปโหลดขึ้น registry กลาง

4. Pull

เครื่องอื่นดึง image เดิมไปรัน

Step 1: docker pull — ดึง image มาใช้งาน

# syntax พื้นฐาน: ระบุชื่อ image และ tag docker pull <image>:<tag> # ถ้าไม่ระบุ tag Docker จะตีความเป็น :latest อัตโนมัติ docker pull nginx # ระบุ tag ชัดเจนเพื่อให้ควบคุมเวอร์ชันได้แน่นอน docker pull node:20-alpine

$ docker pull nginx Using default tag: latest latest: Pulling from library/nginx 2d35ebdb57d9: Pulling fs layer f80aba050ead: Pulling fs layer 621a51978ed7: Pulling fs layer 03e63548f209: Pulling fs layer 23c1f94a30c9: Pulling fs layer f6b9f8d8f3fa: Pulling fs layer 6f7f6d2df0b0: Pulling fs layer 03e63548f209: Waiting 23c1f94a30c9: Waiting f6b9f8d8f3fa: Waiting 6f7f6d2df0b0: Waiting 2d35ebdb57d9: Download complete f80aba050ead: Download complete 621a51978ed7: Download complete 03e63548f209: Download complete 23c1f94a30c9: Download complete f6b9f8d8f3fa: Download complete 6f7f6d2df0b0: Download complete 2d35ebdb57d9: Pull complete f80aba050ead: Pull complete 621a51978ed7: Pull complete 03e63548f209: Pull complete 23c1f94a30c9: Pull complete f6b9f8d8f3fa: Pull complete 6f7f6d2df0b0: Pull complete Digest: sha256:2d9f5c6f8b52b9d8f98a0b0fbc6f34f84a0c353f4d8b8a6dc8a1d2cf1880b1d1 Status: Downloaded newer image for nginx:latest docker.io/library/nginx:latest

# pull จาก GitHub Container Registry docker pull ghcr.io/example-org/example-app:1.2.0 # pull จาก private registry ภายในองค์กร docker pull registry.company.local/platform/api:v1.8.3

# 1) login เพื่อยืนยันตัวตนกับ registry ปลายทาง docker login # 2) tag image local ให้เป็นชื่อปลายทางที่ถูกต้อง # รูปแบบ: docker tag <local-image:tag> <registry/repo:tag> docker tag my-node-app:local YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0 # 3) push image ไปยัง repository ที่ตั้งชื่อไว้ docker push YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0

$ docker push YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0 The push refers to repository [docker.io/YOUR_DOCKERHUB_USERNAME/my-node-app] 8f3c7a9f6e10: Pushing [==================================================>] 15.36MB/15.36MB 5a7b2f4e8d22: Pushed 9d1e3c6a4b77: Layer already exists 31f8d4c2e911: Pushed 65e1c93b8d44: Layer already exists v1.0.0: digest: sha256:4f6e2f4ad6f6919a10d0c5b978bd3f2f7b9e1d1c3f2f7a4c9e8f6d7b1a3c2d4e size: 1578

Step 6: จัดการ tag ให้เป็นระบบ

# tag เวอร์ชันปล่อยใช้งานจริง (semantic version) docker tag my-node-app:local YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0 # tag latest สำหรับ default consumer (ระวังอย่าใช้ latest เดี่ยวใน production) docker tag my-node-app:local YOUR_DOCKERHUB_USERNAME/my-node-app:latest # tag ด้วย git commit hash เพื่อ trace เวอร์ชันได้แม่น docker tag my-node-app:local YOUR_DOCKERHUB_USERNAME/my-node-app:git-a1b2c3d

Tag

ใช้เมื่อไร

ข้อควรระวัง

v1.0.0

release แบบชัดเจน, deploy ซ้ำได้

ต้องมีวินัยในการ bump version

latest

ใช้เป็นค่าเริ่มต้นสำหรับผู้เริ่มต้น

ไม่ควรใช้เดี่ยวใน production

git-a1b2c3d

ต้องการ trace ย้อนกลับถึง source commit

อ่านยากสำหรับคนที่ไม่ดู git

Step 7: End-to-end flow ตั้งแต่ build > tag > push > pull

# build image จาก Dockerfile ในโฟลเดอร์ปัจจุบัน docker build -t my-node-app:local . # tag เพื่อเตรียมชื่อปลายทางบน Docker Hub docker tag my-node-app:local YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0 # push ขึ้น Docker Hub docker push YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0 # (เครื่องอื่น) pull image เดิมลงมาใช้งาน docker pull YOUR_DOCKERHUB_USERNAME/my-node-app:v1.0.0

Docker

Diagram: Developer > Build/Tag > Push Registry > Pull on Another Machine

Step 1: docker pull — ดึง image มาใช้งาน

Step 2: อ่าน output ระหว่าง pull ให้เป็น

Step 3: pull จาก registry อื่นที่ไม่ใช่ Docker Hub

Step 4: docker push — อัปโหลด image ขึ้น registry

Step 5: Terminal mockup ของ docker push (full output)

Step 6: จัดการ tag ให้เป็นระบบ

Step 7: End-to-end flow ตั้งแต่ build > tag > push > pull

Step 8: Workshop จริง (ทำตามทีละข้อ)

Loading

Docker

Diagram: Developer > Build/Tag > Push Registry > Pull on Another Machine

Step 1: docker pull — ดึง image มาใช้งาน

Step 2: อ่าน output ระหว่าง pull ให้เป็น

Step 3: pull จาก registry อื่นที่ไม่ใช่ Docker Hub

Step 4: docker push — อัปโหลด image ขึ้น registry

Step 5: Terminal mockup ของ docker push (full output)

Step 6: จัดการ tag ให้เป็นระบบ

Step 7: End-to-end flow ตั้งแต่ build > tag > push > pull

Step 8: Workshop จริง (ทำตามทีละข้อ)