Instalar Foreman en servidor Debian Bookworm con Puppetserver 7

Foreman es una excelente herramienta para monitorizar el estado de Puppet en nuestros clientes.

En este post, vamos a ver cómo hemos instalado Foreman en nuestro servidor Puppet v6 con sistema Debian Bullseye.

Lo primero que hicimos fue agregar el repositorio de foreman a un fichero de fuentes:

echo "deb http://deb.theforeman.org/ bookworm 3.12" | sudo tee /etc/apt/sources.list.d/foreman.list
echo "deb http://deb.theforeman.org/ plugins 3.12" | sudo tee -a /etc/apt/sources.list.d/foreman.list

En este caso, agregamos la última versión disponible (3.12) para Debian Bookworm. ¿Por qué para Bookworm? Porque el Puppetserver 7 que teníamos instalado en el servidor era de Debian Bookworm.

Una vez agregado el repositorio, agregamos la clave pública del mismo:

wget -qO - https://deb.theforeman.org/pubkey.gpg | sudo gpg --dearmor --output /etc/apt/trusted.gpg.d/theforeman-archive-keyring.gpg

Una vez agregada la clave pública, realizamos un apt update:

sudo apt update

E instalamos el paquete foreman-installer:

sudo apt-get -y install foreman-installer

Una vez instalado el paquete, ejecutamos foreman-installer para realizar la instalación.

sudo foreman-installer

En nuestro caso, se produjo un error al realizar la instalación porque el instalador requería que el sistema tuviese los locales "en_US.utf8" y no los tenía. Para solucionar el problema, simplemente ejecutamos "dpkg-reconfigure locales" y agregamos el paquete de idioma "en_US.utf8".

Si se produce algún error, una vez solventado, volvemos a ejecutar el instalador. Al final, veréis que se finaliza el proceso de instalación sin errores:

foreman-installer 
2024-11-08 09:31:00 [NOTICE] [root] Loading installer configuration. This will take some time.
2024-11-08 09:31:05 [NOTICE] [root] Running installer with log based terminal output at level NOTICE.
2024-11-08 09:31:05 [NOTICE] [root] Use -l to set the terminal output log level to ERROR, WARN, NOTICE, INFO, or DEBUG. See --full-help for definitions.
2024-11-08 09:31:06 [NOTICE] [checks] System checks passed
2024-11-08 09:31:08 [NOTICE] [configure] Starting system configuration.

2024-11-08 09:34:50 [NOTICE] [configure] 250 configuration steps out of 1239 steps complete.
2024-11-08 09:34:50 [NOTICE] [configure] 500 configuration steps out of 1242 steps complete.
2024-11-08 09:34:50 [NOTICE] [configure] 750 configuration steps out of 1373 steps complete.
2024-11-08 09:35:44 [NOTICE] [configure] 1000 configuration steps out of 1375 steps complete.
2024-11-08 09:36:00 [NOTICE] [configure] 1250 configuration steps out of 1375 steps complete.
2024-11-08 09:36:33 [NOTICE] [configure] System configuration has finished.
Executing: foreman-rake upgrade:run
  Success!
  * Foreman is running at https://servidor3.valledeljerte3
      Initial credentials are admin / V4XW2xVgFZub1RJt
  * Foreman Proxy is running at https://servidor3.valledeljerte3:8443

The full log is at /var/log/foreman-installer/foreman.log

Como podéis ver, al finalizar el proceso de instalación, nos muestra la URL de acceso a Foreman.

Para acceder a la interfaz, abrimos un navegador, e introducimos la URL. Se nos abrirá una ventana donde tendremos que introducir los datos de acceso:

El usuario es admin y la contraseña inicial, la que nos muestra en pantalla al realizar la instalación.

Una vez que hayáis accedido con dichas credenciales, podéis cambiar la contraseña en el menú Administrar -> Usuarios