mirror of
https://codeberg.org/forgejo/docs.git
synced 2025-02-08 04:26:39 -05:00
admin: recommend data.forgejo.org over code.forgejo.org
- for actions - for mirrors - for downloading
This commit is contained in:
parent
11b9ffa5b8
commit
c63a884686
4 changed files with 22 additions and 22 deletions
|
@ -15,18 +15,18 @@ value of `DEFAULT_ACTIONS_URL` is prepended to it.
|
||||||
```yaml
|
```yaml
|
||||||
[actions]
|
[actions]
|
||||||
ENABLED = true
|
ENABLED = true
|
||||||
DEFAULT_ACTIONS_URL = https://code.forgejo.org
|
DEFAULT_ACTIONS_URL = https://data.forgejo.org
|
||||||
```
|
```
|
||||||
|
|
||||||
The actions published at https://code.forgejo.org are:
|
The actions published at https://data.forgejo.org are:
|
||||||
|
|
||||||
- known to work with Forgejo Actions
|
- known to work with Forgejo Actions
|
||||||
- published under a Free Software license
|
- published under a Free Software license
|
||||||
|
|
||||||
They can be found in the following organizations:
|
They can be found in organizations such as
|
||||||
|
[actions](https://data.forgejo.org/actions) for general purpose
|
||||||
- [General purpose actions](https://code.forgejo.org/actions)
|
actions, [docker](https://data.forgejo.org/docker) for those related
|
||||||
- [Docker actions](https://code.forgejo.org/docker)
|
to Docker and so on.
|
||||||
|
|
||||||
When setting `DEFAULT_ACTIONS_URL` to a Forgejo instance with an open
|
When setting `DEFAULT_ACTIONS_URL` to a Forgejo instance with an open
|
||||||
registration, **care must be taken to avoid name conflicts**. For
|
registration, **care must be taken to avoid name conflicts**. For
|
||||||
|
@ -119,7 +119,7 @@ See the user documentation for `jobs.<job_id>.container` for more information.
|
||||||
Label examples:
|
Label examples:
|
||||||
|
|
||||||
- `node20:docker://node:20-bookworm` == `node20:docker://docker.io/node:20-bookworm` defines `node20` to be the `node:20-bookworm` image from hub.docker.com
|
- `node20:docker://node:20-bookworm` == `node20:docker://docker.io/node:20-bookworm` defines `node20` to be the `node:20-bookworm` image from hub.docker.com
|
||||||
- `docker:docker://code.forgejo.org/oci/alpine:3.20` defines `docker` to be the `alpine:3.20` image from https://code.forgejo.org/oci/-/packages/container/alpine/3.20
|
- `docker:docker://data.forgejo.org/oci/alpine:3.20` defines `docker` to be the `alpine:3.20` image from https://data.forgejo.org/oci/-/packages/container/alpine/3.20
|
||||||
|
|
||||||
### LXC
|
### LXC
|
||||||
|
|
||||||
|
|
|
@ -1351,7 +1351,7 @@ Note that you may need to set `[migrations].ALLOW_LOCALNETWORKS` option to `true
|
||||||
## Actions (`actions`)
|
## Actions (`actions`)
|
||||||
|
|
||||||
- `ENABLED`: **true**: Enable/Disable actions
|
- `ENABLED`: **true**: Enable/Disable actions
|
||||||
- `DEFAULT_ACTIONS_URL`: **https://code.forgejo.org**: Default address to get action plugins, e.g. the default value means downloading from "https://code.forgejo.org/actions/checkout" for "uses: actions/checkout@v3"
|
- `DEFAULT_ACTIONS_URL`: **https://data.forgejo.org**: Default address to get action plugins, e.g. the default value means downloading from "https://code.forgejo.org/actions/checkout" for "uses: actions/checkout@v3"
|
||||||
- `ARTIFACT_RETENTION_DAYS`: **90**: Default number of days to keep artifacts. Artifacts could have their own retention periods by setting the `retention-days` option in `actions/upload-artifact` step.
|
- `ARTIFACT_RETENTION_DAYS`: **90**: Default number of days to keep artifacts. Artifacts could have their own retention periods by setting the `retention-days` option in `actions/upload-artifact` step.
|
||||||
- `ZOMBIE_TASK_TIMEOUT`: **10m**: Timeout to stop the task which have running status, but haven't been updated for a long time.
|
- `ZOMBIE_TASK_TIMEOUT`: **10m**: Timeout to stop the task which have running status, but haven't been updated for a long time.
|
||||||
- `ENDLESS_TASK_TIMEOUT`: **3h**: Timeout to stop the tasks which have running status and continuous updates, but don't end for a long time.
|
- `ENDLESS_TASK_TIMEOUT`: **3h**: Timeout to stop the tasks which have running status and continuous updates, but don't end for a long time.
|
||||||
|
|
|
@ -9,7 +9,7 @@ Forgejo provides [container images](https://codeberg.org/forgejo/-/packages/cont
|
||||||
docker pull codeberg.org/forgejo/forgejo:9
|
docker pull codeberg.org/forgejo/forgejo:9
|
||||||
```
|
```
|
||||||
|
|
||||||
If `codeberg.org` can not be accessed you can replace every mention of `codeberg.org` with `code.forgejo.org` to use our mirror.
|
If `codeberg.org` can not be accessed you can replace every mention of `codeberg.org` with `data.forgejo.org` to use our mirror.
|
||||||
|
|
||||||
The **9** tag is set to be the latest minor release, starting with **9.0.x**. The **9** tag will then be equal to **9.0.4** when it is released and so on. The **9.0** tag is also set to be the latest patch version release.
|
The **9** tag is set to be the latest minor release, starting with **9.0.x**. The **9** tag will then be equal to **9.0.4** when it is released and so on. The **9.0** tag is also set to be the latest patch version release.
|
||||||
|
|
||||||
|
|
|
@ -9,21 +9,21 @@ It needs to be installed separately from the main Forgejo instance. For security
|
||||||
|
|
||||||
Each `Forgejo Runner` release is published for all supported architectures as:
|
Each `Forgejo Runner` release is published for all supported architectures as:
|
||||||
|
|
||||||
- [binaries](https://code.forgejo.org/forgejo/runner/releases)
|
- [binaries](https://data.forgejo.org/forgejo/runner/releases)
|
||||||
- [OCI images](https://code.forgejo.org/forgejo/-/packages/container/runner/versions)
|
- [OCI images](https://data.forgejo.org/forgejo/-/packages/container/runner/versions)
|
||||||
|
|
||||||
## Binary installation
|
## Binary installation
|
||||||
|
|
||||||
### Downloading and installing the binary
|
### Downloading and installing the binary
|
||||||
|
|
||||||
Download the latest [binary release](https://code.forgejo.org/forgejo/runner/releases) and verify its signature:
|
Download the latest [binary release](https://data.forgejo.org/forgejo/runner/releases) and verify its signature:
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
|
|
||||||
$ export RUNNER_VERSION=$(curl -X 'GET' https://code.forgejo.org/api/v1/repos/forgejo/runner/releases/latest | jq .name -r | cut -c 2-)
|
$ export RUNNER_VERSION=$(curl -X 'GET' https://data.forgejo.org/api/v1/repos/forgejo/runner/releases/latest | jq .name -r | cut -c 2-)
|
||||||
$ wget -O forgejo-runner https://code.forgejo.org/forgejo/runner/releases/download/v${RUNNER_VERSION}/forgejo-runner-${RUNNER_VERSION}-linux-amd64
|
$ wget -O forgejo-runner https://data.forgejo.org/forgejo/runner/releases/download/v${RUNNER_VERSION}/forgejo-runner-${RUNNER_VERSION}-linux-amd64
|
||||||
$ chmod +x forgejo-runner
|
$ chmod +x forgejo-runner
|
||||||
$ wget -O forgejo-runner.asc https://code.forgejo.org/forgejo/runner/releases/download/v${RUNNER_VERSION}/forgejo-runner-${RUNNER_VERSION}-linux-amd64.asc
|
$ wget -O forgejo-runner.asc https://data.forgejo.org/forgejo/runner/releases/download/v${RUNNER_VERSION}/forgejo-runner-${RUNNER_VERSION}-linux-amd64.asc
|
||||||
$ gpg --keyserver keys.openpgp.org --recv EB114F5E6C0DC2BCDD183550A4B61A2DC5923710
|
$ gpg --keyserver keys.openpgp.org --recv EB114F5E6C0DC2BCDD183550A4B61A2DC5923710
|
||||||
$ gpg --verify forgejo-runner.asc forgejo-runner
|
$ gpg --verify forgejo-runner.asc forgejo-runner
|
||||||
Good signature from "Forgejo <contact@forgejo.org>"
|
Good signature from "Forgejo <contact@forgejo.org>"
|
||||||
|
@ -94,7 +94,7 @@ The `Forgejo runner` relies on application containers (Docker, Podman, etc.) or
|
||||||
```shell
|
```shell
|
||||||
$ lxc-helpers.sh lxc_container_run forgejo-runners -- sudo --user debian bash
|
$ lxc-helpers.sh lxc_container_run forgejo-runners -- sudo --user debian bash
|
||||||
$ sudo apt-get install docker.io wget gnupg2
|
$ sudo apt-get install docker.io wget gnupg2
|
||||||
$ wget -O forgejo-runner https://code.forgejo.org/forgejo/runner/releases/download/v4.0.0/forgejo-runner-amd64
|
$ wget -O forgejo-runner https://data.forgejo.org/forgejo/runner/releases/download/v4.0.0/forgejo-runner-amd64
|
||||||
...
|
...
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -235,8 +235,8 @@ host:
|
||||||
|
|
||||||
#### Cache configuration
|
#### Cache configuration
|
||||||
|
|
||||||
Some actions such as https://code.forgejo.org/actions/cache or
|
Some actions such as https://data.forgejo.org/actions/cache or
|
||||||
https://code.forgejo.org/actions/setup-go can communicate with the
|
https://data.forgejo.org/actions/setup-go can communicate with the
|
||||||
`Forgejo runner` to save and restore commonly used files such as
|
`Forgejo runner` to save and restore commonly used files such as
|
||||||
compilation dependencies. They are stored as compressed tar archives,
|
compilation dependencies. They are stored as compressed tar archives,
|
||||||
fetched when a job starts and saved when it completes.
|
fetched when a job starts and saved when it completes.
|
||||||
|
@ -272,18 +272,18 @@ Use `journalctl -u forgejo-runner.service` to read the runner logs.
|
||||||
|
|
||||||
## OCI image installation
|
## OCI image installation
|
||||||
|
|
||||||
The [OCI images](https://code.forgejo.org/forgejo/-/packages/container/runner/versions)
|
The [OCI images](https://data.forgejo.org/forgejo/-/packages/container/runner/versions)
|
||||||
are built from the Dockerfile which is [found in the source directory](https://code.forgejo.org/forgejo/runner/src/branch/main/Dockerfile). It contains the `forgejo-runner` binary.
|
are built from the Dockerfile which is [found in the source directory](https://code.forgejo.org/forgejo/runner/src/branch/main/Dockerfile). It contains the `forgejo-runner` binary.
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
$ docker run --rm code.forgejo.org/forgejo/runner:4.0.0 forgejo-runner --version
|
$ docker run --rm data.forgejo.org/forgejo/runner:4.0.0 forgejo-runner --version
|
||||||
forgejo-runner version v4.0.0
|
forgejo-runner version v4.0.0
|
||||||
```
|
```
|
||||||
|
|
||||||
It does not run as root:
|
It does not run as root:
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
$ docker run --rm code.forgejo.org/forgejo/runner:4.0.0 id
|
$ docker run --rm data.forgejo.org/forgejo/runner:4.0.0 id
|
||||||
uid=1000 gid=1000 groups=1000
|
uid=1000 gid=1000 groups=1000
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -320,7 +320,7 @@ services:
|
||||||
restart: 'unless-stopped'
|
restart: 'unless-stopped'
|
||||||
|
|
||||||
gitea:
|
gitea:
|
||||||
image: 'code.forgejo.org/forgejo/runner:4.0.0'
|
image: 'data.forgejo.org/forgejo/runner:4.0.0'
|
||||||
links:
|
links:
|
||||||
- docker-in-docker
|
- docker-in-docker
|
||||||
depends_on:
|
depends_on:
|
||||||
|
|
Loading…
Add table
Reference in a new issue