updateservicectl lets you control and test the CoreOS update service. Subcommands
let you manage users, groups, packages and write a very simple client that gets
its state via environment variables.
updateservicectl v2.1.0 is compatible with CoreUpdate v2.3.0 or newer.
updateservicectl v2.0.0 is compatible with CoreUpdate v2.2.0 or newer.
updateservicectl v1.4.0 is compatible with CoreUpdate v2.1.1 or older.
The update service is a tool that helps you manage large-scale rolling upgrades of software. The service consists of three main parts:
- A distributed web application that runs within docker containers.
updateservicectla CLI interface to the service- Communication specification for your applications to report their current status and receive notifications of an available update.
Once you have gained access to your update service installation, check out the Getting Started guide that will walk you through configuration of your applications, groups and update settings.
Major releases for all platforms are listed under the Releases tab on this repository. If you'd like to build your own client:
./buildormake(depending on the version ofupdateservicectlyou are building)- The client is now built. Use it with
./bin/updateservicectl <command>
You can build a release of a specfic version by running
scripts/build-release <git-tag-of-version>.
If you are a CoreOS developer, you may bump the version with
scripts/bump-version <version>. You can do this and build a release
at the same time with scripts/new-release.
Example: scripts/new-release 0.2.0+git.
Using the Client - Read about all of the supported commands in updateservicectl
Protocol - A technical document about the Omaha protocol