Rootmanual:foreman: Skillnad mellan sidversioner
Knase (diskussion | bidrag) (Add initial installation steps for setting up foreman on Debian 8) |
Hugo (diskussion | bidrag) (Skrev om hela sidan.) |
||
| Rad 1: | Rad 1: | ||
= Användning = |
|||
= Useful documentation = |
|||
== Importera miljöer och puppetklasser == |
|||
https://www.theforeman.org/manuals/1.14/index.html |
|||
Foreman plockar information om puppetklasser och miljöer från maskinen den kör på, dock behöver de importeras manuellt. Från UI:t, gå till [Configure] / [Environments], och klicka importera. |
|||
'''NOTERA''': Det att det tar ohemult lång tid, och kan behöva göras flera gånger för att komma igenom. |
|||
= Setting up Foreman on Debian 8 = |
|||
== Lägga till nya miljöer och puppetklasser == |
|||
Install the latest puppet versions: |
|||
I nuläget får Lysators Foreman-maskin ([[chapman]]) sina klasser uppdaterade genom r10k, referera till dess dokumentation. Ett cron-job kör <code>r10k deploy environment --modules</code> var annan minut. |
|||
apt -y install ca-certificates |
|||
wget https://apt.puppetlabs.com/puppetlabs-release-pc1-jessie.deb |
|||
dpkg -i puppetlabs-release-pc1-jessie.deb |
|||
= Installation = |
|||
Add Foreman repositories to apt for version 1.14: |
|||
echo "deb http://deb.theforeman.org/ jessie 1.14" > /etc/apt/sources.list.d/foreman.list |
|||
echo "deb http://deb.theforeman.org/ plugins 1.14" >> /etc/apt/sources.list.d/foreman.list |
|||
wget -q https://deb.theforeman.org/pubkey.gpg -O- | apt-key add - |
|||
apt update |
|||
För Lysators räkning finns en färdig puppet-profil för att installera Foreman (https://git.lysator.liu.se/lysator/puppet/profiles/-/blob/foreman_next_next/manifests/puppetserver.pp). Om Foreman sätts upp från en annan puppet-server behöver man antagligen låta den bryta sig låss från den gamla, vilken enklast görs genom att ta bort alla gamla nycklar, och omgenerera dem. |
|||
Install foreman-installer: |
|||
apt -y install foreman-installer |
|||
Texten är skriven utifrån CentOS 8. |
|||
Run the foreman-installer: |
|||
foreman-installer |
|||
== Omgenerera Nycklar == |
|||
'''VARNING GÖR INTE DET HÄR, DET KOMMER HA SÖNDER HALVA LYSATOR''' |
|||
Ta bort alla filer under <code>/etc/puppetlabs/puppet/ssl</code>, samt möjligen <code>/etc/puppetlabs/puppet/crl.pem</code>. Kör sedan |
|||
/opt/puppetlabs/bin/puppetserver ca setup --certname $(hostname --fqdn) --subject-alt-names puppet |
|||
== Återställ Foremans Admin-lösenord == |
|||
foreman-rake permissions:reset |
|||
== Övrigt att se upp för == |
|||
=== Fel Ruby === |
|||
På CentOS kan ruby-repona bytas ut till (i skrivandets stund, 2022-02-02, korrekta) med: |
|||
dnf module reset ruby |
|||
dnf module install ruby:2.7 |
|||
=== Puppet Saknas === |
|||
Sedan Foreman 3.0 kommer inte puppet förinstallerat. Se till att installera det. |
|||
Versionen från 2 februari 2022 kl. 19.18
Användning
Importera miljöer och puppetklasser
Foreman plockar information om puppetklasser och miljöer från maskinen den kör på, dock behöver de importeras manuellt. Från UI:t, gå till [Configure] / [Environments], och klicka importera.
NOTERA: Det att det tar ohemult lång tid, och kan behöva göras flera gånger för att komma igenom.
Lägga till nya miljöer och puppetklasser
I nuläget får Lysators Foreman-maskin (chapman) sina klasser uppdaterade genom r10k, referera till dess dokumentation. Ett cron-job kör r10k deploy environment --modules var annan minut.
Installation
För Lysators räkning finns en färdig puppet-profil för att installera Foreman (https://git.lysator.liu.se/lysator/puppet/profiles/-/blob/foreman_next_next/manifests/puppetserver.pp). Om Foreman sätts upp från en annan puppet-server behöver man antagligen låta den bryta sig låss från den gamla, vilken enklast görs genom att ta bort alla gamla nycklar, och omgenerera dem.
Texten är skriven utifrån CentOS 8.
Omgenerera Nycklar
VARNING GÖR INTE DET HÄR, DET KOMMER HA SÖNDER HALVA LYSATOR
Ta bort alla filer under /etc/puppetlabs/puppet/ssl, samt möjligen /etc/puppetlabs/puppet/crl.pem. Kör sedan
/opt/puppetlabs/bin/puppetserver ca setup --certname $(hostname --fqdn) --subject-alt-names puppet
Återställ Foremans Admin-lösenord
foreman-rake permissions:reset
Övrigt att se upp för
Fel Ruby
På CentOS kan ruby-repona bytas ut till (i skrivandets stund, 2022-02-02, korrekta) med:
dnf module reset ruby dnf module install ruby:2.7
Puppet Saknas
Sedan Foreman 3.0 kommer inte puppet förinstallerat. Se till att installera det.