Kubernetes Operations (kOps) - Production Grade k8s Installation, Upgrades and Management
Go to file
Justin Santa Barbara 241a3daba5 Unmangle the Apache library
Upstream error, but we have to fix it too
2017-01-19 10:49:31 -05:00
_vendor Add gengo dependency 2017-01-15 16:00:56 -05:00
addons Used correct dashboard manifest per @justinsb. 2017-01-09 22:43:19 -05:00
channels Bump alpha channel to k8s 1.5.2 2017-01-12 14:27:10 -05:00
cloudmock/aws Update aws-sdk-go mocks with new functions 2016-12-30 10:47:44 -05:00
cmd Merge pull request #1367 from frodopwns/1302-require-confirm-on-delete 2017-01-19 10:21:51 -05:00
dns-controller dns-controller optimizations 2017-01-16 23:39:25 -05:00
docs Merge pull request #1040 from DualSpark/docs-updates 2017-01-19 10:47:12 -05:00
examples Fix example code 2016-12-19 00:22:30 -05:00
federation fix adminToken not used 2017-01-17 15:45:00 +08:00
hack Merge pull request #1367 from frodopwns/1302-require-confirm-on-delete 2017-01-19 10:21:51 -05:00
images protokube / nodeup: Up kubectl to v1.5.1, bump protokube tag to 1.5.0 2016-12-27 12:39:24 -08:00
nodeup/pkg Remove systemd manifest (for real) 2017-01-18 01:09:35 -05:00
pkg Merge pull request #1438 from blakebarnett/bdb/add_odic_flags 2017-01-19 00:32:30 -05:00
protokube Use versioned taint annotations 2017-01-12 23:59:04 -05:00
tests/integration Merge pull request #1313 from justinsb/security_to_master 2017-01-09 12:23:17 -05:00
upup Merge pull request #1465 from DualSpark/k-c-m-attachedetachflag 2017-01-18 21:44:55 -05:00
util/pkg Merge pull request #1367 from frodopwns/1302-require-confirm-on-delete 2017-01-19 10:21:51 -05:00
vendor Add gengo dependency 2017-01-15 16:00:56 -05:00
.dockerignore Add .dockerignore file to improve build times 2017-01-04 18:11:11 -03:00
.gitignore Ignore tags files generated by Exhuberant Ctags 2016-12-28 22:13:47 -08:00
.gitmodules Add gengo dependency 2017-01-15 16:00:56 -05:00
.travis.yml Commenting out changes instead of delete 2016-12-11 14:07:32 -07:00
CHANGES.md Add notes describing aug 11 changes 2016-08-11 22:40:16 -04:00
CONTRIBUTING.md Updates per the repo 2016-12-19 22:03:24 -07:00
HA.md typo 2016-12-23 16:22:32 +02:00
HISTORY.md Add notes for stable channel update 2016-10-21 13:39:33 -04:00
LICENSE Unmangle the Apache library 2017-01-19 10:49:31 -05:00
Makefile Unset KOPS_STATE_STORE when calling genhelpdocs 2017-01-17 00:27:58 -05:00
OWNERS Updates per the repo 2016-12-19 22:03:24 -07:00
README.md make installation a heading 2017-01-05 11:02:19 +00:00
code-of-conduct.md updating base docs to match close to kubernetes-template-project 2016-12-19 22:02:58 -07:00
doc.go Add canonical import paths 2016-11-03 23:46:27 -04:00
version.go Always include a gitsha in the version 2017-01-15 17:14:37 -05:00

README.md

Kubernetes Operations (kops)

Build Status Go Report Card GoDoc Widget

The easiest way to get a production grade Kubernetes cluster up and running.

What is kops?

We like to think of it as kubectl for clusters.

kops lets you deploy production-grade Kubernetes clusters from the command line, with options that support HA Masters. Kubernetes Operations supports deploying Kubernetes on Amazon Web Services (AWS) and support for more platforms is planned.

Launching a Kubernetes cluster hosted on AWS

Check out our tutorial for launching a Kubernetes cluster hosted on AWS.

Features

  • Automated Kubernetes cluster CRUD for (AWS)
  • Highly Available (HA) Kubernetes Masters Setup
  • Uses a state-sync model for dry-run and automatic idempotency
  • Custom support for kubectl add-ons
  • Kops can generate Terraform configuration
  • Based on a simple meta-model defined in a directory tree
  • Command line autocomplete
  • Community support
  • Upgrade from kube-up

Installing

kubectl is required, see here.

OSX From Homebrew (Latest Stable Release)

$ brew update && brew install kops

OSX From Homebrew (HEAD of master)

$ brew update && brew install --HEAD kops

Linux

Download the latest release, then:

$ chmod +x kops-linux-amd64                 # Add execution permissions
$ mv kops-linux-amd64 /usr/local/bin/kops   # Move the kops to /usr/local/bin

From Source

Go 1.7+ and make are required.

$ go get -d k8s.io/kops
$ cd ${GOPATH}/src/k8s.io/kops/
$ git checkout release
$ make

See building notes for more information.

At this time, Windows is not a supported platform.

Getting involved!

Want to contribute to kops? We would love the extra help from the community. We have a quickstart guide on adding a feature.

Kops also has time set aside every other week to offer help and guidance to the community. Kops maintainers have agreed to set aside time specifically dedicated to working with newcomers, helping with PRs, and discussing new features.

We recommend letting us know beforehand if you plan on attending so we can have time to prepare for the call.

Maintainer Schedule URL
@justinsb 2nd / 4th Friday 9am PDT Zoom
@chrislovecnm 2nd / 4th Friday 9am PDT Zoom
@kris-nova 2nd / 4th Friday 9am PDT Zoom

Reach out to us on kubernetes slack. A great place to get involved or ask questions is #sig-cluster-lifecycle.

Other Resources

History

View our changelog

GitHub Issues

Bugs

If you think you have found a bug please follow the instructions below.

  • Please spend a small amount of time giving due diligence to the issue tracker. Your issue might be a duplicate.
  • Set -v 10 command line option and save the log output. Please paste this into your issue.
  • Note the version of kops you are running (from kops version), and the command line options you are using
  • Open a new issue
  • Remember users might be searching for your issue in the future, so please give it a meaningful title to helps others.
  • Feel free to reach out to the kops community on kubernetes slack

Features

We also use the issue tracker to track features. If you have an idea for a feature, or think you can help kops become even more awesome follow the steps below.

  • Open a new issue
  • Remember users might be searching for your issue in the future, so please give it a meaningful title to helps others.
  • Clearly define the use case, using concrete examples. EG: I type this and kops does that.
  • Some of our larger features will require some design. If you would like to include a technical design for your feature please include it in the issue.
  • After the new feature is well understood, and the design agreed upon we can start coding the feature. We would love for you to code it. So please open up a WIP (work in progress) pull request, and happy coding.