<commit_before>on-imagebuilder [![Build Status](https://travis-ci.org/RackHD/on-imagebuilder.svg?branch=master)](https://travis-ci.org/RackHD/on-imagebuilder)
===============

Copyright 2015, EMC, Inc.

This repository contains a set of scripts that execute ansible playbooks and roles used for building
debian-based linux microkernel images and overlay filesystems, primarily for use
with the [on-taskgraph workflow engine](https://github.com/rackhd/on-taskgraph).
There are three ansible playbooks included, which build mountable
[squashfs](https://en.wikipedia.org/wiki/SquashFS) images,
[overlay](https://en.wikipedia.org/wiki/OverlayFS) filesystems, and initrd images.

<br>

Requirements
---------------

- Any Debian/Ubuntu based system (support for other distributions coming soon, theoretically though, just install debootstrap and it should work)
- Ansible (> 2.0) (**NOTE**: Version 2.1.0.0 is not workable) is installed. To install newest Ansible version ([Ansible Installation Documents](http://docs.ansible.com/ansible/intro_installation.html)):

    ```
    sudo apt-get -y install python-software-properties python-pip
    sudo apt-get -y update
    sudo pip install ansible==2.0.2.0
    ```
- Internet access OR network access to an apt cache/proxy server from the build machine
<commit_msg>updated README with warning about prior ansible installs<commit_after>on-imagebuilder [![Build Status](https://travis-ci.org/RackHD/on-imagebuilder.svg?branch=master)](https://travis-ci.org/RackHD/on-imagebuilder)
===============

Copyright 2015, EMC, Inc.

This repository contains a set of scripts that execute ansible playbooks and roles used for building
debian-based linux microkernel images and overlay filesystems, primarily for use
with the [on-taskgraph workflow engine](https://github.com/rackhd/on-taskgraph).
There are three ansible playbooks included, which build mountable
[squashfs](https://en.wikipedia.org/wiki/SquashFS) images,
[overlay](https://en.wikipedia.org/wiki/OverlayFS) filesystems, and initrd images.

<br>

Requirements
---------------

- Any Debian/Ubuntu based system (support for other distributions coming soon, theoretically though, just install debootstrap and it should work)
- Ansible (> 2.0) (**NOTE**: Version 2.1.0.0 is not workable) is installed. To install newest Ansible version ([Ansible Installation Documents](http://docs.ansible.com/ansible/intro_installation.html)):

**WARNING**: We have seen on some system that an existing installation of Ansible can have adverse effects, this can be resolved by insuring they are removed prior to 
the next steps, below is an example of removing an existing dpkg installation but this could vary depending on the package manager.  
    ```
    sudo dpkg -r ansible
    ```

- Install ansible:

    ```
    sudo apt-get -y install python-software-properties python-pip
    sudo apt-get -y update
    sudo pip install ansible==2.0.2.0
    ```
- Internet access OR network access to an apt cache/proxy server from the build machine

{'fraction_non_alphanumeric': 0.11478663579225934, 'fraction_numerical': 0.009262322196493549, 'mean_word_length': 4.409660107334526, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 7, 'https://': 10, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 4, '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': '1705247', 'n_tokens_mistral': 891, 'n_tokens_neox': 821, 'n_words': 305}