对接OBS云对象存储实例

背景信息

对象存储服务（Object-based Storage Service，OBS）是一个基于对象的海量存储服务，为客户提供海量、安全、高可靠、低成本的数据存储能力，包括创建、修改、删除桶，上传、下载和删除对象等。

在AstroZero中，通过应用与OBS对接，可实现对象或Widget资产存储功能。

前提条件

• 使用OBS前，需要拥有一个华为账号或一个可用于访问OBS的IAM用户，即先注册华为云并实名认证、创建IAM用户、充值以及购买资源包，具体操作请参见使用OBS前需要做的准备工作。
• 获取AK（Access Key ID）、SK（Secret Access Key），即访问密钥对，具体操作请参见获取AK/SK。
• 已在华为OBS上，创建存储桶（例如“bing.testonly.1”），用于后续存储对象使用，具体操作请参见如何创建桶，请记录创建桶时选择的区域。

新建OBS连接器

1. 参考创建连接器入口中操作，进入创建连接器页面。
2. 选择“存储 > OBS”，单击“+”。
   图1 选择OBS
   

3. 设置OBS对接参数，单击“保存”。
   图2 设置基本信息
   
   • 名称：新建连接器的名称，如TestOBS。
   • endpoint：指定承载REST服务端点的AstroZero服务器域名或IP。
   • 鉴权方式：访问OBS的鉴权方式。
     • 委托授权：通过创建委托，可将OBS资源共享给AstroZero。选择该方式后，保存连接器设置时，在弹出的提示框中，请单击“是”，即可访问OBS，不需要输入访问密钥对（AK/SK）。
     • AK/SK：通过IAM用户的访问密钥对（AK/SK），来进行鉴权。
   • 访问密钥：当“鉴权方式”配置为“AK/SK”时，需要配置用户的访问密钥AK，即前提条件中获取的Access Key ID值。
   • 密钥：当“鉴权方式”配置为“AK/SK”时，需要配置与访问密钥AK结合使用的私有访问密钥SK，即前提条件中获取的Secret Access Key值。
   • 内容分发网络：CDN服务器的地址。配置后，后续访问上传的静态资源时，可不用登录OBS，直接通过CDN访问到静态资源。
   • 描述：连接器的描述信息。
   • 打包当前配置：默认为选中，对信息敏感的场景，建议不勾选。

     选中该选项后，应用打包时会将当前配置的连接器信息一并打出。例如，如果应用包发布到运行环境，当前配置默认会被同步到运行环境中。

   • 开启操作日志：选中该选项后，用户使用连接器上传、下载、查看文件时，将会记录操作日志。
   • 校验文件内容类型：开启文件类型校验后，会检查文件内容是否跟后缀类型匹配。 当前仅支持bmp、gif、png、jpg、ico、txt、xml和html几种常见的类型。
   图3 添加桶
   

   设置存储桶所在的区域和桶名称。可选择多个桶，此处以桶“bing.testonly.1”为例。通过配置“文件类型”和“文件大小（字节）”，可限制上传文件的类型和大小。

   • 区域：存储桶所在的区域，配置为前提条件中，创建桶时选择的区域。
   • 文件类型：文件类型可以配置为多个，多个文件类型之间由逗号分隔（如txt,png）。如果此处不填写，则支持所有类型。
   • 文件大小：配置为0或不填写，表示上传文件的大小不受限制，允许输入的最大值为9007199254740991，单位为字节。

4. （可选）测试是否能在存储桶中，存储对象。
   

   此处的测试只能上传小于1MB字节的对象，且只支持txt文件。

   1. 在该连接器详情页面，单击存储桶所在行的。
   2. 单击“点击上传”，选择对象文件，单击“上传”。
      图4 选择对象
      
   3. 单击上传好的文件名，进行下载。
      图5 下载文件
      
   4. 打开下载的对象存储文件，查看与上传的对象存储文件是否一致。

通过REST接口调用连接器

可以通过调用REST接口，完成表1中功能。如何调用接口，请参见连接器API。

通过服务编排调用连接器

OBS连接器创建完成后，支持在服务编排中调用该连接器，实现与OBS的对接。用户也可以在脚本中调用连接器，实现与OBS的对接。

1. 参考如何开发服务编排中操作，创建一个空白服务编排。
   图6 添加服务编排
   

2. 在服务编排设计页面，从左侧“连接器 > 存储”中，拖拽“OBS”图元至画布中。

   OBS是系统预置的，与OBS对接的存储接口。

   图7 拖拽OBS图元到画布中
   

3. 选中OBS图元，单击，设置基本信息。
   图8 设置基本信息
   
   • 标签：OBS图元在系统中展示的名称。
   • 名称：OBS图元在系统中的唯一标识，不能和其他图元相同。
   • 连接器：该服务编排使用的连接器的名称。选择已创建的“TestOBS”。

4. 单击，设置调用OBS参数。
   图9 配置OBS
   
   • 动作：系统预置了如下三个动作。
     • view_object_obs：系统预置的查看存储对象接口。
     • put_object_obs：系统预置的存储对象接口，用于将系统的对象存储到OBS的存储桶中。
     • get_endpoint_obs：用于获取对象存储地址的前缀。该前缀加上传对象的路径，是实际访问对象的全路径。
   • 输入参数：为定义连接器时，设置的自定义参数。
     • “目标”配置为“object”时：请在“源”中，配置对象名称。
     • “目标”配置为“data”时：请在“源”中，配置对象具体数据。
     • “目标”配置为“bucket”时：请在“源”中，配置桶。
     • “目标”配置为“acl”时：请在“源”中，配置对象文件的访问控制权限。例如“private”（私有）、“public-read”（公共读）、“public-read-write”（公共读写）和“default”（和桶权限一致）。
   • 输出参数：“源”选择“result”，“目标”用于接收支付结果，必须定义一个空实例的结构变量来进行接收。

5. 连接开始图元和OBS图元。
   图10 连接图元
   

6. 单击服务编排编辑器空白区域，选择，设置服务编排出参。

   将OBS图元的输出参数，作为整个服务编排的输出参数。

   图11 设置输出参数
   

7. 单击页面上方的，保存服务编排。
8. 保存成功后，单击，运行服务编排。
9. 在OBS上，查看存储桶中存储的对象列表，可查看到对象已存储成功。
10. 单击页面上方的，启用服务编排。