opencode-skill/skills/thai-frontend-dev/EASYPANEL_INTEGRATION.md

🚀 Easypanel Deployment Integration Guide

How to deploy websites created with website-creator skill to Easypanel

---

📋 Current Implementation

The website-creator skill generates Docker-ready websites but does NOT automatically deploy to Easypanel. You need to use the easypanel-deploy skill separately.

---

🔧 Deployment Workflow

Step 1: Generate Website

cd /Users/kunthawatgreethong/Gitea/opencode-skill/skills/website-creator

python3 scripts/create_astro_website.py \
  --name "My Website" \
  --languages "th,en" \
  --output "./my-website"

Step 2: Initialize Git Repository

cd ./my-website

git init
git add .
git commit -m "Initial commit - PDPA compliant Astro website"

# Create remote repository on Gitea first, then:
git remote add origin https://git.moreminimore.com/username/my-website.git
git push -u origin main

Step 3: Deploy to Easypanel

Use the easypanel-deploy skill:

/use easypanel-deploy deploy

You'll be asked:

1. Project name: my-website
2. Service name: my-website-service
3. Git repository URL: https://git.moreminimore.com/username/my-website.git
4. Branch: main
5. Port: 80

The skill will:

• Create project (if not exists)
• Create service
• Connect Git repository
• Set build type to Dockerfile
• Trigger deployment
• Check status

Step 4: Verify Deployment

/use easypanel-deploy status
→ Project: my-website
→ Service: my-website-service

Step 5: Set Environment Variables

In Easypanel dashboard:

1. Go to your service
2. Settings → Environment Variables
3. Add these variables:

UMAMI_WEBSITE_ID=your-website-id
UMAMI_DOMAIN=analytics.example.com
ADMIN_PASSWORD=your-secure-password
ASTRO_DB_REMOTE_URL=file:/app/data/consent.db

4. Redeploy to apply changes

---

🔄 Auto-Deploy After Initial Setup

Once deployed, Easypanel will auto-deploy on every push to main branch:

# Make changes
git add .
git commit -m "Update privacy policy"
git push origin main

# Easypanel will automatically rebuild and deploy
# Check status:
/use easypanel-deploy status

---

🔗 Integration Architecture

┌─────────────────────┐
│  website-creator    │
│  (Python script)    │
│                     │
│  Generates:         │
│  - Astro website    │
│  - Dockerfile       │
│  - docker-compose   │
└──────────┬──────────┘
           │
           │ Manual step:
           │ git push
           ↓
┌─────────────────────┐
│   Gitea Repository  │
│  (git.moreminimore) │
└──────────┬──────────┘
           │
           │ Auto-deploy
           │ or manual trigger
           ↓
┌─────────────────────┐
│   easypanel-deploy  │
│   (Skill via API)   │
│                     │
│   Deploys to:       │
│   - Easypanel       │
│   - Docker          │
└──────────┬──────────┘
           │
           ↓
┌─────────────────────┐
│   Production URL    │
│   https://...       │
└─────────────────────┘

---

🛠️ Future Enhancement: Automatic Integration

To fully automate deployment, the website-creator skill could be extended to:

Option 1: Call easypanel-deploy via subprocess

# In create_astro_website.py
import subprocess

def deploy_to_easypanel(project_name, service_name, git_url):
    """Deploy to Easypanel using easypanel-deploy skill."""
    
    # Push to Git first
    subprocess.run(['git', 'add', '.'])
    subprocess.run(['git', 'commit', '-m', 'Initial commit'])
    subprocess.run(['git', 'push', '-u', 'origin', 'main'])
    
    # Call easypanel-deploy via curl commands
    # (from easypanel-deploy SKILL.md workflow)
    
    print("✅ Deployed to Easypanel!")
    print(f"URL: https://{project_name}.easypanel.app")

Option 2: Use task() delegation

# If running within OpenCode agent context
from opencode import task

def deploy_to_easypanel(project_name, service_name, git_url):
    """Delegate to easypanel-deploy skill."""
    
    result = task(
        category="quick",
        load_skills=["easypanel-deploy"],
        description="Deploy website to Easypanel",
        prompt=f"""Deploy to Easypanel:
        - Project: {project_name}
        - Service: {service_name}
        - Git URL: {git_url}
        - Branch: main
        - Port: 80
        
        Follow easypanel-deploy workflow exactly."""
    )
    
    return result

Option 3: Generate deployment script

# Generate deploy.sh in website root
deploy_script = """#!/bin/bash
# Auto-deploy to Easypanel

PROJECT_NAME="{project_name}"
SERVICE_NAME="{service_name}"
GIT_URL="{git_url}"

# Push to Git
git add .
git commit -m "Deploy $(date)"
git push origin main

echo "✅ Code pushed. Easypanel will auto-deploy."
echo "Check status: /use easypanel-deploy status"
"""

(output_dir / 'deploy.sh').write_text(deploy_script)

---

✅ Current Status

Feature	Status	Notes
Generate website	✅ Complete	Docker-ready
Push to Git	⚠️ Manual	User must run git commands
Deploy to Easypanel	⚠️ Manual	Use /use easypanel-deploy
Auto-deploy on push	✅ Works	After initial setup
Direct integration	❌ Not implemented	Future enhancement

---

📞 Quick Reference

Deploy Commands

# 1. Generate
python3 scripts/create_astro_website.py --name "site" --output "./site"

# 2. Git
cd ./site && git init && git add . && git commit -m "Initial"
git remote add origin <url> && git push -u origin main

# 3. Easypanel (via skill)
/use easypanel-deploy deploy
→ Project: site
→ Service: site-service
→ Git URL: <url>
→ Branch: main
→ Port: 80

# 4. Check status
/use easypanel-deploy status

Environment Variables

Set in Easypanel dashboard:

UMAMI_WEBSITE_ID=xxx-xxx-xxx
UMAMI_DOMAIN=analytics.example.com
ADMIN_PASSWORD=change-me-before-production
ASTRO_DB_REMOTE_URL=file:/app/data/consent.db

---

🎯 Recommended Workflow

For Production:

1. Generate website with website-creator
2. Test locally (npm run dev)
3. Push to Gitea
4. Deploy with easypanel-deploy
5. Set environment variables
6. Verify deployment
7. Future updates: just git push

For Development:

1. Generate website
2. Test locally
3. Make changes
4. Commit when ready
5. Push to trigger deployment

---

📝 Summary

Current: Two separate skills, manual deployment step

• website-creator → Generates website ✅
• User → Pushes to Git ⚠️
• easypanel-deploy → Deploys to Easypanel ⚠️

Future (if implemented): Single command deployment

• website-creator → Generates AND deploys ✅

For now: Use the workflow above for deployment.