You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/content/usage/actions/act-runner.en-us.md
+30-2
Original file line number
Diff line number
Diff line change
@@ -245,8 +245,7 @@ You can find more useful images on [act images](https://github.com/nektos/act/bl
245
245
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.
246
246
However, we suggest you to use a special name like `linux_amd64:host` or `windows:host` to avoid misusing it.
247
247
248
-
One more thing is that it is recommended to register the runner if you want to change the labels.
249
-
It may be annoying to do this, so we may provide a better way to do it in the future.
248
+
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`.
250
249
251
250
## Running
252
251
@@ -261,3 +260,32 @@ After you have registered the runner, you can run it by running the following co
261
260
The runner will fetch jobs from the Gitea instance and run them automatically.
262
261
263
262
Since act runner is still in development, it is recommended to check the latest version and upgrade it regularly.
263
+
264
+
## Configuration variable
265
+
266
+
You can create configuration varibales with user, organization, repository level. And the level of the variable depends on which setting panel you created in.
267
+
268
+
### Naming conventions
269
+
270
+
The following rules apply to variable names:
271
+
272
+
- Varibale names can only contain alphanumeric characters (`[a-z]`, `[A-Z]`, `[0-9]`) or underscores (`_`). Spaces are not allowed.
273
+
274
+
- Varibale names must not start with the `GITHUB_` and `GITEA_` prefix.
275
+
276
+
- Varibale names must not start with a number.
277
+
278
+
- Varibale names are not case-sensitive.
279
+
280
+
- Varibale names must be unique at the level they are created at.
281
+
282
+
- Varibale names must not be 'CI'.
283
+
284
+
### Using varibales
285
+
286
+
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.
287
+
288
+
### Precedence
289
+
290
+
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).
291
+
For example, if an organization-level variable has the same name as a repository-level variable, then the repository-level variable takes precedence.
0 commit comments