使用 Bitnami 的Docker Image快速部署 WordPress 

A. Bitnami、Wordpress、Docker是什麼

B. Bitnami的Wordpress套件

Bitnami官方提供了一個即用型的WordPress Image，搭配官方Github中的環境變數配置說明文件，讓我們可以透過Docker快速客製化建立我們自己的Wordpress伺服器。以下是Bitnami的一些優點：

在選擇和使用Bitnami的WordPress Image時，能夠輕鬆享受到這些優勢，從而專注於網站的開發與內容發想。

C. 編寫docker-compose.yml

為了建構一個功能完整的WordPress網站，我們需要同時部署資料庫和WordPress系統。在這個範例中，使用Bitnami提供的Docker Image來搭建MariaDB和WordPress的環境。通過編寫docker-compose.yml文件，對應用堆疊進行定義和管理。

services:
  mariadb:
    image: docker.io/bitnami/mariadb:11.4
    volumes:
      - /path/to/mariadb-persistence:/bitnami/mariadb
    environment:
      # ALLOW_EMPTY_PASSWORD is recommended only for development.
      - ALLOW_EMPTY_PASSWORD=yes
      - MARIADB_USER=bn_wordpress
      - MARIADB_DATABASE=bitnami_wordpress

services:
  wordpress:
    image: docker.io/bitnami/wordpress:6
    ports:
      - '80:8080'
      - '443:8443'
    volumes:
      - /path/to/wordpress-persistence:/bitnami/wordpress
    depends_on:
      - mariadb
    environment:
      # ALLOW_EMPTY_PASSWORD is recommended only for development.
      - ALLOW_EMPTY_PASSWORD=yes
      - WORDPRESS_DATABASE_HOST=mariadb
      - WORDPRESS_DATABASE_PORT_NUMBER=3306
      - WORDPRESS_DATABASE_USER=bn_wordpress
      - WORDPRESS_DATABASE_NAME=bitnami_wordpress

  wordpress:
    ...
    environment:
      - WORDPRESS_DATABASE_USER=bn_wordpress
      - WORDPRESS_DATABASE_NAME=bitnami_wordpress
      - ALLOW_EMPTY_PASSWORD=yes
      - WORDPRESS_SMTP_HOST=smtp.gmail.com
      - WORDPRESS_SMTP_PORT=587
      - [email protected]
      - WORDPRESS_SMTP_PASSWORD=your_password
  ...

D. Non-root Container

在Container說明上有一段話：

Why use a non-root container?

Non-root container images add an extra layer of security and are generally recommended for production environments. However, because they run as a non-root user, privileged tasks are typically off-limits. Learn more about non-root containers in our docs.

直接翻譯內容大概是這樣：非root比較安全，但有些事情做不了，想知道更多可以去看他們的文件。

我們可以試著直接執行剛剛的docker-compose.yml：

services:
  mariadb:
    image: docker.io/bitnami/mariadb:11.4
    volumes:
      - ./mariadb_data:/bitnami/mariadb
    environment:
      # ALLOW_EMPTY_PASSWORD is recommended only for development.
      - ALLOW_EMPTY_PASSWORD=yes
      - MARIADB_USER=bn_wordpress
      - MARIADB_DATABASE=bitnami_wordpress
  wordpress:
    image: docker.io/bitnami/wordpress:6
    ports:
      - '80:8080'
      - '443:8443'
    volumes:
      - ./wordpress_data:/bitnami/wordpress
    depends_on:
      - mariadb
    environment:
      # ALLOW_EMPTY_PASSWORD is recommended only for development.
      - ALLOW_EMPTY_PASSWORD=yes
      - WORDPRESS_DATABASE_HOST=mariadb
      - WORDPRESS_DATABASE_PORT_NUMBER=3306
      - WORDPRESS_DATABASE_USER=bn_wordpress
      - WORDPRESS_DATABASE_NAME=bitnami_wordpress

建議先開一個專案資料夾，把docker-compose.yml放進其中，再建立mariadb_data和wordpress_data資料夾，

project-folder/
├── mariadb_data/
├── wordpress_data/
└── docker-compose.yml

將bash切換到專案資料夾，並執行以下指令：

docker-compose -f ./docker-compose.yml up --build -d

然後你會發現DB Container開不起來：

嗯。Permission denied

然後在文件講解如何設定volumes時，默默出現了一句話：

NOTE: As this is a non-root container, the mounted files and directories must have the proper permissions for the UID 1001.

其實我一直在想，non-root container這件事在文件中明明很早就提到，為什麼要在一個不起眼的地方才特別提一下呢？

Permissions for the UID 1001

根據他的提示，我們在本地端建立一個one_click.sh，自動建立資料夾並更改權限，最後再自動執行docker-compose指令。其中one_click.sh記得透過

sudo chmod +x one_click.sh

讓這個檔案可被執行，同時第一行的USER也不要忘記修改成你自己。

USER="username"
GROUP="1001"

DIR="./mariadb_data"
if [ ! -d "$DIR" ]; then
    echo "Directory $DIR does not exist. Creating..."
    mkdir -p "$DIR"
fi
echo "Changing owner of $DIR to UID $GROUP..."
sudo chown -R "$GROUP":"$GROUP" "$DIR"
echo "Setting permissions for $DIR..."
sudo chmod -R 775 "$DIR"
echo "Adding user $USER to group $GROUP..."
sudo usermod -aG "$GROUP" "$USER"

DIR="./wordpress_data"
if [ ! -d "$DIR" ]; then
    echo "Directory $DIR does not exist. Creating..."
    mkdir -p "$DIR"
fi
echo "Changing owner of $DIR to UID $GROUP..."
sudo chown -R "$GROUP":"$GROUP" "$DIR"
echo "Setting permissions for $DIR..."
sudo chmod -R 775 "$DIR"
echo "Adding user $USER to group $GROUP..."
sudo usermod -aG "$GROUP" "$USER"

echo "docker-compose running ..."
docker-compose -f ./docker-compose.yml up --build -d
echo "All operations completed successfully."

確認成功執行後，開啟瀏覽器輸入localhost，即可看到Wordpress網站，切換到localhost/admin，輸入預設帳號(user)及密碼(bitnami)即可進入管理後台。

在Appearance -> Theme -> Add New Theme下挑選一個喜歡的主題，安裝並啟用；完成後回到localhost，當頁面產生變化，代表你成功安裝Worepress伺服器且克服權限問題了。

E. 總結

通過編寫docker-compose.yml文件，對應用堆疊進行定義和管理，使用了Bitnami提供MariaDB及WordPress伺服器Image，成功的搭建了我們自己的Wordpress伺服器。

如果前面的內容都懶得看，可以直接跳到D. Non-root Container，找出docker-compose.yml及one_click.sh，放到你的專案資料夾下，執行sudo chmod +x one_click.sh && ./one_click.sh指令，稍等片刻，即可在localhost下查看網站。

第一次看官方說明時其實看得母煞煞，像是non-root container就錯過了，這篇文章精簡了部分內容，希望譨夠讓看的人直接無腦啟動伺服器，稍微熟悉後再回去看官方文件，更容易理解文件的內容。