跳至主要内容

Docker 安裝的進階選項

自訂 CA 憑證​

如果你想要設定 Rancher 使用 CA 根憑證來驗證服務，你需要啟動 Rancher 容器並共享包含 CA 根憑證的目錄。

使用命令範例來啟動已掛載你的私有 CA 憑證的 Rancher 容器。

  • 卷標旗標（-v）應指定包含 CA 根憑證的主機目錄。
  • 環境變數旗標（-e）與 SSL_CERT_DIR 和目錄組合，宣告一個環境變數，指定容器內掛載的 CA 根憑證目錄位置。
  • 將環境變數傳遞給 Rancher 容器可以使用 -e KEY=VALUE 或 --env KEY=VALUE。
  • 在容器內掛載主機目錄可以使用 -v host-source-directory:container-destination-directory 或 --volume host-source-directory:container-destination-directory。

以下範例基於主機上的 /host/certs 目錄中有 CA 根憑證，並將此目錄掛載到 Rancher 容器內的 /container/certs。

需要特權存取。參見此處。

docker run -d --restart=unless-stopped \
  -p 80:80 -p 443:443 \
  -v /host/certs:/container/certs \
  -e SSL_CERT_DIR="/container/certs" \
  --privileged \
  rancher/rancher:latest

API 稽核日誌​

API 稽核日誌記錄透過 Rancher 伺服器進行的所有使用者和系統交易。

預設情況下，API 稽核日誌會寫入 rancher 容器內的 /var/log/auditlog。將該目錄作為卷共享並設定你的 AUDIT_LEVEL 以啟用日誌。

有關更多資訊和選項，請參閱 API 稽核日誌。

需要特權存取。參見此處。

docker run -d --restart=unless-stopped \
  -p 80:80 -p 443:443 \
  -v /var/log/rancher/auditlog:/var/log/auditlog \
  -e AUDIT_LOG_ENABLED=true \
  -e AUDIT_LEVEL=1 \
  --privileged \
  rancher/rancher:latest

TLS 設定​

要設定不同的 TLS 設定，你可以使用 CATTLE_TLS_MIN_VERSION 和 CATTLE_TLS_CIPHERS 環境變數。例如，要將 TLS 1.0 設定為最低接受的 TLS 版本：

docker run -d --restart=unless-stopped \
  -p 80:80 -p 443:443 \
  -e CATTLE_TLS_MIN_VERSION="1.0" \
  --privileged \
  rancher/rancher:latest

需要特權存取。參見此處。

有關更多資訊和選項，請參閱 TLS 設定。

離線環境​

如果你正在訪問此頁面以完成離線安裝，在執行你所選擇選項中的安裝命令時，你必須在伺服器標籤前加上你的私有 Registry URL。在 rancher/rancher:latest 前面加上你的私有 Registry URL <REGISTRY.DOMAIN.COM:PORT>。

範例：

<REGISTRY.DOMAIN.COM:PORT>/rancher/rancher:latest

持久性資料​

Rancher 使用 etcd 作為資料儲存。當使用 Docker 安裝 Rancher 時，會使用嵌入式 etcd。持久性資料位於容器中的以下路徑：/var/lib/rancher。

你可以將主機卷綁定掛載到此位置，以在其執行的主機上保留資料：

docker run -d --restart=unless-stopped \
  -p 80:80 -p 443:443 \
  -v /opt/rancher:/var/lib/rancher \
  --privileged \
  rancher/rancher:latest

需要特權存取。參見此處。

在同一節點上執行 rancher/rancher 和 rancher/rancher-agent​

在你想要使用單一節點來執行 Rancher 並能夠將同一節點新增到叢集的情況下，你必須調整為 rancher/rancher 容器對應的主機埠。

如果將節點新增到叢集，它會部署 nginx Ingress 控制器，該控制器將使用埠 80 和 443。這將與我們建議為 rancher/rancher 容器公開的預設埠衝突。

請注意，不建議在生產環境中使用此設定，但對於開發/示範目的可能很方便。

要變更主機埠對應，請將以下部分 -p 80:80 -p 443:443 替換為 -p 8080:80 -p 8443:443：

docker run -d --restart=unless-stopped \
  -p 8080:80 -p 8443:443 \
  --privileged \
  rancher/rancher:latest

需要特權存取。參見此處。