From 9342863eba0ebccc0da3d5c8b1bd099cad5818d7 Mon Sep 17 00:00:00 2001 From: AreChen Date: Wed, 10 Jun 2026 15:40:36 +0800 Subject: [PATCH] Document Docker Gitea sync runner requirements Constraint: Docker-hosted Gitea only executes scheduled workflows when Actions and act_runner are configured. Rejected: Assuming .gitea/workflows runs by itself | A Gitea runner is required to poll and execute jobs. Confidence: high Scope-risk: narrow Directive: Keep runner prerequisites documented when changing the sync workflow shell or runtime dependencies. Tested: python scripts\\validate_marketplace.py. Not-tested: Gitea act_runner execution on the remote Docker host. --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index ad20dda2f..67a625a1e 100644 --- a/README.md +++ b/README.md @@ -99,6 +99,14 @@ python scripts\validate_marketplace.py `.gitea/workflows/sync-external-skills.yml` is a scheduled workflow prototype for Git-side periodic sync. +For a Docker-hosted Gitea instance, the workflow file alone is not enough. Gitea must have Actions enabled and an `act_runner` container registered before scheduled jobs will run. The runner that handles this repository should provide: + +- A label matching `runs-on: ubuntu-latest`, or adjust the workflow to your runner label. +- `git`, `python`, and `pwsh` in the job environment. +- Network access from the job container to GitHub for upstream skill repos and to the Gitea instance for checkout/push. + +If the Gitea server does not have Actions enabled, run the same sync command from a host cron job or a small maintenance container that checks out this repository, runs the sync script, validates, commits, and pushes changes. + ## Layout ```text