Skillnad mellan versioner av "Rootmanual:foreman"

Från Lysators datorhandbok, den ultimata referensen.
Hoppa till navigering Hoppa till sök
(Add initial installation steps for setting up foreman on Debian 8)
 
(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. 18.19

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.