--- title: '`glab ci run`' stage: AI Clients group: Developer Clients info: To determine the technical writer assigned to the Stage/Group associated with this page, see --- Create a new CI/CD pipeline. ## Synopsis Use `--branch` to specify a branch or reference. Defaults to the current branch. The variable flags (`--variables`, `--variables-env`, `--variables-file`, `--variables-from`) cannot be used with `--mr`. If both are used, the command fails. Specify one or more pipeline inputs using the `-i` or `--input` flag for each input. Each input flag uses the format `key:value`. The values are typed and will default to `string` unless a type is explicitly specified. To specify a type, use the `type(value)` syntax. For example, `key:string(value)` will pass the string `value` as the input. Valid types are: - `string`: A string value. This type is the default. For example, `key:string(value)`. - `int`: An integer value. For example, `key:int(42)`. - `float`: A floating-point value. For example, `key:float(3.14)`. - `bool`: A boolean value. For example, `key:bool(true)`. - `array`: An array of strings. For example, `key:array(foo,bar)`. An array of strings can be specified with a trailing comma. For example, `key:array(foo,bar,)` will pass the array `[foo, bar]`. `array()` specifies an empty array. To pass an array with the empty string, use `array(,)`. Value arguments containing parentheses should be escaped from the shell with quotes. For example, `--input key:array(foo,bar)` should be written as `--input 'key:array(foo,bar)'`. ```plaintext glab ci run [flags] ``` ## Aliases ```plaintext create ``` ## Examples ```console glab ci run glab ci run --variables \"key1:value,with,comma\" glab ci run -b main glab ci run --web glab ci run --mr # Specify CI variables glab ci run -b main --variables-env key1:val1 glab ci run -b main --variables-env key1:val1,key2:val2 glab ci run -b main --variables-env key1:val1 --variables-env key2:val2 glab ci run -b main --variables-file MYKEY:file1 --variables KEY2:some_value # Specify CI inputs glab ci run -b main --input key1:val1 --input key2:val2 glab ci run -b main --input "replicas:int(3)" --input "debug:bool(false)" --input "regions:array(us-east,eu-west)" # Load variables from JSON file # Create variables.json with this format: # [ # { # "key": "CI_PIPELINE_SOURCE", # "value": "web", # "variable_type": "env_var" # }, # { # "key": "DEPLOY_ENV", # "value": "production" # } # ] glab ci run -b main --variables-from variables.json ``` ## Options ```plaintext -b, --branch string Create pipeline on branch or reference . -i, --input stringArray Pass inputs to pipeline in format ':'. Cannot be used for merge request pipelines. See documentation for examples. --mr Run merge request pipeline instead of branch pipeline. --variables strings Pass variables to the pipeline in the format :. Cannot be used for MR pipelines. --variables-env strings Pass variables to the pipeline in the format :. Cannot be used for MR pipelines. --variables-file strings Pass file contents as a file variable to the pipeline in the format :. Cannot be used for MR pipelines. -f, --variables-from string JSON file with variables for pipeline execution. Expects array of hashes, each with at least 'key' and 'value'. Cannot be used for MR pipelines. -w, --web Open pipeline in a browser. Uses default browser, or browser specified in BROWSER environment variable. ``` ## Options inherited from parent commands ```plaintext -h, --help Show help for this command. -R, --repo string Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted. ```