跳至主要内容

配置全域預設私有倉庫

備註

本頁面描述了在 Rancher 已經安裝後，如何從 Rancher UI 配置全域預設私有倉庫。

有關在 Rancher 安裝期間如何設定私有倉庫的說明，請參閱離線安裝指南。

私有倉庫是叢集中容器映像的私有、一致且集中的真實來源。您可以使用私有容器映像倉庫在組織內共享自訂基礎映像。

在 Rancher 中設定私有倉庫有兩種主要方式：

  • 透過全域檢視中的設定分頁設定全域預設倉庫。
  • 在叢集層級設定下的進階選項中設定私有倉庫。

全域預設倉庫旨在用於離線設定，適用於不需要憑證的倉庫。叢集層級的私有倉庫旨在用於私有倉庫需要憑證的設定。

將無憑證的私有倉庫設定為預設倉庫​

  1. 登入 Rancher 並配置預設管理員密碼。
  2. 選擇 ☰ > 全域設定。
  3. 前往 system-default-registry 並選擇 ⋮ > 編輯設定。
  4. 輸入您的倉庫的主機名稱和埠號（例如 registry.yourdomain.com:port）。請勿在文字前加上 http:// 或 https://。

**結果：**Rancher 從您的私有倉庫拉取系統映像。

帶有 RKE2 下游叢集的命名空間私有倉庫​

大多數私有倉庫預設應該可以與 RKE2 下游叢集一起使用。

但是，如果您嘗試設定其 URL 格式為 website/subdomain:portnumber 的命名空間私有倉庫，則需要執行一些額外的步驟。

  1. 選擇 ☰ > 叢集管理。
  2. 在列表中找到 RKE2 叢集，然後點擊 ⋮ > 編輯配置。
  3. 從叢集配置選單中，選擇倉庫。
  4. 在倉庫窗格中，選擇配置進階 containerd 鏡像和倉庫身份驗證選項選項。
  5. 在鏡像下的文字欄位中，輸入倉庫主機名稱和鏡像端點。
  6. 點擊儲存。
  7. 根據需要對每個下游 RKE2 叢集重複此操作。

在建立叢集時配置帶有憑證的私有倉庫​

沒有全域方法可以為每個 Rancher 佈建的叢集設定具有授權的私有倉庫。因此，如果您希望 Rancher 佈建的叢集從需要憑證的私有倉庫拉取映像，則每次建立新叢集時都必須透過進階叢集選項傳遞倉庫憑證。

由於無法在建立叢集後配置私有倉庫，因此您需要在初始叢集設定期間執行這些步驟。

  1. 選擇 ☰ > 叢集管理。
  2. 在叢集頁面上，點擊建立。
  3. 選擇叢集類型。
  4. 在叢集配置中，前往倉庫分頁。
  5. 勾選為 Rancher 系統容器映像啟用叢集範圍的容器倉庫旁邊的框。
  6. 輸入倉庫主機名稱。
  7. 在身份驗證下選擇建立 HTTP 基本身份驗證密鑰並填寫憑證欄位。
  8. 點擊建立。

**結果：**新叢集從私有倉庫拉取映像。

使用私有倉庫憑證​

使用私有倉庫時，確保為這些倉庫建立的所有密鑰都已正確備份非常重要。當您透過 Rancher GUI 新增私有倉庫憑證密鑰並選擇建立 HTTP 基本身份驗證密鑰時，該密鑰將包含在使用 Rancher 備份的備份操作中。

但是，如果您在 Rancher GUI 之外建立憑證密鑰，例如透過使用 kubectl 或 Terraform，則必須新增 fleet.cattle.io/managed=true 標籤以指示該密鑰應包含在 Rancher 備份建立的備份中。

例如，如果您有一個名為「my-private-registry」的自訂私有倉庫並為其建立了一個名為「my-reg-creds」的密鑰，請將 fleet.cattle.io/managed=true 標籤應用於此密鑰。這確保您的備份程序捕獲密鑰，在需要時提供輕鬆的恢復。

透過遵循此指導，您可以確保所有私有倉庫憑證都已備份，並在恢復或遷移時易於存取。