Open Stack

On 12/09/2013 08:51 PM, Andreas Jaeger wrote:
> The OpenStack docu team now has a repository called
> openstack-doc-tools for their automation tools and gate tests.
> 
> I'd like to get some advise on how to use the tool for working with
> the various repositories we have.
> 
> Does the infra team has any recommendation on how to move forward?
> 
> For building documentation with Jenkins, I see two options:
> 
> Option 1: Have Jenkins checkout the openstack-doc-tools repository
> 	  every time and use that for building - similar to the
> 	  "devstack-checkout" job.
> 
> 	  This would mean that directly after every change done in
> 	  openstack-doc-tools, the tools are used for checking of all
> 	  gated repositories.

Anne suggested on IRC to use option 1 - unless we hit some major roadblocks.

> Option 2: Copy the tools and all support files to each and every
>           repository. We could automate that.
> 
> Moving forward, I'd like to have all our repositories (api-site,
> compute-api, identity-api, image-api, netconn-api, object-api,
> volume-api, operations-guide, openstack-manuals) use proper gates,
> thus extend "test.py" so that it can be used in more places. Note that
> the $service-api repos will be moved to $project/doc/source - we then
> should gate on those.
> 
> Right now only operations-guide and openstack-manuals are gated - but
> operations-guide uses an old version of the tools.
> 
> So, I want to move forward with these steps:
> 1) Properly setup openstack-doc-tools project, there are some open
>    reviews that need to go in.
> 2) Use openstack-doc-tools in openstack-manuals and operations-guide

I'm starting with the operations-guide with the assumption that a
failure here will hit us less:

https://review.openstack.org/61204


> 3) Use openstack-doc-tools for gating of api-site
> 4) Use openstack-doc-tools for gating of $service api repos

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
  SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126