b104fafa85
- Renamed auth-service to iam-service across various files for consistency. - Updated Dockerfiles, deployment configurations, and documentation to reflect the service name change. - Enhanced testing commands in documentation to point to the new iam-service. - Removed outdated auth-service files and configurations to streamline the project structure. - Improved bilingual documentation for clarity on the new service structure and usage.
1.3 KiB
1.3 KiB
Troubleshooting Guide
Common Issues
Database Connection Failed
Symptoms: Service can't connect to database
Solutions:
- Check if PostgreSQL is running:
docker ps - Verify DATABASE_URL in .env
- Check network connectivity:
docker network ls - Review logs:
docker logs postgres-auth-local
Port Already in Use
Symptoms: Service fails to start with port error
Solutions:
- Find process using port:
lsof -i :5001 - Kill process or change PORT in .env
- Check docker-compose for port conflicts
Prisma Client Not Generated
Symptoms: Import errors for Prisma Client
Solutions:
cd services/iam-service
pnpm prisma generate
Build Failures
Symptoms: TypeScript or build errors
Solutions:
- Clean build artifacts:
./scripts/utils/cleanup.sh - Reinstall dependencies:
pnpm install - Check TypeScript errors:
pnpm typecheck
Traefik Not Routing
Symptoms: 404 errors from Traefik
Solutions:
- Check Traefik dashboard: http://localhost:8080
- Verify service labels in docker-compose
- Check routes.yml configuration
- Review Traefik logs:
docker logs traefik-local
Getting Help
- Check service logs:
./scripts/dev/logs.sh <service> - Review GitHub Issues
- Contact team lead