Files

T

Team f20bc770f5 feat: add gitea-deploy skill, tools, and sdlc foreground service rule

- skills/gitea-deploy/: new skill for Gitea deployment automation
- tools/: shared utility scripts
- skills/sdlc/SKILL.md: add Foreground Service Rule for long-running
  processes (background start + readiness polling pattern)

2026-04-25 14:11:58 +08:00

1.5 KiB

Raw Blame History

gitea-deploy

Automate deploying a self-hosted Gitea Git server on a VPS and pushing the current project to it.

Architecture

Workflow

When to Use

You want to self-host a private Git server on your own VPS
You need to push a project to a Gitea instance (new or existing)
You want to migrate away from GitHub/GitLab to a self-hosted solution

Trigger phrases: "deploy gitea", "self-host git", "setup git server", "push to my vps", "搭建git服务器", "部署gitea"

How It Works

Collects VPS connection info and credentials from the user
Validates local git repo and SSH connectivity
Installs Docker on the VPS if not present
Deploys Gitea via docker compose up -d
Polls until Gitea is healthy, then initializes via REST API
Creates the target repository and pushes all local branches
Reports the web URL and SSH clone URL

Requirements

SSH access to a Linux VPS
Local project must be (or become) a git repository
Gitea web port (default 3000) and SSH port (default 2222) must be open on the VPS firewall

File Structure

skills/gitea-deploy/
├── SKILL.md
├── README.md
├── assets/
│   ├── architecture.puml
│   ├── gitea-deploy-architecture.svg
│   ├── workflow.puml
│   └── gitea-deploy-workflow.svg
└── evals/
    └── evals.json

Evals

python scripts/run_evals.py gitea-deploy

1.5 KiB Raw Blame History