You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+16-41Lines changed: 16 additions & 41 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,11 +13,8 @@ Table of contents
13
13
*[Install PE](#install-pe)
14
14
*[Get the control\-repo deployed on your master](#get-the-control-repo-deployed-on-your-master)
15
15
*[Setup a webhook in your Git server](#setup-a-webhook-in-your-git-server)
16
+
*[Gitlab](#gitlab-1)
16
17
*[Test Code Manager](#test-code-manager)
17
-
*[Updating from a previous version of PE](#updating-from-a-previous-version-of-pe)
18
-
*[Upgrading to PE2015\.3\.z from PE 2015\.2\.z](#upgrading-to-pe20153z-from-pe-20152z)
19
-
*[Appendix](#appendix)
20
-
*[Test the zack/r10k webhook](#test-the-zackr10k-webhook)
21
18
22
19
# Join the #ramp-up channel on Puppet Community Slack
23
20
@@ -35,9 +32,9 @@ When you finish the instructions below, you will have the beginning of a best pr
35
32
36
33
- A Git server
37
34
- The ability to push code to your Git server and have it automatically deployed to your PE master
38
-
- A config_version script that outputs the most recent sha for your code deployment each time you run `puppet agent -t`
35
+
- A config_version script that outputs the most recent SHA of your code each time you run `puppet agent -t`
39
36
- Optimal tuning of PE settings for this configuration
40
-
- Working and example [roles and profiles](https://docs.puppetlabs.com/pe/2015.3/puppet_assign_configurations.html#assigning-configuration-data-with-role-and-profile-modules) code
37
+
- Working and example [roles and profiles](https://docs.puppet.com/pe/latest/puppet_assign_configurations.html#assigning-configuration-data-with-role-and-profile-modules) code
41
38
42
39
# How to set it all up
43
40
@@ -65,7 +62,7 @@ When you finish the instructions below, you will have the beginning of a best pr
At this point you have our control-repo code deployed into your Git server. However, we have one final challenge: getting that code onto your Puppet master. In the end state the master will pull code from the Git server via Code Manager, however, at this moment your Puppet master does not have credentials to get code from the Git server.
108
105
109
-
So, we will set up a deploy key in the Git server that will allow an SSH key we make to deploy the code and configure everything else.
106
+
We will set up a deploy key in the Git server that will allow an SSH key we make to deploy the code and configure everything else.
110
107
111
108
1. On your Puppet master, make an SSH key for r10k to connect to GitLab
@@ -159,10 +156,18 @@ So, we will set up a deploy key in the Git server that will allow an SSH key we
159
156
160
157
## Setup a webhook in your Git server
161
158
159
+
Independent of which Git server you choose you will grab the webhook URL from your master. Then each Git Server will have similar but slightly different ways to add the webhook.
4. In your first terminal window review the `puppetserver.log` to see the type of logging each sync will create
184
-
185
-
----
186
-
# Updating from a previous version of PE
187
-
188
-
## Upgrading to PE 2015.3.z from PE 2015.2.z
189
-
190
-
Remove `pe_r10k` from the PE master group in the console and instead add the following two parameters to the `puppet_enterprise::profile::master` class under the PE master group.
191
-
192
-
- `r10k_remote` = the SSH URL for your internal repo
When upgrading the `puppet_enterprise::profile::master` class has the `file_sync_enabled` parameter set to `false`. This parameter should be removed so that Code Manager can configure file sync.
196
-
197
-
Finally, you’ll need to `echo 'code_manager_mv_old_code=true' > /opt/puppetlabs/facter/facts.d/code_manager_mv_old_code.txt` so that my Puppet code will redeploy all of your code with Code Manager.
198
-
199
-
# Appendix
200
-
201
-
## Test the zack/r10k webhook
202
-
203
-
If you are using PE2015.2.z or if you've forced the use of the zack/r10k webhook then you'll want to test that it works.
204
-
205
-
One of the components setup by this control-repo is that when you "push" code to your Git server, the Git server will inform the Puppet master to run `r10k deploy environment -p`.
206
-
207
-
1. Edit README.md
208
-
- Just add something to it
209
-
2. `git add README.md`
210
-
3. `git commit -m "edit README"`
211
-
4. `git push origin production`
212
-
5. Allow the push to complete and then give it few seconds to complete
213
-
- Open `/etc/puppetlabs/code/environments/production/README.md` and confirm your change is present
0 commit comments