適用於 Docker 的最佳化 MySQL 安裝

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

設定 MySQL 伺服器

當您啟動 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 伺服器。

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

保存資料和組態變更

原則上，Docker 容器是暫時性的，而且如果容器遭到刪除或損毀，預期會遺失任何資料或組態 (請參閱這裡的討論)。Docker 磁碟區提供了一種機制，可以保存 Docker 容器內建立的資料。在其初始化時，MySQL 伺服器容器會為伺服器資料目錄建立 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 伺服器容器並繫結掛載資料目錄和伺服器組態檔

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 伺服器具有對已掛載主機檔案的寫入權限。

搭配 Docker 使用 MySQL Enterprise Backup

MySQL Enterprise Backup 是 MySQL 伺服器的商業授權備份公用程式，可透過 MySQL Enterprise Edition 取得。MySQL Enterprise Backup 包含在 MySQL Enterprise Edition 的 Docker 安裝中。

在以下範例中，我們假設您已經在 Docker 容器中執行 MySQL 伺服器（請參閱關於如何使用 Docker 啟動 MySQL 伺服器實例的第 2.5.6.1 節「使用 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:9.0

使用此命令，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 伺服器實例，請依照此處列出的步驟進行

搭配 Docker 使用 mysqldump

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

以下指示假設您已經在 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 實例的環境變數