文件

設定儲存桶複製的需求

儲存桶複製使用規則將一個 MinIO 部署上的儲存桶內容同步到遠端 MinIO 部署上的儲存桶。

複製可以透過以下任何方式完成

  • 主動-被動 符合條件的物件會從來源儲存桶複製到遠端儲存桶。遠端儲存桶上的任何變更都不會複製回。

  • 主動-主動 對任一儲存桶的符合條件物件所做的變更會以雙向方式複製到另一個儲存桶。

  • 多站點主動-主動 對任何設定為儲存桶複製的儲存桶上符合條件的物件所做的變更會複製到所有其他儲存桶。

在設定任何這些複製組態之前,請確保您符合以下先決條件。

設定儲存桶複製所需的權限

儲存桶複製需要來源和目的地部署上的特定權限,才能組態和啟用複製規則。

以下原則提供在部署上組態和啟用複製的權限。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "admin:SetBucketTarget",
                "admin:GetBucketTarget"
            ],
            "Effect": "Allow",
            "Sid": "EnableRemoteBucketConfiguration"
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetReplicationConfiguration",
                "s3:ListBucket",
                "s3:ListBucketMultipartUploads",
                "s3:GetBucketLocation",
                "s3:GetBucketVersioning",
                "s3:GetObjectRetention",
                "s3:GetObjectLegalHold",
                "s3:PutReplicationConfiguration"
            ],
            "Resource": [
                "arn:aws:s3:::*"
            ],
            "Sid": "EnableReplicationRuleConfiguration"
        }
    ]
}
  • "EnableRemoteBucketConfiguration" 陳述式授予建立遠端目標以支援複製的權限。

  • "EnableReplicationRuleConfiguration" 陳述式授予在儲存桶上建立複製規則的權限。 "arn:aws:s3:::* 資源將複製權限套用至來源部署上的任何儲存桶。您可以根據需要將使用者原則限制為特定儲存桶。

以下程式碼會建立具有必要原則的 MinIO 管理使用者。將 TARGET 取代為您在其中組態複製的 MinIO 部署的 別名

wget -O - https://minio.dev.org.tw/docs/minio/linux/examples/ReplicationAdminPolicy.json | \
mc admin policy create TARGET ReplicationAdminPolicy /dev/stdin
mc admin user add TARGET ReplicationAdmin LongRandomSecretKey
mc admin policy attach TARGET ReplicationAdminPolicy --user=ReplicationAdmin

針對 Active Directory/LDAPOpenID Connect 使用者管理組態的 MinIO 部署應改為建立專用的 存取金鑰 來進行儲存桶複製。

以下原則提供將複製資料同步到部署的權限。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetReplicationConfiguration",
                "s3:ListBucket",
                "s3:ListBucketMultipartUploads",
                "s3:GetBucketLocation",
                "s3:GetBucketVersioning",
                "s3:GetBucketObjectLockConfiguration",
                "s3:GetEncryptionConfiguration"
            ],
            "Resource": [
                "arn:aws:s3:::*"
            ],
            "Sid": "EnableReplicationOnBucket"
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetReplicationConfiguration",
                "s3:ReplicateTags",
                "s3:AbortMultipartUpload",
                "s3:GetObject",
                "s3:GetObjectVersion",
                "s3:GetObjectVersionTagging",
                "s3:PutObject",
                "s3:PutObjectRetention",
                "s3:PutBucketObjectLockConfiguration",
                "s3:PutObjectLegalHold",
                "s3:DeleteObject",
                "s3:ReplicateObject",
                "s3:ReplicateDelete"
            ],
            "Resource": [
                "arn:aws:s3:::*"
            ],
            "Sid": "EnableReplicatingDataIntoBucket"
        }
    ]
}
  • "EnableReplicationOnBucket" 陳述式授予遠端目標擷取儲存桶層級組態的權限,以支援 MinIO 部署中所有儲存桶上的複製操作。若要將原則限制為特定儲存桶,請在 Resource 陣列中指定這些儲存桶,類似於 "arn:aws:s3:::bucketName"

  • "EnableReplicatingDataIntoBucket" 陳述式授予遠端目標將資料同步到 MinIO 部署中任何儲存桶的權限。若要將原則限制為特定儲存桶,請在 Resource 陣列中指定這些儲存桶,類似於 "arn:aws:s3:::bucketName/*"

以下程式碼會建立一個具備必要政策的 MinIO 管理的使用者。請將 TARGET 替換為您正在設定複寫的 MinIO 部署的 別名

wget -O - https://minio.dev.org.tw/docs/minio/linux/examples/ReplicationRemoteUserPolicy.json | \
mc admin policy create TARGET ReplicationRemoteUserPolicy /dev/stdin
mc admin user add TARGET ReplicationRemoteUser LongRandomSecretKey
mc admin policy attach TARGET ReplicationRemoteUserPolicy --user=ReplicationRemoteUser

針對 Active Directory/LDAPOpenID Connect 使用者管理組態的 MinIO 部署應改為建立專用的 存取金鑰 來進行儲存桶複製。

請參閱 mc admin usermc admin user svcacctmc admin policy,以取得關於將使用者、存取金鑰和政策新增至 MinIO 部署的更完整文件。

儲存貯體複寫的相符物件加密設定

MinIO 支援使用 SSE-KMSSSE-S3 加密的物件複寫。

  • 對於使用 SSE-KMS 加密的物件,MinIO 要求目標儲存貯體支援使用與來源儲存貯體上用於加密物件的相同金鑰名稱來加密物件的 SSE-KMS 加密。

  • 對於使用 SSE-S3 加密的物件,MinIO 要求目標儲存貯體也支援使用 SSE-S3 加密物件,無論金鑰名稱為何。

在複寫過程中,MinIO 會先解密來源儲存貯體上的物件,然後透過網路傳輸未加密的物件。接著,目標 MinIO 部署會使用目標的加密設定重新加密物件。因此,MinIO 強烈建議在來源和目標部署上啟用 TLS,以確保物件在傳輸過程中的安全。

MinIO 支援複寫用戶端加密的物件 (SSE-C)。

儲存貯體複寫需要 MinIO 部署

MinIO 伺服器端複寫僅適用於 MinIO 部署之間。來源和目標部署必須執行具有相符版本的 MinIO 伺服器。

若要在任意相容於 S3 的服務之間設定複寫,請使用 mc mirror

複寫需要版本控制

MinIO 依賴 版本控制 提供的不可變保護,以支援複寫和重新同步。

使用 mc version info 來驗證來源和遠端儲存貯體的版本控制狀態。使用 mc version enable 命令來啟用必要的版本控制。

如果您從來源儲存貯體中的版本控制排除前綴或資料夾,MinIO 無法複寫該資料夾或前綴內的物件。

儲存貯體複寫的相符物件鎖定狀態

MinIO 支援複寫在 WORM 鎖定 下持有的物件。兩個複寫儲存貯體必須都啟用物件鎖定,MinIO 才能複寫鎖定的物件。對於主動-主動設定,MinIO 建議在兩個儲存貯體上使用相同的保留規則,以確保跨站台的一致行為。

您必須依照 S3 行為在建立儲存貯體時啟用物件鎖定。然後,您可以隨時設定物件保留規則。在此程序開始之前,請在不健全的目標儲存貯體上設定必要的規則。