fn withConcurrency(value)fn withConcurrencyMixin(value)fn withContainer(value)fn withContainerMixin(value)fn withContinueOnError(value)fn withContinueOnErrorMixin(value)fn withDefaults(value)fn withDefaultsMixin(value)fn withEnv(value)fn withEnvMixin(value)fn withEnvironment(value)fn withEnvironmentMixin(value)fn withIf(value)fn withName(value)fn withNeeds(value)fn withNeedsMixin(value)fn withOutputs(value)fn withOutputsMixin(value)fn withPermissions(value)fn withPermissionsMixin(value)fn withRunsOn(value)fn withRunsOnMixin(value)fn withServices(value)fn withServicesMixin(value)fn withSteps(value)fn withStepsMixin(value)fn withStrategy(value)fn withStrategyMixin(value)fn withTimeoutMinutes(value=360)fn withTimeoutMinutesMixin(value=360)obj concurrencyobj containerfn withContainer(value)fn withContainerMixin(value)fn withCredentials(value)fn withCredentialsMixin(value)fn withEnv(value)fn withEnvMixin(value)fn withImage(value)fn withOptions(value)fn withPorts(value)fn withPortsMixin(value)fn withVolumes(value)fn withVolumesMixin(value)obj containerobj credentialsobj env
obj continue-on-errorobj defaultsobj envobj environmentobj needsobj permissionsfn withActions(value)fn withAttestations(value)fn withChecks(value)fn withContents(value)fn withDeployments(value)fn withDiscussions(value)fn withIdToken(value)fn withIssues(value)fn withPackages(value)fn withPages(value)fn withPullRequests(value)fn withRepositoryProjects(value)fn withSecurityEvents(value)fn withStatuses(value)
obj runs-onobj strategyobj timeout-minutes
withConcurrency(value)PARAMETERS:
- value (
object,string)
Concurrency ensures that only a single job or workflow using the same concurrency group will run at a time. A concurrency group can be any string or expression. The expression can use any context except for the secrets context. You can also specify concurrency at the workflow level. When a concurrent job or workflow is queued, if another job or workflow using the same concurrency group in the repository is in progress, the queued job or workflow will be pending. Any previously pending job or workflow in the concurrency group will be canceled. To also cancel any currently running job or workflow in the same concurrency group, specify cancel-in-progress: true.
withConcurrencyMixin(value)PARAMETERS:
- value (
object,string)
Concurrency ensures that only a single job or workflow using the same concurrency group will run at a time. A concurrency group can be any string or expression. The expression can use any context except for the secrets context. You can also specify concurrency at the workflow level. When a concurrent job or workflow is queued, if another job or workflow using the same concurrency group in the repository is in progress, the queued job or workflow will be pending. Any previously pending job or workflow in the concurrency group will be canceled. To also cancel any currently running job or workflow in the same concurrency group, specify cancel-in-progress: true.
withContainer(value)PARAMETERS:
- value (
object)
A container to run any steps in a job that don't already specify a container. If you have steps that use both script and container actions, the container actions will run as sibling containers on the same network with the same volume mounts. If you do not set a container, all steps will run directly on the host specified by runs-on unless a step refers to an action configured to run in a container.
withContainerMixin(value)PARAMETERS:
- value (
object)
A container to run any steps in a job that don't already specify a container. If you have steps that use both script and container actions, the container actions will run as sibling containers on the same network with the same volume mounts. If you do not set a container, all steps will run directly on the host specified by runs-on unless a step refers to an action configured to run in a container.
withContinueOnError(value)PARAMETERS:
- value (
boolean,string)
Prevents a workflow run from failing when a job fails. Set to true to allow a workflow run to pass when this job fails.
withContinueOnErrorMixin(value)PARAMETERS:
- value (
boolean,string)
Prevents a workflow run from failing when a job fails. Set to true to allow a workflow run to pass when this job fails.
withDefaults(value)PARAMETERS:
- value (
object)
A map of default settings that will apply to all steps in the job.
withDefaultsMixin(value)PARAMETERS:
- value (
object)
A map of default settings that will apply to all steps in the job.
withEnv(value)PARAMETERS:
- value (
object,string)
To set custom environment variables, you need to specify the variables in the workflow file. You can define environment variables for a step, job, or entire workflow using the jobs.<job_id>.steps[*].env, jobs.<job_id>.env, and env keywords. For more information, see https://docs.github.com/en/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv
withEnvMixin(value)PARAMETERS:
- value (
object,string)
To set custom environment variables, you need to specify the variables in the workflow file. You can define environment variables for a step, job, or entire workflow using the jobs.<job_id>.steps[*].env, jobs.<job_id>.env, and env keywords. For more information, see https://docs.github.com/en/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv
withEnvironment(value)PARAMETERS:
- value (
object,string)
The environment that the job references.
withEnvironmentMixin(value)PARAMETERS:
- value (
object,string)
The environment that the job references.
withIf(value)PARAMETERS:
- value (
boolean,number,string)
You can use the if conditional to prevent a job from running unless a condition is met. You can use any supported context and expression to create a conditional. Expressions in an if conditional do not require the ${{ }} syntax. For more information, see https://help.github.com/en/articles/contexts-and-expression-syntax-for-github-actions.
withName(value)PARAMETERS:
- value (
string)
The name of the job displayed on GitHub.
withNeeds(value)PARAMETERS:
- value (
array,string)
Identifies any jobs that must complete successfully before this job will run. It can be a string or array of strings. If a job fails, all jobs that need it are skipped unless the jobs use a conditional statement that causes the job to continue.
withNeedsMixin(value)PARAMETERS:
- value (
array,string)
Identifies any jobs that must complete successfully before this job will run. It can be a string or array of strings. If a job fails, all jobs that need it are skipped unless the jobs use a conditional statement that causes the job to continue.
withOutputs(value)PARAMETERS:
- value (
object)
A map of outputs for a job. Job outputs are available to all downstream jobs that depend on this job.
withOutputsMixin(value)PARAMETERS:
- value (
object)
A map of outputs for a job. Job outputs are available to all downstream jobs that depend on this job.
withPermissions(value)PARAMETERS:
- value (
object,string)
You can modify the default permissions granted to the GITHUB_TOKEN, adding or removing access as required, so that you only allow the minimum required access.
withPermissionsMixin(value)PARAMETERS:
- value (
object,string)
You can modify the default permissions granted to the GITHUB_TOKEN, adding or removing access as required, so that you only allow the minimum required access.
withRunsOn(value)PARAMETERS:
- value (
array,object,string)
The type of machine to run the job on. The machine can be either a GitHub-hosted runner, or a self-hosted runner.
withRunsOnMixin(value)PARAMETERS:
- value (
array,object,string)
The type of machine to run the job on. The machine can be either a GitHub-hosted runner, or a self-hosted runner.
withServices(value)PARAMETERS:
- value (
object)
Additional containers to host services for a job in a workflow. These are useful for creating databases or cache services like redis. The runner on the virtual machine will automatically create a network and manage the life cycle of the service containers. When you use a service container for a job or your step uses container actions, you don't need to set port information to access the service. Docker automatically exposes all ports between containers on the same network. When both the job and the action run in a container, you can directly reference the container by its hostname. The hostname is automatically mapped to the service name. When a step does not use a container action, you must access the service using localhost and bind the ports.
withServicesMixin(value)PARAMETERS:
- value (
object)
Additional containers to host services for a job in a workflow. These are useful for creating databases or cache services like redis. The runner on the virtual machine will automatically create a network and manage the life cycle of the service containers. When you use a service container for a job or your step uses container actions, you don't need to set port information to access the service. Docker automatically exposes all ports between containers on the same network. When both the job and the action run in a container, you can directly reference the container by its hostname. The hostname is automatically mapped to the service name. When a step does not use a container action, you must access the service using localhost and bind the ports.
withSteps(value)PARAMETERS:
- value (
array)
A job contains a sequence of tasks called steps. Steps can run commands, run setup tasks, or run an action in your repository, a public repository, or an action published in a Docker registry. Not all steps run actions, but all actions run as a step. Each step runs in its own process in the virtual environment and has access to the workspace and filesystem. Because steps run in their own process, changes to environment variables are not preserved between steps. GitHub provides built-in steps to set up and complete a job.
Must contain either uses or run
withStepsMixin(value)PARAMETERS:
- value (
array)
A job contains a sequence of tasks called steps. Steps can run commands, run setup tasks, or run an action in your repository, a public repository, or an action published in a Docker registry. Not all steps run actions, but all actions run as a step. Each step runs in its own process in the virtual environment and has access to the workspace and filesystem. Because steps run in their own process, changes to environment variables are not preserved between steps. GitHub provides built-in steps to set up and complete a job.
Must contain either uses or run
withStrategy(value)PARAMETERS:
- value (
object)
A strategy creates a build matrix for your jobs. You can define different variations of an environment to run each job in.
withStrategyMixin(value)PARAMETERS:
- value (
object)
A strategy creates a build matrix for your jobs. You can define different variations of an environment to run each job in.
withTimeoutMinutes(value=360)PARAMETERS:
- value (
number,string)- default value:
360
- default value:
The maximum number of minutes to let a workflow run before GitHub automatically cancels it. Default: 360
withTimeoutMinutesMixin(value=360)PARAMETERS:
- value (
number,string)- default value:
360
- default value:
The maximum number of minutes to let a workflow run before GitHub automatically cancels it. Default: 360
concurrency.withCancelInProgress(value)PARAMETERS:
- value (
boolean,string)
To cancel any currently running job or workflow in the same concurrency group, specify cancel-in-progress: true.
concurrency.withCancelInProgressMixin(value)PARAMETERS:
- value (
boolean,string)
To cancel any currently running job or workflow in the same concurrency group, specify cancel-in-progress: true.
concurrency.withGroup(value)PARAMETERS:
- value (
string)
When a concurrent job or workflow is queued, if another job or workflow using the same concurrency group in the repository is in progress, the queued job or workflow will be pending. Any previously pending job or workflow in the concurrency group will be canceled.
concurrency.cancel-in-progress.withExpressionSyntax(value)PARAMETERS:
- value (
string)
container.withContainer(value)PARAMETERS:
- value (
object)
container.withContainerMixin(value)PARAMETERS:
- value (
object)
container.withCredentials(value)PARAMETERS:
- value (
object)
If the image's container registry requires authentication to pull the image, you can use credentials to set a map of the username and password. The credentials are the same values that you would provide to the docker login command.
container.withCredentialsMixin(value)PARAMETERS:
- value (
object)
If the image's container registry requires authentication to pull the image, you can use credentials to set a map of the username and password. The credentials are the same values that you would provide to the docker login command.
container.withEnv(value)PARAMETERS:
- value (
object,string)
To set custom environment variables, you need to specify the variables in the workflow file. You can define environment variables for a step, job, or entire workflow using the jobs.<job_id>.steps[*].env, jobs.<job_id>.env, and env keywords. For more information, see https://docs.github.com/en/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv
container.withEnvMixin(value)PARAMETERS:
- value (
object,string)
To set custom environment variables, you need to specify the variables in the workflow file. You can define environment variables for a step, job, or entire workflow using the jobs.<job_id>.steps[*].env, jobs.<job_id>.env, and env keywords. For more information, see https://docs.github.com/en/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv
container.withImage(value)PARAMETERS:
- value (
string)
The Docker image to use as the container to run the action. The value can be the Docker Hub image name or a registry name.
container.withOptions(value)PARAMETERS:
- value (
string)
Additional Docker container resource options. For a list of options, see https://docs.docker.com/engine/reference/commandline/create/#options.
container.withPorts(value)PARAMETERS:
- value (
array)
Sets an array of ports to expose on the container.
container.withPortsMixin(value)PARAMETERS:
- value (
array)
Sets an array of ports to expose on the container.
container.withVolumes(value)PARAMETERS:
- value (
array)
Sets an array of volumes for the container to use. You can use volumes to share data between services or other steps in a job. You can specify named Docker volumes, anonymous Docker volumes, or bind mounts on the host.
To specify a volume, you specify the source and destination path:
container.withVolumesMixin(value)PARAMETERS:
- value (
array)
Sets an array of volumes for the container to use. You can use volumes to share data between services or other steps in a job. You can specify named Docker volumes, anonymous Docker volumes, or bind mounts on the host.
To specify a volume, you specify the source and destination path:
container.container.withCredentials(value)PARAMETERS:
- value (
object)
If the image's container registry requires authentication to pull the image, you can use credentials to set a map of the username and password. The credentials are the same values that you would provide to the docker login command.
container.container.withCredentialsMixin(value)PARAMETERS:
- value (
object)
If the image's container registry requires authentication to pull the image, you can use credentials to set a map of the username and password. The credentials are the same values that you would provide to the docker login command.
container.container.withEnv(value)PARAMETERS:
- value (
object,string)
To set custom environment variables, you need to specify the variables in the workflow file. You can define environment variables for a step, job, or entire workflow using the jobs.<job_id>.steps[*].env, jobs.<job_id>.env, and env keywords. For more information, see https://docs.github.com/en/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv
container.container.withEnvMixin(value)PARAMETERS:
- value (
object,string)
To set custom environment variables, you need to specify the variables in the workflow file. You can define environment variables for a step, job, or entire workflow using the jobs.<job_id>.steps[*].env, jobs.<job_id>.env, and env keywords. For more information, see https://docs.github.com/en/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsenv
container.container.withImage(value)PARAMETERS:
- value (
string)
The Docker image to use as the container to run the action. The value can be the Docker Hub image name or a registry name.
container.container.withOptions(value)PARAMETERS:
- value (
string)
Additional Docker container resource options. For a list of options, see https://docs.docker.com/engine/reference/commandline/create/#options.
container.container.withPorts(value)PARAMETERS:
- value (
array)
Sets an array of ports to expose on the container.
container.container.withPortsMixin(value)PARAMETERS:
- value (
array)
Sets an array of ports to expose on the container.
container.container.withVolumes(value)PARAMETERS:
- value (
array)
Sets an array of volumes for the container to use. You can use volumes to share data between services or other steps in a job. You can specify named Docker volumes, anonymous Docker volumes, or bind mounts on the host.
To specify a volume, you specify the source and destination path:
container.container.withVolumesMixin(value)PARAMETERS:
- value (
array)
Sets an array of volumes for the container to use. You can use volumes to share data between services or other steps in a job. You can specify named Docker volumes, anonymous Docker volumes, or bind mounts on the host.
To specify a volume, you specify the source and destination path:
container.container.credentials.withPassword(value)PARAMETERS:
- value (
string)
container.container.credentials.withUsername(value)PARAMETERS:
- value (
string)
container.container.env.withStringContainingExpressionSyntax(value)PARAMETERS:
- value (
string)
container.credentials.withPassword(value)PARAMETERS:
- value (
string)
container.credentials.withUsername(value)PARAMETERS:
- value (
string)
container.env.withStringContainingExpressionSyntax(value)PARAMETERS:
- value (
string)
continue-on-error.withExpressionSyntax(value)PARAMETERS:
- value (
string)
defaults.withRun(value)PARAMETERS:
- value (
object)
defaults.withRunMixin(value)PARAMETERS:
- value (
object)
defaults.run.withShell(value)PARAMETERS:
- value (
string)
You can override the default shell settings in the runner's operating system using the shell keyword. You can use built-in shell keywords, or you can define a custom set of shell options.
defaults.run.withShellMixin(value)PARAMETERS:
- value (
string)
You can override the default shell settings in the runner's operating system using the shell keyword. You can use built-in shell keywords, or you can define a custom set of shell options.
defaults.run.withWorkingDirectory(value)PARAMETERS:
- value (
string)
Using the working-directory keyword, you can specify the working directory of where to run the command.
env.withStringContainingExpressionSyntax(value)PARAMETERS:
- value (
string)
environment.withEnvironment(value)PARAMETERS:
- value (
object)
The environment that the job references
environment.withEnvironmentMixin(value)PARAMETERS:
- value (
object)
The environment that the job references
environment.environment.withName(value)PARAMETERS:
- value (
string)
The name of the environment configured in the repo.
environment.environment.withUrl(value)PARAMETERS:
- value (
string)
A deployment URL
needs.withName(value)PARAMETERS:
- value (
string)
permissions.withActions(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withAttestations(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withChecks(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withContents(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withDeployments(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withDiscussions(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withIdToken(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withIssues(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withPackages(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withPages(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withPullRequests(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withRepositoryProjects(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withSecurityEvents(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
permissions.withStatuses(value)PARAMETERS:
- value (
string)- valid values:
"read","write","none"
- valid values:
runs-on.withExpressionSyntax(value)PARAMETERS:
- value (
string)
runs-on.withGroup(value)PARAMETERS:
- value (
string)
runs-on.withLabels(value)PARAMETERS:
- value (
array,string)
runs-on.withLabelsMixin(value)PARAMETERS:
- value (
array,string)
runs-on.withStringContainingExpressionSyntax(value)PARAMETERS:
- value (
string)
strategy.withFailFast(value=true)PARAMETERS:
- value (
boolean,string)- default value:
true
- default value:
When set to true, GitHub cancels all in-progress jobs if any matrix job fails. Default: true
strategy.withMatrix(value)PARAMETERS:
- value (
object,string)
A build matrix is a set of different configurations of the virtual environment. For example you might run a job against more than one supported version of a language, operating system, or tool. Each configuration is a copy of the job that runs and reports a status. You can specify a matrix by supplying an array for the configuration options. For example, if the GitHub virtual environment supports Node.js versions 6, 8, and 10 you could specify an array of those versions in the matrix. When you define a matrix of operating systems, you must set the required runs-on keyword to the operating system of the current job, rather than hard-coding the operating system name. To access the operating system name, you can use the matrix.os context parameter to set runs-on. For more information, see https://help.github.com/en/articles/contexts-and-expression-syntax-for-github-actions.
strategy.withMatrixMixin(value)PARAMETERS:
- value (
object,string)
A build matrix is a set of different configurations of the virtual environment. For example you might run a job against more than one supported version of a language, operating system, or tool. Each configuration is a copy of the job that runs and reports a status. You can specify a matrix by supplying an array for the configuration options. For example, if the GitHub virtual environment supports Node.js versions 6, 8, and 10 you could specify an array of those versions in the matrix. When you define a matrix of operating systems, you must set the required runs-on keyword to the operating system of the current job, rather than hard-coding the operating system name. To access the operating system name, you can use the matrix.os context parameter to set runs-on. For more information, see https://help.github.com/en/articles/contexts-and-expression-syntax-for-github-actions.
strategy.withMaxParallel(value)PARAMETERS:
- value (
number,string)
The maximum number of jobs that can run simultaneously when using a matrix job strategy. By default, GitHub will maximize the number of jobs run in parallel depending on the available runners on GitHub-hosted virtual machines.
strategy.matrix.withExpressionSyntax(value)PARAMETERS:
- value (
string)
timeout-minutes.withExpressionSyntax(value)PARAMETERS:
- value (
string)