Tirsvad
9e5dd4f1dd
This commit adds a reusable Gitea workflow that syncs repository description and topics to a configured GitHub push mirror via the GitHub API. Also includes README, LICENSE (AGPL-3.0), and the workflow file itself.
2.2 KiB
🚀 TirSystem GitHub Actions
Global, reusable GitHub Actions and workflows for TirSystem projects.
📚 Table of Contents
🧭 Overview
This repository is the central collection of global GitHub Actions used across TirSystem repositories. The primary repository lives at git.tirsystem.com (Gitea) and is push-mirrored to GitHub.
It currently contains the Gitea workflow sync-github-metadata.yml, which copies the repository description and topics from Gitea to the GitHub mirror on every push to main, on manual dispatch, and daily at 03:17 UTC.
📋 Requirements
- A Gitea instance with Actions enabled and a runner providing
ubuntu-latestwithpython3 - A configured GitHub push mirror on the Gitea repository (exactly one)
- Repository secrets:
TOKEN_FOR_GITEA: Gitea API token (plain string, or JSON withGITEA_TOKEN)CREDENTIALS_FOR_GITHUB: JSON object containingGITHUB_PAT, a GitHub personal access token allowed to edit the mirror repository
🛠️ Setup
No dependencies need to be installed; the workflow uses only the Python standard library.
- Clone the repository:
git clone ssh://git@git.tirsystem.com:10022/TirSystem/github-action.git - Add the secrets listed under Requirements to the repository settings in Gitea.
- Configure the GitHub push mirror in the repository settings.
▶️ Run
Workflows run automatically on push to main and on the daily schedule. To run manually, trigger Sync GitHub mirror metadata via workflow_dispatch from the Actions tab in Gitea.
🧪 Tests
There are no automated tests. Verify changes by running the workflow manually and checking the description and topics on the GitHub mirror.
📄 License
Licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See LICENSE.