Image Processing Application

This is a dockerized image processing application that consists of several microservices working together. The application allows users to upload images, processes them using an image processing service, and stores the processed images in an S3-compatible storage. The application also maintains a provenance database to keep track of the image processing history.

Services

The application is composed of the following services:

• upload: Accepts image uploads, stores them in S3, and sends a notification to the image processing service via RabbitMQ.
• imageproc-runner: Receives notifications from the upload service, downloads images from S3, processes them using the imageproc service, and uploads the processed images to S3.
• imageproc: Performs the actual image processing.
• provenancedb: Stores the provenance information of the processed images in a CouchDB database.
• couchdb: The database used by the provenancedb service.
• rabbitmq: The message broker that facilitates communication between the services.

Configuration

To configure the application, create a .env file in the same directory as the docker-compose.yml file with the following variables:

# service and pub/sub component images

UPLOAD_IMAGE=<image tag>
IMAGEPROC_RUNNER_IMAGE=<image tag>
IMAGEPROC_IMAGE=<image tag>
PROVENANCEDB_IMAGE=<image tag>

# e.g., URL for MinIO running on the host system
S3_URL=http://host.docker.internal:9000
S3_ACCESS_KEY=<your access key>
S3_SECRET_KEY=<your secret key>

S3_INPUT_BUCKET=amplify-poc-input 
S3_OUTPUT_BUCKET=amplify-poc-output

RABBITMQ_USER=amplify
RABBITMQ_PASSWORD=amplify
AMQP_EXCHANGE_SUBSCRIBE=uploaded
AMQP_EXCHANGE_PUBLISH=dithered
AMQP_EXCHANGE_PROV=provenance

COUCHDB_USER=provenance
COUCHDB_PASSWORD=provenance
COUCHDB_DB=provenance

Replace the placeholders (<...>) and other example values with the appropriate values for your setup.

Running the Application

To start the application, run the following command in the directory containing the docker-compose.yml file:

docker-compose up -d

This will start all the services in detached mode.

Accessing the Application

• The upload service is accessible at http://localhost:8000.
• The RabbitMQ management interface is accessible at http://localhost:15672.
• The CouchDB interface is accessible at http://localhost:5984.

Make sure to configure the necessary ports and credentials as specified in the .env file.