src batch preview

Flags

Name	Description	Default Value
-allow-unsupported	Allow unsupported code hosts.	false
-apply	Ignored.	false
-cache	Directory for caching results and repository archives.	~/.cache/sourcegraph/batch
-clean-archives	If true, deletes downloaded repository archives after executing batch spec steps. Note that only the archives related to the actual repositories matched by the batch spec will be cleaned up, and clean up will not occur if src exits unexpectedly.	true
-clear-cache	If true, clears the execution cache and executes all steps anew.	false
-dump-requests	Log GraphQL requests and responses to stdout	false
-f	The batch spec file to read, or - to read from standard input.
-force-override-ignore	Do not ignore repositories that have a .batchignore file.	false
-get-curl	Print the curl command for executing this query and exit (WARNING: includes printing your access token!)	false
-insecure-skip-verify	Skip validation of TLS certificates against trusted chains	false
-j	The maximum number of parallel jobs. Default (or 0) is the number of CPU cores available to Docker.	0
-keep-logs	Retain logs after executing steps.	false
-n	Alias for -namespace.
-namespace	The user or organization namespace to place the batch change within. Default is the currently authenticated user.
-run-as-root	If true, forces all step containers to run as root.	false
-skip-errors	If true, errors encountered while executing steps in a repository won't stop the execution of the batch spec but only cause that repository to be skipped.	false
-text-only	INTERNAL USE ONLY. EXPERIMENTAL. Switches off the TUI to only print JSON lines.	false
-timeout	The maximum duration a single batch spec step can take.	1h0m0s
-tmp	Directory for storing temporary data, such as log files. Default is /tmp. Can also be set with environment variable SRC_BATCH_TMP_DIR; if both are set, this flag will be used and not the environment variable.	/tmp
-trace	Log the trace ID for requests. See https://docs.sourcegraph.com/admin/observability/tracing	false
-user-agent-telemetry	Include the operating system and architecture in the User-Agent sent with requests to Sourcegraph	true
-v	print verbose output	false
-workspace	Workspace mode to use ("auto", "bind", or "volume")	auto

Usage

Usage of 'src batch preview':
  -allow-unsupported
    	Allow unsupported code hosts.
  -apply
    	Ignored.
  -cache string
    	Directory for caching results and repository archives. (default "~/.cache/sourcegraph/batch")
  -clean-archives
    	If true, deletes downloaded repository archives after executing batch spec steps. Note that only the archives related to the actual repositories matched by the batch spec will be cleaned up, and clean up will not occur if src exits unexpectedly. (default true)
  -clear-cache
    	If true, clears the execution cache and executes all steps anew.
  -dump-requests
    	Log GraphQL requests and responses to stdout
  -f string
    	The batch spec file to read, or - to read from standard input.
  -force-override-ignore
    	Do not ignore repositories that have a .batchignore file.
  -get-curl
    	Print the curl command for executing this query and exit (WARNING: includes printing your access token!)
  -insecure-skip-verify
    	Skip validation of TLS certificates against trusted chains
  -j int
    	The maximum number of parallel jobs. Default (or 0) is the number of CPU cores available to Docker.
  -keep-logs
    	Retain logs after executing steps.
  -n string
    	Alias for -namespace.
  -namespace string
    	The user or organization namespace to place the batch change within. Default is the currently authenticated user.
  -run-as-root
    	If true, forces all step containers to run as root.
  -skip-errors
    	If true, errors encountered while executing steps in a repository won't stop the execution of the batch spec but only cause that repository to be skipped.
  -text-only
    	INTERNAL USE ONLY. EXPERIMENTAL. Switches off the TUI to only print JSON lines.
  -timeout duration
    	The maximum duration a single batch spec step can take. (default 1h0m0s)
  -tmp string
    	Directory for storing temporary data, such as log files. Default is /tmp. Can also be set with environment variable SRC_BATCH_TMP_DIR; if both are set, this flag will be used and not the environment variable. (default "/tmp")
  -trace
    	Log the trace ID for requests. See https://docs.sourcegraph.com/admin/observability/tracing
  -user-agent-telemetry
    	Include the operating system and architecture in the User-Agent sent with requests to Sourcegraph (default true)
  -v	print verbose output
  -workspace string
    	Workspace mode to use ("auto", "bind", or "volume") (default "auto")

'src batch preview' executes the steps in a batch spec and uploads it to a
Sourcegraph instance, ready to be previewed and applied.

Usage:

    src batch preview [command options] [-f FILE]
    src batch preview [command options] FILE

Examples:

    $ src batch preview -f batch.spec.yaml

    $ src batch preview batch.spec.yaml