Skip to main content

Connect chaos infrastructures

Chaos infrastructure is a service that runs in your target environment and aids Harness Chaos Engineering (CE) in accessing and injecting chaos at cloud-native scale. There are different types of chaos infrastructure based on the target environments, such as Kubernetes, Linux VMs, etc. These chaos infrastructures can be installed as a Kubernetes service, as a Linux daemon, and so on, based on their type.

All the chaos infrastructure services adhere to the principle of least privilege, where the services execute with the minimum number of required permissions.

Let us jump into the steps involved in connecting chaos infrastructures.

Create an environment

  • To add a chaos infrastructure to your target environment, create a new environment where you want the chaos infrastructure to exist.
  • Navigate to the Environments page, which lists all the environments added as part of your project.
  • Choose New Environment.

Chaos Environments

  • In the Create a new environment screen, specify a name for the environment.
  • You can optionally add a description and a tag. Select an environment type, that is, Production or Non-Production. Click Create.

This creates a new environment.

New Environment

Add a chaos infrastructure

To add a chaos infrastructure to your environment, select New Chaos Infrastructure.


You can either setup a chaos infrastructure on existing infrastructures that uses a Harness cluster connector, that is, Harness Kubernetes connector or install the chaos infrastructure on a new infrastructure.

On existing infrastructures

To install the chaos infrastructure on an existing Harness Kubernetes connector,

  • Select On Existing Infrastructures on the screen.
  • Use any connector under the Project, Organization, and Account scope.

Chaos Infrastructure in Existing Infra

  1. A Harness Kubernetes connector with cluster-wide read/write access can be used to set up chaos infrastructure in cluster scope and namespace scope.
  2. A Harness Kubernetes connector with cluster-wide read access can't be used to set up a chaos infrastructure.
  3. A Harness Kubernetes connector with specific namespace access can be used to set up a chaos infrastructure in that specific Kubernetes namespace scope only.

On a new infrastructure

To install the chaos infrastructure on a new infrastructure,

  • Select On New Infrastructures. Select Continue.
  • Provide a name for the infrastructure. Optionally, you can also provide a description and tags. Select Next.
  • Under the installation mode, choose Cluster Wide or Namespace Mode to install the chaos infrastructure.

Cluster-wide mode: This mode of infrastructure installation allows targeting resources across the entire cluster, that is, all the namespaces, as part of an experiment.

Namespace mode: This mode of infrastructure installation allows targeting resources only in the namespace where the chaos infrastructure is deployed.

  • By default the installation will take place in the hce namespace and uses hce service account, which can be configured under the K8s cluster details.
  • Optionally, you can also specify the node selectors and Kubernetes tolerations for chaos infrastructure deployment.
  • There can only be one cluster-wide chaos infrastructure per cluster.
  • There may be multiple namespace-scoped chaos infrastructures per cluster.

Configure Chaos Infrastructure

  • Click Next. In the final step, if you are deploying to an existing infrastructure with Harness Kubernetes Delegate, Harness installs the chaos infrastructure on your behalf.
  • If you are setting up the chaos infrastructure on a new infrastructure, you will need to execute the given commands and/or download and apply the installation manifest (YAML file).

For the cluster-wide setup, you will see a single command that you can apply.

Cluster Wide Setup Infrastructure

For the namespace mode setup, you will see three commands which you need to apply. These commands perform the below actions, respectively.

  1. Create the target namespace,
  2. Apply the chaos CRDs,
  3. Install the chaos infrastructure.

Namespace Mode Setup Infrastructure

  • Select Done.

Validate the chaos infrastructure installation

  • After applying the manifest, Harness will take some time to set up all the chaos infrastructure resources. Once everything is set up, the chaos infrastructure's connection state reflects CONNECTED.

Infrastructure State

That's it! Now you are all set to inject chaos into your infrastructure.