configucci/.gitea/workflows/README.md

Gitea Actions Workflows

Workflows

1. CI (ci.yml)

Triggers: Push/PR to main, rewrite, feat branches

Jobs:

• Install dependencies
• Lint code
• Build application
• Run unit tests (Vitest)
• Run E2E tests (Playwright)
• Upload test results as artifacts

2. Docker Build (docker-build.yml)

Triggers:

• Tags matching v* (e.g., v1.0.0)
• Push to main branch

Jobs:

• Build React application
• Build Docker image locally
• Save image as tarball artifact
• Upload artifact for download (30 days retention)

Output:

• Docker image artifact: configucci.tar
• Can be downloaded and loaded with: docker load -i configucci.tar

3. Deploy (deploy.yml)

Triggers: Push to main branch

Jobs:

• SSH to deployment server
• Pull latest code
• Update Docker containers
• Clean up old images

Required Secrets:

• DEPLOY_HOST - Server hostname/IP
• DEPLOY_USERNAME - SSH username
• DEPLOY_KEY - SSH private key

Optional Secrets:

• DEPLOY_PORT - SSH port (default: 22)

Setup Instructions

1. Enable Gitea Actions

Make sure Actions is enabled in your Gitea instance:

[actions]
ENABLED = true

2. Configure Secrets

Go to your repository → Settings → Secrets and add:

For Deployment:

DEPLOY_HOST=your-server.com
DEPLOY_USERNAME=deploy
DEPLOY_KEY=<paste-ssh-private-key>
DEPLOY_PORT=22

No Docker secrets needed - images are built locally and downloaded as artifacts!

Workflow Files Location

.gitea/workflows/

Testing Workflows Locally

You can test workflows locally using act:

# Install act
brew install act

# Run CI workflow locally
act push

# Run with specific job
act -j build-and-test

# Run with verbose output
act -v

Badge Examples

Add these to your README.md:

[![CI](https://git.six83.ru/ssa/configucci/actions/workflows/ci.yml/badge.svg)](https://git.six83.ru/ssa/configucci/actions/workflows/ci.yml)
[![Deploy](https://git.six83.ru/ssa/configucci/actions/workflows/deploy.yml/badge.svg)](https://git.six83.ru/ssa/configucci/actions/workflows/deploy.yml)