Armada is an experimental application to achieve high throughput of run-to-completion jobs on multiple Kubernetes clusters.
It stores queues for users/projects with pod specifications and creates these pods once there is available resource in one of the connected Kubernetes clusters.
- Armada maintains fair resource share over time (inspired by HTCondor priority)
- It can handle large amounts of queued jobs (million+)
- It allows adding and removing clusters from the system without disruption
- By utilizing multiple Kubernetes clusters, the system can scale to larger amounts of nodes beyond the limits of a single Kubernetes cluster
Queue: Represent user or project, used to maintain fair share over time, has priority factor
Job: Unit of work to be run (described as Kubernetes PodSpec)
Job Set: Group of related jobs, api allows observing progress of job set together
Prequisites: Git, Go and Docker installed. Ensure the current user has permission to run the docker
command.
- Clone repository & build
git clone https://github.com/G-Research/armada.git
cd armada
make build
- Get kind
go get sigs.k8s.io/kind
- Create 2 kind clusters
kind create cluster --name demoA --config ./example/kind-config.yaml
kind create cluster --name demoB --config ./example/kind-config.yaml
- Start Redis
docker run -d --expose=6379 --network=host redis
- Start server in one terminal
./bin/server
- Start executors for each cluster each in separate terminal
KUBECONFIG=$(kind get kubeconfig-path --name="demoA") ARMADA_APPLICATION_CLUSTERID=demoA ARMADA_METRICSPORT=9001 ./bin/executor
KUBECONFIG=$(kind get kubeconfig-path --name="demoB") ARMADA_APPLICATION_CLUSTERID=demoB ARMADA_METRICSPORT=9002 ./bin/executor
- Create queue, submit jobs and watch progress
./bin/armadactl create-queue test --priorityFactor 1
./bin/armadactl submit ./example/jobs.yaml
./bin/armadactl watch job-set-1