[Openstack-docs] ops guide japanese build fails due to split repositories

Tom Fifield tom at openstack.org
Sun Aug 25 00:59:13 UTC 2013


Cheers for the look-in :) I agree we should be looking at the general 
case ... sorry for the short-sighted bug report!

Thought about the idea of putting things in openstack-infra/config too, 
but discarded it. Essentially, I think we can do this without putting 
additional review load on openstack-infra. Having a bare-bones 
configuration in openstack-infra/config that points to scripts in 
docs-controlled repositories would enable us to be much more responsive 
to updates, and means we don't need to bother infra :)

The last few patches I put through to config are took 1-3 weeks to get 
through. Importantly, this is completely fine - our patches are 
definitely low priority compared to others, and being typically less 
skilled at the ways of jenkins-job-builder we do want the time spent on 
thorough review from the overworked infracores.

However, this doesn't seem like a tenable situation for the tools, given 
the amount of churn we're going through right now (consider eg 
validate.py!). I think it would seriously slow things down for something 
that could potentially be done another way.


Regards,

Tom

On 25/08/13 01:17, Anne Gentle wrote:
> Is there an option to store the tool in openstack-infra/config and
> point it at different repos? They're already running scripts to send
> Horizon strings to transifex. This makes me think so:
> https://review.openstack.org/#/c/32824/3/modules/openstack_project/files/jenkins_job_builder/config/translation-jobs.yaml
>
> Plus https://review.openstack.org/#/c/34700/3/modules/jenkins/files/slave_scripts/propose_translation_update_manuals.sh
> points to a repo and a folder.
>
> It's from one the original patches Daisy sent through to start
> translations. Clark or Jeremy, do you know if a change in the config
> project would do what's needed -- slice docs from any repo?
>
> It's important to figure out because the next priority to me would be
> the API quick start in the openstack/api-site repo, then the install
> guides, so we have at least 3 repos with docs to translate. We could
> put all the high-priority-to-translate docs in one repo but that seems
> too rigid. Let's find a way.
>
> Thanks,
> Anne
>
>
> On Aug 23, 2013, at 7:23 PM, Tom Fifield <tom at openstack.org> wrote:
>
>> Hi all,
>>
>> Just throwing this bug out there for your comment to select a way forward:
>>
>> https://bugs.launchpad.net/openstack-manuals/+bug/1216153
>>
>>
>> The build job for the Japanese version of the Operations Guide was
>> merged at: https://review.openstack.org/#/c/39846/
>>
>> However, from the first run of the job (logs:
>> https://jenkins01.openstack.org/job/openstack-operations-guide-ja/1/console)
>> it becomes clear that it fails due to the split repositories.
>>
>> 2013-08-23 23:42:49.457 | cp: cannot stat
>> `./doc/src/docbkx/openstack-ops': No such file or directory
>>
>> To fix this, we either need to:
>>
>> 1) Check out the openstack-ops repo into manuals for build time
>>
>> 2) Copy the tools into the openstack-ops repo and perform the painful
>> ongoing task of keep them synchronised
>>
>> 3) move openstack-ops back into the openstack-manuals repo
>>
>>
>>
>> Regards,
>>
>>
>> Tom
>>
>> _______________________________________________
>> Openstack-docs mailing list
>> Openstack-docs at lists.openstack.org
>> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs




More information about the Openstack-docs mailing list