CloudForge Application Guides

Comprehensive guides for deploying applications with CloudForge, including detailed configuration options, deployment-context examples, and best practices.

Available Applications

CI/CD & Automation

Application	Status	Guide
Jenkins	Verified	Jenkins Guide
GitLab	Available	GitLab Guide
Drone	Available	Drone Guide

Team Collaboration

Application	Status	Guide
Mattermost Team	Verified	Mattermost Guide
Mattermost Enterprise	Verified	Mattermost Guide

Mattermost Editions: Team Edition is free (uses GitLab OAuth, no single logout). Enterprise Edition requires a license for full features (native OIDC with single logout). See the Mattermost Guide for details.

Analytics & Business Intelligence

Application	Status	Guide
Metabase	Verified	Metabase Guide
Superset	Available	Superset Guide

Monitoring & Observability

Application	Status	Guide
Grafana	Available	Grafana Guide
Prometheus	Available	Prometheus Guide

Artifact Registries

Application	Status	Guide
Harbor	Available	Harbor Guide
Nexus	Available	Nexus Guide

Version Control

Application	Status	Guide
Gitea	Available	Gitea Guide

Databases

Application	Status	Guide
PostgreSQL	Available	PostgreSQL Guide
Redis	Available	Redis Guide

Secrets Management

Application	Status	Guide
Vault	Available	Vault Guide

Code Quality (Plugin Example)

Application	Status	Guide
SonarQube	Plugin	SonarQube Guide

Status Legend:

• Verified: Fully tested and production-ready
• Available: Built-in, functional, awaiting verification
• Plugin: Community plugin example

Quick Start

1. Choose Your Application

Browse the guides above to find detailed documentation for each application.

2. Copy a Deployment Context

Each guide includes ready-to-use deployment-context.json examples that you can copy directly:

# Copy an example from the docs/examples directory
cp docs/examples/applications/jenkins-dev.json deployment-context.json

# Customize required fields
vim deployment-context.json

# Deploy
cdk deploy

3. Customize for Your Environment

At minimum, update these fields:

• stackName: Unique name for your CloudFormation stack
• domain / subdomain: Your DNS configuration (production)
• cognitoDomainPrefix: Globally unique Cognito domain (if using OIDC)
• region: Target AWS region

Guide Structure

Each application guide includes:

1. Overview - What the application does and key features
2. Quick Reference - Ports, images, resource requirements at a glance
3. Configuration Options - All available settings
4. Optional Ports - Additional services you can enable
5. Authentication - OIDC/SAML integration details
6. Deployment Context Examples - Ready-to-use JSON configurations
7. Environment Variables - Application-specific variables
8. Health Checks - Monitoring configuration
9. Compliance Considerations - Security and compliance notes

Deployment Context Examples

The docs/examples/applications/ directory contains application-specific examples:

docs/examples/applications/
├── jenkins-dev.json           # Jenkins development
├── jenkins-production.json    # Jenkins production with SOC2
├── mattermost-dev.json        # Mattermost development
├── mattermost-production.json # Mattermost production with database
├── metabase-dev.json          # Metabase development
├── metabase-production.json   # Metabase production
├── gitlab-production.json     # GitLab with registry
├── grafana-production.json    # Grafana with database
└── ... more examples

Authentication Modes

CloudForge supports three authentication modes:

Mode	Description	Applications
none	No authentication	All (not recommended for production)
alb-oidc	ALB-level authentication	All applications
application-oidc	Native app authentication	Jenkins, GitLab, Grafana, Mattermost

Recommendation:

• Development: none or alb-oidc for quick setup
• Production: application-oidc where available for best user experience

Runtime Options

Runtime	Best For	Pros	Cons
Fargate	Dev/Staging, Auto-scaling	No EC2 management, Pay-per-use	Higher cost at scale
EC2	Production, Cost-sensitive	Lower cost, More control	Requires management

Related Documentation

• Deployment Context Reference - Complete configuration options
• Plugin System - Create custom applications
• Compliance Guide - Security frameworks
• OIDC Integration - Authentication details

Support

• Issues: GitHub Issues
• Examples: cloudforge-sample