Repository files navigation

Kite is a CLI for scaffolding and managing devops modulesThe main purpose is templating of various tools for devops around terraform, bosh, ansible.Currently Kite supports modular stacks(Kite modules) on both AWS and GCP.

We plan in adding community stack using a simple template repository structure.

Add this line to your application's Gemfile:

gem'kite'

And then execute:

$ bundle

Or install it yourself as:

$ gem install kite

To start using kite for bootstraping your infrastructurefollow the steps below.[Note] Most kite commands can be referred by their first letter(for examplekite generate environment test is the same askite g e test)

Create a new kite project using:

$ kite new PROJECT_NAME

Kite environments are separated workspaces with their own credentials, variables and modules.

Generate an environment

$ kite generate environment *env_name* --provider=aws|gcp

If you want to change the credentials for an environment, editconfig/cloud.yml and regenerate environment with the same command.

Now the environment should be generated atconfig/environments/*env_name*

To add a Kite module to your environment, you should first initialize it.It's recommended to use specific module versions/tags(master branch would be used by default):

  kite module init https://url.for/your/module --env *env_name* --version *x.y.z/x-y-stable*

This should clone module's source files intomodules/*module_name* and create avars.*module_name*.yml file with all variables needed by the module.

Fill invars.*module_name*.yml with correct values and render the module:

  kite module render modules/*module_name* --env *env_name*

Set your default gcloud credentials using

  gcloud auth application-default login

  kite terraform init  kite terraform apply --env *env_name*

To list all Kite commands, use

$> kitehelp

After checking out the repo, runbin/setup to install dependencies. Then, runrake spec to run the tests. You can also runbin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, runbundle exec rake install. To release a new version, update the version number inversion.rb, and then runbundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the.gem file torubygems.org.

To use resource scripts locally, set env variableis_devel totrue, e.h.:

$ ruby -Ilib ./bin/concourse/in

Bug reports and pull requests are welcome on GitHub athttps://github.com/rubykube/kite.