阿里云物联网边缘计算阿里云OSS服务访问

一、创建OSS Bucket

1. 参考创建存储空间中的操作步骤，创建存储空间。本示例中部分参数按如下表设置，其余参数可以使用默认值。
   

   参数	描述
   Bucket 名称	设置为le-fc-bucket。
   区域	下拉选择该存储空间的数据中心。 可以选择离您近的数据中心，访问速度更有保障。

2. 在本地创建一个名为ossCloudFile.txt的txt格式的文件（文件内容可随意设置），参考上传文件中的操作步骤，将该文件上传到已创建的le-fc-bucket存储空间中。

   ossCloudFile.txt文件是为了后续测试通过函数下载OSS文件时使用。

二、创建访问OSS的函数

1. 下载访问OSS函数。该函数用于访问OSS，完成本地文件上传OSS和云端文件下载到本地的操作。

   accessAliOSS-code.zip

2. 登录阿里云函数计算控制台。

   如尚未开通该服务，请阅读并勾选我已阅读并同意内容，单击立即开通，开通服务。

3. （可选）左侧导航栏单击服务-函数，在新建函数后的下拉框中选择新建服务，根据界面提示配置参数后，单击确定创建一个服务。

   其中，服务名称必须填写，此处设置为EdgeFC，其余参数可根据您的需求设置，也可以不设置。

   
   说明 若已操作过其他应用场景示例或小程序示例，即已创建EdgeFC服务，则无需重复创建。

4. 创建服务成功后，在服务-函数页面单击新建函数，并使用事件函数方式创建函数。
5. 设置访问OSS函数的基础管理配置参数。
   

   参数	描述
   所在服务	选择已创建的EdgeFC服务。
   函数名称	设置为accessAliOSS。
   运行环境	设置函数的运行环境，此示例中选择nodejs8。
   函数入口	使用默认值index.handler。
   函数执行内存	设置为512 MB。
   超时时间	设置为10秒。

   其余参数的值请根据您的需求，请参见函数计算设置，也可以不设置。

   确认函数信息后，单击完成。

6. 创建函数完成后，系统自动跳转到函数详情页面。请在代码执行页签下选择代码包上传，单击选择文件，上传步骤1中下载的accessAliOSS-code.zip代码包，然后单击保存。

   代码上传成功后，在在线编辑框中更改源码。

   其中：

   • 将<Your OSS Region>替换为一、创建OSS Bucket中创建存储空间时选择的区域信息，请从对象存储的概览页面查看，如下图示例所示。
   • 将<Your OSS Bucket>替换为一、创建OSS Bucket中创建存储空间时设置的Bucket名称，即le-fc-bucket。
7. 登录前提条件中已完成的网关，执行如下命令生成本地测试文件，为样例代码中的本地上传文件功能准备一个名为localFile.txt的本地文件。

   sudo echo "Hi, this is the file from edge GW." > /linkedge/run/localFile.txt

   
   说明 在函数计算代码中访问网关宿主机的文件时，对于文件所在的路径是有约束的。在Link IoT Edge标准版（LE Standard）中，函数计算的代码是运行在与宿主机隔离的文件系统环境中，只有/linkedge/run目录是函数计算和宿主机环境共享并且拥有可读写权限。所以在测试时，请把测试文件的路径指到/linkedge/run目录下。

8. 返回函数计算控制台，在accessAliOSS函数的代码执行管理页面中，单击保存并执行。
9. （可选）如需体验下载云端OSS文件到本地功能，可以accessAliOSS的代码执行 > 在线编辑框中，注释掉第45行的client.put代码，去掉第48行开头的注释符"//"，调用OSS SDK的get方法（client.get('ossCloudFile.txt', "/linkedge/run/fileFromCloud.txt");）。

   其中ossCloudFile.txt是一、创建OSS Bucket中上传到le-fc-bucket存储空间的文件，/linkedge/run/fileFromCloud.txt是文件下载后保存在边缘端的文件名。

说明 样例代码解读如下，其逻辑分为三步：

1. 获取Credential，作为访问云服务的临时Token。

   credChain.resolvePromise()

2. 填写您的OSS Region信息和OSS Bucket信息。

   region: '<Your OSS Region>',
   bucket: '<Your OSS Bucket>',

3. 调用OSS SDK的put方法，将本地文件上传到OSS。

   client.put('fileFromEdge.txt', "/linkedge/run/localFile.txt");

   其中fileFromEdge.txt是文件上传后在云端保存的文件名，/linkedge/run/localFile.txt是本地需要上传的文件，两个文件名都可根据需求做修改，前提是本地文件必须存在。

三、分配函数到边缘实例

首先请参见云资源访问内容，为边缘实例分配包含管理对象存储服务（OSS）权限权限的角色，或者在已分配到边缘实例的角色中添加管理对象存储服务（OSS）权限权限。

1. 在物联网平台控制台左侧导航栏，选择边缘计算 > 应用管理。
2. 参考函数计算应用内容，使用本文上方步骤二中已创建的函数，创建函数计算类型的边缘应用。

   应用信息参数说明如下：

   参数	描述
   应用名称	设置您应用的名称，例如accessAliOSS。
   应用类型	选择函数计算。
   地域	选择您创建的服务所在的地域。
   服务	选择EdgeFC服务。
   函数	选择accessAliOSS函数。
   授权	选择AliyunIOTAccessingFCRole。
   应用版本	设置应用的版本，必须是该应用唯一的版本号，即一个应用不可以设置两个相同的版本号。

   函数配置说明如下：

   参数	描述
   运行模式	运行模式有两种。此处选择持续运行模式。程序部署后会立即执行。
   内存限制（MB）	函数运行可使用的内存资源上限，单位为MB。此处设置为512 MB。当函数使用内存超出该限制时，该函数计算程序会被强制重启。
   超时限制（秒）	函数收到事件后的最长处理时间，此处使用默认值5秒。如超过该时间函数仍未返回结果，该函数计算程序将会被强制重启。
   定时运行	单击开关按钮，打开定时运行，文本框中填入* * * * *。表示该函数会被定时触发运行，每分钟执行一次。Cron表达式详细信息请参见CRONTAB 网页内容。

   其余参数无需配置。

3. 左侧导航栏选择边缘计算 > 边缘实例。
4. 在本文“前提条件”中完成的边缘实例右侧，单击查看。
5. 在实例详情页面，选择设置，单击添加角色，为边缘实例分配AliyunIOTAccessingFCRole角色。然后单击确定。
6. 在实例详情页面，选择边缘应用，单击分配应用。
7. 将已创建的访问OSS的函数accessAliOSS分配到边缘实例中，单击关闭。

四、部署边缘实例

1. 在实例详情页面，单击右上角部署后在弹出框中单击确定，将子设备、函数计算等资源下发到边缘端。

   您可以通过单击部署详情来查看部署进度及结果。

2. 实例部署成功约一分钟后，可以在对象存储控制台，le-fc-bucket > 文件管理页面，可以看到fileFromEdge.txt文件已经成功上传。

   可以单击文件右侧的更多 > 下载，将文件下载到PC上查看文件内容。

   至此您已经完整地体验了使用边缘函数计算实现阿里云OSS服务的访问功能。