mirror of
https://codeberg.org/forgejo/docs.git
synced 2025-02-01 03:35:03 -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
|
||||
[actions]
|
||||
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
|
||||
- published under a Free Software license
|
||||
|
||||
They can be found in the following organizations:
|
||||
|
||||
- [General purpose actions](https://code.forgejo.org/actions)
|
||||
- [Docker actions](https://code.forgejo.org/docker)
|
||||
They can be found in organizations such as
|
||||
[actions](https://data.forgejo.org/actions) for general purpose
|
||||
actions, [docker](https://data.forgejo.org/docker) for those related
|
||||
to Docker and so on.
|
||||
|
||||
When setting `DEFAULT_ACTIONS_URL` to a Forgejo instance with an open
|
||||
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:
|
||||
|
||||
- `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
|
||||
|
||||
|
|
|
@ -1351,7 +1351,7 @@ Note that you may need to set `[migrations].ALLOW_LOCALNETWORKS` option to `true
|
|||
## Actions (`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.
|
||||
- `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.
|
||||
|
|
|
@ -9,7 +9,7 @@ Forgejo provides [container images](https://codeberg.org/forgejo/-/packages/cont
|
|||
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.
|
||||
|
||||
|
|
|
@ -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:
|
||||
|
||||
- [binaries](https://code.forgejo.org/forgejo/runner/releases)
|
||||
- [OCI images](https://code.forgejo.org/forgejo/-/packages/container/runner/versions)
|
||||
- [binaries](https://data.forgejo.org/forgejo/runner/releases)
|
||||
- [OCI images](https://data.forgejo.org/forgejo/-/packages/container/runner/versions)
|
||||
|
||||
## Binary installation
|
||||
|
||||
### 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
|
||||
|
||||
$ export RUNNER_VERSION=$(curl -X 'GET' https://code.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
|
||||
$ 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://data.forgejo.org/forgejo/runner/releases/download/v${RUNNER_VERSION}/forgejo-runner-${RUNNER_VERSION}-linux-amd64
|
||||
$ 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 --verify forgejo-runner.asc forgejo-runner
|
||||
Good signature from "Forgejo <contact@forgejo.org>"
|
||||
|
@ -94,7 +94,7 @@ The `Forgejo runner` relies on application containers (Docker, Podman, etc.) or
|
|||
```shell
|
||||
$ lxc-helpers.sh lxc_container_run forgejo-runners -- sudo --user debian bash
|
||||
$ 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
|
||||
|
||||
Some actions such as https://code.forgejo.org/actions/cache or
|
||||
https://code.forgejo.org/actions/setup-go can communicate with the
|
||||
Some actions such as https://data.forgejo.org/actions/cache or
|
||||
https://data.forgejo.org/actions/setup-go can communicate with the
|
||||
`Forgejo runner` to save and restore commonly used files such as
|
||||
compilation dependencies. They are stored as compressed tar archives,
|
||||
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
|
||||
|
||||
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.
|
||||
|
||||
```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
|
||||
```
|
||||
|
||||
It does not run as root:
|
||||
|
||||
```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
|
||||
```
|
||||
|
||||
|
@ -320,7 +320,7 @@ services:
|
|||
restart: 'unless-stopped'
|
||||
|
||||
gitea:
|
||||
image: 'code.forgejo.org/forgejo/runner:4.0.0'
|
||||
image: 'data.forgejo.org/forgejo/runner:4.0.0'
|
||||
links:
|
||||
- docker-in-docker
|
||||
depends_on:
|
||||
|
|
Loading…
Add table
Reference in a new issue