Go to file
Bruno Tavares 5096abefac Support for loading recipes and roles from modules
Modules are located under `modules` folder. They will be copied on
deploy as well.

An example structure:

```
sample
├── files
├── install.sh
├── modules
│   └── another
│       ├── files
│       ├── install.sh
│       ├── README.md
│       ├── recipes
│       └── roles
│           └── web.sh
├── README.md
├── recipes
└── roles
```

Roles and recipes will be available for your project to access it with
the commited functions
2014-02-23 13:23:25 -03:00
bin Add kickstart binary command with instalation instructions 2014-02-19 20:25:41 -03:00
completions Add autocomplete 2014-02-21 19:43:24 -03:00
docs Support for loading recipes and roles from modules 2014-02-23 13:23:25 -03:00
kickstart Support for loading recipes and roles from modules 2014-02-23 13:23:25 -03:00
lib Fix module loading logic 2014-02-23 12:48:33 -03:00
.gitignore Add kickstart binary command with instalation instructions 2014-02-19 20:25:41 -03:00
Dockerfile Add docker container that comes with kickstart installed 2014-02-23 12:25:01 -03:00
README.md Remove typo on instructions to install kickstart 2014-02-23 12:24:06 -03:00

kickstart

Bash only provisioning tool.

The idea is to use bash scripts to provision machines over ssh, with no client installation on the target. It provides some abstractions and functions that help you structure and write more readable bash scripts. For an example project, check kickstart-baseline.

Goal

  • No installation on the target
  • Over ssh, or local
  • Portable (Mac, Linux, containers and so on)

Installation

Add it to the path.

One options is to download it, and export the bin folder into your PATH

# Adjust the paths to your preferred location
installation_path=/opt/kickstart
shell_configuration=$HOME/.bashrc

git clone https://github.com/bltavares/kickstart.git $installation_path
echo 'export PATH=$PATH:'$installation_path'/bin' >> $shell_configuration
echo 'eval "$(kickstart autocomplete)"' >> $shell_configuration

The other is to link the bin/kickstart into a place that is already on your path. This will allow sudo to see the kickstart command.

# Adjust the paths to your preferred location
installation_path=/opt/kickstart
shell_configuration=$HOME/.bashrc

git clone https://github.com/bltavares/kickstart.git $installation_path
sudo ln -s $installation_path/bin/kickstart /usr/local/bin/kickstart
echo 'eval "$(kickstart autocomplete)"' >> $shell_configuration

Usage

create

Creates a sample project structure

kickstart create [folder name or current folder]

docker-create

Creates a docker container with a running sshd to test recipes

kickstart docker-create

docker-ssh

Access the created docker container over ssh. A simple utility that looks up for the port the docker is bound.

kickstart docker-ssh

compile

Compile the current workspace into the folder to be packaged on deploy

kickstart compile

deploy

Takes an host target and deploy the compiled code on it.

kickstart deploy [--sudo] [--password PASSWORD] target [roles ...]
Examples

Deploy a role on a host

kickstart deploy vagrant@localhost nodejs

Deploy two roles on a host with an alternative port

kickstart deploy "-p 2222 vagrant@localhost" nodejs redis

Deploy with sudo and send the password for sudo

kickstart deploy --sudo --password vagrant "-p 2222 vagrant@localhost" nodejs redis

local

Deploy localy a recipe that is not over ssh. It basicaly compile and run the install script

kickstart local [--sudo] [roles ...]

infect

Infect your shell with the kickstart utility functions

eval "$(kickstart infect)"

bootstrap

Install kickstart on the target

kickstart bootstratp [target]
Example

Using default ssh configurations

kickstart bootstrap vagrant@vagrant

Using alternate ssh port

kickstart bootstrap "-p 2222 vagrant@vagrant"

doc

Show documentation for a kickstart function

kickstart doc [function name]
Example

List all documented functions

kickstart doc

Show documentation for a function

kickstart doc kickstart.os

autocomplete

Enable autocompletion on your terminal

eval "$(kickstart autocomplete)"

Debbuging

Prepend DEBUG=1 to the command and you will see massive ammount of commands on your screen

DEBUG=1 kickstart local nodejs

Thanks

This project was inspired on sunzi