Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
glab(1) 								 glab(1)

NAME
     glab-ci-run - Create a new CI/CD pipeline.

SYNOPSIS
     glab ci run [flags]

DESCRIPTION
     Use  --branch  to	specify  a  branch or reference. Defaults to the current
     branch.

     The variable flags (--variables, --variables-env, --variables-file, --vari-
     ables-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  is  the  default  type.  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)'.

OPTIONS
     -b, --branch=""	  Create pipeline on branch or reference .

     -i,  --input=[]	   Pass inputs to pipeline in format ':'. Cannot be used
     for merge request pipelines. See documentation for examples.

     --mr[=false]      Run merge request pipeline instead of branch pipeline.

     --variables=[]	 Pass variables to the pipeline in the format :.  Cannot
     be used for MR pipelines.

     --variables-env=[]       Pass  variables  to  the pipeline in the format :.
     Cannot be used for MR pipelines.

     --variables-file=[]      Pass file contents  as  a  file  variable  to  the
     pipeline in the format :. Cannot be used for MR pipelines.

     -f,  --variables-from=""	    JSON file with variables for pipeline execu-
     tion. Expects array of hashes, each with at least 'key' and 'value'. Cannot
     be used for MR pipelines.

     -w, --web[=false]	    Open pipeline in a browser. Uses default browser, or
     browser specified in BROWSER environment variable.

OPTIONS INHERITED FROM PARENT COMMANDS
     -h, --help[=false]      Show help for this command.

     -R, --repo=""	Select another repository. You can use either OWNER/REPO
     or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.

EXAMPLE
     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

SEE ALSO
     glab-ci(1)

Auto generated by spf13/cobra	    Aug 2026				 glab(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=glab-ci-run&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help