Skip to content
play

GitHub Action

Create a GitHub deployment

v1.0.2 Latest version

Create a GitHub deployment

play

Create a GitHub deployment

Create a new deployment in your repo

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Create a GitHub deployment

uses: avakar/[email protected]

Learn more about this action in avakar/create-deployment

Choose a version

GitHub Action – Create a GitHub deployment

Creates a new GitHub deployment.

Usage

Add the action to your workflow file.

on: push
jobs:
  release:
    steps:
      - uses: avakar/create-deployment@v1
        with:
          auto_merge: false
        env:
          GITHUB_TOKEN: ${{ secrets.DEPLOY_TOKEN }}

The above snippet will create a new deployment with task "deploy" to environment "production". It will not attempt to merge your default branch first.

Note that creating a deployment will emit the "deployment" event, but workflows that trigger on it will not run if you use secrets.GITHUB_TOKEN. Instead, create your own security token.

Use avakar/set-deployment-status action in your deploy workflow.

Inputs

The inputs are exactly the parameters of the Create Deployment REST request. Both "ant-man" and "flash" API previews are enabled.

To summarize, these are the parameters and their defaults.

  • ref: if left empty, defaults to the current branch
  • task: defaults to "deploy"
  • auto_merge: defaults to "true"
  • required_contexts: defaults to all contexts; use * to say that explicitly
  • payload: defaults to empty; if non-empty, must be a valid JSON string
  • environment: defaults to "production"
  • description: defaults to empty
  • production_environment: defaults to true for production environment, otherwise false
  • transient_environment: defaults to false

Outputs

  • deployment_id: the identifier of the newly created deployment
  • deployment_url: the REST API url representing the new deployment
  • statuses_url: the REST API url representing the deployment's list of statuses