demo/README.md

Gitea Actions demo

A minimal repository that runs a Gitea Actions workflow on the in-cluster runner.

Prerequisites

• Gitea deployed and reachable (VPN required): https://gitea.stg.dadosfera.ai
• The act_runner registered and Idle (Site Administration → Actions → Runners) — see the root README runbook.

Walkthrough

1. Log in at https://gitea.stg.dadosfera.ai with the admin credentials from AWS Secrets Manager (stg/gitea/admin).

2. Create a repository, e.g. demo (under your user or a new org). Leave "Initialize repository" unchecked.

3. Push this directory's content to it (HTTPS only — SSH is disabled on this instance):

   cd examples/demo-repo
   git init -b main
   git add .
   git commit -m "demo"
   git remote add gitea https://gitea.stg.dadosfera.ai/<owner>/demo.git
   git push gitea main
   # authenticate with the admin username + password, or an application token
   # (Settings → Applications → Generate New Token)
   

4. Open the repo's Actions tab in Gitea. The Demo workflow should be running; it checks out the code, prints system info, and runs app.py. Green check = the PoC loop is closed.

How it resolves

• runs-on: ubuntu-latest maps to the runner label ubuntu-latest:docker://gitea/runner-images:ubuntu-latest — the job runs in that image inside the runner pod's docker-in-docker sidecar.
• actions/checkout@v4 is fetched from GitHub because the instance sets DEFAULT_ACTIONS_URL: github (cluster nodes need outbound internet).