# Developers

## Table of Contents

* [Development Environment](#development-environment)
  * [Virtual Machines](#virtual-machines)
  * [Docker](#docker)
* [Contributing](#contributing)
* [IRC](#irc)

## Development Environment

Before hacking on BonnyCI, we'll need to set up a development environment on our local machine.

Supported development platforms:

* [Ubuntu](dev-environment/ubuntu.md)
* [Apple's macOS](dev-environment/macOS.md)

## Contributing

Please see the [contributing documentation](contributing) for more information.

A brief note on repository naming...
> The puns get made, or the plank gets walked.
>
> ~Jesse Keating

## IRC

For discussions about BonnyCI, join us on [freenode](https://freenode.net) #BonnyCi!

# Developers

## Table of Contents

* [Development Environment](#development-environment)
  * [Virtual Machines](#virtual-machines)
* [Contributing](#contributing)
* [IRC](#irc)

## Development Environment

Before hacking on BonnyCI, we'll need to set up a development environment on our local machine.

Supported development platforms:

* [Ubuntu](dev-environment/ubuntu.md)
* [Apple's macOS](dev-environment/macOS.md)

### Virtual Machines

You can test changes to BonnyCI locally by exercising some tools defined in [hoist](www.github.com/BonnyCI/hoist). Hoist is a set of ansible playbooks that automate the deployment of a BonnyCI environment. Be sure that you have completed the `Virtualization Tools` section of your OS's [Development Environment](#development-environment) page before proceeding.

Clone hoist and navigate to its base directory:

```shell
$ git clone git@github.com:BonnyCI/hoist.git
$ cd hoist
```

To perform a full deploy::

```shell
$ vagrant up
```

To redeploy just the nodepool VM::

```shell
$ vagrant destroy nodepool
$ vagrant up nodepool
```

To inspect the zuul VM::

```shell
$ vagrant ssh zuul
$ # netstat, tcpdump, tail logs, etc.
$ logout
```

To tear down the entire stack when you're done::

```shell
$ vagrant destroy
```

## Contributing

Please see the [contributing documentation](contributing) for more information.

A brief note on repository naming...
> The puns get made, or the plank gets walked.
>
> ~Jesse Keating

## IRC

For discussions about BonnyCI, join us on [freenode](https://freenode.net) #BonnyCi!

Move hoist vagrant docs to lore
Move hoist vagrant docs to lore

Since we're using lore as a central documentation repo, we should move
some of the currently existing stuff over here.

Depends-On: #39
Resolves (partial): #1 #4 (step 2)

Signed-off-by: Cullen Taylor <0a4f58109a9f9b7b2781cb48fa62bfe7918cb3d0@outlook.com>
