Forrest logo
back to the gitlab-runner tool

gitlab-runner:tldr:cb962

gitlab-runner: Unregister a runner.
$ sudo gitlab-runner unregister --name ${name}
try on your machine

This command is used to unregister a GitLab Runner instance from GitLab using the GitLab Runner CLI (Command Line Interface). It basically tells the GitLab Runner to remove itself from the list of available runners in GitLab.

Let's break down the command:

  • sudo: It is a command that allows you to execute another command with administrative or superuser privileges. In this case, it runs the following command with elevated privileges.
  • gitlab-runner unregister: This is the main part of the command. It invokes the GitLab Runner CLI with the "unregister" command, which is used to unregister the runner from GitLab.
  • --name ${name}: This is an argument for the command. ${name} is a placeholder for a variable that should be replaced with the actual name of the runner. It specifies the name of the runner to unregister. Replace ${name} with the actual name of the runner you want to unregister.

By executing this command, the specified GitLab Runner will be unregistered and will no longer be available for jobs assigned by GitLab pipelines.

This explanation was created by an AI. In most cases those are correct. But please always be careful and never run a command you are not sure if it is safe.
back to the gitlab-runner tool