# 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

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

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

### Run Locally

```bash
# 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

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

### Update ECS Service

```bash
./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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://oasis-web4.gitbook.io/oasis-web4-docs/docker.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.