針對 Docker 最佳化的 MySQL 安裝

MySQL 的 Docker 映像已針對程式碼大小進行最佳化，這表示它們僅包含預期與在 Docker 容器中執行 MySQL 執行個體的大多數使用者相關的重要元件。MySQL Docker 安裝與一般的非 Docker 安裝在以下方面不同

設定 MySQL Server

當您啟動 MySQL Docker 容器時，您可以透過 docker run 命令將組態選項傳遞至伺服器。例如

docker run --name mysql1 -d container-registry.oracle.com/mysql/community-server:tag --character-set-server=utf8mb4 --collation-server=utf8mb4_col

此命令會以 utf8mb4 作為預設字元集和 utf8mb4_col 作為資料庫的預設定序來啟動 MySQL Server。

設定 MySQL Server 的另一種方法是準備一個組態檔案，並將其掛載到容器內伺服器組態檔案的位置。如需詳細資訊，請參閱持續保存資料和組態變更。

持續保存資料和組態變更

Docker 容器原則上是暫時性的，如果容器被刪除或損壞，任何資料或組態都將遺失 (請參閱此處的討論)。Docker 磁碟區提供了一種機制來持續保存在 Docker 容器內建立的資料。在初始化時，MySQL Server 容器會為伺服器資料目錄建立一個 Docker 磁碟區。容器上 docker inspect 命令的 JSON 輸出包含一個 Mount 金鑰，其值提供有關資料目錄磁碟區的資訊

$> docker inspect mysql1
...
 "Mounts": [
            {
                "Type": "volume",
                "Name": "4f2d463cfc4bdd4baebcb098c97d7da3337195ed2c6572bc0b89f7e845d27652",
                "Source": "/var/lib/docker/volumes/4f2d463cfc4bdd4baebcb098c97d7da3337195ed2c6572bc0b89f7e845d27652/_data",
                "Destination": "/var/lib/mysql",
                "Driver": "local",
                "Mode": "",
                "RW": true,
                "Propagation": ""
            }
        ],
...

輸出顯示主機上持續保存資料的來源目錄 /var/lib/docker/volumes/4f2d463cfc4bdd4baebcb098c97d7da3337195ed2c6572bc0b89f7e845d27652/_data 已掛載在 /var/lib/mysql，即容器內的伺服器資料目錄。

保存資料的另一種方法是在建立容器時，使用 --mount 選項繫結掛載主機目錄。相同的技術可用於持續保存伺服器的組態。以下命令會建立 MySQL Server 容器並繫結掛載資料目錄和伺服器組態檔案

docker run --name=mysql1 \
--mount type=bind,src=/path-on-host-machine/my.cnf,dst=/etc/my.cnf \
--mount type=bind,src=/path-on-host-machine/datadir,dst=/var/lib/mysql \
-d container-registry.oracle.com/mysql/community-server:tag

此命令會在 /etc/my.cnf (容器內的伺服器組態檔案) 掛載 path-on-host-machine/my.cnf，並在 /var/lib/mysql (容器內的資料目錄) 掛載 path-on-host-machine/datadir。繫結掛載要能運作，必須滿足以下條件

執行額外的初始化腳本

如果有任何您想在資料庫建立後立即執行的 .sh 或 .sql 腳本，您可以將它們放入主機目錄，然後將該目錄掛載到容器內的 /docker-entrypoint-initdb.d/。例如：

docker run --name=mysql1 \
--mount type=bind,src=/path-on-host-machine/scripts/,dst=/docker-entrypoint-initdb.d/ \
-d container-registry.oracle.com/mysql/community-server:tag

從另一個 Docker 容器連線到 MySQL

透過設定 Docker 網路，您可以允許多個 Docker 容器彼此通訊，以便另一個 Docker 容器中的客戶端應用程式可以存取伺服器容器中的 MySQL 伺服器。首先，建立一個 Docker 網路：

docker network create my-custom-net

然後，當您建立並啟動伺服器和客戶端容器時，請使用 --network 選項將它們放在您建立的網路上。例如：

docker run --name=mysql1 --network=my-custom-net -d container-registry.oracle.com/mysql/community-server

docker run --name=myapp1 --network=my-custom-net -d myapp

myapp1 容器接著可以使用 mysql1 主機名稱連線到 mysql1 容器，反之亦然，因為 Docker 會自動為給定的容器名稱設定 DNS。在以下範例中，我們從 myapp1 容器內部執行 mysql 客戶端，以連線到其自身容器中的主機 mysql1：

docker exec -it myapp1 mysql --host=mysql1 --user=myuser --password

如需其他容器網路技術，請參閱 Docker 文件中的Docker 容器網路章節。

伺服器錯誤日誌

當 MySQL 伺服器首次使用您的伺服器容器啟動時，如果符合以下任一條件，則不會產生伺服器錯誤日誌：

若要讓 MySQL 伺服器在符合任一條件時產生錯誤日誌，請使用 --log-error 選項來設定伺服器，以便在容器內的特定位置產生錯誤日誌。若要持久化錯誤日誌，請將主機檔案掛載到容器內錯誤日誌的位置，如持久化資料和設定變更中所述。但是，您必須確保容器內的 MySQL 伺服器具有寫入權限才能寫入掛載的主機檔案。

將 MySQL Enterprise Backup 與 Docker 搭配使用

MySQL Enterprise Backup 是 MySQL 伺服器的商業授權備份公用程式，可與MySQL Enterprise Edition 搭配使用。MySQL Enterprise Backup 包含在 MySQL Enterprise Edition 的 Docker 安裝中。

在以下範例中，我們假設您已經在 Docker 容器中執行 MySQL 伺服器（請參閱第 2.5.6.1 節「使用 Docker 部署 MySQL 伺服器的基本步驟」，瞭解如何使用 Docker 啟動 MySQL 伺服器執行個體）。為了讓 MySQL Enterprise Backup 備份 MySQL 伺服器，它必須能夠存取伺服器的資料目錄。例如，這可以透過在您啟動伺服器時將主機目錄繫結掛載到 MySQL 伺服器的資料目錄來實現。

docker run --name=mysqlserver \
--mount type=bind,src=/path-on-host-machine/datadir/,dst=/var/lib/mysql \
-d mysql/enterprise-server:8.4

透過此命令，MySQL 伺服器會使用 MySQL Enterprise Edition 的 Docker 映像啟動，並且主機目錄 /path-on-host-machine/datadir/ 已掛載到伺服器容器內的伺服器資料目錄 (/var/lib/mysql)。我們也假設在伺服器啟動後，已設定所需的權限，以便讓 MySQL Enterprise Backup 存取伺服器（詳細資訊請參閱授予備份管理員 MySQL 權限）。請使用以下步驟來備份和還原 MySQL 伺服器執行個體。

若要使用 Docker 的 MySQL Enterprise Backup 備份在 Docker 容器中執行的 MySQL 伺服器執行個體，請按照此處列出的步驟進行：

若要使用 Docker 的 MySQL Enterprise Backup 還原 Docker 容器中的 MySQL 伺服器執行個體，請按照此處列出的步驟進行：

將 mysqldump 與 Docker 搭配使用

除了使用 MySQL Enterprise Backup 備份在 Docker 容器中執行的 MySQL 伺服器之外，您還可以透過使用 mysqldump 公用程式（在 Docker 容器內執行）來執行伺服器的邏輯備份。

以下指示假設您已經在 Docker 容器中執行 MySQL 伺服器，而且在第一次啟動容器時，主機目錄 /path-on-host-machine/datadir/ 已掛載到伺服器的資料目錄 /var/lib/mysql（詳細資訊請參閱將主機目錄繫結掛載到 MySQL 伺服器的資料目錄），其中包含 mysqldump 和 mysql 可以連線到伺服器的 Unix Socket 檔案。我們也假設在伺服器啟動後，已建立具有適當權限的使用者（此範例中為 admin），mysqldump 可以使用該使用者存取伺服器。請使用以下步驟來備份和還原 MySQL 伺服器資料：

使用 Docker 的 mysqldump 備份 MySQL 伺服器資料:

使用 Docker 的 mysqldump 還原 MySQL 伺服器資料:

已知問題

Docker 環境變數

當您建立 MySQL 伺服器容器時，您可以使用 --env 選項（簡寫為 -e）並指定一個或多個環境變數來設定 MySQL 執行個體。如果已掛載的資料目錄不是空的，則不會執行伺服器初始化，在這種情況下，設定任何這些變數都無效（請參閱持久化資料和組態變更），並且在容器啟動期間不會修改目錄的現有內容，包括伺服器設定。

以下列出可用於設定 MySQL 執行個體的環境變數