0.0
No commit activity in last 3 years
No release in over 3 years
kube-machine manages Kubernetes cluster environments. Provision, scale, and switch between Kubernetes environments.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

~> 1.10
~> 10.0
~> 3.3
 Project Readme

Deprecation Notice

This has been moved to pre-planning at https://github.com/gerred/kube-cluster. It's being refactored for simplicity, and will have a much more docker-machine like focus.

kube-cluster

kube-cluster tool for launching and managing Kubernetes environments.

Usage

$ kube-cluster create env dev --driver=vbox
Creating environment "dev".
Running magic... Let there be more light.
Done.

$ kube-cluster create env stage1 --driver=aws --interactive
Creating environment "stage1".
Give AWS Credential ID: some-aws-id
Give AWS Credential KEY: some-aws-key
How many nodes [5]: 6
Autoscale [Y/n]: n
...
Running magic... Let there be more light.
Done.

$ kube-cluster get env
environment    driver    nodes
dev            vbox      1
stage1         aws       6
live-aws       aws       10
live-gce       gce       20

$ kube-cluster env dev
Current environment is "dev"

$ kube-cluster describe env stage1
Environment: stage1
Driver: AWS
Nodes: 6
Autoscale: No
...

$ kube-cluster get rc,svc,po,no
 ...kubectl output...

Options

  • create env: creates a local environment configuration to communicate with a kubernetes deployment.

  • env [name]: changes to given environment. It reconfigures the tool so all calls are sent to the right deployment.

  • delete env: removes an existing local configuration.

Troubleshooting

  1. I get the error environment not set for any kube-cluster call I make.

It happens because you have not chosen a working environment yet. You can help yourself out of this situation by updating your shell profile with the variable which sets a default environment. In case of Bash:

$ echo export KUBE_CLUSTER_ENVIRONMENT="environment-name" >> ~/.bash_profile

How to Install

# go get github.com/gerred/kube-cluster/...

Dependencies

Contributing

If you want to contribute, you are going to need Go installed and configured in your machina. Please, refer to the CONTRIBUTING file.