add disclaimer

This commit is contained in:
Conor Sloan
2024-07-30 15:33:26 +01:00
parent d627a3342b
commit 5c92b3920b
+8 -4
View File
@@ -1,11 +1,15 @@
# Publish Action Package
_This action_ packages _your action_ as OCI artifacts and publishes it to the [GitHub Container registry](ghcr.io).
_This action_ packages _your action_ as an OCI container and publishes it to the [GitHub Container registry](ghcr.io).
This allows your action to be consumed as an _immutable_ package even if a [SemVer](https://semver.org/) is specified in the consumer's workflow file.
This allows your action to be consumed as an _immutable_ package if a [SemVer](https://semver.org/) is specified in the consumer's workflow file.
Your action workflow must be triggered on `release` as in the following example. The release's title must follow [semantic versioning](https://semver.org/).
Then consumers of your action will then be able to specify the version, e.g., `- uses: your-name/your-action@v1.2.3` or even `- uses: your-name/your-action@v1`.
Consumers of your action will then be able to specify the version, e.g., `- uses: your-name/your-action@v1.2.3` or even `- uses: your-name/your-action@v1`.
> [!IMPORTANT]
> This action is **not ready for public use**. It is part of an upcoming public roadmap item (see [GitHub Actions: Immutable actions publishing](https://github.com/github/roadmap/issues/592)).
> Attempts to use this action to upload an OCI artifact will not work until this feature has been fully released to the public. Please do not attempt to use it until that time.
## Usage
@@ -14,7 +18,7 @@ Then consumers of your action will then be able to specify the version, e.g., `-
on:
release:
- uses: immutable-actions/publish-action-package@v1
- uses: actions/publish-action-package@v1
```
<!-- end usage -->