blocksos/prod-blocks-os repository overview

⁠SELISE Blocks OS

⁠Docker Image

blocksos/prod-blocks-os:tagname

⁠Overview

SELISE Blocks OS is the core management console for the SELISE Blocks platform. It provides the web-based interface and backend APIs required to manage and operate the Blocks platform.

The application combines an ASP.NET Core backend with a React/Vite/TypeScript frontend, packaged as a single integrated application. The production frontend is built and served through the ASP.NET Core application.

⁠Image Purpose

The Docker image:

blocksos/prod-blocks-os:tagname

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

The image includes:

• Blocks OS Web Console
• REST APIs
• React production frontend
• ASP.NET Core backend
• Application services
• Background worker components

⁠Technology Stack

⁠Backend

• ASP.NET Core
• .NET
• C#
• Kestrel web server
• REST APIs

⁠Frontend

• React
• TypeScript
• Vite
• npm

The frontend production build is integrated with the ASP.NET Core application and served together with the backend APIs.

⁠Application Architecture

Blocks OS follows an integrated frontend/backend architecture:

                    ┌──────────────────────┐
                    │     User / Client    │
                    └──────────┬───────────┘
                               │
                               ▼
                    ┌──────────────────────┐
                    │   Ingress / Gateway  │
                    └──────────┬───────────┘
                               │
                               ▼
              ┌─────────────────────────────────┐
              │         SELISE Blocks OS        │
              │                                 │
              │       ASP.NET Core / Kestrel    │
              │                                 │
              │  ┌─────────────┐ ┌────────────┐ │
              │  │ REST APIs   │ │ React SPA  │ │
              │  └─────────────┘ └────────────┘ │
              │                                 │
              │  Image:                         │
              │  blocksos/prod-blocks-os:tagname│
              └────────────────┬────────────────┘
                               │
              ┌────────────────┼────────────────┐
              ▼                ▼                ▼
         Database           Queues        External Services

⁠Container Port

The application is configured to run on port:

5000

Example Docker run command:

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

⁠Pull the Image

docker pull blocksos/prod-blocks-os:tagname

⁠Kubernetes Deployment

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

containers:
  - name: blocks-os
    image: blocksos/prod-blocks-os: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 OS:

⁠Runtime Dependencies

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

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

• Databases
• Message queues
• Logging services
• Monitoring services
• Tracing services
• Other SELISE Blocks platform 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 OS          │
              │                         │
              │ blocksos/prod-blocks-os │
              │                         │
              │ ASP.NET Core + React    │
              └───────────┬─────────────┘
                          │
              ┌───────────┼───────────┐
              ▼           ▼           ▼
           Database    Messaging   Platform APIs

⁠Source Repository

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

GitHub Repository:

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

⁠License

This project is licensed under the MIT License.

The repository includes an MIT LICENSE file.

⁠Summary

SELISE Blocks OS is the core management and administration console for the SELISE Blocks platform. The blocksos/prod-blocks-os:tagname Docker image provides a deployable production container for the service, combining the ASP.NET Core backend, REST APIs, React-based web console, and supporting application components.