trevor/TG_autoposter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
e57ca0b36ef47e9b0dff704db3a9f04ad8bc3bf6
TG_autoposter/docs/QUICK_COMMANDS.md
Andrew K. Choi 48f8c6f0eb ✅ UserBot Integration Complete: Fixed container startup, integrated UserBot menu to main bot 
MAJOR FIXES:
✅ Fixed UserBot container startup by making TELEGRAM_BOT_TOKEN optional
✅ Broke circular import chain between app modules
✅ Made Config.validate() conditional for UserBot-only mode
✅ Removed unused celery import from userbot_service.py

INTEGRATION:
✅ UserBot menu now accessible from main bot /start command
✅ Added 🤖 UserBot button to main keyboard
✅ Integrated userbot_manager.py handlers:
   - userbot_menu: Main UserBot interface
   - userbot_settings: Configuration
   - userbot_collect_groups: Gather all user groups
   - userbot_collect_members: Parse group members
✅ UserBot handlers properly registered in ConversationHandler

CONTAINERS:
✅ tg_autoposter_bot: Running and handling /start commands
✅ tg_autoposter_userbot: Running as standalone microservice
✅ All dependent services (Redis, PostgreSQL, Celery workers) operational

STATUS: Bot is fully operational and ready for testing
2025-12-21 12:09:11 +09:00

9.8 KiB
Raw Blame History

#!/bin/bash

TG Autoposter - Quick Commands Reference

Copy this file and keep it handy while developing/operating

=====================================

🚀 QUICK START

=====================================

Start everything

docker-compose up -d

Start specific service

docker-compose up -d postgres redis bot celery_beat

Stop everything

docker-compose down

Stop specific service

docker-compose stop bot

Restart services

docker-compose restart

=====================================

📊 MONITORING & LOGS

=====================================

View all logs

docker-compose logs -f

View specific service logs (last 50 lines)

docker-compose logs bot --tail 50 docker-compose logs celery_worker_send --tail 50 docker-compose logs postgres --tail 50

Real-time resource usage

docker stats

Check service status

docker-compose ps

Check specific service status

docker ps | grep tg_autoposter

=====================================

🗄️ DATABASE OPERATIONS

=====================================

Connect to PostgreSQL

docker-compose exec postgres psql -U bot -d tg_autoposter

Run SQL commands

docker-compose exec postgres psql -U bot -d tg_autoposter -c "SELECT * FROM groups;"

Backup database

docker-compose exec -T postgres pg_dump -U bot tg_autoposter > backup_$(date +%Y%m%d_%H%M%S).sql

Restore database

gunzip < backup.sql.gz | docker-compose exec -T postgres psql -U bot tg_autoposter

Database migrations

docker-compose exec bot alembic upgrade head # Apply latest docker-compose exec bot alembic downgrade -1 # Rollback one step docker-compose exec bot alembic current # Show current version docker-compose exec bot alembic history # Show all versions

=====================================

🔴 CACHE & CELERY

=====================================

Connect to Redis

docker-compose exec redis redis-cli

Flush Redis cache

docker-compose exec redis redis-cli FLUSHDB

Check Redis info

docker-compose exec redis redis-cli INFO

Check Celery active tasks

docker-compose logs celery_worker_send | grep -i active

Inspect Celery tasks (in another terminal with flower running)

Open: http://localhost:5555

Clear Celery queue

docker-compose exec redis redis-cli

In redis-cli:

FLUSHDB

Revoke a specific task

celery -A app.celery_config revoke TASK_ID

=====================================

🧪 TESTING & CODE QUALITY

=====================================

Run all tests

docker-compose exec bot pytest

Run tests with coverage

docker-compose exec bot pytest --cov=app

Run specific test file

docker-compose exec bot pytest tests/test_handlers.py

Run tests in watch mode (local only)

pytest-watch

Lint code

docker-compose exec bot flake8 app/ docker-compose exec bot mypy app/ docker-compose exec bot black --check app/

Format code

docker-compose exec bot black app/ docker-compose exec bot isort app/

Lint + format in one command

make lint && make fmt

=====================================

🔧 CONFIGURATION & SETUP

=====================================

Create .env file from template

cp .env.example .env

Edit environment variables

nano .env

Validate .env

grep -E "^[A-Z_]+" .env

Check specific variable

echo $TELEGRAM_BOT_TOKEN

Update variable at runtime

export NEW_VARIABLE=value

=====================================

📦 DEPENDENCY MANAGEMENT

=====================================

Install Python dependencies

docker-compose exec bot pip install -r requirements.txt

Install dev dependencies

docker-compose exec bot pip install -r requirements-dev.txt

List installed packages

docker-compose exec bot pip list

Upgrade pip, setuptools, wheel

docker-compose exec bot pip install --upgrade pip setuptools wheel

Check for outdated packages

docker-compose exec bot pip list --outdated

=====================================

🐳 DOCKER MANAGEMENT

=====================================

Build images

docker-compose build

Rebuild specific service

docker-compose build bot

View images

docker images | grep tg_autoposter

Remove unused images

docker image prune

View containers

docker ps -a

Remove container

docker rm container_id

View volumes

docker volume ls

Inspect container

docker inspect container_id

Copy file from container

docker cp container_id:/app/file.txt ./file.txt

Copy file to container

docker cp ./file.txt container_id:/app/file.txt

=====================================

🤖 BOT OPERATIONS

=====================================

Connect to bot shell

docker-compose exec bot bash

or Python shell

docker-compose exec bot python

Check bot token is set

docker-compose exec bot echo $TELEGRAM_BOT_TOKEN

Test bot is running

docker-compose exec bot curl http://localhost:8000

View bot logs

docker-compose logs bot -f

Restart bot service

docker-compose restart bot

Stop bot (without stopping other services)

docker-compose stop bot

Start bot (after stopping)

docker-compose start bot

=====================================

🌐 WEB INTERFACES

=====================================

Flower (Task Monitoring)

Open in browser: http://localhost:5555

Default: admin / password (from FLOWER_PASSWORD env var)

PostgreSQL Admin (if pgAdmin is running)

Open in browser: http://localhost:5050

Default: admin@admin.com / admin

Redis Commander (if running)

Open in browser: http://localhost:8081

=====================================

🔍 DEBUGGING

=====================================

Get container ID

docker-compose ps | grep bot

Inspect container

docker inspect [CONTAINER_ID]

Check container logs for errors

docker-compose logs bot | grep -i error

Check resource limits

docker stats --no-stream

Monitor specific metric

watch -n 1 'docker stats --no-stream | grep tg_autoposter'

Check network

docker network ls | grep tg_autoposter

Test connectivity

docker-compose exec bot ping redis docker-compose exec bot ping postgres

=====================================

🚨 TROUBLESHOOTING

=====================================

Service won't start - check logs

docker-compose logs [service] --tail 50

Fix: Restart service

docker-compose restart [service]

Port already in use

Change port in docker-compose.yml or:

sudo lsof -i :5555 sudo kill -9 PID

Database won't connect

docker-compose exec postgres psql -U bot -d tg_autoposter -c "\dt"

Fix: Run migrations

docker-compose exec bot alembic upgrade head

Out of disk space

docker system prune -a docker image prune docker volume prune

Memory issues

docker stats docker-compose restart [service]

Permission denied

sudo chown -R $USER:$USER . chmod +x docker.sh quickstart.sh

=====================================

🔐 SECURITY

=====================================

Generate secure password

openssl rand -base64 32

Check for exposed secrets

git log --all --oneline --grep="password|secret|key" | head -20

Scan for security issues

pip install bandit docker-compose exec bot bandit -r app/

Check for vulnerable dependencies

pip install safety docker-compose exec bot safety check

Rotate secrets

1. Generate new values

2. Update .env and secrets

3. Restart services

docker-compose restart

=====================================

📈 PERFORMANCE TUNING

=====================================

Check slow queries (in PostgreSQL)

Enable slow query log, then:

docker-compose exec postgres tail -f /var/log/postgresql/slowquery.log

Check database size

docker-compose exec postgres psql -U bot -d tg_autoposter -c " SELECT schemaname, tablename, pg_size_pretty(pg_total_relation_size(schemaname||'.'||tablename)) FROM pg_tables ORDER BY pg_total_relation_size(schemaname||'.'||tablename) DESC;"

Analyze query performance

docker-compose exec postgres psql -U bot -d tg_autoposter -c "EXPLAIN ANALYZE SELECT * FROM messages LIMIT 10;"

Vacuum and analyze database

docker-compose exec postgres psql -U bot -d tg_autoposter -c "VACUUM ANALYZE;"

=====================================

🔄 COMMON WORKFLOWS

=====================================

Full restart (nuclear option)

docker-compose down -v docker-compose up -d docker-compose exec bot alembic upgrade head

Backup and cleanup

docker-compose exec -T postgres pg_dump -U bot tg_autoposter > backup.sql docker-compose down -v docker image prune -a docker volume prune

Deploy new version

git pull origin main docker-compose build docker-compose up -d docker-compose exec bot alembic upgrade head docker-compose logs -f

Roll back to previous version

git checkout previous-tag docker-compose build docker-compose up -d docker-compose exec bot alembic downgrade -1

=====================================

📚 HELP & REFERENCES

=====================================

Show this file

cat QUICK_COMMANDS.md

Docker Compose help

docker-compose help

Docker help

docker help

Check version

docker --version docker-compose --version python --version

Read documentation

- README.md

- DEVELOPMENT.md

- PRODUCTION_DEPLOYMENT.md

- docs/DOCKER_CELERY.md

=====================================

💡 QUICK TIPS

=====================================

Use alias for faster commands (add to ~/.bashrc)

alias dc='docker-compose'

alias dcb='docker-compose build'

alias dcd='docker-compose down'

alias dcu='docker-compose up -d'

alias dcl='docker-compose logs -f'

alias dcp='docker-compose ps'

Then use:

dc ps

dcl bot

dcu

Use Make for predefined targets

make help # Show all make targets make up # Start services make down # Stop services make logs # View logs

Use docker.sh for comprehensive management

./docker.sh up ./docker.sh logs ./docker.sh ps

Quick Reference Version: 1.0 Last Updated: 2024-01-01 Usefulness: ⭐⭐⭐⭐⭐

Keep this file open while working on the project!