將物件從 MinIO 轉換到 GCS

安裝和設定 mc

此程序使用 mc 來執行 MinIO 叢集上的操作。在具有網路存取來源和目的地叢集的機器上安裝 mc。請參閱 mc 的 安裝快速入門，以取得有關下載和安裝 mc 的說明。

使用 mc alias set 命令為來源 MinIO 叢集建立別名。建立別名需要為來源和目的地叢集上的使用者指定存取金鑰。指定的使用者必須具有設定和套用轉換操作的權限。

所需的 MinIO 權限

MinIO 需要以下範圍限定為您正在建立生命週期管理規則的儲存桶或儲存桶的權限。

• s3:PutLifecycleConfiguration

• s3:GetLifecycleConfiguration

MinIO 在您要為物件轉換生命週期管理規則建立遠端層的叢集上，還需要下列管理權限

• admin:SetTier

• admin:ListTier

例如，以下政策提供在叢集中任何儲存桶上設定物件轉換生命週期管理規則的權限：。

{
   "Version": "2012-10-17",
   "Statement": [
      {
            "Action": [
               "admin:SetTier",
               "admin:ListTier"
            ],
            "Effect": "Allow",
            "Sid": "EnableRemoteTierManagement"
      },
      {
            "Action": [
               "s3:PutLifecycleConfiguration",
               "s3:GetLifecycleConfiguration"
            ],
            "Resource": [
                        "arn:aws:s3:::*"
            ],
            "Effect": "Allow",
            "Sid": "EnableLifecycleManagementRules"
      }
   ]
}

必要的 GCS 權限

物件轉換生命週期管理規則需要遠端儲存層的額外權限。具體來說，MinIO 需要 GCS 憑證為遠端儲存桶提供讀取、寫入、列出和刪除權限。

請參閱 GCS IAM 權限 文件，以取得關於設定必要權限的更完整指南。

遠端儲存桶必須存在

在使用該儲存桶作為目標設定生命週期管理層或規則 *之前*，請先建立遠端 GCS 儲存桶。

如果您設定預設的 GCS 儲存空間類別，如果您在定義遠端層時沒有指定 storage class，MinIO 將使用該預設值。請務必記錄您的 GCS 儲存桶和 MinIO 分層設定的設定，以避免任何潛在的混淆、設定錯誤或其他意外結果。

生命週期管理物件掃描器

MinIO 使用 掃描器程序 來檢查物件是否符合所有已設定的生命週期管理規則。由於高 IO 工作負載或有限的系統資源導致的掃描速度慢，可能會延遲生命週期管理規則的應用。請參閱 生命週期管理物件掃描器 以取得更多資訊。

獨佔存取遠端資料

MinIO *必須* 獨佔存取遠端儲存層上的轉換資料。「熱」MinIO 來源上的物件中繼資料與「溫/冷」遠端層上的物件資料密切相關。MinIO 無法在沒有存取遠端的情況下檢索物件資料，遠端也不能用於還原來源上遺失的中繼資料。

所有對轉換物件的存取 *必須* 僅透過 MinIO 使用 S3 API 操作進行。手動修改轉換的物件（無論是「熱」MinIO 層上的中繼資料 *或* 遠端「溫/冷」層上的物件資料）都可能導致該物件資料遺失。

MinIO 會忽略遠端儲存桶或儲存桶前綴中任何未由 MinIO 部署明確管理的物件。自動轉換和透明物件檢索取決於以下假設

• 遠端儲存上沒有物件的外部修改、遷移或刪除。

• 遠端儲存桶上沒有生命週期管理規則（例如轉換或到期）。

MinIO 將所有轉換的物件儲存在遠端儲存桶或資源中的每個部署唯一的字首值下。此值並非旨在支援從後端識別來源部署。MinIO 在設定遠端目標時支援額外的可選人類可讀字首，這可能有助於診斷、維護或災難復原相關的操作。

MinIO 建議為包含其他資料（包括來自其他 MinIO 部署的轉換物件）的遠端儲存層指定此可選字首。本教學課程包含設定此字首的必要語法。

遠端資料的可用性

MinIO 分層行為取決於遠端儲存是否在收到請求後立即（毫秒到秒）傳回物件。因此，MinIO *無法* 支援需要重新水合、等待時間或手動干預的遠端儲存。

MinIO 為每個轉換的物件建立中繼資料，以識別其在遠端儲存上的位置。應用程式無法在不依賴 MinIO 的情況下輕易識別和存取轉換的物件。因此，轉換資料的可用性取決於 糾刪碼 和分散式部署拓撲為 MinIO 部署上的所有物件提供的相同核心保護。使用物件轉換不會提供任何額外的業務持續性或災難復原好處。

需要 BC/DR 保護的工作負載應實作 MinIO 伺服器端複寫。複寫可確保物件保留在遠端複寫站點上，以便在發生部分或全部資料遺失時從遠端重新同步。請參閱 重新同步（災難復原），以取得關於使用複寫在部分或全部資料遺失後進行復原的更完整文件。

1) 設定生命週期管理的使用者帳戶和政策

此步驟會在 MinIO 部署上建立使用者和政策，以支援生命週期管理操作。如果部署已經有具有必要 權限 的使用者，您可以跳過此步驟。

以下範例使用 Alpha 作為 MinIO 部署的佔位符 別名。將此值替換為您要設定生命週期管理規則的 MinIO 部署的適當別名。根據您組織產生密碼的最佳實務，將密碼 LongRandomSecretKey 替換為長、隨機且安全的密碼金鑰。

wget -O - https://minio.dev.org.tw/docs/minio/linux/examples/LifecycleManagementAdmin.json | \
mc admin policy create Alpha LifecycleAdminPolicy /dev/stdin
mc admin user add Alpha alphaLifecycleAdmin LongRandomSecretKey
mc admin policy attach Alpha LifecycleAdminPolicy --user=alphaLifecycleAdmin

此範例假設指定的別名具有在部署上建立政策和使用者的必要權限。請參閱 使用者管理 和 MinIO 基於政策的存取控制，以取得關於 MinIO 使用者和政策的更完整文件。

2) 設定遠端儲存層

使用 mc ilm tier add 命令將新的 Google Cloud Storage 服務新增為遠端儲存層

mc ilm tier add gcs TARGET TIER_NAME \
   --bucket BUCKET \
   --prefix PREFIX \
   --credentials-file CREDENTIALS \
   --storage-class STORAGE_CLASS

以上範例使用以下參數

3) 建立並套用轉換規則

使用 mc ilm rule add 命令為儲存桶建立新的轉換規則。以下範例設定在指定的天曆天數後轉換

mc ilm rule add ALIAS/BUCKET \
--transition-tier TIERNAME \
--transition-days DAYS \
--noncurrent-transition-days NONCURRENT_DAYS
--noncurrent-transition-tier TIERNAME

以上範例指定以下參數

4) 驗證轉換規則

使用 mc ilm rule ls 命令來檢閱已設定的轉換規則

mc ilm rule ls ALIAS/PATH --transition

• 將 ALIAS 替換為 MinIO 部署的 別名。

• 將 PATH 替換為要檢索已設定生命週期管理規則的儲存桶名稱。