Update zh tw languages and fix some broken links

This commit is contained in:
Lunny Xiao
2026-07-01 14:47:51 -07:00
parent 9558006c39
commit a084bdb556
842 changed files with 31137 additions and 31065 deletions

View File

@@ -4,91 +4,91 @@ slug: "quickstart"
sidebar_position: 10
---
# 快速入
# 快速入
页面将指导您使用Gitea Actions的程。
頁面將指導您使用Gitea Actions的程。
## 设置Gitea
## 設定Gitea
首先,您需要一Gitea例。
您可以按照[](installation/from-package.md) 来设置一个新实例或升级现有实例。
无论您如何安装或运行Gitea只要版本是1.19.0或更高即可。
首先,您需要一Gitea例。
您可以按照[](installation/from-package.md) 來設定一個新實例或升級現有實例。
無論您如何安裝或運行Gitea只要版本是1.19.0或更高即可。
1.21.0始,默认情况Actions是用的。如果您正在使用1.21.0之前的版本,您需要以下容添加到配置文件中以用它:
1.21.0始,預設情況Actions是用的。如果您正在使用1.21.0之前的版本,您需要以下容添加到設定文件中以用它:
```ini
[actions]
ENABLED=true
```
如果您想了解更多信息或在配置过程中遇到任何问题,请参考[配置速查表](../../administration/config-cheat-sheet.md#actions-actions)。
如果您想了解更多資訊或在設定過程中遇到任何問題,請參考[設定速查表](../../administration/config-cheat-sheet.md#actions-actions)。
### 设置Runner
### 設定Runner
Gitea Actions需要[runner](https://gitea.com/gitea/runner) 来运行Job。
了避免消耗过多资源并影响Gitea例,建您在Gitea例分开的机器上启动Runner。
Gitea Actions需要[runner](https://gitea.com/gitea/runner) 來運行Job。
了避免消耗過多資源並影響Gitea例,建您在Gitea例分開的機器上啟動Runner。
您可以使用[预构建的二制文件](http://dl.gitea.com/gitea-runner)或[容器](https://hub.docker.com/r/gitea/runner/tags)来设置Runner。
您可以使用[預構建的二制文件](http://dl.gitea.com/gitea-runner)或[容器](https://hub.docker.com/r/gitea/runner/tags)來設定Runner。
一步操作之前,建您先使用预构建的二制文件以命令行方式行它,以保它您的环境兼容,尤其是如果您在本地主机上运行Runner。
如果出现问题,这样调试起来会更容易。
一步操作之前,建您先使用預構建的二制文件以命令行方式行它,以保它您的環境相容,尤其是如果您在本地主機上運行Runner。
如果出現問題,這樣調試起來會更容易。
Runner可以在隔的Docker容器中行Job因此您需要保已安Docker且Docker守护进程正在行。
虽然这不是格必需的,因Runner也可以直接在主机上运行Job这取决于您的配置方式。
然而,建使用Docker行Job它更安全且更易管理。
Runner可以在隔的Docker容器中行Job因此您需要保已安Docker且Docker守護進程正在行。
雖然這不是格必需的,因Runner也可以直接在主機上運行Job這取決於您的設定方式。
然而,建使用Docker行Job它更安全且更易管理。
行Runner之前您需要使用以下命令将其注册到Gitea例中:
行Runner之前您需要使用以下命令將其註冊到Gitea例中:
```bash
./runner register --no-interactive --instance <instance> --token <token>
```
需要两个必需的参数`instance``token`
需要兩個必需的參數`instance``token`
`instance`是您的Gitea例的地址,如`http://192.168.8.8:3000``https://gitea.com`
Runner和Job容器由Runner启动以执行Job将连接到此地址。
意味着它可能与用于Web访问`ROOT_URL`不同。
使用回环地址(例如 `127.0.0.1``localhost`)是一不好的选择
如果不定使用哪地址,通常选择局域地址即可。
`instance`是您的Gitea例的地址,如`http://192.168.8.8:3000``https://gitea.com`
Runner和Job容器由Runner啟動以執行Job將連接到此地址。
意味着它可能與用於Web訪問`ROOT_URL`不同。
使用迴環地址(例如 `127.0.0.1``localhost`)是一不好的選擇
如果不定使用哪地址,通常選擇局域地址即可。
`token`身份验证和标识,例如 `P2U1U0oB4XaRCi8azcngmPCLbRpUGapalhmddh23`
它只能使用一次,且不能用于注册多个Runner。
您可以以下位置取不同级别`token`,从而创建出相应级别`runner`
`token`身份驗證和標識,例如 `P2U1U0oB4XaRCi8azcngmPCLbRpUGapalhmddh23`
它只能使用一次,且不能用於註冊多個Runner。
您可以以下位置取不同級別`token`,從而建立出相應級別`runner`
- 实例级别:管理员设置页面,例如 `<your_gitea.com>/admin/actions/runners`
- 组织级别:组织设置页面,例如 `<your_gitea.com>/<org>/settings/actions/runners`
- 存储库级别:存储库设置页面,例如 `<your_gitea.com>/<owner>/<repo>/settings/actions/runners`
- 實例級別:管理員設定頁面,例如 `<your_gitea.com>/admin/actions/runners`
- 組織級別:組織設定頁面,例如 `<your_gitea.com>/<org>/settings/actions/runners`
- 儲存庫級別:儲存庫設定頁面,例如 `<your_gitea.com>/<owner>/<repo>/settings/actions/runners`
![register runner](/images/usage/actions/register-runner.png)
注册后,当前目录中将出现一个名为 `.runner` 的新文件,文件存储了注册信息
不要手动编辑该文件。
如果文件失或损坏,只需除它然重新注册即可。
註冊後,當前目錄中將出現一個名爲 `.runner` 的新文件,文件儲存了註冊資訊
不要手動編輯該文件。
如果文件失或損壞,只需除它然重新註冊即可。
,是时候启动Runner了
,是時候啟動Runner了
```bash
./runner daemon
```
您可以在管理面上看到新的Runner
您可以在管理面上看到新的Runner
![view runner](/images/usage/actions/view-runner.png)
您可以通过访问[runner](runner) 取更多信息
您可以透過訪問[runner](runner) 取更多資訊
### 使用Actions
即使对于启用了Gitea例的Actions存储库仍默认禁用Actions。
即使對於啟用了Gitea例的Actions儲存庫仍預設禁用Actions。
用它,请转到存储库的设置页面,例如`your_gitea.com/<owner>/repo/settings`,然后启`Enable Repository Actions`
用它,請轉到儲存庫的設定頁面,例如`your_gitea.com/<owner>/repo/settings`,然後啟`Enable Repository Actions`
![enable actions](/images/usage/actions/enable-actions.png)
接下的步可能相当复杂
您需要学习Actions的[工作流](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions)并编写您想要的工作流文件。
接下的步可能相當複雜
您需要學習Actions的[工作流](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions)並編寫您想要的工作流文件。
,我可以从一个简单的演示始:
,我可以從一個簡單的演示始:
```yaml
name: Gitea Actions Demo
@@ -112,20 +112,20 @@ jobs:
- run: echo "🍏 This job's status is ${{ job.status }}."
```
您可以上述例上传为一个`.yaml`展名的文件,放在存储库`.gitea/workflows/`中,例如`.gitea/workflows/demo.yaml`
您可能注意到,这与[GitHub Actions的快速入](https://docs.github.com/en/actions/quickstart)非常相似。
是因Gitea Actions在可能容GitHub Actions的基础上进行设计
您可以上述例上傳爲一個`.yaml`展名的文件,放在儲存庫`.gitea/workflows/`中,例如`.gitea/workflows/demo.yaml`
您可能注意到,這與[GitHub Actions的快速入](https://docs.github.com/en/actions/quickstart)非常相似。
是因Gitea Actions在可能容GitHub Actions的基礎上進行設計
注意,演示文件中包含一些表情符
请确保您的数据库支持它们,特是在使用MySQL
如果字符集不是`utf8mb4`将出现错误,例如`Error 1366 (HY000): Incorrect string value: '\\xF0\\x9F\\x8E\\x89 T...' for column 'name' at row 1`
更多信息,请参阅[数据库准备工作](../../installation/database-preparation.md#mysqlmariadb)。
注意,演示文件中包含一些表情符
請確保您的資料庫支援它們,特是在使用MySQL
如果字符集不是`utf8mb4`將出現錯誤,例如`Error 1366 (HY000): Incorrect string value: '\\xF0\\x9F\\x8E\\x89 T...' for column 'name' at row 1`
更多資訊,請參閱[資料庫準備工作](../../installation/database-preparation.md#mysqlmariadb)。
或者,您可以演示文件中除所有表情符,然后再尝试一次。
或者,您可以演示文件中除所有表情符,然後再嘗試一次。
`on: [push]` 一行表示您向该存储库推送提交,工作流将被触发
然而,您上 YAML 文件,它也推送一提交,所以您应该在"Actions"标签中看到一新的任
`on: [push]` 一行表示您向該儲存庫推送提交,工作流將被觸發
然而,您上 YAML 文件,它也推送一提交,所以您應該在"Actions"標籤中看到一新的任
![view job](/images/usage/actions/view-job.png)
做得好!您已成功始使用Actions。
做得好!您已成功始使用Actions。