You need to enable JavaScript to run this app.
导航
使用 veImageX 实时处理 TOS 存储图片
最近更新时间:2024.11.27 15:20:57首次发布时间:2023.12.21 17:24:04

您可以通过 veImageX 来实时处理存储在 TOS 的图片资源,同步实现例如格式转换、图像压缩、缩放等一系列的处理操作。

背景信息

TOS 作为分布式对象存储产品,适合存放图片、视频等素材类文件。如果您需要在图片分发时,同步进行缩放、裁剪、水印、格式转换等处理操作,以提高图片在 APP 端的加载速度,并减少网络分发的流量。

其中对于图片文件的处理,您可通过跨服务授权的方式,使用 veImageX 对存放在 TOS 中的图片文件进行实时处理,包括画质增强、图片压缩等操作。经过处理后的图片文件将仍然存储在 TOS 中,进而通过 veImageX-CDN 回源到 TOS 对处理后的图片文件进行加速分发。

前提条件

  • 已开通 TOS 服务,且桶内拥有相应图片资源。

  • 已开通 veImageX 服务,且服务状态正常。

  • 已开通 veImageX 服务的存储授权功能,您可以提交工单联系技术支持启用配置。

注意事项

  • 对于 TOS 存储图片资源,仅支持使用 veImageX 图片处理模板中的高效压缩能力和基础处理能力,暂不支持使用附加组件能力。因此,建议您将存储资源迁移至 veImageX 并一站式使用图片解决方案,veImageX 提供了多种迁移方案,详见数据迁移方案选型参考

  • 仅支持绑定华北区域的 TOS 存储桶,其他区域暂不支持。

  • 仅使用 veImageX 的图片处理模板也可能会产生存储费用,例如在模板中开启持久化后产生的中间结果数据、在模板中添加的图片水印和其他系统处理操作产生的数据。

  • 在 veImageX 控制台授权跨服务访问后,访问控制角色列表里会新增一个名为 ServiceRoleForImageX 的角色。如果删除了该角色,将导致跨服务访问不可用,即从 veImageX 侧访问 TOS 存储桶中的文件会因权限问题而失败。

  • 组合使用 TOS 和 veImageX 时,原图资源仅会存储在 TOS 存储桶中。但是如果您在 veImageX 模板开启持久化,那么经模板处理后的中间结果数据会在 veImageX 进行缓存。再次访问处理图时默认优先加载 veImageX 中间结果数据。

计费说明

当您涉及以下操作项时 veImageX 将收取相应费用,具体计费详情参考 veImageX 计费说明

  • 高效图像压缩费用:在模板中将指定图片格式转换为 HEIC、HEIF、AVIF、AVIS 和 VVIC 这 5 种先进格式。

  • 增值服务费用:在模板中使用了截帧、小视频转动图及模版支持的附加组件能力。

  • 基础图像处理费用:在模板中使用了除高效压缩和增值服务以外的其他配置,如亮度、对比度等。

  • 资源存储费用:在模板中开启持久化后缓存的中间结果数据、模板添加的图片水印、其他系统处理操作产生的数据。

  • 资源分发费用:访问缓存结果。

操作步骤

绑定 TOS 存储桶

说明

请确保已开通 veImageX 的存储授权能力,以便可以让 veImageX 访问到 Tos 存储桶内图片文件。建议您将存储迁移至 veImageX 并一站式使用图片解决方案。

  1. 登录 veImageX 控制台,进入服务管理页面。

  2. 选择待配置的服务后,单击基础配置按钮。

  3. 在存储配置页签下,选择存储授权配置项,单击去授权按钮。

  4. 在授权状态为已授权后,绑定 TOS 存储桶,以便 veImageX 可读取桶内的图片资源。

获取访问域名

  1. 在完成绑定存储桶后,单击分发配置页签。

  2. 域名信息中获取已解析且状态正常的域名。

创建图片模板

  1. veImageX 控制台,进入处理配置页面。

  2. 单击新建模板按钮,根据模板配置说明按需创建图像处理模板。

  1. 在模板配置完成后,复制模板配置,例如tplv-ydxxxxx2k-test.png

获取 TOS 图片存储路径

说明

  • 您可以通过 ListObjectsV2 列举指定存储桶中对象信息。

  • 您需要获取 TOS 存储桶内图片文件的存储路径,若图片在多级目录下,则需包含全部目录信息。该路径不包含 Bucket。

  1. 登录对象存储控制台,进入桶列表页面。

  2. 在桶列表页面,单击桶名称,默认进入文件列表页面。

  3. 复制待处理的图片文件路径。其中 veImageX 仅支持特定格式的图片处理,具体格式请参考图片处理格式说明

拼接结果图访问 URL

您可参考下图,依次拼接各参数获取最终结果图访问 URL,查看处理效果。

拼接示例:

您已参考以上步骤获取了 veImageX 访问域名test.example.com、TOS 图片存储路径aaa/tosdemo.png 和 veImageX 图片模板配置~tplv-f0****5k-test.png
则最终结果图访问 URL 为 http://test.example.com/aaa/tosdemo.png~tplv-f0****5k-test.png