使用 Oracle Cloud Object Storage 作为 Velero 备份存储S3 兼容 API 完整配置指南【免费下载链接】veleroBackup and migrate Kubernetes applications and their persistent volumes项目地址: https://gitcode.com/GitHub_Trending/ve/velero导读本文以 Velero 仓库中 oracle-config.md 为骨架完整讲解如何把Oracle Cloud Object StorageOCI Object Storage配置为 Velero 的备份存储后端。核心思路是利用 Oracle 提供的Amazon S3 兼容 API让 Velero 以awsprovider 身份接入 OCI 对象存储从而在不开发专属插件的情况下完成 Kubernetes 应用与持久化数据的备份、灾难恢复与迁移。读完本文你将掌握从下载 CLI、生成 Customer Secret Key、创建存储桶、执行velero install到完成一次真实的备份/恢复演练与资源清理的完整链路并理解--backup-location-config各参数在 Velero 源码与 CRD 层面的落地机制。适用前提本文配置命令与参数以仓库 site/content/docs/v1.0.0 文档体系所描述的 Velero v1.0.0 版本为准。新版 Velero 的velero install已要求显式传入--plugins见 pkg/cmd/cli/install/install.go 的校验逻辑但 Oracle 场景的接入思路与 S3 兼容参数保持一致。整体接入思路为什么 Oracle 需要“S3 兼容”方案Velero 通过BackupStorageLocation这一自定义资源描述备份存放位置其provider字段决定了使用哪个对象存储插件。Velero 原生内置支持aws、gcp、azure三类 provider见 api-types/backupstoragelocation.md 的参数表。Oracle Cloud Object Storage 并未提供原生插件但它的 Object Storage 服务对外暴露了Amazon S3 兼容 API因此只需复用awsprovider 插件并配置 S3 风格的端点s3Url即可接入。仓库源码也印证了这一机制在 pkg/repository/config/config.go 中GetBackendType函数在 provider 无法直接匹配内置后端类型时会检查配置中是否存在s3Url——只要s3Url非空就将其识别为AWSBackendS3 兼容对象存储注释明确写道“If the provider doesnt indicate a known backend type, but the endpoint is specified, Velero regards it as a S3 compatible object store and return AWSBackend as the type.”因此整个接入流程可以概括为四步拿到 S3 兼容签名密钥 → 创建 OCI 存储桶 → 以 aws provider 安装 Velero 并注入 s3Url → 用标准 velero 命令备份/恢复。下载 Velero CLI1. 获取官方发布包到 Velero 官方 GitHub Releases 页面下载对应版本的发布包其中包含veleroCLI 工具与示例 Kubernetes 清单文件。例如 v1.0.0 的 Linux 版本wget https://github.com/velero-io/velero/releases/download/v1.0.0/velero-v1.0.0-linux-amd64.tar.gz强烈建议使用官方正式发布版本。每个版本的 tarball 内都带有 velero 命令行客户端而仓库主分支main上的代码处于活跃开发状态不保证稳定。2. 解压并加入 PATHtar -xzvf RELEASE-TARBALL-NAME.tar.gz为简便起见可把解压出的目录重命名为veleromv velero-v1.0.0-linux-amd64 velero将其加入 PATHexport PATH/usr/local/bin/velero:$PATH3. 验证安装直接运行velero应看到类似下面的输出$ velero Velero is a tool for managing disaster recovery, specifically for Kubernetes cluster resources. It provides a simple, configurable, and operationally robust way to back up your application state and associated data. If youre familiar with kubectl, Velero supports a similar model, allowing you to execute commands such as velero get backup and velero create schedule. The same operations can also be performed as velero backup get and velero schedule create. Usage: velero [command]创建 Customer Secret Key客户密钥Oracle Object Storage 提供了与 Amazon S3 互操作的 API。要使用这套 S3 兼容 API需要生成用于身份认证的签名密钥——即一组Access Key / Secret Key对在 OCI 控制台中称为 Customer Secret Key。创建步骤登录 OCI 控制台进入Identity身份→ Users用户→ 选择目标用户 → Customer Secret Keys客户密钥按 OCI 官方文档“To create a customer secret key”流程生成更多细节可参考 OCI 官方“Working with Customer Secret Keys”文档两篇均在 OCI Identity 管理文档的 managingcredentials 章节下。生成密钥后创建 Velero 使用的凭据文件credentials-velero格式与 AWS CLI 的共享凭据文件完全一致因为 Velero 走的是 S3 兼容 API见 pkg/credentials/file_store.go 对凭据文件的读取逻辑$ vi credentials-velero [default] aws_access_key_idbae031188893d1eb83719648790ac850b76c9441 aws_secret_access_keyMmY9heKrWiNVCSZQ2Mf5XTJ6Ys93Bw2d2D6NMSTXZlk上例中的 Key/Secret 仅为文档演示占位值请替换为你自己生成的真实密钥并妥善保管。该文件会在安装时由--secret-file参数读入最终以名为cloud-credentials的 Secret 落进集群见 pkg/cmd/cli/install/install.go 中NewCommand的 Long 描述。创建 Oracle Object Storage 存储桶在 Oracle Cloud tenancy租户的根 compartment根区间中创建一个名为velero的 Object Storage 存储桶。创建入口为 OCI 控制台的Object Storage → Buckets存储桶更详细的创建步骤参见 OCI 官方“Creating a Bucket”文档managingbuckets 章节。桶名不是硬编码要求velero仅是本文示例名称你可以按需命名并在后续--bucket参数中保持一致。安装 Velero安装前先收集以下信息然后执行velero installvelero install \ --provider [provider name] \ --bucket [bucket name] \ --prefix [tenancy name] \ --use-volume-snapshotsfalse \ --secret-file [secret file location] \ --backup-location-config region[region],s3ForcePathStyletrue,s3Url[storage API endpoint]各参数含义如下参数取值说明--provider由于使用的是 S3 兼容 APIprovider 取aws--bucket在 Oracle Object Storage 中创建的桶名本例为velero--prefix你的 Oracle Cloud tenancy租户名称本例为oracle-cloudnative所有 Velero 数据将存放在桶内该前缀目录下--use-volume-snapshotsfalseVelero 目前没有 Oracle Cloud 的卷快照插件因此关闭卷快照能力--secret-file指向credentials-velero文件--backup-location-config指向 Oracle Object Storage 桶的关键配置region对应 Oracle Cloud 区域名如us-phoenix-1完整区域列表见 OCI 官方 Regions 文档s3Url为该区域对应的 S3 兼容 API 端点格式为https://tenancy.compat.objectstorage.region name.oraclecloud.com一个真实的示例命令velero install \ --provider aws \ --bucket velero \ --prefix oracle-cloudnative \ --use-volume-snapshotsfalse \ --secret-file /Users/mboxell/bin/velero/credentials-velero \ --backup-location-config regionus-phoenix-1,s3ForcePathStyletrue,s3Urlhttps://oracle-cloudnative.compat.objectstorage.us-phoenix-1.oraclecloud.com安装背后的源码细节这些参数如何生效velero install命令由 pkg/cmd/cli/install/install.go 实现其中的关键点--backup-location-config参数解析该参数类型为flag.Map以key1value1,key2value2的逗号分隔格式解析最终通过AsVeleroOptions转成BSLConfig写入默认的BackupStorageLocation的spec.configinstall.go 中BackupStorageConfig字段的定义与赋值。参数校验Validate方法会校验--provider、--bucket为必填当--use-volume-snapshotsfalse时要求--snapshot-location-config必须为空——这正解释了 Oracle 场景下必须显式传--use-volume-snapshotsfalse的原因避免 Velero 尝试为awsprovider 创建默认的卷快照位置VolumeSnapshotLocation因为 OCI 场景根本没有可用的卷快照后端。生成的资源命令会创建velero命名空间、一批 CRD、ClusterRoleBinding、ServiceAccount、Secret 以及 Velero Deployment。其中--secret-file读入的凭据被封装为名为cloud-credentials的 Secret见 pkg/install/install.go 中 Secret 的构造逻辑。排障入口安装后若 Pod 未能成功就绪可用kubectl logs [velero pod name]查看日志定位问题。BackupStorageLocation 配置参数参考如果你希望以 YAML 方式直接声明备份存储位置例如在安装后用velero backup-location create创建对应 CRD 的核心参数如下完整表格见 api-types/backupstoragelocation.mdKey类型默认值含义providerstring必填实际存储备份的云厂商名本文为awsobjectStorage/bucketstring必填备份上传的目标桶objectStorage/prefixstring可选桶内存放备份数据的子目录本文对应--prefix的 tenancy 名config/regionstring空区域名如us-east-1不填时向 S3 API 查询config/s3ForcePathStyleboolfalse使用本地或 S3 兼容存储如 Minio、Oracle Object Storage时置为trueconfig/s3Urlstring非 AWS 托管存储必填S3 兼容端点如http://minio:9000或 Oracle 的.compat.objectstorage.region.oraclecloud.comconfig/publicUrlstring空生成下载 URL如日志时优先使用的公网端点config/signatureVersionstring4签名算法版本1或4多数场景默认4其中s3ForcePathStyletrue对 Oracle 场景至关重要它要求对象存储 SDK 使用“路径风格”访问https://endpoint/bucket/key而非虚拟主机风格https://bucket.endpoint/key这是 Oracle Object Storage 的 S3 兼容 API 所要求的寻址方式。region则用于 SDK 定位区域级端点与签名。卸载与清理Clean Up要彻底移除 Velero删除命名空间、ClusterRoleBinding、ServiceAccount、Secret、Deployment 以及全部 CRDkubectl delete namespace/velero clusterrolebinding/velero kubectl delete crds -l componentvelerovelero install创建的所有资源都会被这两条命令清理干净。端到端演练备份与恢复 nginx 示例应用安装完成后仓库提供了现成的示例应用清单 examples/nginx-app/base.yaml其中包含一个带app: nginx标签的nginx-example命名空间、一个 2 副本的nginx-deploymentDeployment镜像nginx:1.17.6暴露 80 端口以及一个 LoadBalancer 类型的my-nginxService。1. 启动示例应用不含持久卷的基础示例kubectl apply -f examples/nginx-app/base.yaml$ kubectl apply -f examples/nginx-app/base.yaml namespace/nginx-example created deployment.apps/nginx-deployment created service/my-nginx created用kubectl get all查看已创建的资源$ kubectl get all NAME READY STATUS RESTARTS AGE pod/nginx-deployment-67594d6bf6-4296p 1/1 Running 0 20s pod/nginx-deployment-67594d6bf6-f9r5s 1/1 Running 0 20s NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/my-nginx LoadBalancer 10.96.69.166 pending 80:31859/TCP 21s NAME DESIRED CURRENT UP-TO-DATE AVAILABLE AGE deployment.apps/nginx-deployment 2 2 2 2 21s NAME DESIRED CURRENT READY AGE replicaset.apps/nginx-deployment-67594d6bf6 2 2 2 21s2. 创建备份velero backup create nginx-backup --include-namespaces nginx-example$ velero backup create nginx-backup --include-namespaces nginx-example Backup request nginx-backup submitted successfully. Run velero backup describe nginx-backup or velero backup logs nginx-backup for more details.此刻登录 Oracle Cloud Object Storage 控制台打开我们命名为velero的桶即可看到 Velero 备份上去的资源数据。3. 模拟灾难删除命名空间kubectl delete namespaces nginx-example$ kubectl delete namespaces nginx-example namespace nginx-example deleted等待命名空间删除完成然后验证 nginx 的 Deployment、Service 和命名空间都已消失kubectl get deployments --namespacenginx-example kubectl get services --namespacenginx-example kubectl get namespace/nginx-example应返回No resources found.4. 恢复丢失的资源velero restore create --from-backup nginx-backup$ velero restore create --from-backup nginx-backup Restore request nginx-backup-20190604102710 submitted successfully. Run velero restore describe nginx-backup-20190604102710 or velero restore logs nginx-backup-20190604102710 for more details.执行kubectl get namespaces可以看到nginx-example命名空间连同其中的内容都已被恢复。5. 查看恢复状态velero restore get$ velero restore get NAME BACKUP STATUS WARNINGS ERRORS CREATED SELECTOR nginx-backup-20190604104249 nginx-backup Completed 0 0 2019-06-04 10:42:39 -0700 PDT none注意恢复可能需要一些时间期间STATUS列显示为InProgress。恢复成功后会变为Completed且WARNINGS与ERRORS均为0——这意味着nginx-example命名空间中的所有对象都已恢复到删除前的状态。如果出现错误或警告例如STATUS列显示为FAILED而非InProgress可用以下命令查看详细原因velero restore describe RESTORE_NAME6. 清理演练环境与备份kubectl delete -f examples/nginx-app/base.yaml$ kubectl delete -f examples/nginx-app/base.yaml namespace nginx-example deleted deployment.apps nginx-deployment deleted service my-nginx deleted如需删除已创建的备份包括对象存储中的备份数据运行velero backup delete BACKUP_NAME$ velero backup delete nginx-backup Are you sure you want to continue (Y/N)? Y Request to delete backup nginx-backup submitted successfully. The backup will be fully deleted after all associated data (disk snapshots, backup files, restores) are removed.该命令请求 Velero 服务端删除与BACKUP_NAME关联的全部备份数据需要为每个想彻底删除的备份各执行一次文档版本中未来的 Velero 版本将支持按名称或标签选择器批量删除。删除完成后velero backup get BACKUP_NAME将报错而velero backup get将返回空列表$ velero backup get nginx-backup An error occurred: backups.velero.io nginx-backup not found$ velero backup get NAME STATUS CREATED EXPIRES STORAGE LOCATION SELECTOR故障排查与进阶参考安装后 Pod 无法就绪使用kubectl logs deployment/velero -n velero或kubectl logs [velero pod name]查看 Velero 服务端日志常见的失败原因包括s3Url端点拼写错误、region与端点区域不一致、Customer Secret Key 无权限访问目标桶等。备份/恢复失败优先执行velero backup describe BACKUP_NAME、velero restore describe RESTORE_NAME及对应的velero backup logs/velero restore logs查看详细错误。多存储位置Oracle 场景同样适用于 Velero 的多BackupStorageLocation机制可在备份创建时通过--storage-location指定使用哪个位置见 locations.md如需切换默认位置可在velero server上设置--default-backup-storage-location。后端类型识别从源码 pkg/repository/config/config.go 可以看到只要 BSL 配置中存在非空的s3UrlVelero 就会将后端识别为 S3 兼容存储AWSBackend这是 Oracle 等一切 S3 兼容厂商接入 Velero 的通用原理。更多 S3 兼容参数publicUrl日志下载公网地址、signatureVersion签名版本等可在 api-types/backupstoragelocation.md 中查阅按需补充到--backup-location-config。延伸阅读官方 Velero 文档仓库内对应 v1.0.0 文档目录为 site/content/docs/v1.0.0包含 install-overview.md、get-started.md 等入门材料Oracle Cloud Infrastructure 官方文档Object Storage 概述、桶管理、Customer Secret Key 管理、区域列表均在 OCI 文档中心的对应章节【免费下载链接】veleroBackup and migrate Kubernetes applications and their persistent volumes项目地址: https://gitcode.com/GitHub_Trending/ve/velero创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考