Release Highlights

v0.28.0 maintains Temporal's "Alpha" release state.
Do not use this release for production workloads. There are no more code or API breaking changes after this release, however stabilization efforts are still ongoing.

Change details

Major updates:

1. Retry attempts start with 1 instead of 0.
2. Activity has default retry policy.
3. All times and durations use protobuf types google.protobuf.Timestamp and google.protobuf.Duration instead of int64/int32.

Minor updates and fixes

2020-07-15 - eaf9ee9ca - Fix elastic search index name for ExecutionStatus (#544)
2020-07-16 - 3e895b4f6 - TaskQueue Schema Collapse (#500)
2020-07-16 - 7e3899716 - Remove cancel failed events for activity and timer (#534)
2020-07-16 - 7e994f85f - Move internal service error to the repo (#552)
2020-07-17 - 999fa85c8 - Removing references to graphite in docker/README (#548)
2020-07-18 - 71b8a1a39 - Set task queue kind explicitly (#545)
2020-07-18 - 727809490 - Fixes start.sh to not output MySQL/Postgres password during DB setup (#559)
2020-07-20 - 1670f7729 - Rename workflow_task_timeout_seconds (#570)
2020-07-20 - 2411b19f5 - Allow for ElasticSearch scheme (https, http) to be configurable via container's env var (#563)
2020-07-20 - 4485e83fd - ChildWorkflow defaults to workflow run timeout specified by parent (#566)
2020-07-20 - 73b60b12f - Add Hash to Task Schema Key, compound TaskQueueId (#557)
2020-07-20 - b36bc0a4c - Fixes flaky continueAsNewWorkflow_Timeout integration test (#564)
2020-07-20 - c37db074e - Timeout workflow when WorkflowExecutionTimeout is reached (#560)
2020-07-20 - d066a7dcd - Raname WorkflowTaskTimeout to DefaultWorkflowTaskTimeout and CurrentWorkflowTaskTimeout to WorkflowTaskTimeout (#556)
2020-07-20 - d527d1c94 - Change default order for listClosedWorkflowExecutions to by close time #312 (#555)
2020-07-21 - 1e6087acf - Fixes panic when ListTaskQueuePartitions is invoked
2020-07-21 - 7c6df6d37 - Remove emit_metric field from namespace (#579)
2020-07-21 - 9d81f1d18 - Changes ListClosedWorkflow result ordering for SQL-based visibility stores to be based off of workflow close time (#578)
2020-07-21 - d48bd8c31 - Fix TestActivityHeartbeatTimeouts flakiness (#577)
2020-07-21 - ed8f90260 - BufferedEvents Compound Primary Key (#568)
2020-07-22 - 4ee2031f7 - Fix TestClusterMembershipUpsertCanPageRead (#597)
2020-07-22 - 91d435cfc - tctl: improve failure formating (#594)
2020-07-22 - c72053fe6 - ClusterMembership Partition Pin/AutoIncrement Removal (#583)
2020-07-22 - ed595e22c - Fix Querying archived workflows not recognizing terminated workflows (#541)
2020-07-23 - 9865b5366 - Add pinned version_partition column to schema version tables (SQL) (#602)
2020-07-24 - 0bbbb7851 - Support multiple input options in cli (#600)
2020-07-24 - 79269f9a3 - Convert REPLACE INTO -> INSERT ON DUPLICATE KEY UPDATE (#601)
2020-07-24 - a62d26b20 - Update SDK to zapless version (#605)
2020-07-24 - e0fdc8c17 - Adds validation for workflow task for child start and cancel (#599)
2020-07-24 - e807dca07 - Fixes nil reference when trying to propagate terminates to child workflows
2020-07-27 - 2ab6881d5 - Convert ActivityInfo Persistence POGOs to Proto (#615)
2020-07-27 - 36643c5f2 - Add serviceName to health check (#614)
2020-07-27 - 404019125 - Rename cadence-cluster-topics to temporal-cluster-topics (#612)
2020-07-27 - 7a9752bb7 - Use proto JSON serializer for proto objects (#611)
2020-07-27 - 8c9349da7 - Rename Cassandra Namespace Tables (#608)
2020-07-27 - f2bf9b23f - Convert ChildExecutionInfo Persistence POGOs to Proto (#616)
2020-07-28 - 17e3b6777 - Convert ReplicationState/ExecutionState POGO to Proto (#622)
2020-07-28 - 463fc8ae3 - Default NumTaskqueue*Partitions to 4, use this value when listing partitions (#618)
2020-07-28 - 4b012342c - Disable Archival feature in development docker (#609)
2020-07-28 - 80514cd7c - Remove Proto Double Serialization, VersionHistories Column Cassandra (#624)
2020-07-29 - 02c8fac1c - Clean up unused feature flags (#625)
2020-07-29 - 10de202fb - Sets default activity maximum retry interval to be 100x minimum retry interval (#630)
2020-07-29 - 1f880f66b - Adds override for individual fields on activity retry policy #628
2020-07-29 - 22ec320c4 - Fixes issue where NonRetryableErrorTypes was getting dropped during activity info validation
2020-07-30 - 01877638e - Convert attempts to int32 for consistency (#644)
2020-07-30 - 04c422002 - Use 0 as value for EmptyEventID which represents Unspecified (#634)
2020-07-30 - 190877758 - Sleep within activity was too aggressive resulting in test flakiness (#635)
2020-07-30 - 381c67f3d - Default LatestTime to Now in ListOpen/CloseWorkflowExecutions (#641)
2020-07-30 - 58f95bc04 - Default to multiple TaskQueue partitions in FrontEnd LoadBalancer configs (#639)
2020-07-30 - 59629e2f5 - Make 0 as invalid value for failover Version (#642)
2020-07-30 - ced7304d8 - Update ShardID to start with 1 instead of 0 (#633)
2020-07-30 - e299cdd3d - Routing logic to take both NamespaceID and workflowID into account (#629)
2020-07-31 - e5e1edf7d - Use Platform Stable Hashing; Reduce TaskQueueId Size (#647)

Helpful links to get you started with Temporal

Temporal Docs
Server
Java SDK
Java Samples
Go SDK
Go Samples
Helm Chart

Docker images for this alpha release (use tag 0.28.0)

Server
Server With Auto Setup
CLI (tctl)
Admin-Tools

Things we are still working on

1. Stress and Performance testing.

Release Highlights

v0.27.0 maintains Temporal's "Alpha" release state.
Do not use this release for production workloads as there are breaking changes planned for future releases.

This release includes:

• Import path renames
• Major entity renames
• tctl improvements
• Other minor updates

Change details

Import path renames

1. go.temporal.io/temporal-proto → go.temporal.io/api
2. go.temporal.io/temporal → go.temporal.io/sdk: Root files were moved to temporal directory, so package name remained the same but import path changed from go.temporal.io/temporal to go.temporal.io/sdk/temporal.
3. github.com/temporalio/temporal → go.temporal.io/server
4. github.com/temporalio/temporal/.gen/proto→ go.temporal.io/server/api: This is already checked into the repo. This enables the reference of the server package to build a custom version.

Major entities renames:

1. RetryStatus → RetryState
2. ArchivalStatus → ArchivalState
3. NamespaceStatus → NamespaceState: Note that, in the config file, status: needs to be renamed to state:.
4. DecisionTask → WorkflowTask
5. Decision → Command
6. Decider → Workflow

tctl improvements

2020-07-08 - 37f1b7750 - Fixes up admin cluster command for adding search attributes to be indexed (#514)
2020-07-10 - 0a2653912 - Fix issue where non-string heartbeat details fail to display and only the first heartbeat detail shows up in CLI
2020-07-14 - 0eafe049b - Use ToString for CLI output (#542)

Minor updates

2020-06-29 - 4ca4935f3 - Tighten Ringpop Join Params (#446)
2020-06-30 - 620919051 - Add GOBIN to PATH in Makefile (#485)
2020-06-30 - a75666178 - Fix retry for wrapped failures (#490)
2020-07-02 - 1d4a36c05 - Support Dynamic Cluster IP Addresses in Failure Scenarios (#495)
2020-07-06 - dd0857ec1 - Upgrade gocql to latest release (#498)
2020-07-08 - 16f23cb09 - NamespaceMetadata Partitioning Alignment (#486)
2020-07-10 - 1909ab0bc - Adopt Google api-linter (#526)
2020-07-13 - 014a2515d - Pass 127.0.0.1 explicitly to Cassandra in dependency docker (#540)
2020-07-13 - 7ffa04c22 - Remove statsd from / add admin-tools to docker-compose files (#536)
2020-07-13 - 89c51ccd5 - Expose cassandra consistency and serial consistency settings in configuration (#533)

Helpful links to get you started with Temporal

Temporal Docs
Server
Java SDK
Java Samples
Go SDK
Go Samples
Helm Chart

Docker images for this alpha release (use tag 0.26.0):

Server
Server With Auto Setup
CLI (tctl)
Admin-Tools

Things we are still working on

1. We are still working and cleaning some internal API contracts. So more breaking changes are coming. So please don't use this for production setup yet.
2. Stress and Performance testing.

This is a follow-up alpha release for Temporal v0.25.0 (which has enum default value bug). Please use this release instead of 0.25.0.
We still have a few planned breaking changes in pipeline so please do not use it for production workload.

Release Highlights

Major updates

2020-06-27 - 88b3049f - Set ParentClosePolicy default value (#481)
2020-06-27 - c16eef67 - Rename task list to task queue (#480)

tctl improvements

2020-06-25 - 955587f0 - Add execution filter to tasklist tasks CLI command (#462)
2020-06-27 - 172fa9f1 - Remove executable permission from JSON files (#483)

Helpful links to get you started with Temporal

Temporal Docs
Server
Java SDK
Java Samples
Go SDK
Go Samples
Helm Chart

Docker images for this alpha release (use tag 0.26.0):

Server
Server With Auto Setup
CLI (tctl)
Admin-Tools

Things we are still working on

1. We are still working and cleaning some internal API contracts. So more breaking changes are coming. So please don't use this for production setup yet.
2. Stress and Performance testing.

UPDATE: Please don't use this release, but use v0.26.0 instead.

This is a refresh to alpha release for Temporal. We still have a few planned breaking changes in pipeline so please do not use it for production workload.

Release Highlights

Major updates

2020-05-26 - 6b90e13c - Use Failure and FailureInfo for errors (#397)
2020-06-04 - 4e0c4e03 - Save last RetryStatus for retryable failures (#432)
2020-06-05 - 198aeb1d - Set proper timeout for workflows (#398)
2020-06-09 - ef842297 - Prefix enums with type and convert to upper case (#440)
2020-06-11 - fe378c00 - Add UNSPECIFIED to every enum (#441)
2020-06-13 - 8786f004 - Remove query consistency level from request (#452)

tctl improvements

2020-05-26 - 2fa70b3b - Create CLI command to describe shard by id (#370)
2020-05-31 - bd7a944b - Create CLI command to describe Timer Task (#408)
2020-06-02 - 6d918263 - Create CLI command to list Cluster Memberships (#423)
2020-06-03 - 8aa47f47 - Add consistency to CLI admin command names (#427)
2020-06-04 - b16833c5 - Create CLI command to list Ringpop Members (#426)
2020-06-04 - d06e307c - Create CLI command to describe Replication Task (#416)
2020-06-05 - 1e7c2809 - Create CLI admin command to describe Transfer Task (#412)
2020-06-08 - 17863501 - Create CLI command to list Timer, Transfer, Replication tasks (#429)
2020-06-10 - 40c0eb98 - Create CLI util for list commands (#443)
2020-06-10 - 9ed264ac - Create CLI command to list Tasks from Tasklist (#433)
2020-06-11 - ff979ef4 - Change CLI task commands to accept string task-type (#445)
2020-06-18 - 67893258 - Add table-view support for CLI list commands (#444)
2020-06-21 - 84ee85d9 - Create CLI command to list replication DLQ tasks (#456)
2020-06-22 - 7e70ded9 - Create admin CLI command to list namespaces (#463)
2020-06-22 - 927f01c8 - Replace CLI options to accept enum names instead of integers (#447)
2020-06-23 - 8d3896db - Fix CLI reuse policy flag type (#473)
2020-06-25 - 955587f0 - Add execution filter to tasklist tasks CLI command (#462)

Minor updates

2020-05-26 - af5440b8 - emit domain specific metrics in task processing
2020-05-27 - dc3c78f2 - Align dynamic config with proto enum (#417)
2020-06-05 - d287f119 - Remove workflow timeout type (#434)
2020-06-08 - e2bfe5a2 - Call cancel on context to prevent memory leak (#438)
2020-06-18 - 25f7c8d6 - Allow for empty postgres db password (#461)

Helpful links to get you started with Temporal

Temporal Docs
Server
Java SDK
Java Samples
Go SDK
Go Samples
Helm Chart

Docker images for this alpha release (use tag 0.25.0):

Server
Server With Auto Setup
CLI (tctl)
Admin-Tools

Things we are still working on

1. We are still working and cleaning some internal API contracts. So more breaking changes are coming. So please don't use this for production setup yet.
2. Stress and Performance testing.

This is a follow-up release to alpha release v0.23.0 containing fixes for TLS enabled clusters and XDC replication.

Release Highlights

1. Temporal now has support for TLS configuration. Please checkout doc to learn more. Support for TLS in tctl and temporal-web is still in-progress.
2. Simplified workflow execution timeouts. Now all workflow timeouts are optional. Each workflow execution now has 3 timeouts: WorkflowExecutionTimeout, WorkflowRunTimeout, and WorkflowTaskTimeout.
3. Removed ExpirationInterval from RetryPolicy. Instead WorkflowExecutionTimeout is used to stop retries.
4. All payloads (workflow input, activity input, etc) send to Temporal now have both headers and data fields.

Helpful links to get you started with Temporal

Temporal Docs
Server
Java SDK
Java Samples
Go SDK
Go Samples
Helm Chart

Docker images for this alpha release (use tag 0.23.0):

Server
Server With Auto Setup
CLI (tctl)
Admin-Tools

Things we are still working on

1. We are still working and cleaning some internal API contracts. So more breaking changes are coming. So please don't use this for production setup yet.
2. Stress and Performance testing.

This is a refresh to alpha release for Temporal. We still have a few planned breaking changes in pipeline so please do not use it for production workload.

Release Highlights

1. Temporal now has support for TLS configuration. Please checkout doc to learn more. Support for TLS in tctl and temporal-web is still in-progress.
2. Simplified workflow execution timeouts. Now all timeouts are optional. Each workflow execution now has 3 timeouts: WorkflowExecutionTimeout, WorkflowRunTimeout, and WorkflowTaskTimeout.
3. Removed ExpirationInterval from RetryPolicy. Instead WorkflowExecutionTimeout is used to stop retries.
4. All payloads (workflow input, activity input, etc) send to Temporal now have both headers and data fields.

Helpful links to get you started with Temporal

Temporal Docs
Server
Java SDK
Java Samples
Go SDK
Go Samples
Helm Chart

Docker images for this alpha release (use tag 0.23.0):

Server
Server With Auto Setup
CLI (tctl)
Admin-Tools

Things we are still working on

1. We are still working and cleaning some internal API contracts. So more breaking changes are coming. So please don't use this for production setup yet.
2. Stress and Performance testing.

Alpha release for Temporal Server.

Release Highlights

This release adds two fixes:

1. When using docker, BroadcastAddress can be configured via the TEMPORAL_BROADCAST_ADDRESS environment variable.
2. When using docker, MYSQL_TX_ISOLATION_COMPAT environment variable can be set as true in order to support setting up schemas with pre-5.7.20 MySQL installations.

Helpful links to get you started with Temporal

Temporal Docs
Server
Java SDK
Java Samples
Go SDK
Go Samples
Helm Chart

Docker images for this alpha release (use tag 0.21.1):

Server
Server With Auto Setup
CLI (tctl)
Admin-Tools

Things we are still working on

1. We are still working and cleaning some internal API contracts. So more breaking changes are coming. So please don't use this for production setup yet.
2. Stress and Performance testing.

Alpha release for Temporal Server.

Release Highlights

1. Temporal Web is now supported to work this release
2. Renamed Domain to Namespace
3. Simplified getting started experience to have docker pre baked with 'default' namespace
4. Use standard grpc health service endpoint
5. Other internal renaming

Helpful links to get you started with Temporal

Temporal Docs
Server
Java SDK
Java Samples
Go SDK
Go Samples
Helm Chart

Docker images for this alpha release (use tag 0.21.0):

Server
Server With Auto Setup
CLI (tctl)
Admin-Tools

Things we are still working on

1. We are still working and cleaning some internal API contracts. So more breaking changes are coming. So please don't use this for production setup yet.
2. Stress and Performance testing.

First alpha release for Temporal Server.

Release Highlights

1. Service contract is now protobuf over gRPC. Clients should be able to talk to temporal using native gRPC.
2. Thrift completely removed and protobuf payload goes all the way to database.
3. Ringpop bootstrap is removed and now cluster is bootstrapped through database.
4. Configuration cleanup.
5. Significantly improved SDK experience for both Java and Go.
6. Many critical fixes to Server, Go and Java SDKs.

Helpful links to get you started with Temporal

Temporal Docs
Server
Java SDK
Java Samples
Go SDK
Go Samples
Helm Chart

Docker images for this alpha release (use tag 0.20.0):

Server
Server With Auto Setup
CLI (tctl)
Admin-Tools

Things we are still working on

1. We are still working and cleaning some internal API contracts. So more breaking changes are coming. So please don't use this for production setup yet.
2. Stress and Performance testing.

This is the last release which exposes Thrift endpoints. Use it for old clients and backward compatibility checks.