<commit_before># Bosh Inception

Create an Inception VM for Bosh.

Includes a CLI for creating and preparing an Inception VM for deploying/developing a Bosh universe. The created or targeted VM is upgraded into an Inception VM via a Chef cookbook.

STATUS: This is in development. The cookbooks look good so far. README is a description of what the project will become.

## Installation

This tool is distributed as a RubyGem. It requires Ruby 1.9+.

```
$ gem install bosh-inception
```

## Usage

This project includes both a standalone CLI to create an Inception VM or transform an existing VM into an Inception VM; and the internal Chef cookbooks that can be used outside of the CLI.

### CLI usage - create a remote Inception VM

To create a remote Inception VM, normally in the IaaS/region that you will be working with BOSH:

```
$ bosh-inception deploy

Stage 1: Choose infrastructure

Found infrastructure API credentials at ~/.fog (override with --fog)
1. AWS (default)
2. AWS (bosh)
3. Openstack (default)
Choose infrastructure:  1
<commit_msg>Document how to install/use tool from HEAD<commit_after># Bosh Inception

Create an Inception VM for Bosh.

Includes a CLI for creating and preparing an Inception VM for deploying/developing a Bosh universe. The created or targeted VM is upgraded into an Inception VM via a Chef cookbook.

STATUS: This is in development. The cookbooks look good so far. README is a description of what the project will become.

## Installation

This tool is distributed as a RubyGem. It requires Ruby 1.9+.

Currently, install and use the tool via this Git repo (due to its dependency on other unreleased RubyGems).

```
git clone https://github.com/drnic/bosh-inception.git
cd bosh-inception
bundle
bundle exec bin/bosh-inception deploy
```

In future, the following will work:

```
gem install bosh-inception
```

## Usage

This project includes both a standalone CLI to create an Inception VM or transform an existing VM into an Inception VM; and the internal Chef cookbooks that can be used outside of the CLI.

### CLI usage - create a remote Inception VM

To create a remote Inception VM, normally in the IaaS/region that you will be working with BOSH:

```
$ bosh-inception deploy

Stage 1: Choose infrastructure

Found infrastructure API credentials at ~/.fog (override with --fog)
1. AWS (default)
2. AWS (bosh)
3. Openstack (default)
Choose infrastructure:  1

{'fraction_non_alphanumeric': 0.0593607305936073, 'fraction_numerical': 0.005811540058115401, 'mean_word_length': 4.138592750533049, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 1, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2155345', 'n_tokens_mistral': 696, 'n_tokens_neox': 655, 'n_words': 362}