OASIS API Docker Deployment

This folder contains all Docker-related files for building and deploying the OASIS API.

📁 Files

• Dockerfile - Main production Dockerfile for building the OASIS API

• .dockerignore - Files and directories to exclude from Docker build context

• docker-compose.yml - Docker Compose configuration for local development

• build.sh - Script to build Docker image locally for testing

• deploy.sh - Script to build and push Docker image to AWS ECR

• update-ecs.sh - Script to update AWS ECS service with new image

• COMPARISON.md - Comparison between previous working image and current setup

• BUILD_STATUS.md - Build status and configuration details

🚀 Quick Start

Build Locally

cd /Volumes/Storage\ 3/OASIS_CLEAN
./docker/build.sh

This will build the Docker image with tag oasis-api:latest.

Run Locally

# Using Docker directly
docker run -p 5003:80 oasis-api:latest

# Or using Docker Compose
docker-compose up

Then access:

• API: http://localhost:5003

• Swagger: http://localhost:5003/swagger

Build and Deploy to AWS ECR

cd /Volumes/Storage\ 3/OASIS_CLEAN
./docker/deploy.sh

Update ECS Service

./docker/update-ecs.sh

📊 Configuration

Environment Variables

• ASPNETCORE_ENVIRONMENT=Production

• ASPNETCORE_URLS=http://+:80

Ports

• 80: HTTP (internal)

• 443: HTTPS (internal)

• 5003: HTTP (host mapping)

• 5004: HTTPS (host mapping)

Health Check

• Endpoint: /swagger/index.html

• Interval: 30s

• Timeout: 10s

• Retries: 3

• Start Period: 60s

📝 Build Process

1. Base Stage: Uses .NET 9.0 runtime image

2. Build Stage: Uses .NET 9.0 SDK to build the application

3. Publish Stage: Publishes the application

4. Final Stage: Copies published files and sets up runtime

🔍 Key Features

• ✅ .NET 9.0 compatible

• ✅ Multi-stage build for optimized image size

• ✅ Includes all 30+ OASIS providers

• ✅ Health check configured

• ✅ Production-ready configuration

🐛 Troubleshooting

Build Context Too Large

If the build context is too large, check .dockerignore to ensure unnecessary directories are excluded.

Missing Dependencies

Ensure NextGenSoftware-Libraries and other dependencies are available in the build context.

OASIS_DNA.json

The OASIS_DNA.json file should be in the WebAPI project directory. If not present, configuration can be provided via environment variables.

📚 Related Documentation

• BUILD_STATUS.md - Build status and updates

• COMPARISON.md - Comparison with previous working image

• SUMMARY.md - Summary of Docker setup