# Mojaloop Deployment Tools

This document outlines the four deployment options for Mojaloop, ordered by complexity and production-readiness. Each tool serves specific use cases and deployment scenarios.

# Core Test Harness

The Core Test Harness provides a single-node development environment using docker-compose. This tool implements a minimal Mojaloop stack without production components, making it suitable for development and testing.

# Implementation Details

The Core Test Harness runs on a single machine using docker-compose for orchestration. It deploys core services and backing services without production-grade components like gateways, ingress/egress, or IAM stacks. The implementation uses configurable profiles to manage different deployment scenarios.

Resource requirements include a mid-level laptop or desktop workstation with sufficient memory for container orchestration. The tool integrates with CI pipelines for automated testing and validation.

# Development Workflow

Developers interact with the Core Test Harness through docker-compose commands. The tool supports local development workflows with hot-reloading capabilities. Configuration occurs through environment variables and docker-compose override files.

# Testing Capabilities

The Core Test Harness enables unit testing, integration testing, and end-to-end testing of Mojaloop components. It provides a controlled environment for testing service interactions and validating business logic.

# Miniloop

Miniloop implements a single-node Kubernetes environment using microk8s. This deployment option provides a more production-like environment while maintaining simplicity for testing and evaluation.

# Architecture

The implementation uses microk8s as the Kubernetes distribution, with HELM charts for service deployment. The architecture includes core services and backing services, configured through HELM value overrides.

# Deployment Process

Deployment occurs through HELM chart installation with string replacements for configuration. The process includes:

1. microk8s installation and configuration
2. HELM chart repository setup
3. Service deployment with custom values
4. Environment validation

# Testing Environment

Miniloop provides a Kubernetes-based testing environment that mirrors production architecture. It enables testing of:

• Service discovery and routing
• Kubernetes resource management
• HELM chart configurations
• Service interactions in a k8s environment

# HELM Deploy

HELM Deploy provides production-ready deployment capabilities through HELM charts. This implementation requires a pre-configured Kubernetes cluster and implements production-grade security and performance requirements.

# Infrastructure Requirements

The deployment requires:

• A hardened Kubernetes cluster
• Network policies and security configurations
• Storage class definitions
• Resource quotas and limits

# Performance Specifications

The implementation must meet these performance criteria:

• 1000+ TPS sustained for one hour
• 99th percentile latency under 1 second for:
  • Clearing operations
  • Lookup operations
  • Agreement of Terms
• 99.99% availability
• Zero RTO/RPO for critical operations

# Security Implementation

Security implementation includes:

• Network policy enforcement
• Pod security policies
• Service mesh integration
• Secret management
• Certificate management

# Infrastructure as Code

The Infrastructure as Code (IaC) implementation provides a comprehensive deployment solution supporting multiple platforms and orchestration layers. It implements GitOps patterns for managing multiple hub instances.

# Platform Support

The implementation supports:

• AWS deployment through CloudFormation/Terraform
• On-premises deployment through Terraform
• Multi-cloud deployment through provider-agnostic modules
• Multiple Kubernetes distributions:
  • Managed k8s services
  • Microk8s
  • EKS

# Control Center Architecture

The control center implements GitOps patterns for:

• Multi-environment management
• Configuration versioning
• Deployment automation
• State management
• Drift detection

# Component Deployment

The implementation deploys:

• Control center services
• Core Mojaloop services
• Backing services
• Portal applications
• IAM infrastructure
• Monitoring stack
• PM4ML components

# Performance and Security

The IaC implementation enforces:

• Production-grade security controls
• Performance requirements matching HELM Deploy
• High availability configurations
• Disaster recovery procedures
• Compliance requirements

# Document History

Version	Date	Author	Detail
1.0	14th May 2025	Tony Williams	Initial version