Saltar al contenido principal

Solución de problemas

1. El runner muestra el error 404​

Cómo solucionarlo​

Obtención del código de error 401 desde el runner

2. Problema de Gathering Facts para localhost​

El problema puede producirse en Semaphore UI instalado mediante Snap o Docker.

4:10:16 PM
TASK [Gathering Facts] *********************************************************
4:10:17 PM
fatal: [localhost]: FAILED! => changed=false

Por qué ocurre​

Para más información sobre el uso de localhost en Ansible, lea este artículo: Implicit 'localhost'.

Ansible intenta recopilar los facts localmente, pero Ansible se encuentra en un contenedor aislado y limitado que no lo permite.

Cómo solucionarlo​

Hay dos formas:

  1. Desactivar la recopilación de facts:
- hosts: localhost
  gather_facts: False
  roles:
    - ...
  1. Establecer explícitamente el tipo de conexión en ssh:
[localhost]
127.0.0.1 ansible_connection=ssh ansible_ssh_user=your_localhost_user

3. panic: pq: SSL is not enabled on the server​

Esto significa que su Postgres no funciona con SSL.

Cómo solucionarlo​

Añada la opción sslmode=disable al archivo de configuración:

	"postgres": {
		"host": "localhost",
		"user": "postgres",
		"pass": "pwd",
		"name": "semaphore",
		"options": {
			"sslmode": "disable"
		}
	},

4. fatal: bad numeric config value '0' for 'GIT_TERMINAL_PROMPT': invalid unit​

Esto significa que está intentando acceder a un repositorio a través de HTTPS que requiere autenticación.

Cómo solucionarlo​

  • Vaya a la pantalla Almacén de claves.
  • Cree una nueva clave de tipo Login with password.
  • Indique su usuario de GitHub/BitBucket/etc.
  • Indique la contraseña. No puede usar la contraseña de su cuenta de GitHub/BitBucket; en su lugar debe usar un Personal Access Token (PAT). Lea más aquí.
  • Tras crear la clave, vaya a la pantalla Repositorios, busque su repositorio e indique la clave.

5. El clone o pull de Git falla de forma intermitente​

Los registros de la tarea pueden mostrar mensajes como Git pull failed (...), retrying in 2s seguidos de un éxito o de un fallo definitivo tras varios intentos.

Por qué ocurre​

El servidor git estuvo temporalmente inaccesible o devolvió un error transitorio. Semaphore reintenta automáticamente las operaciones de clone y pull antes de marcar la tarea como fallida.

Cómo solucionarlo​

  1. Interrupciones transitorias: normalmente se resuelven por sí solas. Semaphore reintenta hasta git_attempts veces (4 de forma predeterminada) con retroceso exponencial.
  2. Fallos frecuentes: aumente git_attempts en su configuración o establezca SEMAPHORE_GIT_ATTEMPTS.
  3. Fallos inmediatos y constantes: compruebe la URL del repositorio, la rama, las claves de acceso y la conectividad de red.

Consulte Operaciones de Git para los detalles de configuración.

6. unable to read LDAP response packet: unexpected EOF​

Lo más probable es que esté intentando conectarse al servidor LDAP con un método inseguro, aunque este espera una conexión segura (mediante TLS).

Cómo solucionarlo​

Habilite TLS en su archivo config.json:

...
"ldap_needtls": true
...

7. LDAP Result Code 49 "Invalid Credentials"​

Tiene una contraseña o un binddn incorrectos.

Cómo solucionarlo​

Use la herramienta ldapwhoami y compruebe si su binddn funciona:

ldapwhoami\
  -H ldap://ldap.com:389\
  -D "CN=/your/ldap_binddn/value/in/config/file"\
  -x\
  -W

Le pedirá la contraseña de forma interactiva y debería devolver el código 0 y mostrar el DN especificado.

También puede leer los siguientes artículos:

8. LDAP Result Code 32 "No Such Object"​

Próximamente.