This repository contains code used by FORJ (http://forj.io) to implement the Openstack development model (http://ci.openstack.org/) as RedStone blueprint.

The current version implements the following development services:

Source control management	git
Code Review.	gerrit
build system & Continuous integration.	jenkins
an openstack implementation of pastebin.	lodgeit
build automation gating system.	zuul
Contribution statistics	graphite

RedStone Blueprint definition:

The description of this blueprint is detailled in 'redstone-master.yaml' located in the /forj/ directory.

It describes the following:

• Collection of tools

  • git/gerrit : http://ci.openstack.org/gerrit.html
  • jenkins : http://ci.openstack.org/jenkins.html
  • zuul : http://ci.openstack.org/zuul.html
  • lodgeit : http://ci.openstack.org/paste.html
  • graphite : http://graphite.openstack.org

• 'A la openstack' development flow

  This blueprint implements a complete development process, based on continuous integration, and code review. This process also manages projects in each tool (like creating a repository in git/gerrit)

• Blueprint Deployement automation

  Similar to the operation of the original openstack team, your RedStone infrastructure is going to be maintained by puppet modules and manifests. Most of this code is stored under /puppet directory

  Each tool is defined as a collections of puppet modules and manifest. The blueprint definition file (openstack-master.yaml) associates those modules to each tool.

• Blueprint data and management

  This blueprint introduces the notion of project. an RedStone project is a git/gerrit repository, collection of zuul gates and jenkins jobs. Any project created/deleted are controled by forj-config git/gerrit repo and implement a review control on these updates by a core team thanks to gerrit.

• Documentation

  It contains a simple tutorial to learn on this blueprint by example, and a lot of references about tools installed.

RedStone deployement:

When you want to deploy this blueprint, there is 2 choices:

• Create a new maestro and ask it to create your blueprint.
• Use an existing Maestro and configure it to create your blueprint. This functionnality is currently not ready. Documentation given is for information only, and may be updated as needed.

Create a new Maestro + Redstone:

• Get forj cli tool - Install forj cli thanks to instructions described in https://github.com/forj-oss/cli
• Setup hpcloud forj setup
• booting Maestro + redstone with forj boot redstone on hpcloud as

Configure Maestro to instantiate redstone:

!!! Warning !!! This section is still under development.

You will need to define where those services will be hosted. At least, you will need 2 files.

• /opt/config/production/fog/cloud.conf

  This is a fog configuration file to define Cloud or baremetal information like credential, cloud provider,...

  More information from http://fog.io/about/provider_documentation.html

• /forj/...-layout.yaml

  This file defines the list of servers (name, size, etc...) to host services (tools installed and configured)

An example of this layout in located under /forj/openstack-layout.yaml

In order to implement this blueprint layout, you will need the FORJ puppet orchestrator box, named Maestro.

You can install it from <...>

To deploy your own layout, create a copy of 'redstone-layout.yaml', update it as needed and ask Maestro to deploy it.

What 'redstone-layout.yaml' example will deploy:

This example layout file was designed to deploy 3 boxes. The current version of this repository configures your cloud with the following servers/services:

servers

• review (size small)
  • git : http://ci.openstack.org/git.html
  • gerrit : http://ci.openstack.org/gerrit.html
• ci (size small)
  • jenkins : http://ci.openstack.org/jenkins.html
  • zuul : http://ci.openstack.org/zuul.html
• util (size small)
  • lodgeit : http://ci.openstack.org/paste.html
  • graphite : http://graphite.openstack.org

This blueprint exposes services and RedStone project management to maestro in order to facilitate the development management.

Repository hierarchy:

• forj/ : blueprint description. Contains the blueprint definition(master) and a deployement example file (layout)
• puppet/modules : puppet modules
• puppet/manifest : puppet manifest

Contributing to Forj

We welcome all types of contributions. Checkout our website (http://docs.forj.io/en/latest/dev/contribute.html) to start hacking on Forj. Also join us in our community (https://www.forj.io/community/) to help grow and foster Forj for your development today!

License

RedStone is licensed under the Apache License, Version 2.0. See LICENSE for full license text.

test torties