https://github.com/steadybit/extension-istio
A Steadybit extension adding support Istio's service mesh fault injection capabilities.
https://github.com/steadybit/extension-istio
chaos-engineering fault istio service-mesh
Last synced: 3 months ago
JSON representation
A Steadybit extension adding support Istio's service mesh fault injection capabilities.
- Host: GitHub
- URL: https://github.com/steadybit/extension-istio
- Owner: steadybit
- License: mit
- Created: 2023-03-28T13:42:03.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-05-05T15:32:21.000Z (about 1 year ago)
- Last Synced: 2025-05-07T01:07:56.627Z (about 1 year ago)
- Topics: chaos-engineering, fault, istio, service-mesh
- Language: Go
- Homepage: https://hub.steadybit.com/extension/com.steadybit.extension_istio
- Size: 836 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Steadybit extension-istio
This [Steadybit](https://www.steadybit.com/) extension enables the injection of HTTP and gRPC faults into [Istio's virtual services](https://istio.io/latest/docs/reference/config/networking/virtual-service).
Learn about the capabilities of this extension in our [Reliability Hub](https://hub.steadybit.com/extension/com.steadybit.extension_istio).
## Configuration
| Environment Variable | Helm value | Meaning | Required | Default |
|---------------------------------------------------------------------|------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|----------|---------|
| `STEADYBIT_EXTENSION_CLUSTER_NAME` | `kubernetes.clusterName` | Kubernetes cluster name. | yes | |
| `STEADYBIT_EXTENSION_DISCOVERY_ATTRIBUTES_EXCLUDES_VIRTUAL_SERVICE` | `discovery.attributes.excludes.virtualService` | List of Target Attributes which will be excluded during discovery. Checked by key equality and supporting trailing "*" | false | |
The extension supports all environment variables provided by [steadybit/extension-kit](https://github.com/steadybit/extension-kit#environment-variables).
## Installation
### Kubernetes
Detailed information about agent and extension installation in kubernetes can also be found in
our [documentation](https://docs.steadybit.com/install-and-configure/install-agent/install-on-kubernetes).
#### Recommended (via agent helm chart)
All extensions provide a helm chart that is also integrated in the
[helm-chart](https://github.com/steadybit/helm-charts/tree/main/charts/steadybit-agent) of the agent.
You must provide additional values to activate this extension.
```
--set extension-istio.enabled=true \
--set extension-istio.kubernetes.clusterName=my-cluster \
```
Additional configuration options can be found in
the [helm-chart](https://github.com/steadybit/extension-istio/blob/main/charts/steadybit-extension-istio/values.yaml) of the
extension.
#### Alternative (via own helm chart)
If you need more control, you can install the extension via its
dedicated [helm-chart](https://github.com/steadybit/extension-istio/blob/main/charts/steadybit-extension-istio).
```bash
helm repo add steadybit-extension-istio https://steadybit.github.io/extension-istio
helm repo update
helm upgrade steadybit-extension-istio \
--install \
--wait \
--timeout 5m0s \
--create-namespace \
--namespace steadybit-agent \
--set kubernetes.clusterName="my-cluster" \
steadybit-extension-istio/steadybit-extension-istio
```
## Extension registration
Make sure that the extension is registered with the agent. In most cases this is done automatically. Please refer to
the [documentation](https://docs.steadybit.com/install-and-configure/install-agent/extension-registration) for more
information about extension registration and how to verify.
## Version and Revision
The version and revision of the extension:
- are printed during the startup of the extension
- are added as a Docker label to the image
- are available via the `version.txt`/`revision.txt` files in the root of the image