As of December 13, 2023, Netflix has discontinued maintenance of Netflix Conductor OSS on GitHub. This is a fork of the original project maintained by Swift Software Group.
We (Swift Software Group) are working on getting everything up and running again. Things may be broken here and there while we are in the middle of this transition.
Conductor is a platform for orchestrating workflows that span across microservices.
Conductor supports creating workflows using JSON and Code. SDK support for creating workflows using code is available in multiple languages and can be found at:
- Swift Conductor Client SDK for Python
- Swift Conductor Client SDK for .NET
- Swift Conductor Client SDK for Java
- Swift Conductor Client SDK for Go
- Swift Conductor Client SDK for TypeScript / JavaScript
The modules contributed by the community are housed at conductor-community. Compatible versions of the community modules are released simultaneously with releases of the main modules.
Discussion Forum: Please use the forum for questions and discussing ideas and join the community.
List of Conductor community projects: Backup tool, Cron like workflow starter, Docker containers and more.
The easiest way to get started is with Docker containers. Please follow the instructions here.
Conductor Server is a Spring Boot project and follows all applicable conventions. See instructions here.
Latest release binaries are available from the Maven Central Repository: com.swiftconductor.conductor.
Latest snapshot binaries are available from the Maven Snapshot Repository.
See OSSRH Usage Notes for details.
Artifact | Description |
---|---|
conductor-common | Common models used by various conductor modules |
conductor-core | Core Conductor module |
conductor-rest | Spring MVC Rest API |
conductor-server | Spring Boot Web Application |
conductor-grpc | Protobuf models used by the server and client |
conductor-grpc-server | gRPC server Application |
conductor-http-task | Workflow system task implementation to send make requests |
conductor-json-jq-task | Workflow system task implementation to evaluate JSON using jq |
conductor-redis-lock | Workflow execution lock implementation using Redis |
conductor-redis-persistence | Persistence and queue using Redis / Dynomite |
conductor-cassandra-persistence | Persistence using Cassandra |
conductor-es6-persistence | Indexing using Elasticsearch 6.X |
conductor-awss3-storage | External payload storage implementation using AWS S3 |
conductor-awssqs-event-queue | Event queue implementation using AWS SQS |
Artifact | Description |
---|---|
conductor-ui | Web UI / React App |
conductor-client | Java Client that includes helpers for running workers |
conductor-client-spring | Java Client Starter Kit for Spring |
conductor-grpc-client | Java gRPC client to interact with the gRPC server |
conductor-java-sdk | Java SDK for writing workflows in code |
conductor-test-e2e | Integration and regression tests |
- The default persistence used is Redis
- The indexing backend is Elasticsearch (6.x)
- JDK 17+
- UI requires Node 14 to build. Earlier Node versions may work but is untested.
Get in touch with us:
Whether it is a small documentation correction, bug fix or a new feature, contributions are highly appreciated. We just ask you to follow standard OSS guidelines. The Discussion Forum is a good place to ask questions, discuss new features and explore ideas. Please check with us before spending too much time, only to find out later that someone else is already working on a similar feature.
main
branch is the current working branch. Please send your PR's to main
branch, making sure that it builds on your local system successfully. Also, please make sure all the conflicts are resolved.
Copyright 2023 Swift Software Group, Inc.
(Code and content before December 13, 2023, Copyright Netflix, Inc.)
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.