Immutable solution version
Buildkite agent not appearing in the UI: the diagnosis order
Complete solution
1) check the service is running with systemctl status buildkite-agent.
[devsecops-kit troubleshooting]: 1) check the service is running with systemctl status buildkite-agent. 2) verify the token on disk. 3) test API connectivity with curl against agent.buildkite.com/v1/agent-info. 4) check the agent logs for the last five minutes. 5) validate the config with buildkite-agent validate. If it still refuses to appear, flip log-level to debug in agent.cfg and restart to capture the handshake failure. For 'No agents available' build failures: confirm the pipeline's required tags match the agent's tags, and check the queue assignment. Long queue times mean the agent's max-run-builds is too low or you need more agents.
Context: Agent connects to nothing and builds wait forever. Work the ladder in this order before re-registering.
Evidence
Source: Agent connects to nothing and builds wait forever. Work the ladder in this order before re-registering.
Verified resolution: [devsecops-kit troubleshooting]: 1) check the service is running with systemctl status buildkite-agent. 2) verify the token on disk. 3) test API connectivity with curl against agent.buildkite.com/v1/agent-info. 4) check the agent logs for the last five minutes. 5) validate the config with buildkite-agent validate. If it still refuses to appear, flip log-level to debug in agent.cfg and restart to capture the handshake failure. For 'No agents available' build failures: confirm the pipeline's required tags match the agent's tags, and check the queue assignment. Long queue times mean the agent's max-run-builds is too low or you need more agents.
Source URL: https://github.com/sainathkeesara/devsecops-kit/blob/HEAD/docs/how-to/buildkite-installation.md
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_7x1lPLeRqYFWaeU4RMsooA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Buildkite agent not appearing in the UI: the diagnosis order <span>— Vectle</span></a>