Skip to content

xcomponent/appcontrol-release

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AppControl

Release

Operational mastery and IT system resilience. AppControl maps your applications as dependency graphs (DAGs), monitors component health via distributed agents, orchestrates sequenced start/stop/restart operations, manages DR site failover, and provides full DORA-compliant audit trails.

AppControl is not a scheduler. It integrates with existing schedulers (Control-M, AutoSys, Dollar Universe, TWS) via REST API and CLI.


Key Features

Feature Description
Dependency Maps Model applications as DAGs with strong/weak dependencies, visualized in React Flow
Sequenced Operations Start, stop, restart in correct DAG order with parallel execution within levels
3-Level Diagnostics Health (process alive?), Integrity (data consistent?), Infrastructure (OS/prereqs OK?)
Error Branch Restart Detect failed subgraph, restart only affected components
DR Switchover 6-phase site failover with rollback at any phase
RBAC 5 permission levels (view < operate < edit < manage < owner), teams, share links
Audit Trail DORA-compliant append-only logs for every action, state transition, and config change
Scheduler Integration REST API + appctl CLI for Control-M, AutoSys, TWS, Dollar Universe
Distributed Agents Rust agents with process detachment (survives agent crash), offline buffering, mTLS
Realtime UI React SPA with WebSocket live updates, weather-style dashboards

Architecture

┌──────────────────────────────────────────────────────────────────────┐
│                         Frontend (React 18)                         │
│             TypeScript · Vite · Tailwind · shadcn/ui                │
│                     React Flow · React Query                        │
└──────────────────────┬───────────────────────┬───────────────────────┘
                  REST │                   WS  │
┌──────────────────────▼───────────────────────▼───────────────────────┐
│                       Backend (Rust + Axum)                          │
│       FSM Engine · DAG Sequencer · RBAC · Switchover · Reports      │
├──────────────────┬───────────────────────────────────────────────────┤
│  PostgreSQL 16   │  or SQLite (standalone)     JWT RS256 Auth        │
└──────────────────┘                             └─────────────────────┘
                                  │
┌─────────────────────────────────▼────────────────────────────────────┐
│                      Gateway (Rust + Axum)                           │
│                 WebSocket relay · mTLS · Routing                     │
└───────────────────┬──────────────────────┬───────────────────────────┘
                    │                      │
         ┌──────────▼──────────┐ ┌─────────▼──────────┐
         │   Agent (Rust)      │ │   Agent (Rust)      │
         │ Health checks       │ │ Health checks       │
         │ Process detachment  │ │ Process detachment  │
         │ Offline buffer      │ │ Offline buffer      │
         └─────────────────────┘ └─────────────────────┘

Quick Start

Option 1 — Docker Compose (Linux/macOS)

# Download the compose file
gh release download --repo xcomponent/appcontrol-release --pattern 'docker-compose.release.yaml'

# Start the full stack
APPCONTROL_VERSION=1.4.2 docker compose -f docker-compose.release.yaml up -d

# Verify
curl http://localhost:3000/health   # → {"status":"ok"}

# Open the UI
open http://localhost:8080

Login: admin@localhost / admin

Option 2 — Standalone (Windows/Linux, no Docker)

No database to install, no Docker required. One script does everything.

mkdir AppControl; cd AppControl

# Download the standalone script (visible at the repo root)
Invoke-WebRequest -Uri "https://github.com/xcomponent/appcontrol-release/raw/main/appcontrol.ps1" -OutFile appcontrol.ps1

# Install (downloads binaries + frontend)
.\appcontrol.ps1 install

# Start the backend
.\appcontrol.ps1 start

# Add your first site (creates gateway + agent, handles enrollment)
.\appcontrol.ps1 add-site Production

# Add more sites
.\appcontrol.ps1 add-site DR-Site

Login: admin@localhost / admin
Web UI: http://localhost:3000

Other commands: stop, status, upgrade, logs [file], help

Works on Windows PowerShell 5.1+ and PowerShell Core 6+ (Linux/macOS).

Option 3 — CLI only

# Linux (amd64)
gh release download --repo xcomponent/appcontrol-release --pattern 'appctl-linux-amd64' --dir /usr/local/bin
chmod +x /usr/local/bin/appctl-linux-amd64 && mv /usr/local/bin/appctl-linux-amd64 /usr/local/bin/appctl

# macOS (Apple Silicon)
gh release download --repo xcomponent/appcontrol-release --pattern 'appctl-darwin-arm64' --dir /usr/local/bin
chmod +x /usr/local/bin/appctl-darwin-arm64 && mv /usr/local/bin/appctl-darwin-arm64 /usr/local/bin/appctl

# Windows
gh release download --repo xcomponent/appcontrol-release --pattern 'appctl-windows-amd64.exe' --dir $env:LOCALAPPDATA\appcontrol
export APPCONTROL_URL=http://localhost:3000

appctl login --email admin@localhost --password admin
appctl start my-app --wait --timeout 120
appctl status my-app --format table
appctl diagnose my-app --level 2
appctl switchover my-app --target-site lyon --mode FULL --wait

Docker Images

All images are available on GitHub Container Registry:

docker pull ghcr.io/xcomponent/appcontrol-backend:latest
docker pull ghcr.io/xcomponent/appcontrol-frontend:latest
docker pull ghcr.io/xcomponent/appcontrol-gateway:latest
docker pull ghcr.io/xcomponent/appcontrol-agent:latest
docker pull ghcr.io/xcomponent/appcontrol-init-certs:latest

Release Assets

Each release includes:

Asset Description
appctl-{os}-{arch}[.exe] CLI binary (Linux, macOS, Windows)
appcontrol-agent-{os}-{arch}[.exe] Agent binary
appcontrol-backend-{os}-{arch}[.exe] Backend API server (PostgreSQL)
appcontrol-backend-sqlite-{os}-{arch}[.exe] Backend API server (SQLite standalone)
appcontrol-gateway-{os}-{arch}[.exe] Gateway binary
appcontrol.ps1 Standalone deployment script (Windows PS 5.1+ / Linux pwsh)
docker-compose.release.yaml Docker Compose for the full stack
appcontrol-docs-scripts.zip Documentation, scripts, and examples
appcontrol-*.tgz Helm chart (OpenShift compatible)
checksums-sha256.txt SHA-256 checksums

Example Maps

Ready-to-import application maps in the docs zip:

Example Components Highlights
Three-Tier Web App 7 Strong/weak deps, DB replication, batch processing
Microservices E-Commerce 12 API gateway, message broker, service-per-DB pattern
Core Banking System 9 DR switchover, Control-M integration, DORA compliance

Documentation

Full documentation is included in appcontrol-docs-scripts.zip:

Scripts

Script Description
appcontrol.ps1 Unified standalone deployment (install, start, stop, add-site, upgrade)
scripts/deploy-windows.ps1 Deploy Windows services (PostgreSQL mode)
scripts/install-agent-windows.ps1 Install agent as Windows service
scripts/deploy-azure-gateway.sh Deploy gateway on Azure

License

Copyright (c) 2024-2026 XComponent SAS. All rights reserved.

This software is provided as pre-compiled binaries for evaluation and production use. Redistribution, reverse engineering, and offering as a managed service are prohibited without a commercial license.

Contact: support@xcomponent.com

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors