Skip to content

Latest commit

 

History

History
39 lines (32 loc) · 1.6 KB

README.md

File metadata and controls

39 lines (32 loc) · 1.6 KB
Raw

Remove-milestone

A Github action to remove a milestone by the milestone's name

Inputs

milestone_name

Required The name of the milestone, to close.

crash_on_missing

If the milestone should fail if the provided milestone is missing
Default: false

Outputs

milestone_id

The id of the milestone which has been closed.

Explanation for usage

  • The uses keyword specifies which action us used. step-security/close-milestone specifies which repository is used, the @v2.1.0 defines which version of the action is used. You can find the latest version in the badge at the top of the readme file. To always use the latest version, you can change it to @master, but please be aware that changes in the action might break your workflow.
  • The envkeyword specifies the environment variables used by and provided to the action. GITHUB_TOKEN is the secret access token to authorize to the used repository. Without this keyword, the action would not be able to login and close the milestone. It is not stored in any way or transmitted. As the code is open source, it would be noticed anyways.
  • the with keyword specifies data you have to specify. Here the input variables are defined. These are specified above

Example minimal usage

uses: step-security/[email protected]
env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
  milestone_name: milestoneName

Example usage with crash on missing

uses: step-security/[email protected]
env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
  milestone_name: milestoneName
  crash_on_missing: true