blocksos/prod-blocks-logic repository overview

⁠SELISE Blocks Logic

⁠Docker Image

blocksos/prod-blocks-logic:tagname

⁠Overview

SELISE Blocks Logic is the logic and automation service for the SELISE Blocks platform. It provides the backend capabilities required to define, execute, and manage application logic and automated workflows within the Blocks ecosystem.

The application is designed as a backend service that integrates with other SELISE Blocks platform components and supporting infrastructure.

⁠Image Purpose

The Docker image:

blocksos/prod-blocks-logic:tagname

contains the production build of the Blocks Logic application and is intended to be used as the runtime image for deploying the Blocks Logic service.

The image provides the application runtime required for:

• Blocks Logic services
• Logic execution
• Workflow and automation processing
• REST APIs
• Application services
• Integration with other SELISE Blocks platform services
• Background processing where required

⁠Technology Stack

⁠Backend

• ASP.NET Core
• .NET
• C#
• REST APIs
• Application and domain services

⁠Supporting Components

• Blocks platform services
• Message-based integrations
• Database integrations
• Background processing components

⁠Application Architecture

Blocks Logic is designed as a backend platform service that integrates with the SELISE Blocks ecosystem:

                    ┌──────────────────────┐
                    │     User / Client    │
                    └──────────┬───────────┘
                               │
                               ▼
                    ┌──────────────────────┐
                    │   Ingress / Gateway  │
                    └──────────┬───────────┘
                               │
                               ▼
              ┌─────────────────────────────────┐
              │        SELISE Blocks Logic      │
              │                                 │
              │       Application Service       │
              │                                 │
              │  ┌─────────────┐ ┌────────────┐ │
              │  │ REST APIs   │ │ Logic      │ │
              │  │             │ │ Processing │ │
              │  └─────────────┘ └────────────┘ │
              │                                 │
              │  Image:                         │
              │  blocksos/prod-blocks-logic     │
              │  :tagname                       │
              └────────────────┬────────────────┘
                               │
              ┌────────────────┼────────────────┐
              ▼                ▼                ▼
         Database          Messaging       Blocks Services

⁠Container Port

The application exposes its configured API/service port through the container.

For production deployments, the container port should be mapped according to the environment-specific configuration and Kubernetes Service definition.

Example Docker run command:

docker run -d \
  --name blocks-logic \
  -p 5000:5000 \
  blocksos/prod-blocks-logic:tagname

⁠Pull the Image

docker pull blocksos/prod-blocks-logic:tagname

⁠Kubernetes Deployment

The image can be deployed to Kubernetes using the following container configuration:

containers:
  - name: blocks-logic
    image: blocksos/prod-blocks-logic:tagname
    ports:
      - containerPort: 5000

The application can then be exposed through a Kubernetes Service and Ingress or an external application gateway.

⁠Image Naming

The Docker image follows the standard Docker image naming convention:

<organization>/<repository>:<tag>

For Blocks Logic:

⁠Runtime Dependencies

The Blocks Logic container provides the application runtime. External infrastructure and supporting services are deployed separately according to the target environment.

Depending on the deployment configuration, Blocks Logic may communicate with external services such as:

• Databases
• Message queues
• SELISE Blocks platform services
• Authentication and IAM services
• Configuration and secret management services
• Logging services
• Monitoring services
• Tracing services
• Other application services

These dependencies are not bundled into the application container.

⁠Production Deployment

The image is intended for production deployment environments where the container can be managed using Docker, Kubernetes, or another container orchestration platform.

A typical production setup consists of:

                    Internet / Users
                           │
                           ▼
                  ┌─────────────────┐
                  │ Gateway / WAF   │
                  └────────┬────────┘
                           │
                           ▼
                  ┌─────────────────┐
                  │ Kubernetes /    │
                  │ Container       │
                  │ Platform        │
                  └────────┬────────┘
                           │
                           ▼
              ┌─────────────────────────┐
              │      Blocks Logic       │
              │                         │
              │ blocksos/prod-blocks-   │
              │ logic:tagname           │
              │                         │
              │ Logic / API Services    │
              └───────────┬─────────────┘
                          │
              ┌───────────┼───────────┐
              ▼           ▼           ▼
           Database    Messaging   Platform APIs

⁠Source Repository

The complete source code and documentation for SELISE Blocks Logic are available on GitHub:

GitHub Repository:

https://github.com/SELISEdigitalplatforms/blocks-logic

⁠License

This project is licensed under the MIT License.

The repository includes an MIT LICENSE file.

⁠Summary

SELISE Blocks Logic is a core logic and automation service for the SELISE Blocks platform. The blocksos/prod-blocks-logic:tagname Docker image provides a deployable production container for the service and enables integration with the Blocks platform's APIs, messaging infrastructure, databases, and other supporting services.