Add Gitea Actions

2025-09-14 10:34:41 +00:00
parent ad72bf11b2
commit 8c72303bac

76
Gitea-Actions.md Normal file

@@ -0,0 +1,76 @@
## Built-in Environment Variables
When running a workflow in **Gitea Actions**, several environment variables are automatically available. These can be used to reference repository info, workflow/job context, or paths inside the runner/container.
### Repository Information
| Variable | Description |
| ------------------------- | -------------------------------------------------------- |
| `GITHUB_REPOSITORY` | Full repository name (e.g., `owner/repo`) |
| `GITHUB_REPOSITORY_OWNER` | Repository owner |
| `GITHUB_REF_NAME` | Branch or tag name being built |
| `GITHUB_SHA` | Full commit SHA of the current commit |
| `GITHUB_REF` | Full ref (e.g., `refs/heads/main`) |
| `GITHUB_REF_TYPE` | Type of ref (`branch` or `tag`) |
| `GITHUB_SERVER_URL` | URL of the Gitea instance (e.g., `https://git.kopic.hr`) |
### Workspace & Paths
| Variable | Description |
| ----------------------------------------- | ------------------------------------------------------------- |
| `GITHUB_WORKSPACE` | Path to the workspace directory where your repo can be cloned |
| `PWD` | Current working directory inside the container |
| `GITEA_PATH`, `GITEA_ENV`, `GITEA_OUTPUT` | Internal paths for storing state, environment, and output |
### Workflow & Job Info
| Variable | Description |
| ------------------- | ---------------------------------------------------------------- |
| `GITHUB_WORKFLOW` | Name of the workflow |
| `GITHUB_JOB` | Name of the current job |
| `GITHUB_RUN_NUMBER` | Pipeline run number |
| `GITHUB_EVENT_NAME` | Event that triggered the workflow (`push`, `pull_request`, etc.) |
| `RUNNER_OS` | OS of the runner (`Linux`, `Windows`, etc.) |
| `RUNNER_ARCH` | Architecture of the runner (`amd64`, `ARM64`, etc.) |
### Gitea-specific
| Variable | Description |
| --------------- | ---------------------------------------------- |
| `GITEA_ACTIONS` | `true` if running inside Gitea Actions |
| `ACT` | `true` if running via `act` locally (optional) |
---
## Example: Manual Git Clone in a Job
Sometimes you may want to **clone the repository manually** instead of using `actions/checkout` (which requires Node). You can do it with the built-in variables like this:
```yaml
name: Some job name
on:
push:
branches:
- main
pull_request:
jobs:
helm-lint:
runs-on: docker
container:
image: alpine:latest
steps:
- name: Clone repo
run: |
echo "Cloning repository $GITHUB_REPOSITORY..."
git clone "${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}.git" "$GITHUB_WORKSPACE"
cd "$GITHUB_WORKSPACE"
```
### ✅ Notes:
* `$GITHUB_SERVER_URL` → your Gitea instance URL
* `$GITHUB_REPOSITORY` → repository full name (`owner/repo`)
* `$GITHUB_WORKSPACE` → clone target path inside the container
* Works **without Node**, suitable for minimal containers like `alpine/helm`