labFusion/docs/GITEA_DEPLOYMENT.md

LabFusion Gitea Registry Deployment

This guide explains how to deploy LabFusion using images from your Gitea container registry.

Registry Information

• Registry URL: gittea.kammenstraatha.duckdns.org/admin
• Username: admin
• Image Tag: main

Quick Start

1. Authentication

First, authenticate with your Gitea registry:

# Login to Gitea registry
docker login gittea.kammenstraatha.duckdns.org/admin
# Enter your Gitea username and password when prompted

2. Configuration

The Docker Compose files are already configured to use your Gitea registry by default. No additional configuration is needed unless you want to override the defaults.

Default Configuration:

DOCKER_REGISTRY=gittea.kammenstraatha.duckdns.org/admin
DOCKER_USERNAME=admin
IMAGE_TAG=main

3. Deploy

# Production deployment
docker-compose up -d

# Development deployment (with volume mounts)
docker-compose -f docker-compose.dev.yml up -d

Image URLs

Your LabFusion images are available at:

• API Gateway: gittea.kammenstraatha.duckdns.org/admin/api-gateway:main
• Service Adapters: gittea.kammenstraatha.duckdns.org/admin/service-adapters:main
• Frontend: gittea.kammenstraatha.duckdns.org/admin/frontend:main
• API Docs: gittea.kammenstraatha.duckdns.org/admin/api-docs:main

Verification

Check if images are accessible:

# Test pulling each image
docker pull gittea.kammenstraatha.duckdns.org/admin/api-gateway:main
docker pull gittea.kammenstraatha.duckdns.org/admin/service-adapters:main
docker pull gittea.kammenstraatha.duckdns.org/admin/frontend:main
docker pull gittea.kammenstraatha.duckdns.org/admin/api-docs:main

Check running services:

# View running containers
docker-compose ps

# Check logs
docker-compose logs api-gateway
docker-compose logs service-adapters
docker-compose logs frontend
docker-compose logs api-docs

Troubleshooting

Common Issues

1. Authentication Failed:

   # Re-authenticate
   docker logout gittea.kammenstraatha.duckdns.org/admin
   docker login gittea.kammenstraatha.duckdns.org/admin
   

2. Image Not Found:

   # Check if images exist in registry
   curl -u admin:password https://gittea.kammenstraatha.duckdns.org/admin/v2/_catalog
   

3. Network Issues:

   # Test connectivity
   ping gittea.kammenstraatha.duckdns.org
   curl -I https://gittea.kammenstraatha.duckdns.org/admin/v2/
   

4. Permission Denied:

   • Verify you have access to the admin organization
   • Check if the images are public or require authentication
   • Ensure your Gitea account has the necessary permissions

Debug Commands

# Check Docker daemon logs
docker system events

# Inspect image details
docker inspect gittea.kammenstraatha.duckdns.org/admin/api-gateway:main

# Check registry connectivity
docker pull gittea.kammenstraatha.duckdns.org/admin/api-gateway:main

Environment Variables

You can override the default registry settings by setting environment variables:

# Use different tag
export IMAGE_TAG=v1.0.0
docker-compose up -d

# Use different registry (if you have multiple)
export DOCKER_REGISTRY=your-other-registry.com
export DOCKER_USERNAME=your-username
docker-compose up -d

CI/CD Integration

If you're using Gitea Actions to build and push images, ensure your workflow pushes to the correct registry:

# Example Gitea Actions workflow
- name: Build and Push Images
  run: |
    # Build and tag images
    docker build -t gittea.kammenstraatha.duckdns.org/admin/api-gateway:main ./services/api-gateway
    docker build -t gittea.kammenstraatha.duckdns.org/admin/service-adapters:main ./services/service-adapters
    docker build -t gittea.kammenstraatha.duckdns.org/admin/frontend:main ./frontend
    docker build -t gittea.kammenstraatha.duckdns.org/admin/api-docs:main ./services/api-docs
    
    # Push to registry
    docker push gittea.kammenstraatha.duckdns.org/admin/api-gateway:main
    docker push gittea.kammenstraatha.duckdns.org/admin/service-adapters:main
    docker push gittea.kammenstraatha.duckdns.org/admin/frontend:main
    docker push gittea.kammenstraatha.duckdns.org/admin/api-docs:main

Security Considerations

• Authentication: Always authenticate before pulling images
• HTTPS: Ensure your Gitea registry uses HTTPS
• Access Control: Verify that only authorized users can access the images
• Image Scanning: Regularly scan images for vulnerabilities
• Updates: Keep images updated with security patches

Support

If you encounter issues with the Gitea registry deployment:

1. Check the troubleshooting section above
2. Verify your Gitea registry configuration
3. Check network connectivity to gittea.kammenstraatha.duckdns.org
4. Ensure you have proper permissions in the admin organization
5. Review Docker and Docker Compose logs for detailed error messages