80 lines
2.2 KiB
Markdown
80 lines
2.2 KiB
Markdown
# Delete Package Versions
|
|
|
|
This action deletes versions of a package from [GitHub Packages](https://github.com/features/packages).
|
|
|
|
## What It Can Do
|
|
|
|
* Delete a single version
|
|
* Delete multiple versions
|
|
* Delete specific version(s)
|
|
* Delete oldest version(s)
|
|
* Delete version(s) from a package that is hosted in the same repo that is executing the workflow
|
|
* Delete version(s) from a package that is hosted in a different repo than the one executing the workflow
|
|
|
|
# Usage
|
|
|
|
```yaml
|
|
- uses: actions/delete-package-versions@v1
|
|
with:
|
|
# Can be a single package version id, or a comma separated list of package version ids.
|
|
# Defaults to an empty string.
|
|
package-version-ids: ''
|
|
|
|
# Owner of the repo hosting the package.
|
|
# Defaults to the owner of the repo executing the workflow.
|
|
# Required if deleting a version from a package hosted in a different repo than the one executing the workflow.
|
|
owner: ''
|
|
|
|
# Repo hosting the package.
|
|
# Defaults to the repo executing the workflow.
|
|
# Required if deleting a version from a package hosted in a different repo than the one executing the workflow.
|
|
repo: ''
|
|
|
|
# Name of the package.
|
|
# Defaults to an empty string.
|
|
# Required if `package-version-ids` input is not given.
|
|
package-name: ''
|
|
|
|
# The number of old versions to delete starting from the oldest version.
|
|
# Defaults to 1.
|
|
num-old-versions-to-delete: ''
|
|
|
|
# The token used to authenticate with GitHub Packages.
|
|
# Defaults to github.token.
|
|
# Required if deleting a version from a package hosted in a different repo than the one executing the workflow.
|
|
# If `package-version-ids` is given the token only needs the delete packages scope.
|
|
# If `package-version-ids` is not given the token needs the delete packages scope and the read packages scope
|
|
token: ''
|
|
|
|
```
|
|
|
|
|
|
|
|
```yaml
|
|
- uses: test
|
|
with: 'hey'
|
|
```
|
|
|
|
|
|
|
|
# Scenarios
|
|
|
|
* [Delete a specific single version]
|
|
|
|
## Delete a single version
|
|
|
|
### Delete
|
|
|
|
|
|
|
|
## Delete a specific single version by Id from a package hosted in the same repo that is executing the workflow
|
|
|
|
|
|
|
|
|
|
|
|
# License
|
|
|
|
The scripts and documentation in this project are released under the [MIT License](https://github.com/actions/delete-package-versions/blob/master/LICENSE)
|
|
|