Adding Endpoints

Supported Endpoints

Endpoint in Mangle refers to an infrastructure component that will be the primary target for your chaos engineering experiments.

For version 1.0, Mangle supported four types of endpoints:

1. Kubernetes

2. Docker

3. VMware vCenter

4. Remote Machine

From version 2.0, apart from the four endpoints listed above, support has been extended to the following new endpoint:

1. AWS (Amazon Web Services)

Kubernetes Endpoint

Mangle supports K8s clusters as endpoints or targets for injection. It needs a kubeconfig file to connect to the cluster and run the supported faults. If a kubeconfig file is not provided, Mangle assumes that it is running on a K8s cluster and targets the same cluster for fault injection.

Steps to follow:

1. Login as an user with read and write privileges to Mangle.

2. Navigate to Endpoint tab ---> Kubernetes Cluster.

3. Click on .
4. Enter a name, credential (kubeconfig file), namespace (mandatory...Please specify "default" if you are unsure of the namespace else provide the actual name), tags (refers to additional tags that should be send to the enabled metric provider to uniquely identify faults against that endpoint) and click on Test Connection.

5. If Test Connection succeeds click on Submit.

6. A success message is displayed and the table for Endpoints will be updated with the new entry.

7. Click on against a table entry to see the supported operations.

Docker Endpoint

Mangle supports docker hosts as endpoints or targets for injection. It needs the IP/Hostname, port details and certificate details (if TLS is enabled for the docker host with --tlsverify option specified) to connect to the docker host and run the supported faults.

Steps to follow:

1. Login as an user with read and write privileges to Mangle.

2. Navigate to Endpoint tab.

3. Click on .
4. Enter a name, IP/Hostname, port details, tags (refers to additional tags that should be send to the enabled metric provider to uniquely identify faults against that endpoint), certificate details (if TLS is enabled for the docker host)and click on Test Connection.

5. If Test Connection succeeds click on Submit.

6. A success message is displayed and the table for Endpoints will be updated with the new entry.

7. Click on against a table entry to see the supported operations.

VMware vCenter Endpoint

Mangle supports VMware vCenter as endpoints or targets for injection. It needs the IP/Hostname, credentials and a vCenter adapter URL to connect to the vCenter instance and run the supported faults.

Steps to follow:

1. Login as an user with read and write privileges to Mangle.

2. Navigate to Endpoint tab.

3. Click on .
4. Enter a name, IP/Hostname, credentials, vCenter Adapter URL (format: "https://:"where the IP/hostname is the docker host where the adapter container runs appended with the port used), username, password, tags (refers to additional tags that should be send to the enabled metric provider to uniquely identify faults against that endpoint) and click on Test Connection.

5. If Test Connection succeeds click on Submit.

6. A success message is displayed and the table for Endpoints will be updated with the new entry.

7. Click on against a table entry to see the supported operations.

When the vCenter adapter is deployed on the same machine on which Mangle is running, vCenter adapter IP used for adding vCenter endpoint can be either

• A internal docker container IP OR

• A docker host IP

To find out the internal docker container IP for mangle-vc-adapter run

docker inspect --format '{{.NetworkSettings.IPAddress}}' *mangle-vc-adapter

Remote Machine Endpoint

Mangle supports any remote machine with ssh enabled as endpoints or targets for injection. It needs the IP/Hostname, credentials (either password or private key), ssh details, OS type and tags to connect to the remote machine and run the supported faults.

Steps to follow:

1. Login as an user with read and write privileges to Mangle.

2. Navigate to Endpoint tab.

3. Click on .
4. Enter a name, IP/Hostname, credentials (either password or private key), ssh port, ssh timeout, OS type, tags (refers to additional tags that should be send to the enabled metric provider to uniquely identify faults against that endpoint) and click on Test Connection.

5. If Test Connection succeeds click on Submit.

6. A success message is displayed and the table for Endpoints will be updated with the new entry.

7. Click on against a table entry to see the supported operations.

AWS (Amazon Web Services)

Mangle supports AWS as endpoint or target for injection. It needs the Region, credentials (Access key ID and Secret key) and tags to connect to AWS and run the supported faults. Currently the only supported service is EC2. However, there are plans to extend this to other important services in AWS.

Steps to follow:

1. Login as an user with read and write privileges to Mangle.

2. Navigate to Endpoint tab.

3. Click on .
4. Enter a name, Region, credentials (Access key ID and Secret key), tags (refers to additional tags that should be send to the enabled metric provider to uniquely identify faults against that endpoint) and click on Test Connection.

5. If Test Connection succeeds click on Submit.

6. A success message is displayed and the table for Endpoints will be updated with the new entry.

7. Click on against a table entry to see the supported operations.

Relevant API Reference

For access to Swagger documentation:

Please traverse to link -----> API Documentation from the Mangle UI or access https:///mangle-services/swagger-ui.html#/endpoint-controller