Docker 安裝命令
Docker 安裝方式適用於想要測試 Rancher 的使用者。
與在 Kubernetes 叢集上執行不同，您可以使用 docker run 命令在單一節點上安裝 Rancher 伺服器元件。由於只有一個節點和一個 Docker 容器，如果該節點故障，其他節點上將沒有 etcd 資料的備份，您將遺失 Rancher 伺服器的所有資料。
備份應用程式可用於使用這些步驟將 Rancher 伺服器從 Docker 安裝遷移到 Kubernetes 安裝。
基於安全考量，使用 Rancher 時必須啟用 SSL（安全通訊層）。SSL 可保護所有 Rancher 網路通訊的安全，例如當您登入或與叢集互動時。
| 環境變數鍵 | 環境變數值 | 說明 |
|---|---|---|
CATTLE_SYSTEM_DEFAULT_REGISTRY | <REGISTRY.YOURDOMAIN.COM:PORT> | 設定 Rancher 伺服器在佈建叢集時始終從您的私有鏡像倉庫提取映像檔。 |
CATTLE_SYSTEM_CATALOG | bundled | 設定 Rancher 伺服器使用打包的 Helm 系統 chart 副本。系統 chart 儲存庫包含監控、日誌記錄、告警和全域 DNS 等功能所需的所有目錄項目。這些 Helm chart 位於 GitHub，但由於您處於離線環境中，使用 Rancher 內建的 chart 會比設定 Git 鏡像容易得多。 |
從以下選項中選擇：
選項 A：預設自簽憑證
點擊展開
如果您在開發或測試環境中安裝 Rancher，且不關心身份驗證問題，可以使用 Rancher 自動生成的自簽憑證來安裝。此安裝選項省去了自己生成憑證的麻煩。
登入您的 Linux 主機，然後執行以下安裝命令。輸入命令時，請使用下表替換每個佔位符。
| 佔位符 | 說明 |
|---|---|
<REGISTRY.YOURDOMAIN.COM:PORT> | 您的私有鏡像倉庫 URL 和連接埠。 |
<RANCHER_VERSION_TAG> | 您想要安裝的 Rancher 版本的發布標籤。 |
需要特權存取。
docker run -d --restart=unless-stopped \
-p 80:80 -p 443:443 \
-e CATTLE_SYSTEM_DEFAULT_REGISTRY=<REGISTRY.YOURDOMAIN.COM:PORT> \ # 設定要在 Rancher 中使用的預設私有鏡像倉庫
-e CATTLE_SYSTEM_CATALOG=bundled \ # 使用打包的 Rancher 系統 chart
--privileged \
<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher:<RANCHER_VERSION_TAG>
選項 B：自備憑證：自簽
點擊展開
在您的團隊將存取 Rancher 伺服器的開發或測試環境中，請建立自簽憑證以供安裝使用，以便您的團隊可以驗證他們正在連接到您的 Rancher 實 例。
建立憑證後，登入您的 Linux 主機，然後執行以下安裝命令。輸入命令時，請使用下表替換每個佔位符。使用 -v 標誌並提供憑證路徑以將其掛載到您的容器中。
| 佔位符 | 說明 |
|---|---|
<CERT_DIRECTORY> | 包含您憑證檔案的目錄路徑。 |
<FULL_CHAIN.pem> | 您的完整憑證鏈路徑。 |
<PRIVATE_KEY.pem> | 您憑證的私密金鑰路徑。 |
<CA_CERTS.pem> | 憑證授權機構的憑證路徑。 |
<REGISTRY.YOURDOMAIN.COM:PORT> | 您的私有鏡像倉庫 URL 和連接埠。 |
<RANCHER_VERSION_TAG> | 您想要安裝的 Rancher 版本的發布標籤。 |
需要特權存取。
docker run -d --restart=unless-stopped \
-p 80:80 -p 443:443 \
-v /<CERT_DIRECTORY>/<FULL_CHAIN.pem>:/etc/rancher/ssl/cert.pem \
-v /<CERT_DIRECTORY>/<PRIVATE_KEY.pem>:/etc/rancher/ssl/key.pem \
-v /<CERT_DIRECTORY>/<CA_CERTS.pem>:/etc/rancher/ssl/cacerts.pem \
-e CATTLE_SYSTEM_DEFAULT_REGISTRY=<REGISTRY.YOURDOMAIN.COM:PORT> \ # 設定要在 Rancher 中使用的預設私有鏡像倉庫
-e CATTLE_SYSTEM_CATALOG=bundled \ # 使用打包的 Rancher 系統 chart
--privileged \
<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher:<RANCHER_VERSION_TAG>
選項 C：自備憑證：由公認 CA 簽署
點擊展開
在您公開應用程式的開發或測試環境中，請使用由公認 CA 簽署的憑證，以便您的使用者不會遇到安全警告。
憑證檔案必須為 PEM 格式。
取得憑證後，登入您的 Linux 主機，然後執行以下安裝命令。輸入命令時，請使用下表替換每個佔位符。由於您的憑證是由公認的 CA 簽署，因此不需要掛載額外的 CA 憑證檔案。
| 佔位符 | 說明 |
|---|---|
<CERT_DIRECTORY> | 包含您憑證檔案的目錄路徑。 |
<FULL_CHAIN.pem> | 您的完整憑證鏈路徑。 |
<PRIVATE_KEY.pem> | 您憑證的私密金鑰路徑。 |
<REGISTRY.YOURDOMAIN.COM:PORT> | 您的私有鏡像倉庫 URL 和連接埠。 |
<RANCHER_VERSION_TAG> | 您想要安裝的 Rancher 版本的發布標籤。 |
使用 --no-cacerts 作為容器參數以停用 Rancher 生成的預設 CA 憑證。
需要特權存取。
docker run -d --restart=unless-stopped \
-p 80:80 -p 443:443 \
--no-cacerts \
-v /<CERT_DIRECTORY>/<FULL_CHAIN.pem>:/etc/rancher/ssl/cert.pem \
-v /<CERT_DIRECTORY>/<PRIVATE_KEY.pem>:/etc/rancher/ssl/key.pem \
-e CATTLE_SYSTEM_DEFAULT_REGISTRY=<REGISTRY.YOURDOMAIN.COM:PORT> \ # 設定要在 Rancher 中使用的預設私有鏡像倉庫
-e CATTLE_SYSTEM_CATALOG=bundled \ # 使用打包的 Rancher 系統 chart
--privileged
<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher:<RANCHER_VERSION_TAG>