niravpatel27 / triton-kubernetes Goto Github PK

Triton Kubernetes is a multi-cloud Kubernetes solution. It has a global cluster manager (control plane) which can run on any cloud - Public, Private or Bare Metal and manages Kubernetes environments. The current release uses Triton (Joyent public cloud). With our forthcoming release, you will be able to run the global control plane on any cloud, bare metal or VMware.

The cluster manager will manage environments running on any region of any supported cloud. Out of box, AWS, Azure, Google and Triton (public and private) are supported. If not using a cloud, environments on bare metal servers are also going to be supported in our forthcoming release. For an example set up, look at the Working with the CLI section.

triton-kubernetes interactive cli is one of two ways you can interact with Triton Multi-Cloud Kubernetes. Using triton-kubernetes cli, you can:

• create a cluster manager
• destroy a cluster manager and all clusters it is managing
• add/remove a cluster to/from an existing cluster manager
• backup/restore a kubernetes namespace from any of your clusters to manta/S3
• query your existing cluster managers and clusters

The cli triton-kubernetes allows for creating and managing a kubernetes deployment only. Application deployments will still need to be done using kubectl.

_{Note: Keep in mind that every cloud has a resource quota. If that quota has been reached, Triton-Kubernetes will not be able to provision new machines and throw errors.}

In order to run Triton Kubernetes, you must create a Triton account and install jq and terraform.

Triton is our container-native and open source cloud, which we will use to provide the infrastructure required for your Kubernetes cluster.

jq is a lightweight and flexible command-line JSON processor. It is leveraged by triton-kubernetes.

Terraform enables you to safely and predictably create, change, and improve production infrastructure. It is an open source tool that codifies APIs into declarative configuration files that can be shared amongst team members, treated as code, edited, reviewed, and versioned.

Install jq for the system you are on:

# OS X using brew
brew install jq

# Debian/Ubuntu
apt-get install jq

# CentOS/RHEL
yum install jq

Install terraform for the system you are on:

# OS X using brew
brew install terraform

# Debian/Ubuntu/CentOS/RHEL
wget https://releases.hashicorp.com/terraform/0.11.2/terraform_0.11.2_linux_amd64.zip
unzip terraform_0.11.2_linux_amd64.zip
mv terraform /usr/local/bin/

From Source:

go get -u github.com/joyent/triton-kubernetes
go install github.com/joyent/triton-kubernetes
triton-kubernetes --help

• Build and Install from source
• Install from pre-built packages

Triton Kubernetes allows you to create/destroy global cluster managers, kubernetes environments and individual cluster nodes. You can also get information on a cluster manager or kubernetes environment. Triton Kubernetes provides these features through the create, destroy and get commands.

To get help on a command, use the --help flag. For example:

$ triton-kubernetes --help
This is a multi-cloud Kubernetes solution. Triton Kubernetes has a global
cluster manager which can manage multiple clusters across regions/data-centers and/or clouds. 
Cluster manager can run anywhere (Triton/AWS/Azure/GCP/Baremetal) and manage Kubernetes environments running on any region of any supported cloud.
For an example set up, look at the How-To section.

Usage:
  triton-kubernetes [command]

Available Commands:
  create      Create cluster managers, kubernetes clusters or individual kubernetes cluster nodes.
  destroy     Destroy cluster managers, kubernetes clusters or individual kubernetes cluster nodes.
  get         Display resource information
  help        Help about any command
  version     Print the version number of triton-kubernetes

Flags:
      --config string     config file (default is $HOME/.triton-kubernetes.yaml)
  -h, --help              help for triton-kubernetes
      --non-interactive   Prevent interactive prompts
  -t, --toggle            Help message for toggle

Use "triton-kubernetes [command] --help" for more information about a command.

triton-kubernetes create [manager or cluster or node]

Creates a new cluster manager, kubernetes cluster or individual kubernetes cluster node.

When creating a new kubernetes cluster, you must specify the cloud provider for that cluster (Triton, AWS, Azure and GCP).

triton-kubernetes destroy [manager or cluster or node]

Destroys an existing cluster manager, kubernetes cluster or individual kubernetes cluster node.

triton-kubernetes get [manager or cluster]

Displays cluster manager or kubernetes cluster details.

Triton Kubernetes persists state by leveraging one of the supported backends. This state is required to add/remove/modify infrastructure managed by Triton Kubernetes.

Will persist state in the /triton-kubernetes/ folder for the provided user in Manta Cloud Storage.

Will persist state in the ~/.triton-kubernetes/ folder on the machine Triton Kubernetes was run on.

• AWS
• AZURE
• BareMetal
• GCP
• Triton
• vSphere

• Release Process

The SOURCE_URL flag will override the default terraform module source. Default is github.com/joyent/triton-kubernetes.

The SOURCE_REF flag will override the default branch/tag/commit reference for the terraform module source. Default is master

Testing local changes

SOURCE_URL=/full/path/to/working/dir/triton-kubernetes ./triton-kubernetes

Testing remote changes

SOURCE_URL=github.com/fayazg/triton-kubernets SOURCE_REF=new-branch ./triton-kubernetes