[docs] DNS problem with puppet-manifests

[Artur Kaszuba]

When we want to install slave with procedure from https://docs.fuel-infra.org/fuel-dev/ci/overview.html, we will end with fail.
Puppet will override /etc/hosts during execution and we will loose connection with puppet master.

Please solve this problem, possible solutions:
- change docs and describe how to install simple DNS server (for example dnsmasq) or describe what is required to change in existing DNS zone
- change puppet manifests to not override /etc/hosts

[Igor Shishkin (teran)]

@Artur, I can't get how overriding /etc/hosts could cause DNS failure since our code resets /etc/hosts to ubuntu default look.
Please provide more details.

[Artur Kaszuba (akaszuba)]

Now it looks like this:
- to get communication puppet node -> puppet master we need to know puppet master IP
- documentation in point 5.2.3 tell us that we need to set puppet address in /etc/hosts file
- execute puppet agent
- during puppet work manifest override /etc/hosts and delete our changes with puppet IP
- puppet client ends with error, part of steps cannot be done, agent dont know where puppet server is :)

It works when we have puppet master name in DNS, but now we cannot use /etc/hosts as a source for puppet master IP.

[Igor Shishkin (teran)]

@Artur,

Thanks, got your point.
We're using PXEtool to run puppet for the first time, so we probably need to cover that part in docs too.
And obviously not using /etc/hosts but DNS entry for our puppet master.

Thanks.

[Pawel Brzozowski (pbrzozowski)]

Yes, that's true - that how-to was written before /etc/hosts was managed by Puppet - I will fix that.

[Igor Shishkin (teran)]

Had a discussion today.
Solution is simple - not to use /etc/hosts but describe requirements and how to install most of them.

[Mateusz Matuszkowiak (mmatuszkowiak)]

Yes, DNS feature will be covered in the "infra overview" document.

[OpenStack Infra (hudson-openstack)]

Related fix proposed to branch: master
Review: https://review.openstack.org/256322

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/256322
Committed: https://git.openstack.org/cgit/openstack/fuel-web/commit/?id=6195d63606a3906ee9489c4842eb8efc791e6e00
Submitter: Jenkins
Branch: master

commit 6195d63606a3906ee9489c4842eb8efc791e6e00
Author: Mateusz Matuszkowiak <email address hidden>
Date: Tue Dec 29 15:05:10 2015 +0100

    infra overview docs related to Fuels infra

    Change-Id: I2315e35bfcbc4e49425cd5d73087ab0fbb28cd2e
    Related-Bug: #1510524