[OpenStack-docs] Rebooting Debian support in the install-guide

Andreas Jaeger aj at suse.com
Sun May 8 09:42:54 UTC 2016


On 05/07/2016 11:15 AM, Thomas Goirand wrote:
> Hi,
> 
> During the Austin summit, I could discuss with Lana about what could be
> done for the Debian support in the install-guide.
> 
> Currently, there's these facts:
> - The Debconf support adds lots of conditionals which aren't easy to
> support (ie: it makes the individual foo-install.rst more complicated).
> - Some people would prefer to document the non-interactive mode.
> - Some people (like me) would still prefer to keep supporting using
> Debconf during the installation.
> 
> As a consequence, we believe the most easy way forward is as follow:
> - Keep Debian support directly in the install-guide.
> - Remove conditionals for Debian using Debconf in the foo-install.rst
> files, and document there the DEBIAN_FRONTEND=noninteractive mode.

Exactly, that's what we all agreed on in the Install Guide session in
Austin.

> - Push Debconf support in separate foo-debconf-install.rst files, and
> use them to generate the install-guide instead of the normal files.

I don't understand what you want to do here - and especially how you do
this to make it in a way that is easy to support.

We discussed briefly in the meeting a Debconf guide and our consensus
was that any *automatic* setup would be done in a separate repository.

> This means that effectively, we'd have 2 install-guide for Debian, and
> not one anymore. Though the non-interactive one would be very close from
> the Ubuntu one, and wouldn't add much work.


> The chapter explaining how Debconf works will have to be written in 2
> versions, one explaining generalities about Debconf, for the
> Debconf-supporting install-guide, and one explaining how to switch to
> the non-interactive mode (ie: using DEBIAN_FRONTEND= or doing
> dpkg-reconfigure debconf).
> 
> I hope this solution will satisfy everyone.
> 
> Going forward, to make this happen, I would need that the Debian install
> guide gets published again. I am currently not sure how to make this
> happen (ie: what kind of patch is needed?). I have made this patch:
> https://review.openstack.org/313854 but is this enough to get the guide
> in docs.openstack.org? Also, what would be needed to get a guide with
> debiandebconf tag?

That should be enough to get it up for Newton, but let me review in
depth afterwards.

Sourcing an additional debconf guide looks likes making everything much
more difficult...

Let's do this in steps:

* Get existing guide building for Debian again
* Rework existing guide so that it uses the non-interactive mode
* Write a spec explaining how your debconf guide should look like and
discuss that.
* Implement that spec

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




More information about the OpenStack-docs mailing list