安装 Temporal
在本地安装 Temporal,开始开发分布式应用程序。
系统要求
- Docker Desktop 4.0+(用于运行 Temporal Server)
- Java 17+ 或 Java 21+
- Maven 3.6+ 或 Gradle 7+
- 4GB 可用内存
- 10GB 可用磁盘空间
安装 Temporal CLI
Temporal CLI(命令行工具)用于管理工作流、启动开发服务器和与 Temporal Server 交互。
macOS / Linux
Bash
curl -sSf https://temporal.io/cli.sh | sh
Windows
PowerShell
Invoke-Expression (Invoke-WebRequest -Uri https://temporal.io/cli.sh).Content
验证安装
temporal --version
运行本地 Temporal Server
使用 Docker Compose 在本地启动 Temporal Server,包括 Temporal Web UI。
启动服务器
Terminal
temporal server start-dev
该命令会下载并启动 Temporal Server、PostgreSQL 数据库和 Temporal Web UI。
访问 Web UI
服务器启动后,您可以在浏览器中访问:
Web UI 让您可以查看工作流执行历史、搜索工作流和调试问题。
安装 Java SDK
将 Temporal Java SDK 添加到您的项目中。
Maven
在 pom.xml 中添加依赖
pom.xml
<dependency>
<groupId>io.temporal</groupId>
<artifactId>temporal-sdk</artifactId>
<version>1.23.1</version>
</dependency>
Gradle
在 build.gradle 中添加依赖
build.gradle
dependencies {
implementation 'io.temporal:temporal-sdk:1.23.1'
}
创建项目
使用 Maven 或 Gradle 创建一个新的 Java 项目。
Maven 项目结构
my-temporal-app/
├── pom.xml
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── io/
│ │ │ └── temporal/
│ │ │ └── sample/
│ │ │ ├── workflows/
│ │ │ │ ├── MyWorkflow.java
│ │ │ │ └── MyWorkflowImpl.java
│ │ │ ├── activities/
│ │ │ │ ├── MyActivities.java
│ │ │ │ └── MyActivitiesImpl.java
│ │ │ ├── WorkerMain.java
│ │ │ └── StarterMain.java
│ │ └── resources/
故障排除
Docker 未运行
确保 Docker Desktop 正在运行。您可以通过运行 docker ps 来验证。
端口已被占用
如果端口 7233 或 8233 已被占用,您可以使用 --port 和 --ui-port 选项指定不同的端口:
temporal server start-dev --port 7234 --ui-port 8234
CLI 未安装
如果 temporal 命令未找到,请确保将 CLI 添加到系统 PATH 中,或使用完整路径执行:
export PATH=$HOME/temporal:$PATH
下一步
版权与许可:Temporal 官方文档及其中文译文项目采用 MIT License;保留原作者声明,详见许可证。