归档文件到 Google Cloud Storage

Yeastar 统一管理平台支持定期或随时将系统中通过备份任务生成的 P 系列云 PBX 的备份文件归档到 Google Cloud Storage。本文介绍如何将 Google Cloud Storage 存储桶添加为归档服务器,并创建任务来归档所需的文件。

使用要求和使用限制

使用要求
  • Yeastar 统一管理平台的固件为 87.14.0.31 或更高版本。
  • 仅支持归档由备份任务生成,并可在 资源库 > 备份包 访问到的备份文件。
    注: 以下备份文件不会被归档:
    • 在 PBX 系统中创建的备份文件
    • 手动上传到 Yeastar 统一管理平台的备份文件
使用限制
  • 归档服务器: 10
  • 归档任务: 100

操作说明

要将 P 系列云 PBX 的备份文件归档到 Google Cloud Storage 的特定存储桶中,你需要完成以下操作:

  1. 在 Google Cloud 上准备一个符合要求的账号和存储桶。
  2. 在 Yeastar 统一管理平台上配置归档服务器和归档任务。

当到达归档任务的执行时间时,Yeastar 统一管理平台将使用服务账号的密钥向 Google Cloud Storage 发送文件归档请求。如果请求有效,指定的文件就会归档到 Google Cloud Storage 的存储桶中。

步骤一、在 Google Cloud 上创建服务账号

  1. 登录 Google Cloud 控制台
  2. 在项目选择器页面上,选择或创建一个 Google Cloud 项目。

    在本例中,我们创建一个新项目 "Demo"。

  3. 创建服务账号。
    1. 在顶部的搜索栏中,搜索并选择 服务账号

    2. 点击顶部的 创建服务账号

    3. 服务账号详情 栏,在 服务账号名称 字段中输入一个名称帮助你识别此账号,然后点击 创建并继续

    4. 向此服务账号授予对项目的访问权限 (可选) 栏,从 角色 下拉列表中搜索并选择 Storage Admin,然后点击 完成

      服务账号已创建,并显示在服务账号列表中。

  4. 为此服务账号创建密钥。
    1. 在服务账号列表中,点击服务账号旁边的 ,然后选择 管理密钥

      网页重定向到密钥配置界面。

    2. 点击 添加密钥,然后从下拉列表中选择 创建新密钥

    3. 设置 密钥类型JSON,然后点击 创建

      密钥已创建;密钥文件以 JSON 格式自动下载到本地电脑。
      注: 将此密钥文件存储在安全位置。后续在 Yeastar 统一管理平台上将 Google Cloud Storage 设置为归档服务器时将会用到此密钥文件。
    4. 点击 关闭,关闭弹窗。

步骤二、在 Google Cloud Storage 上创建存储桶

  1. 在顶部的搜索栏,搜索并选择 Cloud Storage

    网页重定向到存储桶配置界面。

  2. 点击顶部的 创建

  3. 指定存储桶的名称 栏,填写一个名称,帮助你识别此存储桶,然后点击 继续

  4. 选择数据存储位置 栏, 选择要创建存储桶的区域,然后点击 创建

    存储桶已创建成功。

    注: 如果要对 Google Cloud Storage 中归档的文件进行分组,你可以在存储桶中创建文件夹。这样一来,你就可以在后续设置中指定将文件归档到此文件夹下。

步骤三、在 Yeastar 统一管理平台上添加 Google Cloud Storage 存储桶为归档服务器

  1. 登录 Yeastar 统一管理平台,进入 任务 > 预约任务
  2. 在页面顶部,点击 归档服务器

  3. 设置 Google Cloud Storage 存储桶为归档服务器。
    1. 点击 添加
    2. 在弹出的窗口中,完成以下设置。

      设置 说明
      名称 填写一个名称,帮助你识别此服务器。
      服务器类型 选择 Google Cloud Storage
      Private Key(JSON type) 点击 浏览,浏览并选择 在 Google Cloud 中下载的 JSON 文件
    3. 点击 保存

      Google Cloud Storage 存储桶已添加为归档服务器,并显示在服务器列表中。

  4. 点击 关闭窗口。

步骤四、在 Yeastar 统一管理平台创建任务以将文件归档到 Google Cloud Storage

  1. 在 Yeastar 统一管理平台,进入 任务 > 预约任务,然后点击 添加
  2. 创建一次性或周期性归档任务。

    设置 说明
    名称 填写一个名称,帮助你识别此任务。
    对象类型 选择 P 系列云 PBX
    任务 选择 归档
    备份包范围 指定要归档的备份文件的时间范围。
    注: 支持一次性归档最多 31 天内的文件。
    归档服务器 选择 已添加的 Google Cloud Storage 存储桶
    文件存储路径 选择你要归档文件的存储桶或文件夹。
    归档后删除备份包 若启用,则 Yeastar 统一管理平台将在成功归档文件后自动删除对应备份文件。
    注:
    • 若有备份文件归档失败,该文件将不会被删除
    • 若你拥有管理下级用户备份文件的权限,归档操作将会同步删除这些下级用户的备份文件。
    执行频率 设置文件归档到 Google Cloud Storage 的频率。
    • 一次性:若选择此项,则保存归档任务后,系统立即归档文件。
    • 每天:若选择此项,在 执行时间 下拉列表中选择一个时间 。系统每天在指定的时间归档文件。
    • 每周:若选择此项,在 执行时间 下拉列表中选择一周的某一天,并设置时间。系统每周在指定的时间归档文件。
    • 每月:若选择此项,在 执行时间 下拉列表中选择一个日期,并设置时间。系统每月在指定的时间归档文档。

    任务文件存储限制 可选。设置此归档任务在 Google Cloud Storage 存储桶中可保留的生成文件最大数量。

    当达到数量限制时,系统将保留最新的文件并删除较早的文件。

    例如,某归档任务设置为每日晚上 11:00 执行,存储限制为3个文件。则系统每日生成一个归档文件,到第 4 天时,系统将删除第1天的归档文件,并归档第4天的新备份文件。

    注:
    • 每个归档任务将生成一个文件,而该文件可能包含多个备份文件。

    • 此设置项仅在设置定期执行归档任务时出现。若留空,则不会限制文件数量,系统也不会自动删除文件。

    时区 选择执行时间的时区。
    提示: 你可以根据需要启用或禁用夏令时。
    创建者 此项默认读取你的名字,且不可编辑。
    备注 可选。添加备注信息。
  3. 点击 保存

执行结果

指定的文件将立即 / 在预约的时间被归档到 Google Cloud Storage 的指定存储桶或文件夹中。

注: 为避免影响系统性能,系统一次只执行一个任务。如果有多个任务,这些任务会排队执行。

你可以通过以下方式查看归档结果。

在 Yeastar 统一管理平台上查看归档结果
在 Yeastar 统一管理平台,进入 任务 > 执行记录。若任务的 结果 栏显示 成功,则表示指定文件已成功归档到 Google Cloud Storage。

注: 若任务未执行成功,你可以查看任务详情并重试。

在 Google Cloud Storage 上查看归档结果
在 Google Cloud 控制台,进入创建的存储桶。如果指定文件出现在列表中,表明归档成功。