https://github.com/coreos/airlock

Minimal update/reboot orchestrator for Fedora CoreOS clusters
https://github.com/coreos/airlock

Last synced: 4 months ago
JSON representation

Minimal update/reboot orchestrator for Fedora CoreOS clusters

• Host: GitHub
• URL: https://github.com/coreos/airlock
• Owner: coreos
• License: apache-2.0
• Created: 2019-04-10T17:48:04.000Z (about 7 years ago)
• Default Branch: main
• Last Pushed: 2024-01-03T21:10:16.000Z (over 2 years ago)
• Last Synced: 2025-04-14T22:08:00.945Z (about 1 year ago)
• Language: Go
• Homepage:
• Size: 9.07 MB
• Stars: 40
• Watchers: 11
• Forks: 8
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# Airlock

[![Build status](https://github.com/coreos/airlock/actions/workflows/go.yml/badge.svg)](https://github.com/coreos/airlock/actions/workflows/go.yml)

[![Container image](https://img.shields.io/badge/container-quay.io-blue)](https://quay.io/repository/coreos/airlock)

Airlock is a minimal update/reboot manager for clusters of Linux nodes. It is meant to be simple to run in a container.

Fleet-wide updates and reboots are coordinated via semaphore locking, with configurable groups and simultaneous reboot slots.

Configuration is done through a single TOML file. The service is stateless, and etcd3 is used to store the semaphore and to guarantee its consistency.

![slots locking graph](./docs/images/metrics.png)

## Quickstart

```

go get -u -v github.com/coreos/airlock && airlock serve --help

```

A TOML configuration sample (with comments) is available under [examples](dist/examples/).

An automatically built `x86_64` container image is available on [quay.io](https://quay.io/repository/coreos/airlock) and can be run as:

```

docker run -p 3333:3333/tcp -v "$PWD/dist/examples/config.toml:/etc/airlock/config.toml" quay.io/coreos/airlock:main airlock serve -vv

```