Skip to content
diamond_dragon edited this page Apr 14, 2021 · 7 revisions

What is CodeReview.Orchestrator?

CodeReview.Orchestrator is command line tool creating, executing and destroing Docker containers according to workflow defined by manifest.

Tools like Docker Swarm, Kubernetes, Docker Compose are suitable for orchestration of long-running Docker Images. Usually these images contain services \ web applications which run until container is terminated.

CodeReview.Orchestrator is different. Primary purpose of this tool is orchestration of containers containing command line tools. These containers are not executed to run for long time. One command line tool execution completed container stops. To some extent this kind of functionality can be found in Kubernetes if jobs are used.

CodeReview.Orchestrator uses YAML format to describe activities and their settings which need to be executed as part of workflow. I addition to container orchestration it's possible to create volumes which are mounted to each container. These volumes are used to share state between different containers. CodeReview.Orchestrator supports import and export of files and folders located on computer running this tool.

Main Terms

In order to understand available functionality number of terms needs to be defined and described:

  • Ochestrator is short name of CodeReview.Orchestrator tool.
  • Activity is Docker container which is single unit of workflow execution.
  • Volume is Docker volume which is mounted to each activity of workflow.
  • Requirement is tag or operating system associated with activity. Each activity might have any number of tags and only one operating system requirement. This information is used to find matching Docker engine.
  • Docker Engine is information about Docker API endpoints which can be used to execute workflow. Orchestrator supports workflows which use different Docker Engines for different activities. Volumes are exported and importer when Docker engine switch is detected during workflow execution.

These terms are used by documentation to describe details of workflow execution.

Execution Workflow Diagram

Simplified sequence diagram of execution workflow can be found beflow:

Execution Workflow

Demployment Model of CodeReview.Orchestrator

At the moment CodeReview.Orchestrator is availe in the following sources: