5 problemas comunes en la empresa de títeres
Puppet Enterprise es una gran plataforma para automatizar la configuración y el despliegue de aplicaciones en servidores, pero como una sofisticada herramienta de gestión de infraestructuras con numerosas partes móviles interconectadas, puede ser un reto solucionar problemas cuando las cosas van mal. Esto es especialmente cierto cuando se trata de errores en cascada que son difíciles de aislar para su resolución. Lo que sigue es una breve lista de algunos de los problemas más comunes que uno puede encontrar, y algunos consejos sobre cómo solucionarlos y resolverlos.
1. No puede iniciar sesión como administrador en la consola
Localizar los archivos de registro adecuados para el análisis es el primer paso para determinar la causa raíz:
Uso de la autenticación de terceros (Active Directory, LDAP, et al.):
- /var/registro/pe-httpd/access.log
- /var/registro/pe-httpd/error.log
Uso del servicio de autenticación de consola (sistema de autenticación integrado de Puppet):
- /var/log/pe-consol-auth/cas.log
En cualquier caso, los archivos de registro respectivos contendrán información sobre por qué falló la autenticación. Para esta discusión, supondremos que el servicio de autenticación de consola nativo se usa sobre la autenticación de terceros. El análisis del archivo /var/log/pe-consol-auth/cas.log debería revelar algo como "Credenciales no válidas dadas para el usuario 'adminuser1@acme.com'", donde 'adminuser1@acmecorp.com' es el usuario en cuestión.
Los administradores también pueden encontrarse bloqueados después de 10 intentos fallidos de inicio de sesión. En esta situación, otro administrador debe iniciar sesión para borrar manualmente el bloqueo de la otra cuenta. Problema resuelto: suponiendo que exista otra cuenta de administrador. Pero si no, ¿entonces qué? Al ejecutar lo siguiente, se creará una nueva cuenta de administrador:
$cd /opt/puppet/share/console-auth$sudo /opt/puppet/bin/rake db:create_user USERNAME= "adminuser2@acmecorp.com " PASSWORD= "<password> " ROLE= "Admin "
La nueva cuenta de administrador se puede usar para iniciar sesión y desbloquear la otra cuenta de administrador.
Alternativamente, se puede desbloquear a un usuario eliminando directamente la marca de bloqueo de su registro de base de datos. Puppet ha creado un tutorial sobre cómo hacer esto, aunque es específico para las bases de datos Postgres instaladas en PE.
2. Los nodos no aparecen en el panel de control de la consola
De nuevo, asegúrese de comprobar los registros adecuados como paso inicial para la solución de problemas:
- /var/log/pe-httpd/puppetdashboard.error.log
- /var/log/pe-httpd/puppetdashboard.access.log
- /var/registro/pe-httpd/puppetmaster.error.log
El panel Tareas en segundo plano puede proporcionar información adicional sobre por qué no aparecen los nodos. Un gran número de tareas en segundo plano puede indicar un trabajador del panel que no funciona correctamente.
En este caso, detener e iniciar pe-puppet-dashboard-workers puede solucionar el problema. Asegúrese de volver a comprobar el panel Tareas en segundo plano después de reiniciar los trabajadores del panel para comprobar que el número de tareas ha disminuido.
3. No se enumeran datos para los nodos en el panel de control de la consola, o el administrador de nodos muestra una página en blanco o un mensaje de error
Más a menudo, este problema se produce cuando hay problemas con el certificado del panel interno de Puppet. Esto se puede verificar analizando el archivo de registro adecuado:
- /var/registro/pe-httpd/puppetmaster.error.log
Si existen errores de verificación de certificados o SSL, la regeneración del certificado del panel interno debería resolver el problema.
4. PuppetDB no se inicia o falla silenciosamente
Existen una miríada de causas para que PuppetDB no se inicie o falle, siendo la más común quedarse sin memoria. Para comprobar que este es el caso, compruebe el archivo de registro adecuado:
- /var/log/pe-puppetdb/puppetdb.log
Si ve un error como "java.lang.OutOfMemoryError: Java heap space", aumentar la memoria de Puppet a un límite superior debería resolver el problema. Esto se puede hacer editando el archivo de configuración /etc/sysconfig/pe-puppetdb o /etc/default/pe-puppetdb, dependiendo de su sistema operativo.
5. No aparecen nodos en la gestión en vivo
Cuando se utiliza Live Management para examinar recursos en nodos e invocar acciones de orquestación, a veces aparece un panel en blanco sin nodos presentes. El análisis del archivo /var/log/pe-httpd/error.log debería revelar una línea que dice "No respondieron los servidores MCollective. " Reiniciar MCollective en el maestro y/o los agentes debería solucionar eficazmente el problema.
Una nota final sobre los registros: son tus amigos, y deben ser mirados primero cuando te encuentres con problemas. Si bien esto puede parecer una obviedad, la realidad es que los archivos de registro a menudo se pasan por alto cuando se vienen a la mente soluciones obvias. Para facilitar las cosas, Puppet Labs creó esta hoja de trucos para averiguar dónde se encuentran los distintos registros y qué podrían significar los errores/advertencias. Dicho esto, el análisis de registros debería ser el primero de una serie de pasos para resolver los problemas encontrados con Puppet.
Aunque estos 5 problemas comunes de Puppet Enterprise pueden tener varias causas, en muchos casos los problemas (por ejemplo, nodos que no informan o una base de datos que falla) son el resultado de configuraciones incorrectas antes de la automatización. Es fundamental que las configuraciones de la infraestructura y las aplicaciones sean visibles y comprendidas primero, con el objetivo de controlar el entorno antes de la automatización. GuardRail simplifica la tarea de detección de requisitos de automatización e incluso puede convertir esos requisitos en manifiestos de Puppet preformateados. Al validar las configuraciones tanto durante la compilación posterior como de forma continua, puede estar seguro de que el estado de sus sistemas está bajo control y a salvo de desviaciones de la configuración.