Amazon SWF 常见问题

要注册 Amazon SWF，请访问 Amazon SWF 详细信息页面，然后单击“立即注册”按钮。如果没有 Amazon Web Service 账户，系统将会提示您创建一个。注册后，即可在 AWS 管理控制台逐步运行示例，它们将指导您了解使用 Amazon SWF 运行简单的图像转换应用程序的步骤。您也可以下载 AWS Flow Framework 示例，了解该服务的各种功能。要在应用程序中开始使用 Amazon SWF，请参阅 Amazon SWF 文档。

符合。开始使用 Amazon SWF 时，您可以在 AWS 管理控制台逐步尝试示例，它们将指导您注册域和类型、部署工作程序与决策程序及开始工作流执行任务。您可以下载此逐步介绍中使用的工作程序和决策程序的代码，在自己的基础设施中运行它们，甚至对其进行修改来构建自己的应用程序。此外，也可以下载 AWS Flow Framework 示例，它们描述了分布式数据处理、Cron 任务和应用程序堆栈部署等各种使用案例中对 Amazon SWF 的使用情况。通过查询随附的源代码，您可以详细了解 Amazon SWF 的功能及如何使用 AWS Flow Framework 来构建自己的分布式应用程序。

您可以下面任何方式访问 SWF：

• 适用于 Java、Ruby、.NET 和 PHP 的 AWS 开发工具包
• 适用于 Java 的 AWS Flow Framework（适用于 Java 的 AWS 开发工具包随附）
• Amazon SWF Web 服务 API
• AWS 管理控制台

注册是为各种不同类型的工作流和活动执行的一次性步骤。您可以编程方式或通过 Amazon SWF 管理控制台注册。注册时，您需要为每种活动和工作流类型提供唯一类型的 ID。还要提供运行工作流时使用的默认信息，例如超时值和任务分配参数。

在 SWF 中，您要为自己的应用程序资源定义逻辑容器，称为域。域只能在 AWS 账户级别创建，不能嵌套。域可以使用用户定义的任何名称。每个应用程序资源（例如，工作流类型、活动类型或执行任务）只属于一个域。注册时，您需要指定在哪个域下注册工作流或活动类型。开始执行任务时，将自动在与其工作流类型相同的域中进创建任务。资源标识符的唯一性（如类型 ID、执行 ID）范围限于域内，即您可以在不同的域中重复使用标识符。

您可以使用域来整理应用程序资源，因为它们易于管理，且不会无意中影响彼此。例如，您可以为开发、测试和生产环境创建不同的域，并在每个域中创建相应的资源。虽然可以在以上每个域中注册相同的工作流类型，但在各个域中会将其视为独立的资源。您可以在开发域中更改其设置，也可以在测试域中管理执行任务，而不会影响生产域中所对应的资源。

决策程序可视为特殊类型的工作程序。同工作程序一样，可以任何语言编写决策程序，并且它可从 Amazon SWF 获取任务。不过，它处理的是特殊任务，称为决策任务。当工作流执行任务发生转变（例如正在完成活动任务或活动任务超时）时，Amazon SWF 将发布决策任务。决策任务包含输入、输出及先前启动的活动任务的当前状态等信息。决策程序使用这些数据来确定后续步骤，包括任何新的活动任务及将数据返回 Amazon SWF。Amazon SWF 继而制定这些决策，根据需要启动新活动任务并监控它们。决策程序通过持续响应决策任务，控制活动任务的顺序、时间和并发性，由此执行应用程序中的处理步骤。开始执行任务时，SWF 发布第一个决策任务。自此以后，Amazon SWF 将制定决策程序提出的决策以推动执行任务。执行将一直继续，直到决策程序作出完成执行的决策。

为帮助决策程序作出决策，SWF 会持续保存有关执行中所有任务详细信息的记录。此记录称为历史记录，对于每个执行任务是唯一的。执行任务开始时，会启动新的历史记录。这时，历史记录中包含执行的输入数据等初步信息。之后，随着工作程序处理活动任务，Amazon SWF 会用其输入和输出数据及最新状态来更新该历史记录。当决策程序收到决策任务时，它可以检查执行的历史记录。Amazon SWF 确保历史记录准确反映了决策任务发布时的执行状态。因此，决策程序可使用历史记录来确定执行中发生的事情并决定相应的后续步骤。

您可以使用任务列表来确定如何分配任务。任务列表是 Amazon SWF 资源，启动的任务会添加到当中，并从中请求任务。任务列表由用户定义的名称标识。任务列表可能包含不同类型 ID 的任务，但它们必须属于活动任务或决策任务。注册时，您要为每种活动和工作流类型指定一个默认任务列表。Amazon SWF 还允许您在运行时创建任务列表。创建任务列表方法非常简单，对其命名并开始使用它即可。任务列表的使用方法如下：

• 启动活动任务时，决策程序可将其添加到特定的任务列表，也可以请求 Amazon SWF 将其添加到其活动类型的默认任务列表。
• 开始执行时，您可以请求 Amazon SWF 将其所有决策任务添加到特定的任务列表或添加到该工作流类型的默认任务列表。
• 请求任务时，决策程序和工作程序可以指定它们分别希望从哪个任务列表接收任务。如果列表中存在任务，SWF 会在响应中将其发送并包括其类型 ID。

综上所述，您可以控制任务添加到哪个任务列表以及每个程序从哪个列表中获取任务。因此，您可以确保工作程序和决策程序仅获取其了解的任务。

AWS Flow Framework 是一种编程框架，让您可以快速、轻松开发基于 Amazon SWF 的应用程序。它会提取任务级协调的细节，并与简单的编程结构异步交互。Amazon SWF 中的工作流协调包含启动需要不同时间完成的远程操作（例如，活动任务）及正确实施各任务之间的依赖性。

AWS Flow Framework 让您可以通过熟悉的编程理念方便地表达协调的不同方面。例如，像调用一种方法一样简单地启动活动任务。AWS Flow Framework 会自动将调用转换为决策以启动活动任务，并让 Amazon SWF 向工作程序分配任务，进行监控并在完成时反馈报告。该框架在从方法调用返回值时，以代码形式向您提供任务结果，包括其输出数据。为表达对任务的依赖性，您只需向处理常见的方法调用一样，在代码中使用返回的值。该框架的运行时将自动等待任务完成，并仅在结果可用时继续执行。在后台，该框架的运行时会从 Amazon SWF 接收工作程序和决策任务，在正确的时间从程序中调用相关方法，并制定决策返回到 Amazon SWF。通过提供直观的编程框架来访问 Amazon SWF，AWS Flow Framework 让用户能够在应用程序开发时轻松加入异步和事件驱动编程。

通常，基于轮询的协议要求开发人员确定一个最优的轮询频率。如果开发人员轮询频率过高，许多轮询可能会返回空结果。这样，将导致轮询耗费大量应用程序和网络资源，但没有返回有意义的结果来进一步推动执行任务。如果开发人员所定的轮询频率过低，保留消息可能会持续较长时间，从而增加应用程序延迟。

为克服轮询内在的效率低下问题，Amazon SWF 提供了长时间轮询。长时间轮询可大大降低轮询返回空任务的次数。当工作程序和决策程序轮询 Amazon SWF 获取任务时，如果没有任务可用，该连接将保留一分钟。如果在该段期间产生可用任务，它们将返回响应长时间轮询的请求。通过将连接保留一段时间，可避免该段期间返回空结果的其他轮询。借助长时间轮询，您的应用程序将获益于轮询的安全性和流量控制优势，而不会损害推送 Web 服务提供的延迟和效率优势。

工作程序使用标准的 HTTP GET 请求从 Amazon SWF 获取任务并返回结果。要将现有的 Web 服务作为工作程序，您可以创建一个包装程序从 Amazon SWF 获取任务，根据需要调用该 Web 服务的 API，并向 Amazon SWF 返回结果。在包装程序中，将任务提供的输入数据转换为适用于该 Web 服务 API 的参数。同理，还要将该 Web 服务 API 的输出数据转换为适用于任务的结果并向 Amazon SWF 返回。

不会，您可以使用任何编程语言来编写工作程序或决策程序，只要您能使用 Web 服务 API 与 Amazon SWF 通信即可。当前提供适用于 Jave、.NET、PHP 和 Ruby 的 AWS 开发工具包。适用于 Java 的 AWS 开发工具包包括 AWS Flow Framework。

当开始执行新工作流时，您需要为该工作流执行任务提供一个 ID。这让您能够将执行任务与业务实体或操作（例如，客户 ID、文件名、串行号码）关联起来。在运行时，Amazon SWF 可确保该执行任务的 ID 是唯一的。在此期间，尝试启动相同 ID 的执行任务会失败。这让您可以轻松满足要求针对给定业务操作不得运行多个执行任务的业务需求，例如交易、提交或分配。以在网站上注册新用户的工作流为例。当用户单击提交按钮时，可以使用该用户的唯一电子邮件地址来命名执行任务。如果该执行任务已存在，调用启动执行任务将失败。无需其他代码，以防注册时单击按钮的多个用户导致产生冲突。

当工作流执行完成后（成功或失败），您可以相同 ID 启动另一工作流执行任务。这样，将以相同的执行 ID 运行新的工作流执行任务，但运行 ID 不同。运行 ID 由 Amazon SWF 生成，工作流执行 ID 相同的多个执行任务可以凭借运行 ID 加以区分。通过允许您以这种方式重新使用工作流执行 ID，Amazon SWF 可帮助您满足重试等使用案例。例如，以上述用户注册为例，假使为用户创建数据库记录时，工作流执行失败。您可以相同的执行 ID（用户的电子邮件地址）再次启动工作流执行，而不用创建新的 ID 来重试注册。

Amazon SWF 允许您扩展应用程序，让您能够完全控制为每种活动类型运行的工作程序数及为决策程序运行的实例数。通过增加工作程序或决策程序实例数量，可以增加为相应处理步骤分配的计算资源，由此增加这些步骤的吞吐量。要自动扩展，您可以使用 Amazon SWF 通过其 API 提供的运行时数据。例如，Amazon SWF 提供任务列表中的任务数。由于数量增加意味着工作程序赶不上负载，所以当待处理的任务达到阈值时，您可以自动加速新的工作程序。

除管理控制台外，Amazon SWF 提供一整套查看 API。您可以使用它们来获取运行时信息，监控所有执行任务并根据负载自动扩展执行任务。您可以获取每种工作流类型的详细数据，例如特定时间范围内开放和关闭的执行任务数。使用查看 API，还可以构建自定义的监控应用程序。

Amazon SWF 允许您通过管理控制台和查看 API 搜索执行任务。您可以按各种条件进行搜索，包括执行开始或完成的时间间隔、当前状态（即开放或关闭）及标准的故障模式（例如，超时、终止）。要组合工作流执行任务，开始执行时，可以使用多达 5 个标签将自定义文本与工作流执行任务关联起来。在 AWS 管理控制台中，可以使用标签搜索工作流执行任务。

要查找可能已停止的执行任务，您可以从基于时间搜索开始，深入到运行时间超过预期的执行任务。接下来，可以监控它们来了解任务级细节，并确定特定任务的运行时间是否已过长或失败，或者决策程序是否没有启动任务。这样，可帮助您准确查明任务级的问题。

符合。如果应用程序和活动全部在相同的域中进行了注册，则多个应用程序可以共享给定的活动类型。为此，您可以让不同的决策程序为该活动类型启动任务，并将其添加到任务列表中以便工作程序对该活动轮询。然后，该活动类型的工作程序将从所有不同的应用程序获取活动任务。如果要说明某个活动任务来自哪个应用程序，或者是否要为不同的应用程序部署不同的工作程序集，您可以使用多个任务列表。请参阅如何确保工作程序或决策程序仅获取其了解的任务？

符合。您可以授予 IAM 用户访问 Amazon SWF 的许可权限。IAM 用户只能访问您指定的 SWF 域和 API。

符合。工作程序使用标准 HTTP GET 请求从 Amazon SWF 获取任务并返回计算结果。由于工作程序总是向 Amazon SWF 启动请求，所以您不必配置防火墙来允许入站请求。

工作程序使用标准 HTTP GET 请求从 Amazon SWF 获取任务并返回计算结果。因此，您不必曝露工作程序的任何终端节点。而且，Amazon SWF 仅在决策程序启动任务时才向工作程序提供这些任务。鉴于决策程序由您编写，所以您能够完全控制何时以及如何启动任务，包括通过这些任务发送到工作程序的输入数据。

Amazon SWF 围绕任务分配提供可靠的保证。它可确保任务永远不会重复，且只分配一次。因此，即使有多个特定活动类型的工作程序（或大量决策程序实例），Amazon SWF 为特定的任务仅提供一个工作程序（或一个决策程序实例）。此外，Amazon SWF 对于工作流执行，每次最多保留一个待定的决策任务。因此，您可以运行多个决策程序实例，而不必担心同时针对同一执行任务运行两个实例。借助这些功能，您可以协调工作流，而不必担心任务重复、丢失或冲突。

每个域中最多可以注册或淘汰 10000 个工作流和活动类型（总计）。在 AWS 账户中，最多可以拥有 100 个 Amazon SWF 域（包括注册和弃用的域）。

在任何给定时间，您的域中最多可以拥有 100000 个开放的执行任务。对于运行的执行任务累计数或 Amazon SWF 保留的执行任务数，没有其他限制。

每个工作流执行任务最长可以运行 1 年。每个工作流执行历史记录最多可以增长到 25000 个事件。如果您的使用场景需要超出此限制，可以使用 Amazon SWF 提供的功能，借助子工作流执行来继续执行和规划您的应用程序。

如果工作流执行任务闲置了较长的一段时间，Amazon SWF 不会进行任何专门操作。闲置的执行任务受您配置的超时约束。例如，如果您已将执行任务的最大持续时间设置为 1 天，则如果闲置的执行任务超出 1 天，它将会超时。此外，闲置的执行任务还受 Amazon SWF 对于执行任务可以运行的时间限制（1 年）约束。

Amazon SWF 不会对工作程序处理一项任务所需的时间强加特定限制。它会执行超时，即您为活动任务指定的最大持续时间。请注意，由于 Amazon SWF 限制一项执行任务最长可运行 1 年，所以工作程序处理一项任务的时间不能超过该限制。

Amazon SWF 不会对工作程序轮询前保留任务的时间强加特定限制。不过，在注册活动类型时，您可以对 Amazon SWF 保留该类活动任务的时间设置默认的超时。此外，在调度活动任务时，还可以通过决策程序代码指定此超时或覆盖默认的超时。由于 Amazon SWF 限制一项工作流执行任务最长可运行 1 年，所以如果没有指定超时，任务的保留时间不能超过 1 年。

可以，您可以在一个决策中安排调度多达 100 个活动任务，还可以相继发布多个决策。

对于工作流执行期间使用的活动任务、信号及定时器数，没有限制。不过，当前每个工作流执行最多只能包含 1000 个开放活动任务。其中包括已经启动和工作程序正在处理的活动任务。同理，每个工作流执行最多可包含 1,000 个开放定时器，及多达 1,000 个开放子执行任务。

对于工作流执行期间传输的数据总量，没有限制。不过，Amazon SWF API 会对执行中用来传送数据的参数强加特定的最大限制。例如，传入活动任务的输入数据和使用信号发送的输入数据每项最多可以包含 32,000 个字符。

Amazon SWF 可在您指定的任意天数内保留已完成执行任务的历史记录，最长可保留 90 天（即大约 3 个月）。在保留期间，您可以编程方式或通过控制台访问历史记录和搜索执行任务。

除了少见的峰值以外，如果您在很短时间内调用大量 API，可能会受到限制。

有关提供服务的地区，请参阅 AWS 全球基础设施区域表。

是，Amazon SWF 可以跨 3 个可用区域管理工作流执行历史记录及工作流的其他细节，所以即使在某一可用区域出现故障，您的应用程序仍可以继续依赖于 Amazon SWF。

请访问 AWS 一般参考文档，了解更多关于访问端点的信息。

除非另行说明，否则我们的价格不包含适用的税费和关税（包括增值税和适用销售税）。 使用日本账单地址的客户若要使用 AWS，则需缴纳日本消费税。

了解详情