opendev/system-config
Code Issues Proposed changes

Merge "Updates to running-your-own CI docs: Changes required"

Browse Source
This commit is contained in:
Jenkins 2015-04-06 21:14:41 +00:00 committed by Gerrit Code Review
commit 265613ebe3
1 changed files with 26 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/source/running-your-own.rst
View File

@ -50,7 +50,7 @@ Initial setup
b) `project-config <http://git.openstack.org/cgit/openstack-infra/project-config/>`_ b) `project-config <http://git.openstack.org/cgit/openstack-infra/project-config/>`_
Contains configuration data used by OpenStack projects and services. Contains configuration data used by OpenStack projects and services.
For more details on the config repo split, read the following spec: For more details on the config repo split, read the following spec:
`http://specs.openstack.org/openstack-infra/infra-specs/specs/config-repo-split.html` http://specs.openstack.org/openstack-infra/infra-specs/specs/config-repo-split.html.
#. Follow http://ci.openstack.org/puppet.html#id2 and use your repository #. Follow http://ci.openstack.org/puppet.html#id2 and use your repository
in addition to the OpenStack CI repository. This is appropriate to stay in in addition to the OpenStack CI repository. This is appropriate to stay in
@ -63,27 +63,43 @@ Initial setup
Changes required Changes required
================ ================
To run your own infrastructure we recommend you to clone the entire tree and reuse
the system and project configurations from the OpenStack Infrastructure repositories.
Your config overrides will be applied on top of these settings by replacing hostnames
and class names throughout.
site.pp site.pp
~~~~~~~ ~~~~~~~
This file lists the specific servers you are running. Minimally you need a This file lists the specific servers you are running. Minimally you need a
puppetmaster, gerrit (review), jenkins (secure jobs such as making puppetmaster, jenkins, and then one or more slaves with appropriate distro choices.
releases), jenkins01 (untrusted jobs from any code author), puppetboard, To use all the choices for running your tests, you also need zuul, nodepool, and
nodepool, zuul, and then one or more slaves with appropriate distro choices. puppetBoard. Unless you have a specific need to setup your own gerrit review system,
your CI system can consume events from the upstream gerrit and test OpenStack changes.
A minimal site.pp can be useful to start with to get up and running. E.g. A minimal site.pp can be useful to start with to get up and running. E.g.
delete all but the puppetmaster and default definitions. delete all but the puppetmaster and default definitions.
Create a node entry for each server registered on puppetmaster and the define
the class it belongs to. The parameters will depend on each server and you can
use the configuration used by the Infra team as a template.
Example::
node 'jenkins.example.com' {
class { 'your-company_openstack_project::jenkins':
jenkins_jobs_password => hiera('jenkins_password'),
<...>
}
}
modules/openstack_project modules/openstack_project
~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~
This tree defines the shape of servers (some of which are unique, some of which This tree defines the shape of servers (some of which are unique, some of which
are scaled horizonally, thus the separation). To run your own infrastructure we are scaled horizonally, thus the separation). To run your own infrastructure we
recommend you copy the entire tree, delete any servers you won't run, and recommend you copy the entire tree, delete (or simply ignore) any servers you won't
replace hostnames and class names with yours throughout. run, and replace hostnames and class names with yours throughout. Some templates can
be used as-is by leaving their references to point within the openstack_project tree.
Some templates can be used as-is by leaving their references to point
within the openstack_project tree.
Bootstrapping Bootstrapping
~~~~~~~~~~~~~ ~~~~~~~~~~~~~