mirror of
https://code.forgejo.org/actions/setup-forgejo.git
synced 2024-11-23 22:20:57 -05:00
57 lines
1.5 KiB
Markdown
57 lines
1.5 KiB
Markdown
# setup-forgejo
|
|
|
|
<!-- action-docs-description -->
|
|
## Description
|
|
|
|
Setup Forgejo and a runner
|
|
<!-- action-docs-description -->
|
|
|
|
It can only be run on the `self-hosted` platform, running on a host with LXC installed.
|
|
|
|
<!-- action-docs-inputs -->
|
|
## Inputs
|
|
|
|
| parameter | description | required | default |
|
|
| --- | --- | --- | --- |
|
|
| image | Container image | `false` | codeberg.org/forgejo/forgejo |
|
|
| image-version | Container image version | `false` | 1.19 |
|
|
| user | Administrator user name | `false` | root |
|
|
| password | Administrator password | `false` | admin1234 |
|
|
| runner | Runner git repository | `false` | https://code.forgejo.org/fogejo/runner |
|
|
| runner-version | Runner version | `false` | v1.4.1 |
|
|
<!-- action-docs-inputs -->
|
|
|
|
|
|
<!-- action-docs-outputs -->
|
|
## Outputs
|
|
|
|
| parameter | description |
|
|
| --- | --- |
|
|
| url | URL of the Forgejo instance |
|
|
| host-port | Host and port of the Forgejo instance, e.g 172.0.17.2:3000 |
|
|
| token | Administrator application token with all,sudo scopes |
|
|
| runner-logs | Filename of the Forgejo runner logs |
|
|
<!-- action-docs-outputs -->
|
|
|
|
## Example
|
|
|
|
```
|
|
name: Setup Forgejo
|
|
on: [push]
|
|
jobs:
|
|
setup-forgejo:
|
|
runs-on: self-hosted
|
|
steps:
|
|
- uses: actions/checkout@v3
|
|
- id: forgejo
|
|
uses: setup-forgejo@v1
|
|
with:
|
|
image-version: 1.19
|
|
- run: |
|
|
curl ${{ steps.forgejo.outputs.url }}/api/forgejo/v1/version | grep 1.19
|
|
|
|
```
|
|
|
|
## Hacking
|
|
|
|
* Update the README from the action file with https://github.com/npalm/action-docs `action-docs --update-readme`
|