Open Stack

On 01/03/2014 02:27 PM, Cyril Roelandt wrote:
> On 12/20/2013 04:17 PM, Anne Gentle wrote:
>> On Thu, Dec 19, 2013 at 1:26 PM, Cyril Roelandt
>> <cyril.roelandt at enovance.com
>>> wrote:
>>
>>> On 11/28/2013 09:33 PM, Anne Gentle wrote:
>>>
>>>> Cyril, I think you would build the WADL with the Sphinx extension as a
>>>> Jenkins job, triggered when the Ceilometer gets an update. Then
>>>> automate
>>>> the patch proposal to the api-site similar to how translation jobs
>>>> work. A
>>>> human can then review the api-site patch (also similar to how
>>>> translation
>>>> jobs work). I'd rather not automate beyond creating the patch as we
>>>> still
>>>> want to review wording, meaning, and so on.
>>>>
>>>
>>> Hello Anne,
>>>
>>> Seems like the patch that adds a WADL target to Ceilometer's build
>>> system (
>>> https://review.openstack.org/#/c/57574/) should be merged quite soon.
>>> I'll then need to write that Jenkins job. Do you know where I could
>>> submit
>>> code to do that ? I'm new to Jenkins and the whole OpenStack
>>> infrastructure
>>> :)
>>>
>>>
>> Hi Cyril,
>>
> 
> Hi Anne,
> 
>> The place where doc jobs are created is in a yaml file in the
>> openstack-infra/config repository.
>>
>> The manuals.yaml and api-jobs.yaml contains the build jobs for the docs
>> we're talking about
>>
>> modules/openstack_project/files/jenkins_job_builder/config/api-jobs.yaml<https://review.openstack.org/#/c/59556/1/modules/openstack_project/files/jenkins_job_builder/config/api-jobs.yaml>
>>
>>
>> and the layout.yaml contains calls to those named build jobs.
>>
>> modules/openstack_project/files/zuul/layout.yaml<https://review.openstack.org/#/c/58313/1/modules/openstack_project/files/zuul/layout.yaml>
>>
>>
> 
> OK. So, I'm thinking of adding a job in api-jobs.yaml that would just
> call a shell script in modules/jenkins/files/slave_scripts/ . This
> script would build the documentation, compare it to the existing doc,
> and send me an email with the diff if they are not the same, so that I
> can manually review it and submit it if necessary. Do you think there is
> a sendmail properly configured on the Jenkins slaves ? I'd probably just
> need to be able to do something as simple as "mail -s 'Doc changed!'
> foo at example.com".

Best ask directly on #openstack-infra for help.

The documentation of Zuul http://ci.openstack.org/zuul/ seems to allow
mail sending, see http://ci.openstack.org/zuul/reporters.html#smtp

The openstack-infra/config module contains two usages of smtp, see
modules/openstack_project/files/zuul/layout.yaml,

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