Harness Solutions Factory (HSF) is a scalable automation framework designed to help organizations rapidly deploy and manage Harness resources through self-service workflows, governance, and best practices, all out of the box. Whether you're enabling new teams, setting up golden templates, or driving adoption of Harness at scale, HSF provides a repeatable, governed foundation to help you get started faster and stay standardized across your organization.
- Overview
- Quick Start
- Repository Structure
- Core Components
- Requirements
- Deployment Guide
- Contributing
- License
HSF provides a comprehensive ecosystem of Terraform modules that progressively build out your Harness platform infrastructure. Starting from foundational setup through advanced distributed operations, each module in HSF addresses specific stages of your Harness adoption journey.
The framework follows a modular, progressive deployment approach:
- Pilot Light — Bootstrap foundational Harness resources
- Solutions Factory — Deploy core workspace management infrastructure
- Factory Floor — Add operational pipelines to any project
- Mini Factory — Distribute factory capabilities across organizations
- HSF Hub — Enable API-driven provisioning for service portals
- HSF Core Manager — Placeholder for centralized resource management
- Valid Harness Account and API Key (Account-level Admin)
- OpenTofu or Terraform installed locally
- This repository cloned to your local machine
- An IDE or text editor
The fastest way to get started:
# 1. Clone and navigate to Pilot Light
git clone https://github.com/harness/harness-solutions-factory.git
cd harness-solutions-factory/pilot-light
# 2. Configure your credentials
cp terraform.tfvars.example terraform.tfvars
# Edit terraform.tfvars with your Harness account details
# 3. Deploy
tofu init && tofu apply
# 4. Copy local state to the remote IACM workspace
tofu initAfter Pilot Light completes, follow the output instructions to proceed with subsequent modules.
harness-solutions-factory/
├── README.md # This file - overview and navigation
├── pilot-light/ # Foundation module (start here)
├── solutions-factory/ # Core workspace management
├── factory-floor/ # Operational pipelines (reusable module)
├── mini-factory/ # Distributed factory pattern
├── hsf-hub/ # API-driven provisioning
├── hsf-core-mgr/ # Centralized management (placeholder)
├── CONTRIBUTING.md # Contributor guidelines
└── LICENSE # Business Source License 1.1
Entry point for HSF deployment
Sets up the minimal infrastructure needed to bootstrap the Solutions Factory:
- Organization and project creation
- Service account with admin permissions
- IACM workspaces for state management
- Repository connectors and DockerHub integration
- Scheduled repository mirroring and token rotation
Start here if this is your first HSF deployment.
→ Full Pilot Light Documentation
Centralized workspace management hub
Deploys the main HSF infrastructure for managing IACM workspaces at scale:
- Core workspace management pipelines
- Day-2 operational pipelines (provisioning, validation, drift analysis, teardown)
- IDP resource management and integration workflows
- Central project with shared templates and connectors
- Infrastructure projects for Images and Delegate management
- RBAC controls and resource groups
Deploy after Pilot Light to establish your primary workspace management infrastructure.
→ Full Solutions Factory Documentation
Reusable operational pipeline suite
A modular factory pattern that can be deployed to multiple projects for workspace lifecycle management:
- Day-Zero through Day-180 IACM workspace operations
- Create, provision, validate, drift-check, and teardown pipelines
- Project-level RBAC and resource groups
- Bulk workspace management with tag-based filtering
- Optional IDP integration for automated drift detection
Use to extend HSF pipelines to other projects after Solutions Factory is active.
→ Full Factory Floor Documentation
Distributed workspace management across organizations
Enables organizational-scoped factory patterns for multi-tenant scenarios:
- Creates a Factory Floor per organization
- Isolates workspace management within organizational boundaries
- Maintains centralized governance while enabling local control
Deploy when you need workspace management in multiple organizations with local isolation.
→ Full Mini Factory Documentation
🔗 HSF Hub
API-driven provisioning for service portals
Brings HSF workspace workflows to external service portals (Jira, ServiceNow, Backstage, etc.):
- Centralized Hub project with API-triggered pipelines
- HTTP endpoints for third-party integration
- Independent pipelines (no IDP required)
- Seamless integration with existing service catalogs
Deploy when you need external system integration with HSF workspace provisioning.
Reserved for centralized resource management
Currently a placeholder module for future Core Manager workspace functionality:
- Reserved for centralized policy and resource management
- May be provisioned when IDP is disabled in Factory Floor
This module does not currently provision resources.
→ Full HSF Core Manager Documentation
- Harness Account with Admin-level API key
- Harness Account Number for authentication
- OpenTofu ≥ 1.6 or Terraform ≥ 1.0 installed locally
- Git access to this repository
- Kubernetes connector configured in Harness
- Kubernetes cluster with namespace access
- Harness Delegate deployed in the target cluster
- Custom provisioner images (if overriding defaults)
-
Pilot Light (15-30 min)
- Sets up foundational infrastructure
- Creates organization, project, and connectors
- Outputs instructions for next steps
-
Solutions Factory (10-20 min)
- Deploys core workspace management
- Creates operational pipelines
- Integrates with Pilot Light resources
-
Optional: Factory Floor (5-15 min per project)
- Deploy to individual projects needing workspace management
- Reuse across multiple projects
- No organizational scope restrictions
-
Optional: Mini Factory (5-15 min per org)
- Deploy per-organization factory patterns
- Isolate workspace management by organization
-
Optional: HSF Hub (10-20 min)
- Enable external service portal integration
- Set up API endpoints for third-party systems
Each module requires a terraform.tfvars file:
# Navigate to module directory
cd <module-directory>
# Copy the example configuration
cp terraform.tfvars.example terraform.tfvars
# Edit with your environment values
editor terraform.tfvarsSee individual module READMEs for required and optional variables.
After initial deployment:
# For Pilot Light (recommended)
tofu init # Push state to IACM workspace for centralized managementOther modules can store state locally or push to a remote backend.
✅ Progressive Deployment — Start simple, expand as needed ✅ Modular Design — Use components independently or together ✅ RBAC & Governance — Built-in access controls and policies ✅ Day-2 Operations — Comprehensive workspace lifecycle management ✅ Multi-tenant Support — Organizational isolation with Mini Factory ✅ External Integration — Service portal support via HSF Hub ✅ IDP Ready — Optional Harness IDP integration for automation ✅ Self-Hosted or Cloud — Kubernetes or Harness Cloud execution
- Provider errors: Ensure Harness credentials are set correctly (variables or env vars)
- Resource conflicts: Verify no resources exist with same identifiers in target org/project
- Permission errors: Confirm API key has Account Admin permissions
Refer to the troubleshooting section in each module's README:
- Pilot Light Troubleshooting
- Solutions Factory Troubleshooting
- Factory Floor Troubleshooting
- Mini Factory Troubleshooting
- HSF Hub Troubleshooting
We welcome contributions! Please see CONTRIBUTING.md for:
- Code style guidelines
- Contribution process
- Testing requirements
- Pull request procedures
For issues, questions, or feature requests:
- Documentation: See module-specific READMEs
- Issues: Open an issue on GitHub
- Discussions: Start a discussion for questions
- Contact: Reach out to the Harness team
Module is maintained by Harness, Inc
Business Source License 1.1 — See LICENSE for full details.
| Module | Purpose | Time | Status |
|---|---|---|---|
| Pilot Light | Foundation | 15-30 min | ✅ Stable |
| Solutions Factory | Core Hub | 10-20 min | ✅ Stable |
| Factory Floor | Operations | 5-15 min | ✅ Stable |
| Mini Factory | Distributed | 5-15 min | ✅ Stable |
| HSF Hub | Integration | 10-20 min | ✅ Stable |
| HSF Core Manager | Reserved | — | 🔄 Planned |
Ready to get started? Head to Pilot Light!