enter-services
Deploy and manage enter.pollinations.ai text/image services on EC2 and Cloudflare Workers. Requires: SSH keys, sops, wrangler.
- License 许可
- MIT
- 最近更新
- 2026-07-26
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- enter-services
- description
- Deploy and manage enter.pollinations.ai text/image services on EC2 and Cloudflare Workers. Requires: SSH keys, sops, wrangler.
02 资源文件 2
- 其他.gitignore25 B
- 参考文档token-rotation.md9.5 KB
03 SKILL.md 正文
Requirements
Before using this skill, ensure you have:
- SSH keys: Configured via GitHub secrets (see workflow)
- sops:
brew install sops(for decrypting secrets) - Wrangler:
npm install -g wrangler - Node.js:
brew install node
Must run from the pollinations repo root.
Architecture Overview
| Environment | Gateway (Cloudflare Worker) | Text/Image Services (EC2) |
|---|---|---|
| Production | enter.pollinations.ai |
54.147.14.220 (ports 16384/16385) |
| Staging | staging.enter.pollinations.ai |
44.222.254.250 (ports 16384/16385) |
SSH Configuration
Add to ~/.ssh/config:
# Production instance
Host enter-services
HostName 54.147.14.220
User ubuntu
IdentityFile ~/.ssh/enter-services-shared
# Staging instance
Host enter-services-staging
HostName 44.222.254.250
User ubuntu
IdentityFile ~/.ssh/enter-services-staging
Quick Commands
Production
# Service status
ssh enter-services "sudo systemctl status text-pollinations.service image-pollinations.service"
# View logs (real-time)
ssh enter-services "sudo journalctl -u text-pollinations.service -f"
ssh enter-services "sudo journalctl -u image-pollinations.service -f"
# Restart services
ssh enter-services "sudo systemctl restart text-pollinations.service image-pollinations.service"
# Recent errors
ssh enter-services "sudo journalctl -u text-pollinations.service -p err -n 20"
Staging
# Service status
ssh enter-services-staging "sudo systemctl status text-pollinations.service image-pollinations.service"
# View logs
ssh enter-services-staging "sudo journalctl -u text-pollinations.service -f"
# Restart
ssh enter-services-staging "sudo systemctl restart text-pollinations.service image-pollinations.service"
Deploy to Production
The GitHub workflow handles production deployments automatically on push to production branch.
Manual deployment:
# 1. SSH into production
ssh enter-services
# 2. Pull and restart
cd /home/ubuntu/pollinations
git pull origin production
cd text.pollinations.ai && npm install
cd ../image.pollinations.ai && npm install
sudo systemctl restart text-pollinations.service image-pollinations.service
Deploy to Staging
Full Setup (New Instance)
# 1. SSH into the new instance
ssh enter-services-staging
# 2. Install build tools (if needed)
sudo apt-get update && sudo apt-get install -y build-essential
# 3. Clone repo
git clone https://github.com/pollinations/pollinations.git
cd pollinations
# 4. Run setup script
bash enter.pollinations.ai/scripts/setup-services.sh /home/ubuntu/pollinations
# 5. From your LOCAL machine - decrypt and copy env files
cd /path/to/pollinations
sops --output-type dotenv -d gen.pollinations.ai/secrets/prod.vars.json > /tmp/image.env
scp /tmp/image.env enter-services-staging:/home/ubuntu/pollinations/image.pollinations.ai/.env
rm /tmp/image.env
# 6. Restart services
ssh enter-services-staging "sudo systemctl restart text-pollinations.service image-pollinations.service"
Update Staging
ssh enter-services-staging "cd /home/ubuntu/pollinations && git pull && cd text.pollinations.ai && npm install && cd ../image.pollinations.ai && npm install && sudo systemctl restart text-pollinations.service image-pollinations.service"
Deploy Cloudflare Worker (enter.pollinations.ai)
cd enter.pollinations.ai
# Production
npm run deploy:production
# Staging
npm run deploy:staging
Service Locations (on EC2)
- Service definitions:
/etc/systemd/system/ - Text service:
/home/ubuntu/pollinations/text.pollinations.ai/ - Image service:
/home/ubuntu/pollinations/image.pollinations.ai/
Wrangler Configuration
The wrangler.toml contains environment configs:
| Environment | Route | Service URLs |
|---|---|---|
production |
enter.pollinations.ai |
Production EC2 |
staging |
staging.enter.pollinations.ai |
Staging EC2 |
local |
localhost:3000 |
Local dev |
Troubleshooting
Services won't start
# Check logs
ssh enter-services-staging "sudo journalctl -u text-pollinations.service -n 50"
# Check if .env exists
ssh enter-services-staging "ls -la /home/ubuntu/pollinations/text.pollinations.ai/.env"
# Check node/npm
ssh enter-services-staging "node -v && npm -v"
Missing dependencies
ssh enter-services-staging "cd /home/ubuntu/pollinations/text.pollinations.ai && npm install"
Need build tools
ssh enter-services-staging "sudo apt-get install -y build-essential"
Token Rotation
Internal trust-boundary tokens (PLN_ENTER_TOKEN, PLN_GPU_TOKEN, Tinybird
tokens, SOPS recipients): see token-rotation.md for the
inventory, rotation mechanisms, deploy path, and rollback.
Notes
- Production deploys on push to
productionbranch - Staging deploys on push to
stagingbranch - Always test on staging before merging to production
- The Cloudflare Worker (enter.pollinations.ai) routes to EC2 services
- Text service: port 16385, Image service: port 16384
04 同仓库更多 Skills
polli
Generate images, text, audio, video, and transcribe speech via the Pollinations API using the polli CLI. Use when asked to generate media, call pollinations.ai, check pollen balance, list models, manage API keys, inspect quests, manage my-models, or run polli commands.
founder-meditation
When something goes wrong — build failures, crashes, errors, test failures, deployment issues — generate a short calming meditation with TTS audio to reassure the user that everything will be okay.
web-research
Query Pollinations text API with web-search models (gemini-search, perplexity-fast, nomnom, etc.). Use when you need web search grounded answers via Pollinations.
voting-status
Create and post ASCII art voting status diagrams to GitHub issues and Discord. Use when asked to update voting, show voting results, or announce voting status.
tinybird-deploy
Deploy Tinybird pipes and datasources for enter.pollinations.ai observability with the Tinybird Forward CLI.
sync-production
Sync the main branch into production via the GitHub merges API. Pre-checks for merge conflicts and bails out with a clear reason if the merge isn't clean. Use when asked to merge main into production, deploy main to production, or sync production.