Temporal 项目教程

1. 项目介绍

Temporal 是一个持久化执行平台，旨在帮助开发者构建可扩展的应用程序，同时不牺牲生产力或可靠性。Temporal 服务器执行称为“工作流”的应用逻辑单元，并以一种能够自动处理间歇性故障和重试失败操作的方式进行。Temporal 是一个成熟的技术，起源于 Uber 的 Cadence 项目，由 Temporal Technologies 开发，该公司由 Cadence 的创建者创立。

2. 项目快速启动

2.1 安装 Temporal 服务器

首先，使用 Homebrew 安装 Temporal CLI：

brew install temporal

2.2 启动 Temporal 服务器

使用以下命令启动 Temporal 服务器及其所有依赖项：

temporal server start-dev

2.3 运行示例

克隆或下载 Go 或 Java 的示例项目，并使用本地 Temporal 服务器运行它们。以下是 Go 示例的运行命令：

git clone https://github.com/temporalio/samples-go.git
cd samples-go
go run .

2.4 使用 Temporal CLI

使用 Temporal CLI 与运行的 Temporal 服务器进行交互：

temporal operator namespace list
temporal workflow list

2.5 使用 Temporal Web UI

通过打开 http://localhost:8233 访问 Temporal Web UI，查看在 Temporal 上执行的示例工作流。

3. 应用案例和最佳实践

3.1 应用案例

Temporal 适用于需要高可靠性和可扩展性的应用场景，如：

• 微服务编排：Temporal 可以用于编排多个微服务，确保每个服务按顺序执行并处理失败。
• 定时任务：Temporal 可以管理定时任务，确保任务在指定时间执行，并在失败时自动重试。
• 复杂业务流程：对于需要多个步骤和条件判断的业务流程，Temporal 提供了强大的工作流管理能力。

3.2 最佳实践

• 定义清晰的工作流：在设计工作流时，确保每个步骤都有明确的输入和输出，并考虑可能的失败情况。
• 使用重试策略：为每个活动设置合适的重试策略，以应对间歇性故障。
• 监控和日志：使用 Temporal Web UI 和日志系统监控工作流的执行情况，及时发现和解决问题。

4. 典型生态项目

4.1 Temporal Web UI

Temporal Web UI 是一个用于监控和管理 Temporal 工作流的 Web 界面，提供了直观的视图来查看工作流的执行状态和历史记录。

4.2 Temporal CLI

Temporal CLI 是一个命令行工具，用于与 Temporal 服务器进行交互，支持创建命名空间、列出工作流、启动和终止工作流等操作。

4.3 Temporal SDK

Temporal SDK 提供了用于开发 Temporal 工作流的客户端库，支持多种编程语言，如 Go、Java 等。开发者可以使用 SDK 定义工作流、活动和工作者。

4.4 Temporal 社区

Temporal 拥有一个活跃的社区，开发者可以在社区论坛和 Slack 上交流经验、提出问题和分享最佳实践。

---

通过本教程，您应该能够快速启动 Temporal 项目，并了解其在实际应用中的使用方法和最佳实践。