mirror of
https://gitea.com/gitea/docs.git
synced 2026-07-22 12:37:42 +00:00
Update zh tw languages and fix some broken links (#455)
--------- Co-authored-by: silverwind <me@silverwind.io> Co-authored-by: silverwind <2021+silverwind@noreply.gitea.com> Reviewed-on: https://gitea.com/gitea/docs/pulls/455 Reviewed-by: silverwind <2021+silverwind@noreply.gitea.com>
This commit is contained in:
Lunny Xiao
@@ -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需要[act runner](https://gitea.com/gitea/act_runner) 来运行Job。
|
||||
為了避免消耗過多资源並影響Gitea实例，建议您在与Gitea实例分开的机器上启动Runner。
|
||||
Gitea Actions需要[act runner](https://gitea.com/gitea/act_runner) 來運行Job。
|
||||
為了避免消耗過多資源並影響Gitea實例，建議您在與Gitea實例分開的機器上啟動Runner。
|
||||
|
||||
您可以使用[预构建的二進制文件](http://dl.gitea.com/act_runner)或[容器镜像](https://hub.docker.com/r/gitea/act_runner/tags)来设置Runner。
|
||||
您可以使用[預構建的二進制文件](http://dl.gitea.com/act_runner)或[容器鏡像](https://hub.docker.com/r/gitea/act_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
|
||||
./act_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`。
|
||||
|
||||
|
||||
|
||||
注册后，当前目錄中将出現一个名為 `.runner` 的新文件，該文件存儲了注册信息。
|
||||
請不要手动编辑該文件。
|
||||
如果該文件丢失或损坏，只需删除它然后重新注册即可。
|
||||
註冊後，當前目錄中將出現一個名為 `.runner` 的新文件，該文件儲存了註冊資訊。
|
||||
請不要手動編輯該文件。
|
||||
如果該文件丟失或損壞，只需刪除它然後重新註冊即可。
|
||||
|
||||
最后，是时候启动Runner了：
|
||||
最後，是時候啟動Runner了：
|
||||
|
||||
```bash
|
||||
./act_runner daemon
|
||||
```
|
||||
|
||||
您可以在管理页面上看到新的Runner：
|
||||
您可以在管理頁面上看到新的Runner：
|
||||
|
||||
|
||||
|
||||
您可以通過访问[act runner](usage/actions/act-runner.md) 获取更多信息。
|
||||
您可以透過訪問[act runner](usage/actions/act-runner.md) 獲取更多資訊。
|
||||
|
||||
### 使用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`。
|
||||
|
||||
|
||||
|
||||
接下来的步骤可能相当复杂。
|
||||
您需要学习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"標籤中看到一個新的任務。
|
||||
|
||||
|
||||
|
||||
做得好！您已成功开始使用Actions。
|
||||
做得好！您已成功開始使用Actions。
|
||||
|
||||
Reference in New Issue
Block a user