Skip to content

mw gitlab runner-controller scope create

Releasev0.35.0 · cfeceb67

mw gitlab runner-controller scope create <controller-id> [flags]

Creates a scope for a runner controller. This is an administrator-only feature.

Use one of the following flags to specify the scope type:

  • –instance: Add an instance-level scope, allowing the runner controller to evaluate jobs for all runners in the GitLab instance.
  • –runner : Add a runner-level scope, allowing the runner controller to evaluate jobs for a specific instance-level runner. Multiple IDs can be comma-separated or specified by repeating the flag.

This feature is an experiment and is not ready for production use. It might be unstable or removed at any time. For more information, see https://docs.gitlab.com/policy/development_stages_support/.

--instance
Add an instance-level scope.
-F, --output <string>
Format output as: text, json. Default: text.
--runner <int64Slice>
Add a runner-level scope for the specified runner ID. Multiple IDs can be comma-separated or specified by repeating the flag.
-h, --help
Show help for this command.
--no-interaction
Do not ask any interactive questions
--profile <string>
Saved account profile (login defaults to the verified username)
-v, --verbose <count>
Increase output verbosity. Example: --verbose=2 or -vv
Terminal window
# Add an instance-level scope to runner controller 42
$ glab runner-controller scope create 42 --instance
# Add a runner-level scope for runner 5 to runner controller 42
$ glab runner-controller scope create 42 --runner 5
# Add runner-level scopes for multiple runners
$ glab runner-controller scope create 42 --runner 5 --runner 10
$ glab runner-controller scope create 42 --runner 5,10
# Add a runner-level scope and output as JSON
$ glab runner-controller scope create 42 --runner 5 --output json
Report an issue with this page

Report a documentation issue

The report includes this page’s link, section and documentation version.

Review and submit on Phabricator, or run the command using your saved CLI profile. The command asks before creating the task.