Docker 管理術(四):透過 Dockerfile 撰寫專案環境

有了 Docker 以後,就可以將專案的環境寫成 Dockerfile,到了有 Docker 的機器,就可以把專案所需的環境 build 起來。

通常你在 Docker Hub 上找到的容器,通常都是官方預設的設定;就算有人客製化一些容器,這些容器可能也不一定符合我們的需求。例如我們要改寫 Nginx 伺服器的設定檔 nginx.conf 的時候,可能就要先 docker run 一個 nginx,然後 docker exec -ti [id] bash 進去改寫 /etc/nginx/nginx.conf

如果你看不懂 docker rundocker exec,可以回去閱讀 Docker 管理術(三):啟動容器與基本指令

Dockerfile 管理 Image

這時候,Dockerfile 就能夠幫助我們建立自己的 Image,建好 Image 之後隨時要執行都沒有問題。例如剛剛的例子可以這樣寫成 Dockerfile:

FROM nginx:latest

COPY ./default.conf /etc/nginx/conf.d/default.conf

EXPOSE 80

上面這個 Dockerfile 會基於最新版的 nginx 這個 Image,再複製一個我們目前資料夾下的 default.conf 檔案去覆蓋掉 Image 內的 /etc/nginx/conf.d/default.conf,最後把 PORT 80 expose 出來(讓外面的人可以連到 port 80)。

Dockerfile 常用到的指令有:

  • FROM:也就是你要基於哪個 Docker Image。
    • 例如:FROM debian
  • MAINTAINER:用來說明維護這個 Dockerfile 的人是誰。
    • 例如:MAINTAINER NoobTW noob@noob.tw
  • RUN:後面放建立這個 Image 需要執行的指令。需要注意你原本的 Image 有沒有這些指令就是了。
    • 例如:RUN curl http://npmjs.org/install.sh | sh
  • ADD:把目前資料夾的檔案複製到 Image 裡。如果是 tar.gz 檔,它還會自動幫你解壓縮。
    • 例如:ADD wordpress-latest-zh_TW.tar.gz /var/www/html/
  • COPY:把目前資料夾的檔案複製到 Image 裡面。
    • 例如:COPY package.json /usr/src/app/package.json
  • ENV:用來設定環境變數。
    • 例如:ENV PATH /root/.npm/node_modules:$PATH
  • CMD:使用者執行 docker run 時要執行的指令和參數。
    • 例如:CMD [ "npm", "start" ]
  • EXPOSE:要開放連進去的 port
    • 例如:EXPOSE 3306

寫好以後可以透過這個指令去 build 成我們自己的 Image:

docker build -t [作者]/[Image 名稱] [Dockerfile 資料夾]

例如:

docker built -t NoobTW/mynginx .

這樣就能建立一個叫做 NoobTW/mynginx 的 Docker Image。想執行它的話只要:

docker run -p 80:80 -d NoobTW/mynginx

就能看到這個 Container 開始執行了。

記住:雖然剛剛已經有 EXPOSE 80,但建立 Container 時還是要加個 -p 80:80 才能

Docker Compose 一次執行多個 Docker Container

如果在撰寫大型專案的時候,例如有個前後端分離的專案,同時又需要資料庫的 Container,可能就會有多個資料夾、多個 Dockerfile。

例如你的資料夾結構長這樣:

├ app/
├── src/
├── app.js
├── Dockerfile
├ api/
├── src/
├── server.js
├── Dockerfile
├ dbs/
├── mongo-backup/
├── Dockerfile
├ README.md

前端、後端、和資料庫工程師各把自己的部分寫完,並寫好了屬於自己的 Dockerfile,而你需要把這三個 Image build 起來並啟動這些容器的時候,就可以用寫一個 docker-compose.yml:

version: '3'

services:
    api:
        depends_on:
             - db
        container_name: api
        build:
            context: ./api
            dockerfile: Dockerfile
        volumes:
            - './api:/usr/src/app'
            - '/usr/src/app/node_modules'
        restart: always
        ports:
            - 8080:8080
        environment:
            DB_HOST: db
    app:
        depends_on:
            - db
        container_name: app
        build:
            context: ./app
            dockerfile: Dockerfile
        volumes:
            - './api:/usr/src/app'
            - '/usr/src/app/node_modules'
        restart: always
        ports:
            - 80:3000
    db:
        container_name: db
        build:
            context: ./db
            dockerfile: Dockerfile
        volumes:
            - './db/:/db'
        restart: always
        ports:
            - 27017:27017

接著執行這個指令,就能夠自動 build 所有環境,並建立所有的 Container:

docker-compose up

你可能會需要安裝 Docker Compose,請參考 Install Docker Compose

Docker 管理術 目錄