Skip to main content

Chaos Toolkit Kubernetes support

Project description

# Chaos Toolkit Kubernetes Support

[![Build Status](https://travis-ci.org/chaostoolkit/chaostoolkit-kubernetes.svg?branch=master)](https://travis-ci.org/chaostoolkit/chaostoolkit-kubernetes)

This project contains activities, such as probes and actions, you can call from
your experiment through the Chaos Toolkit.

## Install

To be used from your experiment, this package must be installed in the Python
environment where [chaostoolkit][] already lives.

[chaostoolkit]: https://github.com/chaostoolkit/chaostoolkit

```
$ pip install chaostoolkit-kubernetes
```

## Usage

First, in your experimenty project, make sure

To use the probes and actions from this package, add the following to your
experiment file:

```json
{
"title": "Our microservice should really be gone by now",
"layer": "kubernetes",
"type": "python",
"module": "chaosk8s.probes",
"func": "microservice_available_and_healthy",
"arguments": {
"name": "mysvc"
}
}
```

That's it!

Please explore the code to see existing provbes and actions.

## Configuration

This extension to the Chaos Toolkit expects the Kubernetes configuyration to
be found at the usual place in your HOME directory under `~/.kube/`.

You should therefore ensure you can fully connect to your Kubernetes cluster
from a `kubectl` command before using this extension in your experiment.

## Contribute

If you wish to contribute more functions to this package, you are more than
welcome to do so. Please, fork this project, make your changes following the
usual [PEP 8][pep8] code style, sprinkling with tests and submit a PR for
review.

[pep8]: https://pycodestyle.readthedocs.io/en/latest/


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chaostoolkit-kubernetes-0.4.2.tar.gz (9.4 kB view hashes)

Uploaded Source

Built Distribution

chaostoolkit_kubernetes-0.4.2-py3-none-any.whl (7.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page