Harness Connected On-Premise Setup
This document describes the process for setting up Harness Connected On-Premise. In the Harness Connected On-Premise architecture, the Harness Manager runs in your enterprise environment (on-premise or "on-prem") and Harness manages the installation through a connection to Harness' Cloud.
For more information about Harness Connected On-Premise, see Harness Architecture and On-Premise Overview.
Intended Audience
- System Administrators
- Network Administrators
- DevOps
Installation Overview
The Harness platform comprises 5 micro-services:
- Proxy/Load Balancer
- User Interface
- Machine Learning Engine
- Manager
- Database
Each micro-service is containerized and is deployed on every physical machine.
Once you are signed up with Harness, you download and install an Ambassador that acts as a proxy between your data center and Harness Cloud. The Ambassador makes one-way outbound HTTPS calls to the Harness cloud, initiates the on-premise installation across your physical machines, and automates the Harness Connected On-Premise installation process for you.
Harness Connected On-Premises installation is managed by Harness Support and takes minutes.
The high-level steps for obtaining Harness Connected On-Premise are:
- Prepare your on-premise infrastructure for Harness.
- Provide Harness with your infrastructure information via email.
- Download and run the Ambassador, the tool Harness uses to initiate your Harness Connected On-Premise deployment, and notify Harness that the Ambassador is running.
- Harness triggers the installation and notifies you.
- Point your browser at the URL for your Connected Harness On-Premise.
- Download the Harness Delegate and begin setup.
Set Up Harness Connected On-Premise
To set up Harness Connected On-Premise, do the following:
- Prepare your on-premise infrastructure for Harness. There are separate requirements for Harness Connected On-Premise Evaluation and Harness Connected On-Premise Production.
For the requirements, see Harness On-Premise Evaluation Requirements and Harness On-Premise Production Requirements. - Once your infrastructure is configured, send the infrastructure information to Harness Support at support@harness.io with the subject Harness On-Premise Information.
Use the following list to enter your information and paste it into your email:- Company Name*:
- Account Name:
- Primary Admin Email Address*:
- Host 1 IP Address (Private IP)*:
- Host 2 IP Address (Private IP)**:
- Host 3 IP Address (Private IP)**:
- Load Balancer URL (including https:// scheme)**:
- SSH Username*:
- SSH Key File Path*:
SSH interconnectivity is required among all three hosts. The SSH Key must be present on all machines so they may connect to each other. - Harness support will make an account entry in the Harness cloud based on the information you sent and then provide you with an URL for the Ambassador download.
- Run the Ambassador on any one machine. After receiving the Ambassador download URL from Harness Support, perform the following steps on one or more of the hosts you provided to Harness.
- Download the Ambassador using cURL.
- Expand the archive.
- Start the Ambassador:
$./start.sh
- Once the Ambassador is up and running, notify Harness Support at support@harness.io or the sales representative you are working with about your on-premise setup.
- Using Ambassador, Harness Support will initiate the deployment of your version of Connected Harness On-Premise onto your infrastructure.
Harness On-Premise Evaluation Requirements
Harness On-Premise Evaluation has the following requirements.
Component | Description |
System | 1 Linux Machine:
|
Firewall Rules | |
Internal Source: Application Subnet |
|
External Source: Harness Machine/Subnet |
|
External Source: Docker Hub |
|
Harness On-Premise Production Requirements
Harness On-Premise Production has the following requirements.
Component | Description |
System | 3 Linux Machine:
|
Load Balancer | SSL Certificates installed |
Firewall Rules | |
Internal Source: Application Subnet |
|
Internal Source: Load Balancer |
|
Internal Source: Harness Machine/Subnet |
|
External Source: Harness Machine/Subnet |
|
External Source: Docker Hub |
|
Notes
The Harness Delegate is installed in your network and connects to Harness Connected On-Premise. The Delegate has the following requirements:
- Linux/UNIX server.
- Minimum 8GB RAM.
- Minimum 6GB Disk Space.
- Access to artifact servers, deployment environments, and cloud providers.
- Multiple delegates can be used and their scope can be managed.
- The Harness delegate does NOT require root account access.
For more information, see Delegate Installation.
MongoDB Backups
A MongoDB database is hosted on the servers on which Harness is running. Harness makes periodic backups on the same servers. Harness will assist you with storing the backups on another drive. Also, you can simply perform regular backups of the drive yourself.