> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/continuous-delivery/use-gitops/gitops-entities/agents/gitops-agent-with-openshift-operator.md).

# Harness GitOps Agent Operator for OpenShift

The Harness GitOps Agent Operator simplifies the installation and lifecycle management of the Harness GitOps Agent on Red Hat OpenShift. By installing it as a Red Hat–certified operator, you ensure that it meets strict security and quality standards, enabling safer and more efficient GitOps workflows in your enterprise environment.

{% hint style="info" %}
Currently, this feature is behind the feature flag `CDS_GITOPS_OPERATOR`. Contact [Harness Support](mailto:support@harness.io) to enable the feature.
{% endhint %}

## Prerequisites <a href="#prerequisites" id="prerequisites"></a>

* **OpenShift Cluster**: You must have access to a functioning OpenShift cluster.
* **Cluster Admin Privileges**: Ensure you have sufficient privileges to install Operators from the OperatorHub.
* **Red Hat Container Catalog Access**: Confirm that your cluster has access to pull images from the Red Hat Ecosystem Catalog or the appropriate container registry.
* **Argo CD** must be installed in the same namespace where the Harness GitOps Agent will be installed.

## Installing the Harness GitOps Agent Operator <a href="#installing-the-harness-gitops-agent-operator" id="installing-the-harness-gitops-agent-operator"></a>

Below is a high-level outline of how to install and configure the Harness GitOps Agent Operator through the OpenShift web console. (For CLI-based steps, consult the Harness GitOps documentation or Red Hat’s operator docs.)

1. **Access the OperatorHub**
   * In the OpenShift web console, navigate to **Operators** → **OperatorHub**.
   * Search for **Harness GitOps Operator**.
2. **Select the Operator**
   * Click the **Harness GitOps Agent** tile.
   * Review details such as version, provider (Harness), and description.
3. **Install the Operator**
   * Choose the **Installation Mode** (e.g., install it cluster-wide).
   * Select an **update channel** if applicable (e.g., “stable” or “latest”), and decide on the **approval strategy** (Automatic or Manual).
   * Select the **version**.
   * Click **Install** to start the operator installation.
4. **Verify Installation**
   * After the installation is complete, go to the **Installed Operators**.
   * In the **GitOps Agent** tab, you can create any number of agents by clicking on **Create Agent**.
   * You can do this through a **YAML** or **Form** view. Select **YAML** for more direct control.
5. **Create and Configure the Agent**
   * Now navigate to the Harness UI: **Deployments** → **GitOps** → **Settings** → **GitOps Agent**.
   * Create a new GitOps Agent, providing all the necessary details like agent name, namespace, etc.
   * Copy the operator YAML of the agent and paste it in the YAML section of the OpenShift cluster.
   * Click **Create**.
   * Your agent is now created. Under the **Conditions** section, you can see the status of the agent.

<details>

<summary>Sample YAML</summary>

Here is a sample operator YAML for your reference:

```yaml
apiVersion: gitops.harness.io/v1alpha1
kind: GitopsAgent
metadata:
  labels:
    app.kubernetes.io/managed-by: kustomize
    app.kubernetes.io/name: gitops-operator
  name: Agentname
  namespace: AgentNamespace
spec:
  identity:
    accountIdentifier: YourAccountIdentifier
    agentIdentifier: YourAgentIdentifier
    agentName: Agentname
    orgIdentifier: default
  logLevel: DEBUG
  replicas: 1
  networkPolicy:
    create: true
  secrets:
    agentSecret: YourAgentSecrets
  target:
    http: 'https://app.harness.io/gitops'
    protocol: HTTP1
```

</details>