2012-12-03 11:34:16 -08:00
|
|
|
:title: StackForge
|
|
|
|
|
2014-08-27 14:10:16 -04:00
|
|
|
.. _stackforge:
|
|
|
|
|
2012-12-03 11:34:16 -08:00
|
|
|
StackForge
|
|
|
|
##########
|
|
|
|
|
|
|
|
StackForge is the way that OpenStack related projects can consume and
|
|
|
|
make use of the OpenStack project infrastructure. This includes Gerrit
|
|
|
|
code review, Jenkins continuous integration, GitHub repository
|
|
|
|
mirroring, and various small things like IRC bots, pypi uploads, RTFD
|
|
|
|
updates. Projects should make use of StackForge if they want to run
|
|
|
|
their project with Gerrit code review and have a trunk gated by Jenkins.
|
|
|
|
|
|
|
|
StackForge projects are expected to be self sufficient when it comes to
|
|
|
|
configuring Gerrit/Jenkins/Zuul etc. The openstack-infra team can
|
|
|
|
provide assistance as resources allow, but should not be relied on.
|
|
|
|
|
|
|
|
What StackForge is not:
|
|
|
|
|
|
|
|
* Official endorsement of a project by OpenStack.
|
2015-10-17 14:11:48 -07:00
|
|
|
* A guarantee of eventual OpenStack incubation (though it is a good
|
|
|
|
first step in that process as it exposes the project to the
|
|
|
|
OpenStack way of doing things).
|
|
|
|
|
|
|
|
Note that StackForge and official OpenStack projects were previously
|
|
|
|
segregated into two separate git namespaces (stackforge/ and
|
|
|
|
openstack/). They now both occupy the openstack/ namespace though
|
|
|
|
this does not indicate that all such projects are official OpenStack
|
|
|
|
projects; it merely indicates that they are developed within the
|
|
|
|
OpenStack project infrastructure. Projects must apply to the
|
|
|
|
Technical Committee to become official OpenStack projects.
|
2012-12-03 11:34:16 -08:00
|
|
|
|
2013-05-26 13:45:09 +00:00
|
|
|
Audience
|
|
|
|
********
|
|
|
|
|
|
|
|
The focus of StackForge is to provide a place for OpenStack contributors
|
|
|
|
to maintain related unofficial projects using the same tools and
|
|
|
|
procedures as they employ when working on official OpenStack projects,
|
|
|
|
to make it easier for other OpenStack developers to contribute effort to
|
|
|
|
those projects and in some cases to ease a project's path to incubation
|
|
|
|
and official integration. As such, the target audience for this document
|
|
|
|
is current OpenStack developers who are assumed to already be familiar
|
|
|
|
with how changes are uploaded and reviewed within OpenStack projects. As
|
|
|
|
an introduction to OpenStack contribution, it is recommend to first read
|
2014-12-03 21:09:56 +01:00
|
|
|
https://wiki.openstack.org/wiki/How_To_Contribute and then
|
|
|
|
the `Developer's Guide <http://docs.openstack.org/infra/manual/developers.html>`_.
|
2013-05-26 13:45:09 +00:00
|
|
|
|
2012-12-03 11:34:16 -08:00
|
|
|
Add a Project to StackForge
|
|
|
|
***************************
|
|
|
|
|
2014-12-03 16:51:07 +01:00
|
|
|
For information on adding a project to StackForge, see the `Project
|
|
|
|
Creator's Guide
|
|
|
|
<http://docs.openstack.org/infra/manual/creators.html>`_.
|