借助时间表触发器,您可以按特定的时间间隔定期运行集成。如果您希望在不进行任何手动干预的情况下自动运行集成,则此触发器很有用。例如,您可以考虑使用时间表触发器来执行以下类型的任务:
- 定期将文件从一个系统上传到另一个系统
- 发送定期电子邮件提醒
- 定期同步数据库
准备工作
请确保将 Apigee Integration Invoker IAM 角色分配给 Google Cloud 项目中的 Apigee Service Agent (
service-PROJECT_ID
@gcp-sa-apigee.iam.gserviceaccount.com
)。
如需详细了解如何分配 IAM 角色,请参阅在 Google Cloud 中管理访问权限。
添加时间表触发器
如需向新的或现有的集成添加时间表触发器,请执行以下步骤:- 在 Apigee 界面中,选择您的 Apigee 组织。
- 点击开发 > 集成。
- 选择现有集成,或通过点击创建集成来创建新集成。
要创建新的集成,请执行以下操作:
- 在创建 Integrations对话框中输入名称和说明。
- 从支持的区域列表中选择集成的区域。
- 点击创建。
这将在集成设计器中打开集成。
- 在集成设计器导航栏中,点击 + 添加任务/触发器 > 触发器以查看可用触发器列表。
- 点击时间表触发器元素并将其放入设计器中。
配置时间表触发器
点击集成编辑器中的时间表触发器 (Schedule Trigger) 元素以查看触发器配置窗格。
您可以使用以下任一模式配置时间表触发器:
- 基本:提供用于配置运行频率的界面。
- 高级:使用 cron 表达式配置运行频率。
在基本模式下,您可以选择在特定时间或按每小时间隔运行集成。如果要在特定时间运行集成,请从时间下拉列表中选择 Run at a specific time,并设置以下属性:
- 时间:集成必须运行的时间(采用 24 小时制)。
- 天:必须运行集成的日期。您可以选择在每天、一周中的特定几天、一个月中的特定某一天等运行集成。
- 月份:必须运行集成的月份。您可以选择每月或在特定月份运行集成。
在高级模式下,您可以使用 cron 表达式指定运行频率。cron 表达式包含五个必须按以下顺序指定的值:
- 分钟 (0-59)
- 小时 (0-23)
- 日期 (1-31)
- 月份,以下任一值:
- 1-12 的数字
- 三个字母的月份缩写(例如 Jan、Feb、Mar 等)
- 星期几,以下任一值:
- 0 到 6 的数字,星期日是 0
- 三个字母的缩写(例如 Mon、Tue、Wed 等)
例如,如需在每月的第一天运行集成,请使用 * * 1 * *
cron 表达式。
最佳做法
最佳做法是不再需要时停用时间表触发器。如果让冗余时间表触发器保持活跃状态,它将继续自动触发集成。
如需停用时间表触发器,您可以执行以下任一操作:
- 取消发布包含时间表触发器的集成。您的集成将不再有效,并且触发器也不会运行。
- 将时间表触发器替换为其他触发器,然后重新发布集成。重新发布的活跃集成版本将不使用时间表触发器。
- 删除当前版本的集成。您可以在集成名称旁边的版本列表下找到删除选项。