mirror of https://github.com/go-gitea/gitea.git
Update actions variables documents (#30394)
Fix #30393 --------- Co-authored-by: silverwind <me@silverwind.io> Co-authored-by: Zettat123 <zettat123@gmail.com>
This commit is contained in:
parent
50dbed6527
commit
f3cc00626b
|
@ -303,34 +303,3 @@ sudo systemctl enable act_runner --now
|
||||||
```
|
```
|
||||||
|
|
||||||
If using Docker, the `act_runner` user should also be added to the `docker` group before starting the service. Keep in mind that this effectively gives `act_runner` root access to the system [[1]](https://docs.docker.com/engine/security/#docker-daemon-attack-surface).
|
If using Docker, the `act_runner` user should also be added to the `docker` group before starting the service. Keep in mind that this effectively gives `act_runner` root access to the system [[1]](https://docs.docker.com/engine/security/#docker-daemon-attack-surface).
|
||||||
|
|
||||||
## Configuration variable
|
|
||||||
|
|
||||||
You can create configuration variables on the user, organization and repository level.
|
|
||||||
The level of the variable depends on where you created it.
|
|
||||||
|
|
||||||
### Naming conventions
|
|
||||||
|
|
||||||
The following rules apply to variable names:
|
|
||||||
|
|
||||||
- Variable names can only contain alphanumeric characters (`[a-z]`, `[A-Z]`, `[0-9]`) or underscores (`_`). Spaces are not allowed.
|
|
||||||
|
|
||||||
- Variable names must not start with the `GITHUB_` and `GITEA_` prefix.
|
|
||||||
|
|
||||||
- Variable names must not start with a number.
|
|
||||||
|
|
||||||
- Variable names are case-insensitive.
|
|
||||||
|
|
||||||
- Variable names must be unique at the level they are created at.
|
|
||||||
|
|
||||||
- Variable names must not be `CI`.
|
|
||||||
|
|
||||||
### Using variable
|
|
||||||
|
|
||||||
After creating configuration variables, they will be automatically filled in the `vars` context.
|
|
||||||
They can be accessed through expressions like `{{ vars.VARIABLE_NAME }}` in the workflow.
|
|
||||||
|
|
||||||
### Precedence
|
|
||||||
|
|
||||||
If a variable with the same name exists at multiple levels, the variable at the lowest level takes precedence:
|
|
||||||
A repository variable will always be chosen over an organization/user variable.
|
|
||||||
|
|
|
@ -258,32 +258,3 @@ Runner的标签用于确定Runner可以运行哪些Job以及如何运行它们
|
||||||
Runner将从Gitea实例获取Job并自动运行它们。
|
Runner将从Gitea实例获取Job并自动运行它们。
|
||||||
|
|
||||||
由于Act Runner仍处于开发中,建议定期检查最新版本并进行升级。
|
由于Act Runner仍处于开发中,建议定期检查最新版本并进行升级。
|
||||||
|
|
||||||
## 变量
|
|
||||||
|
|
||||||
您可以创建用户、组织和仓库级别的变量。变量的级别取决于创建它的位置。
|
|
||||||
|
|
||||||
### 命名规则
|
|
||||||
|
|
||||||
以下规则适用于变量名:
|
|
||||||
|
|
||||||
- 变量名称只能包含字母数字字符 (`[a-z]`, `[A-Z]`, `[0-9]`) 或下划线 (`_`)。不允许使用空格。
|
|
||||||
|
|
||||||
- 变量名称不能以 `GITHUB_` 和 `GITEA_` 前缀开头。
|
|
||||||
|
|
||||||
- 变量名称不能以数字开头。
|
|
||||||
|
|
||||||
- 变量名称不区分大小写。
|
|
||||||
|
|
||||||
- 变量名称在创建它们的级别上必须是唯一的。
|
|
||||||
|
|
||||||
- 变量名称不能为 “CI”。
|
|
||||||
|
|
||||||
### 使用
|
|
||||||
|
|
||||||
创建配置变量后,它们将自动填充到 `vars` 上下文中。您可以在工作流中使用类似 `{{ vars.VARIABLE_NAME }}` 这样的表达式来使用它们。
|
|
||||||
|
|
||||||
### 优先级
|
|
||||||
|
|
||||||
如果同名变量存在于多个级别,则级别最低的变量优先。
|
|
||||||
仓库级别的变量总是比组织或者用户级别的变量优先被选中。
|
|
||||||
|
|
|
@ -0,0 +1,41 @@
|
||||||
|
---
|
||||||
|
date: "2024-04-10T22:21:00+08:00"
|
||||||
|
title: "Variables"
|
||||||
|
slug: "actions-variables"
|
||||||
|
sidebar_position: 25
|
||||||
|
draft: false
|
||||||
|
toc: false
|
||||||
|
menu:
|
||||||
|
sidebar:
|
||||||
|
parent: "actions"
|
||||||
|
name: "Variables"
|
||||||
|
sidebar_position: 25
|
||||||
|
identifier: "actions-variables"
|
||||||
|
---
|
||||||
|
|
||||||
|
## Variables
|
||||||
|
|
||||||
|
You can create configuration variables on the user, organization and repository level.
|
||||||
|
The level of the variable depends on where you created it. When creating a variable, the
|
||||||
|
key will be converted to uppercase. You need use uppercase on the yaml file.
|
||||||
|
|
||||||
|
### Naming conventions
|
||||||
|
|
||||||
|
The following rules apply to variable names:
|
||||||
|
|
||||||
|
- Variable names can only contain alphanumeric characters (`[a-z]`, `[A-Z]`, `[0-9]`) or underscores (`_`). Spaces are not allowed.
|
||||||
|
- Variable names must not start with the `GITHUB_` and `GITEA_` prefix.
|
||||||
|
- Variable names must not start with a number.
|
||||||
|
- Variable names are case-insensitive.
|
||||||
|
- Variable names must be unique at the level they are created at.
|
||||||
|
- Variable names must not be `CI`.
|
||||||
|
|
||||||
|
### Using variable
|
||||||
|
|
||||||
|
After creating configuration variables, they will be automatically filled in the `vars` context.
|
||||||
|
They can be accessed through expressions like `${{ vars.VARIABLE_NAME }}` in the workflow.
|
||||||
|
|
||||||
|
### Precedence
|
||||||
|
|
||||||
|
If a variable with the same name exists at multiple levels, the variable at the lowest level takes precedence:
|
||||||
|
A repository variable will always be chosen over an organization/user variable.
|
|
@ -0,0 +1,39 @@
|
||||||
|
---
|
||||||
|
date: "2024-04-10T22:21:00+08:00"
|
||||||
|
title: "变量"
|
||||||
|
slug: "actions-variables"
|
||||||
|
sidebar_position: 25
|
||||||
|
draft: false
|
||||||
|
toc: false
|
||||||
|
menu:
|
||||||
|
sidebar:
|
||||||
|
parent: "actions"
|
||||||
|
name: "变量"
|
||||||
|
sidebar_position: 25
|
||||||
|
identifier: "actions-variables"
|
||||||
|
---
|
||||||
|
|
||||||
|
## 变量
|
||||||
|
|
||||||
|
您可以创建用户、组织和仓库级别的变量。变量的级别取决于创建它的位置。当创建变量时,变量的名称会被
|
||||||
|
转换为大写,在yaml文件中引用时需要使用大写。
|
||||||
|
|
||||||
|
### 命名规则
|
||||||
|
|
||||||
|
以下规则适用于变量名:
|
||||||
|
|
||||||
|
- 变量名称只能包含字母数字字符 (`[a-z]`, `[A-Z]`, `[0-9]`) 或下划线 (`_`)。不允许使用空格。
|
||||||
|
- 变量名称不能以 `GITHUB_` 和 `GITEA_` 前缀开头。
|
||||||
|
- 变量名称不能以数字开头。
|
||||||
|
- 变量名称不区分大小写。
|
||||||
|
- 变量名称在创建它们的级别上必须是唯一的。
|
||||||
|
- 变量名称不能为 `CI`。
|
||||||
|
|
||||||
|
### 使用
|
||||||
|
|
||||||
|
创建配置变量后,它们将自动填充到 `vars` 上下文中。您可以在工作流中使用类似 `${{ vars.VARIABLE_NAME }}` 这样的表达式来使用它们。
|
||||||
|
|
||||||
|
### 优先级
|
||||||
|
|
||||||
|
如果同名变量存在于多个级别,则级别最低的变量优先。
|
||||||
|
仓库级别的变量总是比组织或者用户级别的变量优先被选中。
|
Loading…
Reference in New Issue