1042717 - creating a new puppet environment fails in several interesting ways

Status: RESOLVED FIXED

(Infrastructure & Operations :: RelOps: Puppet, task)

Description

[Amy Rich [:arr] [:arich]]

I had removed my puppet environment on releng-puppet2.srv.releng.scl3.mozilla.com a while back so I could start fresh.  I ran into a few problems trying to set it up again.

1) If you search for puppet environment on wikimo, apparently it sends you to the wrong (outdated) page.  Can we delete that and update the documentation to be accurate and findable via search (not sure how to accomplish the latter.  Maybe we have a link from mana, which I find infinitely more discoverable).

2) You can't clone the repo into /etc/puppet/environments/$USER because there's already an environment.conf file there (not an empty directory). I got around that by moving it to /tmp and then cloning.

3) When I attempted to actually run puppet agent, I got an error code 255 from /etc/puppet/get_rev.sh which aborted the run.  I ran the script by hand and found that, unlike with other people, it didn't give me a revision number. I ran "/usr/local/bin/git describe --all --always --dirty" by hand and noticed it was giving me the error: "abort: requirement 'dotencode' not supported!" Googling that brought me to http://mercurial.selenic.com/wiki/RequiresFile and I tried blowing everything and recloning with "hg --config format.dotencode=0 clone --pull" After that, I was finally able to run the agent to test my changes.

Comment 1

[Dustin J. Mitchell [:dustin] (he/him)]

(In reply to Amy Rich [:arich] [:arr] from comment #0)
> 1) If you search for puppet environment on wikimo, apparently it sends you
> to the wrong (outdated) page.  Can we delete that and update the
> documentation to be accurate and findable via search (not sure how to
> accomplish the latter.  Maybe we have a link from mana, which I find
> infinitely more discoverable).

Searching for "puppet" will get you all manner of stuff.  "PuppetAgain" is the thing to search for.  I marked that page as deprecated, though.

Comment 2

[Dustin J. Mitchell [:dustin] (he/him)]

I updated the docs for the rest:

https://wiki.mozilla.org/ReleaseEngineering/PuppetAgain/HowTo/Set_up_a_user_environment#Common