kubeone

A lifecycle management tool for Highly-Available Kubernetes clusters

Github星跟蹤圖

KubeOne

kubeone is a CLI tool and a Go library for installing, managing, and upgrading
Kubernetes High-Available (HA) clusters. It can be used on any cloud provider,
on-prem or bare-metal cluster.

Project Status

As of v0.6.0, KubeOne is in the beta phase. Check out the
Backwards Compatibility Policy for more details on
backwards compatibility, KubeOne versioning, and maturity of each KubeOne
component.

Versions earlier than v0.6.0 are considered alpha and it's strongly advised to
upgrade to the v0.6.0 or newer as soon as possible.

KubeOne in Action

KubeOne Demo asciicast

Features

  • Supports Kubernetes 1.13+ High-Available (HA) clusters
  • Uses kubeadm to provision clusters
  • Comes with a straightforward and easy to use CLI
  • Choice of Linux distributions between Ubuntu, CentOS and CoreOS
  • Integrates with Cluster-API and Kubermatic machine-controller to
    manage worker nodes
  • Integrates with Terraform for sourcing data about infrastructure and control
    plane nodes
  • Officially supports AWS, DigitalOcean, GCE, Hetzner, Packet, OpenStack, VMware
    vSphere and Azure

Installing KubeOne

Downloading a binary from GitHub Releases

The recommended way to obtain KubeOne is to grab the
binary from the GitHub Releases page. On the
releases page, find the binary for your operating system
and architecture and download it or grab the URL and use
wget or curl to download the binary.

Version: version of KubeOne
Operating system: linux or darwin for macOS

curl -LO https://github.com/kubermatic/kubeone/releases/download/v<version>/kubeone_<version>_<operating_system>_amd64.zip

Extract the binary to the KubeOne directory. On Linux and macOS, you can use unzip.

unzip kubeone_<version>_<operating_system>_amd64.zip -d kubeone_<version>_<operating_system>_amd64

Move the kubeone binary to your path, so you can easily
invoke it from your terminal.

sudo mv kubeone_<version>_<operating_system>_amd64/kubeone /usr/local/bin

Building KubeOne

The alternative way to install KubeOne is using go get.

To get latest stable release:

GO111MODULE=on go get github.com/kubermatic/kubeone

To get latest beta release (for example v0.11.0-beta.0 tag):

GO111MODULE=on go get github.com/kubermatic/kubeone@v0.11.0-beta.0

While running of the master branch is a great way to peak at and test
the new features before they are released, note that master branch can
break at any time or may contain bugs. Official releases are considered
stable and recommended for the production usage.

If you already have KubeOne repository cloned, you can use make
to install it.

make install

Using package managers

Support for packages managers is still work in progress and expected
to be finished for one of the upcoming release. For details about the
progress follow the issue #471

Arch Linux

We have a package in the AUR here.
Use your favorite method to build it on your system, for example by using
aurutils:

aur sync kubeone && pacman -S kubeone

Shell completion and generating documentation

KubeOne comes with commands for generating scripts for the shell
completion and for the documentation in format of man pages
and more.

To activate completions for bash (or zsh), run or put this command
into your .bashrc file:

. <(kubeone completion bash)

To put changes in the effect, source your .bashrc file.

source ~/.bashrc

To generate documentation (man pages for example, more available), run:

kubeone document man -o /tmp/man

Kubernetes Versions Compatibility

Each KubeOne version is supposed to support and work with a set of Kubernetes
minor versions. We're targeting to support at least 3 minor Kubernetes versions,
however for early KubeOne releases we're supporting only one or two minor
versions.

New KubeOne release will be done for each minor Kubernetes version. Usually, a
new release is targeted 2-3 weeks after Kubernetes release, depending on number
of changes needed to support a new version.

Since some Terraform releases introduces incompatibilities to previuos versions,
only a specific version range is supported with each KubeOne release.

In the following table you can find what are supported Kubernetes and Terraform
versions for each KubeOne version. KubeOne versions that are crossed out are not
supported. It's highly recommended to use the latest version whenever possible., KubeOne version, 1.17, 1.16, 1.15, 1.14, 1.13, Terraform, Supported providers, -----------------, ------, ------, ------, ------, ------, -----------, --------------------------------------------------------------------, v0.11.0+, +, +, +, -, -, v0.12+, AWS, DigitalOcean, GCE, Hetzner, Packet, OpenStack, vSphere, Azure, v0.10.0+, -, +, +, +, -, v0.12+, AWS, DigitalOcean, GCE, Hetzner, Packet, OpenStack, vSphere, Azure, ## Getting Started

We have a getting started tutorial for each cloud provider we support in our
documentation. For example, the following document shows
how to get started with KubeOne on AWS.

A cluster is created using the kubeone install command. It takes a KubeOne configuration file and optionally Terraform state used to source information about the infrastructure. You may also use our Ansible roles to create the configuration file.

kubeone install config.yaml --tfjson tf.json

To learn more about KubeOne configuration, please run kubeone config print --full.

For advanced use cases and other features, check the KubeOne features
document.

Getting Involved

We very appreciate contributions! If you want to contribute or have an idea for
a new feature or improvement, please check out our contributing guide.

If you want to get in touch with us and discuss about improvements and new
features, please create a new issue on GitHub or connect with us over the
mailing list or Slack:

Reporting Bugs

If you encounter issues, please create a new issue on GitHub or talk to us
on the #kubeone Slack channel. When reporting a bug please include the
following information:

  • KubeOne version or Git commit that you're running (kubeone version),
  • description of the bug and logs from the relevant kubeone command (if
    applicable),
  • steps to reproduce the issue,
  • expected behavior

If you're reporting a security vulnerability, please follow
the process for reporting security issues.

Changelog

See the list of releases to find out about feature changes.

主要指標

概覽
名稱與所有者kubermatic/kubeone
主編程語言Go
編程語言Go (語言數: 7)
平台
許可證Apache License 2.0
所有者活动
創建於2018-11-03 10:59:33
推送於2025-04-24 17:29:47
最后一次提交
發布數136
最新版本名稱v1.10.0 (發布於 )
第一版名稱v0.1.0-beta0 (發布於 )
用户参与
星數1.4k
關注者數33
派生數244
提交數1.9k
已啟用問題?
問題數1143
打開的問題數95
拉請求數2181
打開的拉請求數10
關閉的拉請求數259
项目设置
已啟用Wiki?
已存檔?
是復刻?
已鎖定?
是鏡像?
是私有?