Update job stuck error message due to CI job tags not matching tags assigned to runners
Overview
The error message This job is stuck because you don't have any active runners online or available with any of these tags assigned to them:
is ambiguous and does not enable the user to quickly determine the reason for the job failure.
Background
The other day I spent hours trying to find out why my GitLab Runner didn't pick up any of my jobs. It appeared as being successfully registered with GitLab and it was active, but still I was getting this error/warning on the pipeline jobs:
I wasn't able to find much documentation on GitLab Runner tags and no information on how multiple runner tags are interpreted. In the end I found out that I should probably understand them as capabilities that a runner needs in order for it to take the job (the runner was only registered with tag "macOS"). However, above screenshot didn't hint that at all by saying "with any of these tags". I'm not a native English speaker and that might be why I misunderstand the message, but if it had just been something like "with all of these tags" I would've immediately spotted the error and saved myself four hours of frustrating work.
I hope that you will improve the error message and maybe extend the GitLab Runner tag documentation a bit with how multiple tags are interpreted.
Proposal
-
Change the error message text to this job is stuck because you don't have any runners online or runners with all of these tags
.