https://github.com/rancher/kontainer-engine

Provisioning kubernetes cluster at ease
https://github.com/rancher/kontainer-engine

Last synced: about 2 months ago
JSON representation

Provisioning kubernetes cluster at ease

• Host: GitHub
• URL: https://github.com/rancher/kontainer-engine
• Owner: rancher
• License: apache-2.0
• Archived: true
• Created: 2017-10-25T06:15:02.000Z (almost 7 years ago)
• Default Branch: release/v2.4
• Last Pushed: 2023-02-25T02:16:29.000Z (over 1 year ago)
• Last Synced: 2024-07-27T07:31:24.862Z (2 months ago)
• Language: Go
• Homepage:
• Size: 45.3 MB
• Stars: 77
• Watchers: 34
• Forks: 80
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
kontainer-engine

========

A tool like docker-machine to provision kubernetes cluster for different cloud providers

## Building

`make`

## Usage

`kontainer-engine create --driver $driverName [OPTIONS] cluster-name`

`kontainer-engine inspect cluster-name`

`kontainer-engine ls`

`kontainer-engine update [OPTIONS] cluster-name`

`kontainer-engine rm cluster-name`

To see what driver create options it has , run

`kontainer-engine create --driver $driverName --help`

To see what update options for a cluster , run

`kontainer-engine update --help cluster-ame`

A serviceAccountToken which binds to the clusterAdmin is automatically created for you, to see what it is, run

`kontainer-engine inspect clusterName`

The current supported driver is gke(https://cloud.google.com/container-engine/)

Before running gke driver, make sure you have the credential. To get the credential, you can run any of the steps below

`gcloud auth login` or

`export GOOGLE_APPLICATION_CREDENTIALS=$HOME/gce-credentials.json` or 

`kontainer-engine create --driver gke --gke-credential-path /path/to/credential cluster-name`

## Running

`./bin/kontainer-engine`

## Tests

Run tests with:

```

    ./run_integration_tests

```

You must have Go and [Bats](https://github.com/sstephenson/bats) installed for the tests to run.

If you are adding new tests, note that they must have a `.bats` extension to be recognized by the runner.

## Generated Code

The `types/drivers.pb.go` file is a generated file.  It contains the GRPC 

client and server for the Kontainer-Engine drivers.  This file is generated 

from the `types/drivers.proto` file.  See [here](https://grpc.io/docs/tutorials/basic/go.html)

for more information on the format of these files.

Before running the generation script you must follow the quickstart 

instructions [here](https://grpc.io/docs/quickstart/go.html#prerequisites) and 

install the protoc binary and protoc plugin for Go.

After you have installed the prerequisites, the generated code can be 

generated by running `./scripts/generate-protoc.sh `. This will update the 

`drivers.pb.go` file from the `drivers.proto` template.  This script should 

be re-run every time `drivers.proto` is changed.

## License

Copyright (c) 2014-2016 [Rancher Labs, Inc.](http://rancher.com)

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

You may obtain a copy of the License at

[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)

Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

limitations under the License.