Link to this sectionGoogle Cloud Storage 集成#
Google Cloud Storage 集成将你的 GCS 存储桶与 Ultralytics Platform 连接起来。你的图像保留在你的存储桶中——Platform 会对其进行就地索引，因此你无需上传副本即可浏览、标注和训练 YOLO 模型。
Google Cloud Storage 数据集需要 Pro 或 Enterprise 计划。免费工作区可以看到此集成，并在连接时收到升级提示。如果订阅到期，现有的 Google Cloud Storage 数据集仍可完全访问——只有新的连接和导入需要 Pro 计划。
Link to this section创建只读服务账号#
Platform 只会读取你的存储空间——它从不写入、修改或删除你的对象。创建一个仅具有读取权限的专用 服务账号：
- 在 Google Cloud 控制台中，前往 IAM & Admin > Service Accounts 并创建一个服务账号。
- 在你要连接的存储桶上授予它 Storage Object Viewer (
roles/storage.objectViewer) 角色。 - 打开该服务账号，选择 Keys > Add key > Create new key，选择 JSON，然后下载密钥文件。
Link to this section连接到 Platform#
- 前往 Settings > Integrations 并找到 Google Cloud 卡片。
- 点击 Connect 并粘贴服务账号 JSON 密钥的内容。
- Platform 会列出该服务账号可以读取的存储桶。选择要连接的存储桶，如果账号无法列出存储桶，则手动输入存储桶名称。
- 点击 Connect。Platform 在保存任何内容之前会验证它是否可以列出并读取每个选定的存储桶。
稍后重新连接同一个服务账号会将新存储桶添加到现有集成中。仅当已保存的凭据被替换后仍然可以读取你已连接的所有存储桶时，该凭据才会被替换。
凭据在静态时使用 AES-256-GCM 加密，绝不会返回给浏览器，也不会进入训练任务负载。要撤销访问权限，请在 Google Cloud 中删除该服务账号密钥。
Link to this section从 GCS 存储桶创建数据集#
- 点击 New Dataset 并打开 Cloud storage 选项卡。
- 选择一个已连接的存储桶并浏览到包含你数据的文件夹。
- 确认文件夹，调整数据集名称，然后创建数据集。
Platform 会列出文件夹一次并索引其发现的内容：
- 图像 —
.jpg、.jpeg、.png、.webp和.avif对象通过从边界头请求中读取的尺寸进行索引。源像素永远不会从你的存储桶中复制出来。 - Labels — YOLO
.txt附带文件被解析为 Platform 标注，匹配标准images/→labels/布局或作为同文件夹下的并列文件。 - Metadata —
data.yaml/data.yml提供类别名称、任务类型和姿态关键点形状，与 归档上传 完全一致。 - Splits — 对象路径中的
train、val和test文件夹名称会自动分配拆分。
该数据集随后表现得与其他数据集一样：浏览并 标注 它，将其设置为公开或私有，与你的 团队 分享它，并通过托管训练在上面进行 训练。原始文件按需流式传输，索引图像不会消耗你的 Platform 存储配额。
单次导入可索引多达 50,000 个对象，标签或 YAML 文件每个最大 1 MB。更大的存储桶应拆分到多个数据集中。
每个索引图像都固定到其 GCS 对象生成版本，如果对象在底层发生更改，Platform 将会失败关闭。请添加新对象，而不是覆盖现有对象。
Link to this section导入失败#
如果导入失败（如文件夹为空、路径拼写错误或权限被撤销），数据集会在其页面上显示错误。编辑者可以点击 Retry import 以使用已存储的存储桶和文件夹重新启动，或者创建一个指向更正路径的新数据集。
Link to this section训练#
托管训练通过正常的训练流程进行。Worker 将固定的原始文件下载到临时作业存储中进行运行，并在作业清理时将其删除——你的 Google Cloud 凭据永远不会进入计算环境。
Link to this section当前限制#
GCS 支持的数据集目前不包含需要 Platform 拥有图像副本的功能：自动标注、聚类分析、数据集克隆和不可变的 版本快照。
删除 GCS 支持的数据集或其中的单个图像仅会删除 Platform 的引用——你的对象永远不会被触及。
另请参阅 Amazon S3 和 Azure Blob Storage 集成。