wgshtg / cms-docker-compose-template

Docker compose templates for CMS on local development

使用 Joomla(Apache+PHP) + MariaDB(MySQL) + Traefik 來搭建 CMS

準備環境

• Docker

操作容器 (服務)

# 當前路徑為專案根目錄

# 啟動容器
docker-compose up -d

# 啟動指定容器
# docker-compose up -d <service1 name> <service2 name> ...
docker-compose up -d mysql adminer apple traefik

# 停止並移除容器
docker-compose down

# 重啟容器
docker-compose restart

建立本機開發用的 SSL 憑證

可透過 mkcert 建立本機開發用的 SSL 憑證

# 安裝 mkcert
brew install mkcert

# 安裝本機開發用的憑證簽發證書
mkcert -install

# 產生 SSL 憑證
mkdir -p traefik/conf/ssl
mkcert -cert-file traefik/etc/ssl/cert.pem -key-file traefik/etc/ssl/key.pem '*.website'

啟用 HTTPS 連線

設定 ./traefik/etc/dynamic/tls.yml。

tls:
  stores:
    default:
      defaultCertificate:
        certFile: /etc/traefik/ssl/cert.pem
        keyFile: /etc/traefik/ssl/key.pem

使用 Adminer 資料庫管理工具

伺服器填寫 mysql，請參考 docker-compose.yml 定義資料庫容器使用的服務名稱

注意不是 container_name

帳號密碼自行填入，若初始啟動、尚未修改過管理者帳號密碼，請參考 docker-compose.yml 裡定義資料庫容器的環境變數數值

若有建立或修改使用者帳號密碼，再自行調整填入的數值

設定容器環境變數

透過 env_file 將環境變數帶入至容器中，只需在 .env 內新增、修改、刪除環境變數即可達到調整服務配置

注意容器內服務會讀取特定環境變數數值，需確定設定正確的環境變數名稱和數值，來調整服務配置

依照不同容器來建立對應 .env 檔案

例如：apple.env

JOOMLA_DB_HOST=mysql
JOOMLA_DB_PASSWORD=root
JOOMLA_DB_NAME=apple

問題說明

問題 1. 想直接修改容器內的網站內容，該怎麼做？

透過將本機路徑掛載至容器中，更新本機檔案時，容器內檔案同時更新。

# ./google 為本機相對路徑，/var/www/html 為容器內網站路徑
volumes:
  - ./google:/var/www/html

問題 2. 想要開啟 HTTPS，需要自簽憑證，要如何製作？

請參考 建立本機開發用的 SSL 憑證 和 啟用 HTTPS 連線。

注意： 憑證存放路徑：./traefik/etc/ssl traefik 指定憑證路徑：/etc/traefik/ssl

問題 3. 同時開發多個網站要怎麼設定？

此架構下只需要複製多個網站容器 (Joomla)，MariaDB 和 Traefik 只需要一個容器即可。

在 docker-compose.yml 中複製 Joomla 容器配置於既有配置容器下，將 <name> 替換成自定義名稱，可以是網站或服務名稱。

注意：不能和既有容器名稱重複。

<name>:
  image: joomla:3.10.8
  container_name: <name>
  environment:
    JOOMLA_DB_HOST: mysql
    JOOMLA_DB_PASSWORD: root
    JOOMLA_DB_NAME: <name>
  labels:
    - traefik.enable=true
    # 啟用 HTTP
    - traefik.http.routers.<name>.rule=Host(`<name>.website`)
    # 啟用 HTTPS
    - traefik.http.routers.<name>-https.entrypoints=websecure
    - traefik.http.routers.<name>-https.tls=true
    - traefik.http.routers.<name>-https.rule=Host(`<name>.website`)
  restart: unless-stopped
  # 設定本地掛載目錄，可直接修改容器內網站內容
  volumes:
    - ./<name>:/var/www/html

問題 4. 透過 Akeeba Kickstart Core 還原網站，該如何操作？

準備 Akeeba Kickstart Core，在網站目錄下放置 kickstart.php 和 *.jpa 檔案，並將服務啟動後，依照 kickstart 步驟還原。

注意：在設定資料庫主機時，請使用服務名稱，而非容器名稱。

# 服務名稱
apple:
    image: joomla:3.10.8
    # 容器名稱
    container_name: apple-container-name

問題 5. image:joomla:3.10.8 的 3.10.8 是什麼？

是 joomla image 的 tag，可以是 3.10, 3, 3.10.8-apache,3.10.8-php7.4，可在各個不同 image repository 查詢。

問題 6. MariaDB 可以替換成 MySQL 嗎？

可以，把 image 替換成 mysql 即可，自行決定版本號選用和調整container_name(容器名稱是唯一值，不能重複)。

問題 7. 如何調整 PHP 設定？

將 php/etc/php.ini 掛載至容器內，容器內 PHP 設定會即時更新，必要時可重啟容器。

問題 8. 直接在專案下啟動容器，瀏覽器打開網址，顯示無法連上這個網站？

請將範本內的 apple, google 兩個服務的域名指向本地加入至本機 DNS，即可正常連線。

# 方法 1：使用編輯器直接修改 host
# macOS & linux file path: /etc/hosts
# Windows file path: C:\Windows\System32\Drivers\etc\hosts
# 增加以下內容
127.0.0.1 apple.website google.website

# 方法 2：執行以下指令 (macOS or Linux)
sudo echo 127.0.0.1 apple.website google.website >> /etc/hosts

問題 9. 安裝套件時，缺少 php 相關模組或套件，該如何處理？

1. 可以透過 docker-php-ext-install 在容器內安裝套件，參考這裡。
2. 若需要重新建立容器也自動包含需要的套件，需另外客製化 docker image。