mirror of
https://gitea.com/gitea/docs.git
synced 2026-11-07 02:20:31 +00:00
Simplify the runner docs and fix their outdated facts (#600)
The runner pages had drifted from the runner. They claimed Podman is unsupported, a registration retry limit of 10, a `container.env` proxy override that has no effect, and they used the deprecated `generate-config` command, while the actual instructions were buried under implementation details. The develop and 5.x pages are rewritten from the current runner sources (`main` is `v5.2.0`). They are shorter and aimed at operators, with a new page covering what jobs get. The reference generator now documents the `config` command, and the quickstart pages in every language use the `gitea-runner` binary name. Reviewed-on: https://gitea.com/gitea/docs/pulls/600 Reviewed-by: Lunny Xiao <[email protected]> Co-authored-by: silverwind <[email protected]>
This commit is contained in:
silverwind authored and 
silverwind committed
1 parent
a874918bb7
commit
be6aefc7e8
53 files changed
+1531
-1661
No files matched your search
@@ -40,7 +40,7 @@ Gitea Actions需要[runner](https://gitea.com/gitea/runner) 来运行Job。
|
||||
在运行Runner之前，您需要使用以下命令将其注册到Gitea实例中：
|
||||
|
||||
```bash
|
||||
./runner register --no-interactive --instance <instance> --token <token>
|
||||
gitea-runner register --no-interactive --instance <instance> --token <token>
|
||||
```
|
||||
|
||||
需要两个必需的参数：`instance` 和 `token`。
|
||||
@@ -52,10 +52,10 @@ Runner和Job容器（由Runner启动以执行Job）将连接到此地址。
|
||||
如果不确定使用哪个地址，通常选择局域网地址即可。
|
||||
|
||||
`token` 用于身份验证和标识，例如 `P2U1U0oB4XaRCi8azcngmPCLbRpUGapalhmddh23`。
|
||||
它只能使用一次，并且不能用于注册多个Runner。
|
||||
每个令牌都可用于注册多个Runner。通过重置链接替换为新令牌后，旧令牌将失效。
|
||||
您可以从以下位置获取不同级别的`token`,从而创建出相应级别的`runner`
|
||||
|
||||
- 实例级别：管理员设置页面，例如 `<your_gitea.com>/admin/actions/runners`。
|
||||
- 实例级别：管理员设置页面，例如 `<your_gitea.com>/-/admin/actions/runners`。
|
||||
- 组织级别：组织设置页面，例如 `<your_gitea.com>/<org>/settings/actions/runners`。
|
||||
- 存储库级别：存储库设置页面，例如 `<your_gitea.com>/<owner>/<repo>/settings/actions/runners`。
|
||||
|
||||
@@ -68,7 +68,7 @@ Runner和Job容器（由Runner启动以执行Job）将连接到此地址。
|
||||
最后，是时候启动Runner了：
|
||||
|
||||
```bash
|
||||
./runner daemon
|
||||
gitea-runner daemon
|
||||
```
|
||||
|
||||
您可以在管理页面上看到新的Runner：
|
||||
|
||||
@@ -28,7 +28,7 @@ aliases:
|
||||
|
||||
Runner级别决定了从哪里获取注册令牌。
|
||||
|
||||
- 实例级别：管理员设置页面，例如 `<your_gitea.com>/admin/actions/runners`。
|
||||
- 实例级别：管理员设置页面，例如 `<your_gitea.com>/-/admin/actions/runners`。
|
||||
- 组织级别：组织设置页面，例如 `<your_gitea.com>/<org>/settings/actions/runners`。
|
||||
- 存储库级别：存储库设置页面，例如 `<your_gitea.com>/<owner>/<repo>/settings/actions/runners`。
|
||||
|
||||
|
||||
@@ -40,7 +40,7 @@ Gitea Actions需要[runner](https://gitea.com/gitea/runner) 来运行Job。
|
||||
在运行Runner之前，您需要使用以下命令将其注册到Gitea实例中：
|
||||
|
||||
```bash
|
||||
./runner register --no-interactive --instance <instance> --token <token>
|
||||
gitea-runner register --no-interactive --instance <instance> --token <token>
|
||||
```
|
||||
|
||||
需要两个必需的参数：`instance` 和 `token`。
|
||||
@@ -52,10 +52,10 @@ Runner和Job容器（由Runner启动以执行Job）将连接到此地址。
|
||||
如果不确定使用哪个地址，通常选择局域网地址即可。
|
||||
|
||||
`token` 用于身份验证和标识，例如 `P2U1U0oB4XaRCi8azcngmPCLbRpUGapalhmddh23`。
|
||||
它只能使用一次，并且不能用于注册多个Runner。
|
||||
每个令牌都可用于注册多个Runner。通过重置链接替换为新令牌后，旧令牌将失效。
|
||||
您可以从以下位置获取不同级别的`token`,从而创建出相应级别的`runner`
|
||||
|
||||
- 实例级别：管理员设置页面，例如 `<your_gitea.com>/admin/actions/runners`。
|
||||
- 实例级别：管理员设置页面，例如 `<your_gitea.com>/-/admin/actions/runners`。
|
||||
- 组织级别：组织设置页面，例如 `<your_gitea.com>/<org>/settings/actions/runners`。
|
||||
- 存储库级别：存储库设置页面，例如 `<your_gitea.com>/<owner>/<repo>/settings/actions/runners`。
|
||||
|
||||
@@ -68,7 +68,7 @@ Runner和Job容器（由Runner启动以执行Job）将连接到此地址。
|
||||
最后，是时候启动Runner了：
|
||||
|
||||
```bash
|
||||
./runner daemon
|
||||
gitea-runner daemon
|
||||
```
|
||||
|
||||
您可以在管理页面上看到新的Runner：
|
||||
|
||||
@@ -28,7 +28,7 @@ aliases:
|
||||
|
||||
Runner级别决定了从哪里获取注册令牌。
|
||||
|
||||
- 实例级别：管理员设置页面，例如 `<your_gitea.com>/admin/actions/runners`。
|
||||
- 实例级别：管理员设置页面，例如 `<your_gitea.com>/-/admin/actions/runners`。
|
||||
- 组织级别：组织设置页面，例如 `<your_gitea.com>/<org>/settings/actions/runners`。
|
||||
- 存储库级别：存储库设置页面，例如 `<your_gitea.com>/<owner>/<repo>/settings/actions/runners`。
|
||||
|
||||
|
||||
@@ -40,7 +40,7 @@ Gitea Actions需要[runner](https://gitea.com/gitea/runner) 來運行Job。
|
||||
在運行Runner之前，您需要使用以下命令將其註冊到Gitea實例中：
|
||||
|
||||
```bash
|
||||
./runner register --no-interactive --instance <instance> --token <token>
|
||||
gitea-runner register --no-interactive --instance <instance> --token <token>
|
||||
```
|
||||
|
||||
需要兩個必需的參數：`instance` 和 `token`。
|
||||
@@ -52,10 +52,10 @@ Runner和Job容器（由Runner啟動以執行Job）將連接到此地址。
|
||||
如果不確定使用哪個地址，通常選擇局域網地址即可。
|
||||
|
||||
`token` 用於身份驗證和標識，例如 `P2U1U0oB4XaRCi8azcngmPCLbRpUGapalhmddh23`。
|
||||
它只能使用一次，並且不能用於註冊多個Runner。
|
||||
每個令牌都可用來註冊多個Runner。透過重設連結換成新令牌後，舊令牌就會失效。
|
||||
您可以從以下位置獲取不同級別的`token`,從而建立出相應級別的`runner`
|
||||
|
||||
- 實例級別：管理員設定頁面，例如 `<your_gitea.com>/admin/actions/runners`。
|
||||
- 實例級別：管理員設定頁面，例如 `<your_gitea.com>/-/admin/actions/runners`。
|
||||
- 組織級別：組織設定頁面，例如 `<your_gitea.com>/<org>/settings/actions/runners`。
|
||||
- 儲存庫級別：儲存庫設定頁面，例如 `<your_gitea.com>/<owner>/<repo>/settings/actions/runners`。
|
||||
|
||||
@@ -68,7 +68,7 @@ Runner和Job容器（由Runner啟動以執行Job）將連接到此地址。
|
||||
最後，是時候啟動Runner了：
|
||||
|
||||
```bash
|
||||
./runner daemon
|
||||
gitea-runner daemon
|
||||
```
|
||||
|
||||
您可以在管理頁面上看到新的Runner：
|
||||
|
||||
@@ -28,7 +28,7 @@ aliases:
|
||||
|
||||
Runner級別決定了從哪裡獲取註冊令牌。
|
||||
|
||||
- 實例級別：管理員設定頁面，例如 `<your_gitea.com>/admin/actions/runners`。
|
||||
- 實例級別：管理員設定頁面，例如 `<your_gitea.com>/-/admin/actions/runners`。
|
||||
- 組織級別：組織設定頁面，例如 `<your_gitea.com>/<org>/settings/actions/runners`。
|
||||
- 儲存庫級別：儲存庫設定頁面，例如 `<your_gitea.com>/<owner>/<repo>/settings/actions/runners`。
|
||||
|
||||
|
||||
@@ -40,7 +40,7 @@ Gitea Actions需要[runner](https://gitea.com/gitea/runner) 來運行Job。
|
||||
在運行Runner之前，您需要使用以下命令將其註冊到Gitea實例中：
|
||||
|
||||
```bash
|
||||
./runner register --no-interactive --instance <instance> --token <token>
|
||||
gitea-runner register --no-interactive --instance <instance> --token <token>
|
||||
```
|
||||
|
||||
需要兩個必需的參數：`instance` 和 `token`。
|
||||
@@ -52,10 +52,10 @@ Runner和Job容器（由Runner啟動以執行Job）將連接到此地址。
|
||||
如果不確定使用哪個地址，通常選擇局域網地址即可。
|
||||
|
||||
`token` 用於身份驗證和標識，例如 `P2U1U0oB4XaRCi8azcngmPCLbRpUGapalhmddh23`。
|
||||
它只能使用一次，並且不能用於註冊多個Runner。
|
||||
每個令牌都可用來註冊多個Runner。透過重設連結換成新令牌後，舊令牌就會失效。
|
||||
您可以從以下位置獲取不同級別的`token`,從而建立出相應級別的`runner`
|
||||
|
||||
- 實例級別：管理員設定頁面，例如 `<your_gitea.com>/admin/actions/runners`。
|
||||
- 實例級別：管理員設定頁面，例如 `<your_gitea.com>/-/admin/actions/runners`。
|
||||
- 組織級別：組織設定頁面，例如 `<your_gitea.com>/<org>/settings/actions/runners`。
|
||||
- 儲存庫級別：儲存庫設定頁面，例如 `<your_gitea.com>/<owner>/<repo>/settings/actions/runners`。
|
||||
|
||||
@@ -68,7 +68,7 @@ Runner和Job容器（由Runner啟動以執行Job）將連接到此地址。
|
||||
最後，是時候啟動Runner了：
|
||||
|
||||
```bash
|
||||
./runner daemon
|
||||
gitea-runner daemon
|
||||
```
|
||||
|
||||
您可以在管理頁面上看到新的Runner：
|
||||
|
||||
@@ -28,7 +28,7 @@ aliases:
|
||||
|
||||
Runner級別決定了從哪裡獲取註冊令牌。
|
||||
|
||||
- 實例級別：管理員設定頁面，例如 `<your_gitea.com>/admin/actions/runners`。
|
||||
- 實例級別：管理員設定頁面，例如 `<your_gitea.com>/-/admin/actions/runners`。
|
||||
- 組織級別：組織設定頁面，例如 `<your_gitea.com>/<org>/settings/actions/runners`。
|
||||
- 儲存庫級別：儲存庫設定頁面，例如 `<your_gitea.com>/<owner>/<repo>/settings/actions/runners`。
|
||||
|
||||
|
||||
Reference in new issue
Block a user