kubermatic / kubeone

Kubermatic KubeOne Kubermatic KubeOne automates cluster operations on all your cloud, on-prem, edge, and IoT environments. KubeOne can install high-available (HA) master clusters as well single master clusters. Getting Started All user documentation for the latest stable version is available at the [KubeOne docs website][docs]. Information about the support policy (natively-supported providers, supported Kubernetes versions, and supported operating systems) can be found in the [Compatibility document][docs-compatibility]. For a quick start, you should check the following documents: • [Architecture][docs-concepts] to get familiar with the concepts of KubeOne. • [Getting KubeOne][docs-getting-kubeone] to download and install KubeOne locally. • [Provisioning][docs-provisioning] to provision the Kubernetes cluster. Quick Start The fastest way to deploy a KubeOne kubernetes cluster is to use the installation script: Check out, [All-in-one Cluster][docs-kubeone-local]. Installing KubeOne You can also customize the installation: The installation script downloads the release archive from GitHub, installs the KubeOne binary in your directory, and unpacks the example Terraform configs, addons, and helper scripts in your current working directory. For other installation methods, check the [Getting KubeOne guide][docs-getting-kubeone] on our documentation website. Features Easily Deploy Your Highly Available Cluster On Any Infrastructure KubeOne works on any infrastructure out of the box. All you need to do is to provision the infrastructure and let KubeOne know about it. KubeOne will take care of setting up a production ready Highly Available cluster! Native Support For The Most Popular Providers KubeOne natively supports the most popular providers, including AWS, Azure, DigitalOcean, GCP, Hetzner Cloud, Nutanix, OpenStack, VMware Cloud Director, and VMware vSphere. The natively supported providers enjoy additional features such as integration with Terraform and Kubermatic machine-controller. Kubernetes Conformance Certified KubeOne is a Kubernetes Conformance Certified installer with support for all [upstream-supported][upstream-supported-versions] Kubernetes versions. Declarative Cluster Definition Define all your clusters declaratively, in a form of a YAML manifest. You describe what features you want and KubeOne takes care of setting them up. Integration With Terraform The built-in integration with Terraform, allows you to easily provision your infrastructure using Terraform and let KubeOne take all the needed information from the Terraform state. Integration With Cluster-API, Kubermatic machine-controller, and operating-system-manager Manage your worker nodes declaratively by utilizing the [Cluster-API][cluster-api] and [Kubermatic machine-controller][machine-controller]. Create, remove, upgrade, or scale your worker nodes using kubectl. [Kubermatic operating-system-manager][operating-system-manager] is responsibile for managing user-data for worker machines in the cluster. 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][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 Slack: • [ channel][k8s-slack-kubeone] on [Kubernetes Slack][k8s-slack] Reporting Bugs If you encounter issues, please [create a new issue on GitHub][github-issue] or talk to us on the [ Slack channel][k8s-slack-kubeone]. When reporting a bug please include the following information: • KubeOne version or Git commit that you're running ( ), • description of the bug and logs from the relevant 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][security-vulnerability]. Changelog See [the list of releases][changelog] to find out about feature changes. [upstream-supported-versions]: https://kubernetes.io/docs/setup/release/version-skew-policy/#supported-versions [cluster-api]: https://github.com/kubernetes-sigs/cluster-api [machine-controller]: https://github.com/kubermatic/machine-controller [operating-system-manager]: https://github.com/kubermatic/operating-system-manager [docs]: https://docs.kubermatic.com/kubeone/ [docs-architecture]: https://docs.kubermatic.com/kubeone/main/architecture/ [docs-concepts]: https://docs.kubermatic.com/kubeone/main/architecture/concepts/ [docs-compatibility]: https://docs.kubermatic.com/kubeone/main/architecture/compatibility/ [docs-getting-kubeone]: https://docs.kubermatic.com/kubeone/main/getting-kubeone/ [docs-kubeone-local]: https://docs.kubermatic.com/kubeone/main/guides/local/ [docs-provisioning]: https://docs.kubermatic.com/kubeone/main/tutorials/creating-clusters/ [contributing-guide]: https://github.com/kubermatic/kubeone/blob/main/CONTRIBUTING.md [k8s-slack-kubeone]: https://kubernetes.slack.com/messages/CNEV2UMT7 [k8s-slack]: http://slack.k8s.io/ [github-issue]: https://github.com/kubermatic/kubeone/issues [security-vulnerability]: https://github.com/kubermatic/kubeone/blob/main/CONTRIBUTING.md#reporting-a-security-vulnerability [changelog]: https://github.com/kubermatic/kubeone/releases