安装 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

服务器启动后，您可以在浏览器中访问：

http://localhost:8233

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

下一步

创建您的第一个工作流