【Docker】Multi-Stage Build 減少Image大小

Tue, 21 Apr 2026 13:48:45 +0800

為了可以在CI build Docker Image時節省Image的大小，學了一下Multi-Stage build，這篇文章就來記錄一下。

Image Layer Link to heading

首先最重要的概念就是，Docker的每個Image都是由多個Layer組成的，當我們在Dockerfile裡每執行一個指令(e.g.FROM, RUN, COPY...)時，都會在原有的Layer之上再建立一個新的Layer，且該指令對檔案的任何操作或是Diff都只會記錄在這個Layer中(如果是改上一個Layer就有的檔案會複製一份再改，不影響上個Layer的完整性，Copy-on-Write)。

所以說當我們要build一個新的Image時，裡面可能就會包含很多不同的階段，像是安裝套件、編譯、打包可執行檔等等，每個步驟可能都會在對應的Layer裡產生很多最終執行檔不需要的東西，例如快取、編譯工具，導致整包Image很肥大。

FROM node:18

WORKDIR /app

# 複製 package.json 並安裝所有依賴 (包含 devDependencies)
COPY package*.json ./
RUN npm install

# 複製所有原始碼並進行編譯
COPY . .
RUN npm run build

# 啟動伺服器 (通常是 npm start)
CMD ["npm", "start"]

# 【結果】映像檔大小：可能高達 1GB+ (包含 node_modules 和原始碼)

Multi-Stage Build Link to heading

為了處理這個問題 Docker提供了多階段build的功能，我們只需要使用FROM AS就可以把每個不同階段拆開來，只傳遞該階段重要的結果(Artifact)，其他用不到的東西都可以直接丟掉。

【DevOps】自架Gitlab以及Gitlab Runner跑CI/CD

Fri, 19 Dec 2025 15:00:15 +0800

Docker Compose Link to heading

services:
 gitlab:
 image: gitlab/gitlab-ce:latest
 container_name: gitlab
 restart: always
 environment:
 GITLAB_OMNIBUS_CONFIG: |
 # 讓網頁上的 Clone 連結的ip顯示正確
 external_url 'http://<區網ip>:12080'

 nginx['listen_port'] = 80
 nginx['listen_https'] = false

 # 讓網頁上的 Clone 連結的ssh port顯示正確
 gitlab_rails['gitlab_shell_ssh_port'] = 12022

 prometheus_monitoring['enable'] = false
 ports:
 - "12080:80"
 - "12443:443"
 - "12022:22" # ssh改12022，避免衝突
 volumes:
 - /path/to/your/volume/gitlab/gitlab-config:/etc/gitlab
 - /path/to/your/volume/gitlab/gitlab-logs:/var/log/gitlab
 - /path/to/your/volume/gitlab/gitlab-data:/var/opt/gitlab
 shm_size: '256m'
 networks:
 - gitlab-network

 gitlab-runner:
 image: gitlab/gitlab-runner:latest
 container_name: gitlab-runner
 restart: always
 depends_on:
 - gitlab
 volumes:
 - /path/to/your/volume/gitlab/gitlab-runner-config:/etc/gitlab-runner
 - /var/run/docker.sock:/var/run/docker.sock
 networks:
 - gitlab-network

networks:
 gitlab-network:
 driver: bridge

預設創建了root帳號，預設密碼可以用以下指令查詢

CI/CD on WSLIN

【Docker】Multi-Stage Build 減少Image大小

Image Layer Link to heading

Multi-Stage Build Link to heading

【DevOps】 自架Gitlab以及Gitlab Runner跑CI/CD

Docker Compose Link to heading

【DevOps】自架Gitlab以及Gitlab Runner跑CI/CD