Release Highlights

This release includes a patch for an issue found in infinite timeout feature, i.e. allowing not setting certain timeout: (https://github.com/temporalio/temporal/releases/tag/v1.4.0).
For details see: #1071 #1073

NOTE: Infinite timeout feature will be the default behavior beginning from v1.5.x

The infinite timeout functionality is by default disabled for forward / backward compatibility.
When deploying a brand new v1.4.x Temporal service, user can set "system.enableInfiniteTimeout" to be true.
When upgrading to v1.4.x Temporal service, user must first deploy the v1.4.x service, then set "system.enableInfiniteTimeout" to be true.

1. In terms of workflow execution timeout (across multiple continue as new / retry runs), setting the WorkflowExecutionTimeout parameter to 0 means no timeout for workflow execution
2. In terms of workflow run timeout (per run ID), setting the WorkflowRunTimeout parameter to 0 means no timeout for this workflow run
3. Additional checks from server logic will guarantee that
   a. when WorkflowExecutionTimeout > 0 && WorkflowRunTimeout > 0 => WorkflowRunTimeout <= WorkflowExecutionTimeout
   b. when WorkflowExecutionTimeout > 0 && WorkflowRunTimeout == 0 => WorkflowRunTimeout = WorkflowExecutionTimeout
   c. when WorkflowExecutionTimeout == 0 => no restriction on WorkflowRunTimeout
4. Activity schedule to start / schedule to close timeout can also be 0 (no timeout) if workflow run timeout is 0 (no timeout)

Helpful links to get you started with Temporal

Temporal Docs
Server
Helm Chart

Docker images for this release (use tag 1.4.1)

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

UPDATE: We have discovered some issue related to v1.4.0 release regarding the infinite timeout feature, please use v1.4.1 instead.

NOTE: The infinite timeout feature is by default disabled for v1.4.x.

Release Highlights

This release contains refactoring, optimizations, bug fixes, metric fixes, support for signed requests to AWS Elastic Search, and significant enhancements to Temporal's Authorization story.

Notable Changes

Persistence Schema:
This release updates the current Persistence store schema. Be sure to upgrade your schema (target version 1.2) before upgrading to the latest server bits.

Authorization:
This release includes a set of features and improvements for authorization. Notably, ClaimMapper and Authorizer plugin interfaces with the corresponding server options for configuring them. This enables a range of authorizations scenarios based on JWT tokens and Mutual TLS certificates. defaultJWTClaimMapper and defaultAuthorizer are included as fully functional examples that can be used as is, or customized for specific use cases. Documentation is in progress.

Change details

2020-11-11 - 62efe4c9 - Add context to all SQL interfaces (#980)
2020-11-11 - 648016b8 - NoSQL / SQL specific changes for messages, part 3 (#962)
2020-11-11 - 7ad94fc4 - Use latest sqlx and dependencies & update SQL max conn config (#951)
2020-11-11 - 7bfb0c47 - Rename RetryReplication in proto (#975)
2020-11-11 - a07f053e - Increase frontend list operation QPS to 30 (#968)
2020-11-11 - c3beeb21 - Allow multiple deleted to DB within one transaction (#970)
2020-11-11 - ce573363 - Refactor replication task fetcher (#966)
2020-11-11 - ddbf982c - NoSQL / SQL specific changes for messages, part 4 (#979)
2020-11-12 - aee20037 - Adds ability to serve different TLS certificates and verify different sets of ClientCert CAs from the same Temporal Cluster (#981)
2020-11-12 - ebbbff03 - Preload config before setting server options, so that they can get configured (#985)
2020-11-16 - 05163352 - Add PostgreSQL to tctl admin commands (#1002)
2020-11-16 - 254c2015 - Update stale dynamic config (#999)
2020-11-16 - 31901398 - Fix nil execution stats dereference (#997)
2020-11-16 - 430daa82 - Remove unused ES fields (#991)
2020-11-16 - 7ea6f624 - Pass LastCompletionResult to next run on workflow timeout (#993)
2020-11-16 - 873b510d - Optimize SQL layer supporting batch delete (#982)
2020-11-16 - a9eed10c - Refactor replication task executor (#1001)
2020-11-16 - c11b82e6 - Update NDC sync activity logic & unit test (#974)
2020-11-17 - 766e8907 - Update yaml property name after renaming Security -> Authorization (#1006)
2020-11-17 - da08b3b7 - Authorization for JWT tokens (#986)
2020-11-18 - 622852f5 - Refactor replication task processor (#1005)
2020-11-18 - 795c0b62 - Adds ability to connect to Kafka Cluster via SASL SCRAM (SHA256/SHA512) mechanism (#1009)
2020-11-18 - def2f0bb - Bugfix: replication DLQ handler mem allocation (#1007)
2020-11-18 - fdad95f8 - Adds support for configuring AWS ElasticSearch request signing (#1011)
2020-11-19 - 9078e7b6 - Update replication fetcher & processor (#1010)
2020-11-19 - cec61a93 - Fix broken DescribeHistoryHost API / CLI (#1013)
2020-11-20 - 812d3f36 - Remove forced namespace cache refresh (#1014) (#1016)
2020-11-23 - afd2c291 - Fix typo in json name attribute (#1022)
2020-11-23 - ecade6e6 - Add TLS connection info to AuthInfo (#1020)
2020-11-24 - 7756ff9f - Perf optimization for NDC (#1019)
2020-11-24 - b168c38b - Set workflow start time within business logic (#1025)
2020-11-24 - b88ecb12 - Optimize activity / user timer creation (#1023)
2020-11-25 - 3e11440d - Allow to specify custom metrics reporter (#1015)
2020-11-25 - a6ce2f45 - Use proper context deadline when pushing activity to matching (#1031)
2020-11-25 - c85a1f09 - Ensure version history values are copied (#1029)
2020-11-26 - e278150d - Use github.com/go-sql-driver/mysql v1.5.0 (#1032)
2020-11-30 - 2b63e6f5 - Allow workflow timeout being infinite (#995)
2020-11-30 - 4282cf30 - Fix namespace registration response (#1034)
2020-12-01 - 2bdda518 - Add integration tests for cron workflow failures (#994)
2020-12-01 - 94a500e6 - Fix broken admin dlq CLI (#1038)
2020-12-01 - c5d0144c - Make entity with Start / Stop functions idempotent (#1037)
2020-12-02 - b0c5e6b7 - Adjust RPC replication config (#1039)
2020-12-02 - dfaf475f - Fix PostgreSQL EnableHostVerification behavior (#1048)
2020-12-03 - 1ac19c15 - Bugfix: messaging client not set when advanced visibility is used (#1053)
2020-12-03 - 58d75ffc - Adjust GetHistoryMaxPageSize default size (#1049)
2020-12-03 - 72b9a40a - Do not validate Kafka config if RPC replication stack is used (#1051)
2020-12-03 - 7f9e1c63 - Unify active logic workflow start time vs start event time (#1042)
2020-12-03 - f4cda392 - Allow concurrent fetching replication tasks (#1040)
2020-12-04 - 880287fa - Patch metrics reported with different tags. (#1050)
2020-12-04 - f6693f67 - Fix: history_size and event_blob_size metrics should have same tags (#1054)
2020-12-08 - c96de944 - Adjust MySQL binary data upper size limit (#1056)

Helpful links to get you started with Temporal

Temporal Docs
Server
Helm Chart

Docker images for this release (use tag 1.4.0)

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

Release Highlights

This release includes a patch for an issue found in [1.3.1] (https://github.com/temporalio/temporal/releases/tag/v1.3.1).
For details: #1014

Helpful links to get you started with Temporal

Temporal Docs
Server
Helm Chart

Docker images for this release (use tag 1.3.2)

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

Release Highlights

This release includes a patch for an issue found in [1.2.1] (https://github.com/temporalio/temporal/releases/tag/v1.2.1).
For details: #1014

Helpful links to get you started with Temporal

Temporal Docs
Server
Helm Chart

Docker images for this release (use tag 1.2.2)

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

Release Highlights

This release includes a patch for an issue found in 1.3.0.

If you are upgrading from a version older than 1.0.0, use this release (1.3.1) instead of 1.3.0.

Helpful links to get you started with Temporal

Temporal Docs
Server
Helm Chart

Docker images for this release (use tag 1.3.1)

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

UPDATE: If you are upgrading from a version older than 1.0.0, use 1.3.1 instead.

Release Highlights

This release contains configuration and API refactors and bug fixes.

Important:

1. The metrics configuration sections were moved from the per service configuration sections to the global section. This will set up a Prometheus listener only once per process (not per hosted service). The old metrics section is still supported but deprecated and will be removed later.
2. The DescribeMutableState API response for adminservice was changed from JSON to Protobuf. This is a breaking change for this API, but it is only being used by the tctl admin command. This means that some admin commands from the previous tctl versions won't work with this server version and vice versa.

Change details

2020-10-27 - b47c5449d - Update local namespace workflows to use version history (#910)
2020-10-27 - c2056ba1f - Adds templatization for gRPC and membership ports exposed by Temporal #905
2020-10-27 - da73216d3 - Set MinConnectTimeout to 20 seconds (#912)
2020-10-27 - e7ef1ea91 - Fix cockroach config (#909)
2020-10-27 - e8598abd5 - Makes TaskType constraint in dynamic configuration optional when specifying Task Queue Partitions #904
2020-10-27 - f39f62a59 - Adds support for differing gRPC ports for the same temporal service on a deployed cluster (#913)
2020-10-28 - 0cbd5f8e5 - Add global.metrics section and deprecate service.metrics (#915)
2020-10-28 - 571c1c092 - Refactor history service event notifier (#917)
2020-10-28 - 8ebb5dbd8 - Refactor history service for event cache (#916)
2020-10-28 - d280cc1db - Remove NilCheckHandler (#902)
2020-10-28 - ff1b92aea - Fixed a bug that may lead to masking of errors (#919)
2020-10-29 - 1f1fac492 - Change DescribeMutableState API to proto (#901)
2020-10-29 - 78df3471e - Refactor history service config (#918)
2020-10-30 - 407734a73 - Increases number of go-routines that acquire history shards #930
2020-10-30 - 9e4cbf7f7 - Fix dynamic config loging (#932)
2020-10-30 - b82700587 - Refactor history service shard & engine (#923)
2020-10-30 - c414a273d - Update gRPC library (#929)
2020-10-31 - 84d756c9f - Adds support for passing in custom scheme, port, username and password to config-template (#936)
2020-10-31 - adf5a600e - Use filter struct instead of pointer for matching SQL layer (#934)
2020-10-31 - c75d8be07 - Replace accessControlHandler with authorization interceptor (#925)
2020-11-02 - 9b6c58749 - Bugfix: matching persistence layer update sticky task queue (#935)
2020-11-02 - dfb9ba512 - Enable NetworkTopologyStrategy for cassandra (#938)
2020-11-03 - 3c15ff038 - Fix PATH variable on MacOS (#949)
2020-11-03 - 48f13023c - Refactor versionhistories package (#920)
2020-11-04 - 08c38f281 - Improve matching error handling (#953)
2020-11-04 - d74c2903d - Make workflow cancellation idempotent (#952)
2020-11-05 - 4173272af - Remove unused cause / reason from cancel workflow (#957)
2020-11-05 - d90f4e002 - Update NDC default config (#956)

Helpful links to get you started with Temporal

Temporal Docs
Server
Helm Chart

Docker images for this release (use tag 1.3.0)

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

Release Highlights

This release adds official support for PostgreSQL v9.6 in Temporal.

Notable changes

2020-10-27 - c87f1563d - Bugfix SQL 1.1 schema change (#907)
2020-10-26 - 1eafb88f1 - Fixes Dynamic Configuration bug where TaskType Constraint match always failed (#898)
2020-10-22 - c45ad9105 - Add an option to tctl to override server name for TLS host verification (#889)
2020-10-21 - 9e3ed33b5 - Adds check-health command to temporal-cassandra-tool and switches start.sh to use that instead of cqlsh (#885)
2020-10-21 - 60f5a30a5 - Enables Cassandra auto-setup to specify username, password, port and TLS (#882)
2020-10-19 - ec220ca05 - Cherry pick #3627 from Cadence (#839)
2020-10-19 - f3e0b03c4 - Various TLS-related fixes (#874)
2020-10-16 - cf3a5f78d - Adds support for --tls_enable_host_verification as global option for TCTL (#873)
2020-10-16 - 7d065a206 - Exposes additional configuration knobs for TLS and updates docker-config so they can be set using env variables (#869)
2020-10-16 - 62c89e1b7 - Improve error handling (#870)
2020-10-15 - 27c7aa8b7 - Use go 1.15 (#867)
2020-10-15 - 548af4717 - Suppress noisy timer related log (#860)
2020-10-15 - b25bd3daf - Add protection on namespace cache in case namespace is not created (#824)
2020-10-15 - c32bb17b3 - Adding admin command for retrieving cluster metadata (#865)
2020-10-15 - 27965f4a6 - Enable Temporal to startup even if Elastic Search is down (#866)
2020-10-15 - 764b9e479 - Update readme (#861)
2020-10-14 - d2d09b6dc - Update PostgreSQL TLS config (#853)
2020-10-13 - 07a3a6338 - Add TLS configuration for PostgreSQL (#849)

Helpful links to get you started with Temporal

Temporal Docs
Server
Helm Chart

Docker images for this release (use tag 1.2.1)

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

Release Highlights

This is hotfix for v1.1.0 release. Please use it instead of v1.1.0.

Change details

2020-10-20 - 6c6c87b5 - Hotfix SERVICES env
2020-10-20 - 7bf6bea7 - Fix the bug with 1.1 startup on Mysql after the upgrade (#879)

Helpful links to get you started with Temporal

Temporal Docs
Server
Helm Chart

Docker images for this release (use tag 1.1.1)

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

UPDATE: This release has few bugs, please use v1.1.1 instead.

Release Highlights

This release includes schema changes.
Before upgrading your cluster, run the schema tool and upgrade your schema to support version 1.1
For MySQL databases use: temporal-sql-tool, for Cassandra use temporal-cassandra-tool.

Below are a few examples that show how to upgrade "default" and "visibility" schemas for Cassandra.

Run these commands if you "bring your own" database.

Default:

temporal-cassandra-tool --tls --tls-ca-file $TLS_CA_FILE --user $CASSANDRA_USER --password $CASSANDRA_PASSWORD \
		--endpoint $CASSANDRA_ENDPOINT --keyspace temporal --timeout 120 update --schema-dir ./schema/cassandra/temporal/versioned

Visibility:

temporal-cassandra-tool --tls --tls-ca-file $TLS_CA_FILE --user $CASSANDRA_USER --password $CASSANDRA_PASSWORD \
		--endpoint $CASSANDRA_ENDPOINT --keyspace temporal_visibility --timeout 120  update --schema-dir ./schema/cassandra/visibility/versioned

Run these commands if you have a localhost installation:

Default:

temporal-cassandra-tool --keyspace temporal update -schema-dir schema/cassandra/temporal/versioned

Visibility:

temporal-cassandra-tool --keyspace temporal_visibility update -schema-dir schema/cassandra/visibility/versioned

Let us know how you use it: https://community.temporal.io/

Change details

2020-10-01 - 4e9f18ed - Add ability to specify client certificate and associated private key via base64 values in config (#782)
2020-10-01 - 94c4beda - Add TLS settings to config_template.yaml (#783)
2020-10-02 - 20515851 - Convert int/int64 timestamps to time.Time (#786)
2020-10-05 - 0399b19b - Make marker event payloads readable in cli (#794)
2020-10-05 - 1bbdee56 - Enable support for ScyllaDB #801
2020-10-05 - c2d50b8c - Make upsert event payload readable in cli (#797)
2020-10-07 - b63d577e - Adding mutable metadata and cluster id (#803)
2020-10-08 - cd1e4668 - Add support for TLS and mTLS to tctl (#812)
2020-10-09 - 0531c951 - Adding automated version check on server (#823)
2020-10-10 - 32d6a921 - Extract server struct and add server options (#826)
2020-10-12 - 490d2faa - Cluster metadata api (#835)
2020-10-12 - 505f876d - Add a server option for setting authorizer (#829)
2020-10-12 - 84053ea5 - Enforce minimum TLS version of 1.2 (#831)
2020-10-12 - 88f9dddb - Improve test stability (#838)
2020-10-12 - 9c8813b3 - Add server option for overriding default TLS config provider (#830)
2020-10-12 - abf57796 - Reduce redundant history tree creation for workflow reset (#825)
2020-10-12 - e30f9f3b - Connect ElasticSearch with username and password (#833)
2020-10-13 - 5a28408e - Remove unused config (#847)

Helpful links to get you started with Temporal

Temporal Docs
Server
Helm Chart

Docker images for this release (use tag 1.1.0)

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

Notes

This release introduced version info check feature that periodically checks most recent version of temporal in order to provide upgrade recommendations. If you would like to disable this feature either set TEMPORAL_VERSION_CHECK_DISABLED=1 or set frontend.enableServerVersionCheck dynamic config property to false.

Release Highlights

v1.0.0 is Temporal's first production ready release!

Let us know how you use it: https://community.temporal.io/

Change details

No new bugs have been found since v1.0.0-rc1.

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 release (use tag 1.0.0)

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

Release Highlights

v1.0.0-rc1 is undergoing testing as a release candidate. Please do not use this release for production workloads.

The release improves the system by fixing the bugs described in the change details below.

Change details

2020-09-22 - 8c74aef76 - Remove JSON serialization option for persistence (#750)
2020-09-24 - 23e313d9a - Use time datatype instead of unix nano representation for archival (#757)
2020-09-24 - a94be76a4 - Fix default out-of-box experience for tctl batch commands (#758)
2020-09-24 - a97a0e6bd - Add message to Timeout failures (#756)
2020-09-24 - ce204a17a - History activity cancellation fixes (#760)
2020-09-25 - 09036fe31 - Add failure type info to tctl wf describe (#766)
2020-09-25 - 0d332edb8 - Fix history resender source cluster (#3365) (#767)
2020-09-25 - 1214ac0b4 - Remove timestamp rounding to avoid preliminary timer firing (#765)
2020-09-25 - 1b00d51fc - Do not extend activity expiration time (#3489)
2020-09-25 - 34ec7e250 - Enforce re-replication context timeout for standby tasks (#3473)
2020-09-25 - 3bdf1aaff - Change client/server version support (#761)
2020-09-25 - 41e1a3891 - Start queue processor before failover callback registration (#3494)
2020-09-25 - 4e14c2d6c - Adding replication task processing metrics (#3452)
2020-09-25 - 666dadb58 - removed current workflow CAS from persistence used by 2dc only (#755)
2020-09-25 - 711d4c18b - Enforce time resolution for timerMaxReadLevel (#3411)
2020-09-25 - 758432e24 - Fix code to be compatible with go 1.15.2 (#762)
2020-09-25 - 8fd6fd3ec - Sets default WorkflowExecutionTimeout and WorkflowRunTimeout on the request in FrontEnd. (#763)
2020-09-25 - 95261ce60 - Support NDC raw histroy in message parser (#3227)
2020-09-25 - 9f05b7456 - Tune dynamic config knobs
2020-09-25 - a2443d920 - Fix task processor shutdown logic (#3311)
2020-09-25 - a8e0f07dc - Fix upsert SQL template for Postgres plugin (#3498)
2020-09-25 - b331a4eb5 - Add a default timeout for get replication messages API (#3459)
2020-09-25 - c886a7e61 - Fix regression from #3489 merge
2020-09-25 - d066d27b4 - Reduce context timeout for transfer tasks (#3437)
2020-09-25 - d516b40bf - Update worker replication config (#3373)
2020-09-26 - 413102ae8 - Update contribution guide with a note about increasing file handle limit (#769)
2020-09-27 - 1410257d6 - Fix repo URLs in README.md
2020-09-27 - 606faf5b8 - Fixes instances where an activity heartbeat timeout would get "lost" (#771)
2020-09-28 - aa15e3b7b - Add instructions for developing on Windows to the contribution guide (#770)

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 release candidate (use tag 1.0.0-rc1)

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

Release Highlights

v0.31.0 maintains Temporal's "Alpha" release state. Please do not use this release for production workloads.

Important
This release contains hotfixes. The most critical one (#740) fixes an issue that prevented the server from spinning up multiple times via docker-compose.

Change details

2020-09-19 - 197b2525b - Fix install-schema target (and docker image) idempotency (#740)
2020-09-19 - 2627df79c - Fix delete workflow execution admin command (#742)
2020-09-19 - 526beb5f0 - Temporary fix for WorkflowMutableState serialization (#739)
2020-09-21 - 53ef2b22f - Remove GetRawHistoryV1 api used for 2dc (#744)
2020-09-21 - d572abd06 - Force terminate workflow execution when exceeds system limit (#743)
2020-09-22 - 37ea46d27 - Prettify tctl workflow history export to file (#748)

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.31.0)

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

Things we are still working on

1. Stress and Performance testing.
2. Failure testing.

UPDATE: Due to #740 bug docker-compose version of the server can't be started more than once. Please use v0.31.0 instead.

Release Highlights

v0.30.0 maintains Temporal's "Alpha" release state. Please do not use this release for production workloads.

Important

1. You can not rollback to a previous version once you have upgraded to v0.30.0. Data that is created in v0.30.0 is not supported by older versions and you will get panic: runtime error: invalid memory address or nil pointer dereference when the service tries to start. Using an older version after the upgrade will require a fresh install.

2. After upgrading to v0.30.0 you can not call Reset on Workflows which were started with a previous version. However, you can still call Reset on Workflows that were started while running v0.30.0.

Change details

2020-08-25 - e9bb772ae - Remove Membership.Name config; Hardcode Ringpop app name (#688)
2020-08-26 - f210123eb - Disable trimming of Failure field (#693)
2020-08-27 - 96ca34e2f - Fixes bug where terminating a parent with a lot of child workflows that continue-as-new doesn't propagate terminate to children (#696)
2020-08-28 - 3f3dcced6 - Don't fail if schema_version and schema_update_history tables already exist (#697)
2020-09-01 - d95406a5c - Skip BufferedEvents persistence when empty (#707)
2020-09-02 - 50de8a2bc - Remove 2dc codepath (#692)
2020-09-02 - d86d7e259 - Expose SQL Connection Options in docker template (#708)
2020-09-04 - 02ab64cf1 - Fixes bug where the failure details were not persisted for a marker recorded event, which corrupts workflow on replay #712
2020-09-05 - 7f44f3405 - Fixes MySQL persistence for workflow reset (#713)
2020-09-08 - 99c40e26f - Update workflow resetter to call PersistNonFirstWorkflowEvents (#714)
2020-09-08 - e108bb9c7 - BufferedEvents Read Path Protections (#709)
2020-09-09 - 7ad07522f - Fix publicClient (#717)
2020-09-10 - 078e01f62 - Set Backoff.MaxDelay to 10 seconds (#720)
2020-09-10 - acbb6a505 - Fixes Internal Server Error returned on simultaneous SignalWithStart requests for the same WF ID (#719)
2020-09-10 - bddefb667 - Fix wrong field (#721)
2020-09-11 - faf2fe79a - WorkflowExecutionInfo Field Conversions (#715)
2020-09-15 - a09867d1f - Fixes blockage of Transfer Queue if UpsertSearchAttributes is invoked on a Temporal Server w/o Elastic Search (#727)

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.30.0)

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

Things we are still working on

1. Stress and Performance testing.
2. Failure testing.

Release Highlights

v0.29.0 maintains Temporal's "Alpha" release state.

Please do not use this release for production workloads.

Change details

2020-08-03 - e5e7846e - Convenience docker-compose file that enables one to deploy both MySQL and ElasticSearch in one box environment.
2020-08-04 - 0ae59f62 - Adds automatic population of unset retrypolicy field when starting Workflows (#654)
2020-08-04 - 34948aed - Upgrade Web UI to v0.28.1 (#657)
2020-08-04 - 36525fad - Replace time.Now() with time.Now().UTC() and time.Unix() with time.Unix().UTC() (#648)
2020-08-04 - a3d03348 - Permit Web to execute write requests by default (#656)
2020-08-04 - d6b4e745 - Fix namespace cache refresh errors in integration tests (#653)
2020-08-06 - eeb3e793 - Fix development_*.yml PublicClient/ClusterRpcAddress Ports (#650)
2020-08-09 - 91d8190a - Replace Insert Ignore in Execution (#658)
2020-08-10 - 04058a50 - Allow reset for workflow with corrupted history when possible (#661)
2020-08-11 - 1547d778 - Exit with error code when tests are failing (#669)
2020-08-11 - 2e47e403 - Use environment.GetCassandraPort() instead of defaultCassandraPort in tests (#660)
2020-08-11 - 993c06a6 - Remove unused yaml fields for logging (#667)
2020-08-11 - aabf3c88 - fix error message for the reset (#670)
2020-08-12 - 6164b918 - Support configurable PublicClient in docker config_template.yaml (#671)
2020-08-12 - e8e21a8b - Remove unused errors (#659)
2020-08-13 - 503f0376 - Support time.Time in MutableState#ActivityWithTimerHeartbeat methods (#666)
2020-08-13 - c551f216 - Allow workflow reset without run id (#672)
2020-08-13 - dbafe8ab - Reset for workflows without completed tasks (#665)
2020-08-17 - 15c8d047 - Update proto license header (#617)
2020-08-17 - d51ef552 - RespondWorkflowTaskCompleted returns error on bad commands (#655)
2020-08-18 - 2e1159f9 - Add config property for Cassandra connection timeout (#679)
2020-08-18 - fec152db - Allows terminate of child even after continue as new (#365)
2020-08-20 - 2a4449cc - Allow dynamic config editting outside of container when running docker-compose (#681)

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.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.