From 01e19830c37843bedd8e58f344cfbd0bb09a4987 Mon Sep 17 00:00:00 2001 From: Robert Collins Date: Thu, 29 Aug 2013 11:02:23 +1200 Subject: [PATCH] Start documenting running your own CI infra. This is incomplete, but as I haven't got a full thing up yet I can't write it all. It is minimally a useful pointer for other folk trying to do the same thing. Change-Id: Iefb62a0ff60e5f46f1f0091beef54bfc4a376a53 --- doc/source/index.rst | 1 + doc/source/running-your-own.rst | 39 +++++++++++++++++++++++++++++++++ 2 files changed, 40 insertions(+) create mode 100644 doc/source/running-your-own.rst diff --git a/doc/source/index.rst b/doc/source/index.rst index a97ebd97c4..eb44a34c00 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -29,6 +29,7 @@ Contents: project sysadmin + running-your-own systems .. toctree:: diff --git a/doc/source/running-your-own.rst b/doc/source/running-your-own.rst new file mode 100644 index 0000000000..b477f90fe0 --- /dev/null +++ b/doc/source/running-your-own.rst @@ -0,0 +1,39 @@ +:title: Running your own CI infrastructure + +.. _running-your-own: + +Running your own CI infrastructure +################################## + +The OpenStack CI infrastructure is designed to be shared amongst other projects +wanting a scalable cloud based CI system. We're delighted when someone wants to +reuse what we're building. + +To avoid having lots of meta references in the rest of the system +documentation, we document most things targeted specifically for use in the +OpenStack CI system itself. This chapter acts as a patch to the rest of our +documentation explaining how to reuse the OpenStack CI infrastructure for +another project. + +Requirements +============ + +* You need a cloud of some sort, all our tooling is built for OpenStack clouds :). + +* A service account for your CI systems within that cloud/clouds. + +* A domain for your servers to live in; puppet is hostname based, having + everything in sync is just easier. + +* A git repository that you can store your code in :). + +Initial setup +============= + +1. Clone the CI config repository and adjust it as necessary. + +1. Manually boot a machine with ~2G of ram to be the puppetmaster. + +1. Follow http://ci.openstack.org/puppet.html#id2 but use your repository + rather than the OpenStack CI repository. +