/temporal

Temporal service and CLI

Primary LanguageGoMIT LicenseMIT

Build status Coverage Status Discourse

Temporal

Temporal is a microservice orchestration platform which enables developers to build scalable applications without sacrificing productivity or reliability. Temporal server executes units of application logic, Workflows, in a resilient manner that automatically handles intermittent failures, and retries failed operations.

Temporal is a mature technology, a fork of Uber's Cadence. Temporal is being developed by Temporal Technologies, a startup by the creators of Cadence.

Temporal

Learn more about Temporal at docs.temporal.io.

Getting Started

Download and Start Temporal Server Locally

Execute the following commands to start a pre-built image along with all the dependencies.

$ git clone https://github.com/temporalio/docker-compose.git
$ cd docker-compose
$ docker-compose up

Refer to Temporal docker-compose repo for more advanced options.

Run the Samples

Clone or download samples for Go or Java and run them with the local Temporal server. We have a number of HelloWorld type scenarios available, as well as more advanced ones. Note that the sets of samples are currently different between Go and Java.

Use CLI

Use Temporal's command line tool tctl to interact with the local Temporal server.

$ alias tctl="docker exec temporal-admin-tools tctl"
$ tctl namespace list
$ tctl workflow list

Use Temporal Web UI

Try Temporal Web UI by opening http://localhost:8088 for viewing your sample workflows executing on Temporal.

Repository

This repository contains the source code of the Temporal server. To implement Workflows, Activities and Workers, use Go SDK or Java SDK.

Contributing

We'd love your help in making Temporal great. Please review our contribution guide.

If you'd like to work on or propose a new feature, first peruse feature requests and our proposals repo to discover existing active and accepted proposals.

Feel free to join the Temporal Slack channel to start a discussion or check if a feature has already been discussed. Once you're sure the proposal is not covered elsewhere, please follow our proposal instructions or submit a feature request.

License

MIT License