Skip to content

Commit de942a2

Browse files
committed
add basic readme
Signed-off-by: Rajat Jindal <[email protected]>
1 parent ceca522 commit de942a2

File tree

1 file changed

+29
-1
lines changed

1 file changed

+29
-1
lines changed

README.md

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,31 @@
11
# Spin Plugin Releaser
22

3-
This GitHub release action helps with automation of releasing Spin Plugins.
3+
`spin-plugin-releaser` is a GitHub action (backed by a [Spin app](https://github.com/rajatjindal/spin-plugin-release-bot) deployed on Fermyon Cloud) that automates the update of plugin manifests in spin-plugins repo when a new version of your spin plugin is released. If a release is marked as a 'prerelease' in github, it will not be released to the spin-plugins index.
4+
5+
To trigger `spin-plugin-releaser` you can use a github-action which sends the event to the bot.
6+
7+
# Basic Setup
8+
9+
- Make sure you have enabled github actions for your repo
10+
- Add a `.spin-plugin.json.tmpl` template file at the root of your repo. Refer to [cloud-plugin](https://github.com/fermyon/cloud-plugin) repo for an example.
11+
12+
- To setup the action, add the following snippet after the step that publishes the new release and assets:
13+
```yaml
14+
- name: Update new version in spin plugins repo
15+
uses: rajatjindal/spin-plugin-releaser@main
16+
with:
17+
github_token: ${{ secrets.GITHUB_TOKEN }}
18+
upload_checksums: true
19+
```
20+
21+
# Inputs for the action
22+
23+
| Key | Default Value | Description |
24+
| ------------------ | ---------------------- | ------------------------------------------------------------------------------------ |
25+
| template_file | `.spin-plugin.json.tmpl` | The path to template file |
26+
| upload_checksums | false | uploads the checksums-<tagname>.txt file to the release |
27+
28+
# Limitations of spin-plugin-releaser
29+
30+
- only works for repos hosted on github right now
31+
- The first version of plugin has to be submitted manually, by plugin author, to the spin-plugins repo

0 commit comments

Comments
 (0)