Release Highlights

This release includes a few patches improving the overall stability of the Temporal service

• Fix for potential data race for the describe mutable state API (#1360)
• Fix for potential data race for history service task processing (#1386)

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.6.5)

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

Release Highlights

This release includes a patch for an issue found in Cassandra persistence, which can lead to workflow history corruption.
Bugfix PR: #1187.

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.5.6)

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

Release Highlights

This release includes a patch for an issue found in Cassandra persistence, which can lead to workflow history corruption.
Bugfix PR: #1187.

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.4.4)

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

Release Highlights

This release includes a patch for an issue found in Cassandra persistence, which can lead to workflow history corruption.
Bugfix PR: #1187.

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.3.3)

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

Release Highlights

This release includes a patch for an issue found in Cassandra persistence, which can lead to workflow history corruption.
Bugfix PR: #1187.

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.2.3)

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

Release Highlights

This release includes a patch for an issue found in Cassandra persistence, which can lead to workflow history corruption.
Bugfix PR: #1187.

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.1.2)

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

Release Highlights

This release includes a patch for an issue found in Cassandra persistence, which can lead to workflow history corruption.
Bugfix PR: #1187.

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.0.1)

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

Release Highlights

This release includes a patch for an issue found in non-Kafka visibility queue implementation.
For details see: #1287.

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.6.4)

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

Release Highlights

This release includes a patch for an issue found in non-Kafka visibility queue implementation.
For details see: #1287.

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.5.5)

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

Release Highlights

This release includes two patches:

1. Server docker image can't start if it is configured to use Elasticsearch (ENABLE_ES is true). You are not affected if you don't use Elasticsearch. Check #1239 for details.
2. Kafka config is not required if visibility queue is set to internal. You are not affected if you are ok to keep kafka section in your static config. Check #1238 for details.

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.6.3)

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

Release Highlights

This release includes a patch for an issue found in Kafka deprecation logic. If you are not using Kafka or don't plan to migrate out of it with 1.6.x release you are not affected.
For details see: #1229

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.6.2)

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

Release Highlights

This release includes a patch for an issue found in Kafka deprecation logic. If you are not using Kafka or don't plan to migrate out of it with 1.5.x release you are not affected.
For details see: #1229

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.5.4)

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

Release Highlights

This release includes a patch for an issue found in infinite timeout feature
For details see: #1220

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.6.1)

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

Release Highlights

This release includes a patch for an issue found in infinite timeout feature
For details see: #1220

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.5.3)

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

Release Highlights

This release includes a patch for an issue found in infinite timeout feature
For details see: #1220

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.4.3)

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

Release Highlights

• Kafka deprecation: Internal queues are now being used for visibility in a dual processor mode. See details below.
• Bug fixed: When using Cassandra persistence, there was an issue that could have lead to Workflow creation without an initial event.
• Other small bug fixes and refactors: See change details.

Deprecate Kafka

UPDATE: Please use v1.6.4 release to migrate out of Kafka.

This release uses internal visibility queues by default, instead of Kafka. New visibility updates will go to the internal visibility queue but the Kafka processor will still be running in order to process previously created messages. This change will provide a smooth migration (no action required) to the internal visibility queue even if you didn't follow the upgrade steps from the previous v1.5.0 release.

In the next release all remaining Kafka code will be completely removed.

Change details

2020-12-23 - 20f01da3c - Use common rate limiter implementations (#1125)
2020-12-23 - 86ac8dd0b - Refactor rate limiter (#1118)
2020-12-23 - 8e4ba6d05 - Add multi-stage throttler (#1122)
2020-12-23 - ca62d18d5 - Deprecate Kafka for NDC path (#1126)
2020-12-28 - e31771c8d - Remove unused ResetWorkflowExecution in DB layer (#1137)
2020-12-29 - 4766eed4e - Bugfix: infinite timeout for SDK compatibility (#1141)
2020-12-29 - 6494477fe - Update API and SDK (#1128)
2020-12-30 - 09e7d7943 - Remove tools from go.mod dependencies (#1143)
2020-12-30 - 4d935f376 - Fix db scan admin command (#1147)
2020-12-30 - 8217f3163 - Add authorization header to context (#1144)
2020-12-30 - 95c6b9a42 - Deprecate mutable state branch token (#1145)
2020-12-30 - f28f51cef - Switch visibility queue to dual processor mode (#1146)
2020-12-31 - 2738ee974 - Refactor Cassandra sessions management (#1148)
2021-01-04 - 59876863c - Switch ES mocks to gomock (#1158)
2021-01-05 - d78c0cfe6 - Parallelizes instantiation of connections to data and visibility stores #1160
2021-01-06 - cad8072d8 - Update Go SDK to 1.3.0 (#1161)
2021-01-07 - b3b3e7b5a - Add Elasticsearch v7 support (#1164)
2021-01-07 - f6dee18e6 - Await Cassandra schema agreement when modifying schema (#1167)
2021-01-08 - 29b5fedcd - Adds ALPN support for "h2" protocol
2021-01-11 - b9b80cf81 - Add scanning for corrupt ActivityIds to tctl scan(#1155)
2021-01-12 - b32ddb092 - Drop database/keyspace if exists (#1181)
2021-01-12 - b8667fde3 - Add 'admin decode proto' and 'admin decode base64' commands (#1180)
2021-01-14 - 39c85db79 - Bugfix: AppendHistoryNodes return error not correctly set (#1187)
2021-01-14 - d8c74c925 - Add ServiceResolver interface and corresponding ServerOption (#1188)
2021-01-14 - fad7c4396 - Update Cassandra cli consistency settings (#1189)
2021-01-15 - c38d8fcc6 - Better retry policy when loading timer tasks (#1193)
2021-01-16 - 38c51a43b - Add force flag to drop command of database tools (#1196)
2021-01-18 - 0070bf06f - Add option to disable visibility queue processor (#1198)
2021-01-18 - 7d29b5436 - Decrease list visibility requests log level to Debug (#1199)
2021-01-19 - 1ed8d9bfa - Fix nil response within admin handler (#1202)
2021-01-19 - ac3990909 - Add extra protection logic to passive task processing (#1201)
2021-01-20 - 0eefdbca7 - Fix duplication handling in ES processor (#1205)
2021-01-20 - d65b356d5 - Sync non-ES and ES dynamic configs (#1200)
2021-01-20 - e5956ca6f - Remove visibility sampling for ES (#1204)
2021-01-21 - 1428a3da3 - Set default ES bulk processor ack timeout to 1 minute (#1210)
2021-01-21 - b46fbe3f0 - Add ES logger (#1209)

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.6.0)

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

Release Highlights

This release includes a patch for an issue found in new visibility queue processor logic (you are not affected if you are not using Elasticsearch or use it with Kafka). For details see: #1205, #1210.

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.5.2)

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

Release Highlights

This release includes a patch for an issue found in infinite timeout feature
For details see: #1141

Helpful links to get you started with Temporal

Temporal Docs
Server
Docker Compose
Helm Chart

Docker images for this release (use tag 1.5.1)

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

Release Highlights

This release includes a patch for an issue found in infinite timeout feature
For details see: #1141

Helpful links to get you started with Temporal

Temporal Docs
Server
Helm Chart

Docker images for this release (use tag 1.4.2)

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

Release Highlights

• The use of Kafka for visibility has been deprecated.
• Authorization code improvements and refactors.
• Small bug fixes.

Schema changes

This release includes schema changes.
Before upgrading your cluster, run the schema tool and upgrade your schema to support version 1.3. 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.

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

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

Deprecate Kafka

UPDATE: Please use 1.5.5 release to migrate out of Kafka.

Because the use of Kafka is deprecated for visibility, to upgrade to this release in a backward compatible way you must perform the following steps:

1. Rollout this release and make sure everything works.
2. Add the following to your dynamic config and then perform a rolling restart:

history.visibilityQueue:
    - value: "internalWithDualProcessor"
      constraints: {}

3. Wait for the Kafka visibility queue to drain. You may monitor the Kafka backlog, but 10 minutes should be enough.
4. Change the history.visibilityQueue dynamic config value from internalWithDualProcessor to internal:

history.visibilityQueue:
    - value: "internal"
      constraints: {}

5. Perform another rolling restart.
6. Kafka and zookeeper are no longer used, and can be removed from the setup.

If it is acceptable to lose some visibility messages you may set the dynamic config value to internal right away or wait for the next release where the default value will be internal.

Change details

2020-12-08 - c96de9445 - Adjust MySQL binary data upper size limit (#1056)
2020-12-09 - 32924ef34 - Add visibility tasks table for SQL (#1055)
2020-12-09 - 650beab52 - Use valid input for wfClient.GetSearchAttributes (#1067)
2020-12-09 - f67c31b0d - Finish migration of infinite workflow timeout (#1030)
2020-12-10 - 857c4d3dd - Properly handle infinite activity timeout for SDK (#1073)
2020-12-10 - ad093b364 - Add explicit TLS settings for system workers while also supporting legacy config (#1059)
2020-12-10 - fab8274e0 - Bugfix: infinite timeout feature with activity & workflow retry (#1071)
2020-12-11 - 2eb150246 - Add checks for nil claims to defaultAuthorizer (#1074)
2020-12-11 - 55881bf0b - Replace Kafka for visibility with internal VisibilityQueue (#988)
2020-12-11 - 9ba849a7d - Adds log whenever we fetch bootstrap hosts for Ringpop from DB (#1076)
2020-12-11 - 9f720f732 - Wire visibility tasks for SQL (#1083)
2020-12-14 - 1abde2a4d - Correctly config ES for history service (#1094)
2020-12-14 - 61d9f53fc - Add CLI command to check cluster health (#1091)
2020-12-14 - 7cb19f6f1 - Correctly config ES for frontend service (#1095)
2020-12-14 - aec399607 - Enable gRPC reflection for frontend service (#1089)
2020-12-14 - bdddc305a - Add add tasks API to DB layer (#1092)
2020-12-14 - e8f44af43 - Optimize delete visibility task (#1093)
2020-12-15 - e23283259 - Use local quorum for Cassandra when querying schema version (#1099)
2020-12-15 - e5c28cf02 - Notify new task in shard context (#1097)
2020-12-15 - ff39007e9 - Add enforcement of namespace match for async completion tokens (#1086)
2020-12-16 - 16cd5400c - Replace bool visibility queue dynamic configs with single string config (#1104)
2020-12-16 - 71499bf7c - Switch to using jose.JSONWebKeySet for parsing JWKS (#1101)
2020-12-16 - df20c7f29 - Add proper index to SQL visibility store (#1107)
2020-12-17 - 21efba4a6 - Add Prometheus to development dependencies (#1111)
2020-12-17 - 82ce0b4af - Add support for EC JWT keys (#1108)
2020-12-17 - a92e09bc9 - Log details of authorization errors and return a generic unauthorized error to the caller (#1110)
2020-12-17 - ec1de6438 - Properly handling task queue lease expiration (#1112)
2020-12-17 - f73e73c1a - Fix typo on availability zone env key (#1109)
2020-12-18 - 91e06262a - Use Prometheus as default metrics provider for all configs (#1116)
2020-12-18 - 9cb819d81 - Add support for extra authorization data (#1113)
2020-12-19 - 1df7e31bc - Fix ES processor metrics (#1117)
2020-12-21 - 423adbc8b - Make metric ids globally unique (#1124)
2020-12-21 - 77acf2c46 - Fix authorization metrics scope (#1123)
2020-12-21 - 81de03db8 - Start Kafka producer in dual mode (#1121)

Helpful links to get you started with Temporal

Temporal Docs
Server
Helm Chart

Docker images for this release (use tag 1.5.0)

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