mirror of
				https://github.com/go-gitea/gitea
				synced 2025-11-03 21:08:25 +00:00 
			
		
		
		
	Update documentation for 1.21 actions (#26317)
As title. Close #26309 Related to #24724, #24806
This commit is contained in:
		@@ -245,8 +245,7 @@ You can find more useful images on [act images](https://github.com/nektos/act/bl
 | 
			
		||||
If you want to run jobs in the host directly, you can change it to `ubuntu-22.04:host` or just `ubuntu-22.04`, the `:host` is optional.
 | 
			
		||||
However, we suggest you to use a special name like `linux_amd64:host` or `windows:host` to avoid misusing it.
 | 
			
		||||
 | 
			
		||||
One more thing is that it is recommended to register the runner if you want to change the labels.
 | 
			
		||||
It may be annoying to do this, so we may provide a better way to do it in the future.
 | 
			
		||||
After Gitea 1.21 released, you can change labels by modfiying `container.labels` in configuration file (if you don't have a configuration file, please refer to [configuration tutorials](#configuration)), and runner will declare the new labels which you defined in configuration file after executing `./act_runner daemon --config config.yaml`.
 | 
			
		||||
 | 
			
		||||
## Running
 | 
			
		||||
 | 
			
		||||
@@ -261,3 +260,32 @@ After you have registered the runner, you can run it by running the following co
 | 
			
		||||
The runner will fetch jobs from the Gitea instance and run them automatically.
 | 
			
		||||
 | 
			
		||||
Since act runner is still in development, it is recommended to check the latest version and upgrade it regularly.
 | 
			
		||||
 | 
			
		||||
## Configuration variable
 | 
			
		||||
 | 
			
		||||
You can create configuration varibales with user, organization, repository level. And the level of the variable depends on which setting panel you created in.
 | 
			
		||||
 | 
			
		||||
### Naming conventions
 | 
			
		||||
 | 
			
		||||
The following rules apply to variable names:
 | 
			
		||||
 | 
			
		||||
- Varibale names can only contain alphanumeric characters (`[a-z]`, `[A-Z]`, `[0-9]`) or underscores (`_`). Spaces are not allowed.
 | 
			
		||||
 | 
			
		||||
- Varibale names must not start with the `GITHUB_` and `GITEA_` prefix.
 | 
			
		||||
 | 
			
		||||
- Varibale names must not start with a number.
 | 
			
		||||
 | 
			
		||||
- Varibale names are not case-sensitive.
 | 
			
		||||
 | 
			
		||||
- Varibale names must be unique at the level they are created at.
 | 
			
		||||
 | 
			
		||||
- Varibale names must not be 'CI'.
 | 
			
		||||
 | 
			
		||||
### Using varibales
 | 
			
		||||
 | 
			
		||||
After creating configuration varibales, they will be automatically filled in the `vars` context. They are available to you with expression like `{{ vars.VARIABLE_NAME }}` in workflow.
 | 
			
		||||
 | 
			
		||||
### Precedence
 | 
			
		||||
 | 
			
		||||
If a variable with the same name exists at multiple levels, the variable at the lowest level takes precedence(the level of organization and user is higher than repository's).
 | 
			
		||||
For example, if an organization-level variable has the same name as a repository-level variable, then the repository-level variable takes precedence.
 | 
			
		||||
 
 | 
			
		||||
@@ -241,8 +241,7 @@ Runner的标签用于确定Runner可以运行哪些Job以及如何运行它们
 | 
			
		||||
如果您想直接在主机上运行Job,您可以将其更改为`ubuntu-22.04:host`或仅`ubuntu-22.04`,`:host`是可选的。
 | 
			
		||||
然而,我们建议您使用类似`linux_amd64:host`或`windows:host`的特殊名称,以避免误用。
 | 
			
		||||
 | 
			
		||||
还有一点需要注意的是,建议在更改标签时注册Runner。
 | 
			
		||||
这可能会有些麻烦,所以我们可能会在将来提供更好的方法来处理。
 | 
			
		||||
Gitea 1.21 发布后,您可以通过修改配置文件中的 `container.labels` 来更改标签(如果没有配置文件,请参考 [配置教程](#配置)),执行 `./act_runner daemon --config config.yaml` 命令后,它会向 Gitea 声明您在配置文件中定义的新标签。
 | 
			
		||||
 | 
			
		||||
## 运行
 | 
			
		||||
 | 
			
		||||
@@ -257,3 +256,32 @@ Runner的标签用于确定Runner可以运行哪些Job以及如何运行它们
 | 
			
		||||
Runner将从Gitea实例获取Job并自动运行它们。
 | 
			
		||||
 | 
			
		||||
由于Act Runner仍处于开发中,建议定期检查最新版本并进行升级。
 | 
			
		||||
 | 
			
		||||
## 变量
 | 
			
		||||
 | 
			
		||||
您可以创建用户、组织和仓库级别的变量。变量的级别是取决于你在哪个设置面板中创建它们的。
 | 
			
		||||
 | 
			
		||||
### 命名规则
 | 
			
		||||
 | 
			
		||||
以下规则适用于变量名:
 | 
			
		||||
 | 
			
		||||
- 变量名称只能包含字母数字字符 (`[a-z]`, `[A-Z]`, `[0-9]`) 或下划线 (`_`)。不允许使用空格。
 | 
			
		||||
 | 
			
		||||
- 变量名称不能以 `GITHUB_` 和 `GITEA_` 前缀开头。
 | 
			
		||||
 | 
			
		||||
- 变量名称不能以数字开头。
 | 
			
		||||
 | 
			
		||||
- 变量名称不区分大小写。
 | 
			
		||||
 | 
			
		||||
- 变量名称在创建它们的级别上必须是唯一的。
 | 
			
		||||
 | 
			
		||||
- 变量名称不能为 “CI”。
 | 
			
		||||
 | 
			
		||||
### 使用
 | 
			
		||||
 | 
			
		||||
创建配置变量后,它们将自动填充到 `vars` 上下文中。您可以在工作流中使用类似 `{{ vars.VARIABLE_NAME }}` 这样的表达式来使用它们。
 | 
			
		||||
 | 
			
		||||
### 优先级
 | 
			
		||||
 | 
			
		||||
如果同名变量存在于多个级别,则级别最低的变量优先(组织和用户的级别高于仓库)。
 | 
			
		||||
比如,如果组织级变量与仓库级变量同名,则仓库变量优先。
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user