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

FreeBSD Manual Pages

  
 
  

home | help
glab(1)								       glab(1)

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

SYNOPSIS
       glab ci run [flags]

DESCRIPTION
       The --branch option is available	for all	pipeline types.

       The   options   for  variables  are  incompatible  with	merge  request
       pipelines.  If used with	merge request  pipelines,  the	command	 fails
       with  a	message	 like ERROR: if	any flags in the group [output output-
       format] are set none of the others can be

       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 ex-
       plicitly	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	 exam-
       ple, key:array(foo,bar,)	will pass the array [foo, bar].	array()	speci-
       fies  an	 empty	array. To pass an array	with the empty string, use ar-
       ray(,).

       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/ref .

       -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 pipeline	in format :. Cannot be
       used for	MR pipelines.

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

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

       -f, --variables-from=""	    JSON file with variables for pipeline exe-
       cution. 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. Can use either OWNER/REPO
       or GROUP/NAMESPACE/REPO format. Also accepts full URL or	Git URL.

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)"

       // For an example of 'glab ci run -f' with a variables file, see
       // [Run a CI/CD pipeline	with variables from a file](https://docs.gitlab.com/editor_extensions/gitlab_cli/#run-a-cicd-pipeline-with-variables-from-a-file)
       // in the GitLab	documentation.

SEE ALSO
       glab-ci(1)

Auto generated by spf13/cobra	   Nov 2025			       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.0>

home | help