src batch exec

Flags

Name Description Default Value
-allow-unsupported Allow unsupported code hosts. 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. 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 is GOMAXPROCS. 8
-n Alias for -namespace.
-namespace The user or organization namespace to place the batch change within. Default is the currently authenticated user.
-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
-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 exec':
  -allow-unsupported
    	Allow unsupported code hosts.
  -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. (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 is GOMAXPROCS. (default 8)
  -n string
    	Alias for -namespace.
  -namespace string
    	The user or organization namespace to place the batch change within. Default is the currently authenticated user.
  -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.
  -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")

INTERNAL USE ONLY: 'src batch exec' executes the given raw batch spec in the given workspaces.

The input file contains a JSON dump of the WorkspacesExecutionInput struct in
github.com/sourcegraph/sourcegraph/lib/batches.

Usage:

    src batch exec -f FILE [command options]

Examples:

    $ src batch exec -f batch-spec-with-workspaces.json