本文以常用的访问阿里云对象存储(OSS)服务为例,详细讲解如何使用边缘函数计算访问阿里云服务,完成本地文件上传和云端文件下载能力。

前提条件

背景信息

物联网边缘计算提供边缘函数计算能力,更方便地访问阿里云各种云服务,支持将设备在边缘端运行时生成的各类文件(统计报表、日志、图片、视频等)传输到云端,或从云端下载配置文件作为程序的输入来影响边缘端程序的行为。通过边缘函数计算访问OSS服务,可以选择永久存储设备数据。

使用边缘函数计算访问阿里云各种云服务的操作流程主要分为三步:

  1. 访问阿里云官网,开通对应的云服务,下载云服务SDK,将SDK和函数计算代码一起打包成.zip文件。
  2. 访问阿里云函数计算控制台,创建函数,上传.zip文件。
  3. 访问物联网平台控制台,分配函数到边缘实例,部署函数到边缘网关运行。

步骤一:创建OSS Bucket

  1. 创建存储空间,具体操作,请参见控制台创建存储空间

    本示例中部分参数按如下表设置,其余参数可以使用默认值。

    参数描述
    Bucket 名称设置为le-fc-bucket
    地域从下拉框中选择该存储空间的数据中心。

    可以选择离您近的数据中心,访问速度更有保障。

    重要 选择地域后,该参数下方会显示您已选地域对应的Endpoint值,请复制该值到本地文件中,用于后续编辑函数代码。
  2. 在本地创建一个名为ossCloudFile.txt的TXT格式的文件,文件内容可随意设置。
    该文件为后续通过函数下载OSS文件,提供文件源。
  3. ossCloudFile.txt文件上传到已创建的le-fc-bucket存储空间中,具体操作,请参见控制台上传文件

步骤二:创建访问OSS的函数

  1. 下载访问OSS函数accessAliOSS-code.zip。该函数用于访问OSS,完成本地文件上传OSS和云端文件下载到本地的操作。
  2. 登录函数计算控制台
    如尚未开通该服务,请阅读并选中我已阅读并同意,单击立即开通,开通服务。
  3. (可选)在左侧导航栏单击服务及函数,在服务及函数页面服务列表区域,单击新增服务,创建一个服务。
    其中,服务名称必须填写,此处设置为EdgeFC,其余参数可根据您的需求设置,也可以不设置。
    说明
    • 若您首次在函数计算中创建服务,请根据配置向导配置参数。
    • 若已操作过其他应用场景示例或小程序示例,即已创建EdgeFC服务,则无需重复创建。
  4. 创建服务成功后,在服务与函数页面的EdgeFC区域,单击新增函数,然后单击事件函数区域中的配置部署
  5. 设置访问OSS函数的基础管理配置参数。
    参数描述
    函数类型保持默认选项。
    所在服务选择已创建的EdgeFC服务。
    函数名称设置为accessAliOSS
    运行环境设置函数的运行环境,此示例中选择Node.JS 8.x

    上传代码右侧选择上传代码包,单击上传代码,上传步骤1中下载的accessAliOSS-code.zip代码包。

    函数入口使用默认值index.handler

    其余参数的值请根据您的实际需求设置,也可以不设置。更多信息,请参见函数计算

    确认函数信息后,单击新建完成操作。

  6. 创建函数完成后,系统自动跳转到函数详情页面。您可在代码执行页签的代码执行管理区域下,选中在线编辑单选框,查看源码。
    在线编辑代码

    其中:

    • <Your OSS Region>替换为创建OSS Bucket中,创建存储空间时保存到本地的Endpoint值。
    • <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. 在左侧导航栏单击应用管理
  3. 使用本文上方步骤二中已创建的函数,创建函数计算类型的边缘应用。具体操作,请参见函数计算应用

    应用信息参数说明如下:

    参数描述
    应用名称设置您应用的名称,例如accessAliOSS
    应用类型选择函数计算
    地域选择您创建的服务所在的地域。
    服务选择EdgeFC服务。
    函数选择accessAliOSS函数。
    授权选择AliyunIOTAccessingFCRole
    应用版本设置应用的版本,必须是该应用唯一的版本号,即一个应用不可以设置两个相同的版本号。
    函数配置说明如下:
    参数描述
    启用默认配置选择
    运行模式运行模式有两种。此处选择持续运行模式。程序部署后会立即执行。
    超时限制(秒)函数收到事件后的最长处理时间,此处使用默认值5秒。如超过该时间函数仍未返回结果,该函数计算程序将会被强制重启。
    定时运行打开定时运行开关,文本框中填入* * * * *。表示该函数会被定时触发运行,每分钟执行一次。Cron表达式详细信息请参见CRONTAB 网页内容。

    其余参数无需配置。

  4. 在左侧导航栏单击边缘实例
  5. 在本文“前提条件”中创建的边缘实例右侧,单击查看
  6. 实例详情页面,选择设置,单击添加角色与权限,为边缘实例分配AliyunIOTAccessingFCRole角色。操作详情,请参见云资源访问
  7. 实例详情页面的边缘应用页签,单击分配应用
  8. 分配应用面板,找到已创建的访问OSS的函数accessAliOSS,单击对应操作栏中的分配,然后单击关闭

步骤四:部署边缘实例

  1. 实例详情页面,单击右上角部署后,在弹出对话框中单击确定,将子设备、函数计算等资源下发到边缘端。
  2. 实例部署成功约一分钟后,可以在对象存储控制台le-fc-bucket > 文件管理页面,可以看到fileFromEdge.txt文件已经成功上传。
    可以选择文件右侧的更多 > 下载,将文件下载到PC上查看文件内容。查看文件内容

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

常见问题

如果在OSS文件管理页没有看到fileFromEdge.txt文件,可能有如下几种原因:

  • 函数触发时间还没到:函数定时每分钟运行一次,如果刚部署完成,函数有可能还没有运行。请等待2分钟刷新页面查看。
  • 网关本地系统时间不正确:本地时间可通过date命令查看,如果时间和网络时间差距过大,OSS会拒绝请求。
  • 本地待上传文件不存在:如果在网关上执行ls /linkedge/run/localFile.txt命令,显示文件不存在,请参考本文上方生成本地测试文件内容创建。
  • OSS配置信息填写有误:请参考本文上方在线编辑代码内容填写正确的OSS配置信息。
  • 如果上述配置都检查无误,可通过cat /linkedge/run/logger/fc-base/accessAliOSS/log.INFO命令查看函数运行日志,定位问题。