diff --git a/mkdocs/docs/experiments/categories/pods/pod-network-corruption.md b/mkdocs/docs/experiments/categories/pods/pod-network-corruption.md index 586636a87..047a7e7c2 100644 --- a/mkdocs/docs/experiments/categories/pods/pod-network-corruption.md +++ b/mkdocs/docs/experiments/categories/pods/pod-network-corruption.md @@ -171,12 +171,22 @@ DNS Names/FQDN names of the services, the accessibility to which, is impacted if not provided, it will induce network chaos for all ips/destinations or DESTINATION_IPS if already defined + + SOURCE_PORTS + ports of the target application, the accessibility to which is impacted + comma separated port(s) can be provided. If not provided, it will induce network chaos for all ports + + + DESTINATION_PORTS + ports of the destination services or pods or the CIDR blocks(range of IPs), the accessibility to which is impacted + comma separated port(s) can be provided. If not provided, it will induce network chaos for all ports + PODS_AFFECTED_PERC The Percentage of total pods to target Defaults to 0 (corresponds to 1 replica), provide numeric value only - + LIB The chaos lib used to inject the chaos Default value: litmus, supported values: pumba and litmus @@ -281,6 +291,45 @@ spec: value: '60' ``` +### Source And Destination Ports + +The network experiments interrupt traffic for all the source & destination ports by default. The interruption of specific port(s) can be tuned via `SOURCE_PORTS` and `DESTINATION_PORTS` ENV. + +- `SOURCE_PORTS`: It contains ports of the target application, the accessibility to which is impacted +- `DESTINATION_PORTS`: It contains the ports of the destination services or pods or the CIDR blocks(range of IPs), the accessibility to which is impacted + +Use the following example to tune this: + +[embedmd]:# (pod-network-corruption/source-and-destination-ports.yaml yaml) +```yaml +# it inject the chaos for the ingrees and egress traffic for specific ports +apiVersion: litmuschaos.io/v1alpha1 +kind: ChaosEngine +metadata: + name: engine-nginx +spec: + engineState: "active" + annotationCheck: "false" + appinfo: + appns: "default" + applabel: "app=nginx" + appkind: "deployment" + chaosServiceAccount: pod-network-corruption-sa + experiments: + - name: pod-network-corruption + spec: + components: + env: + # supports comma separated source ports + - name: SOURCE_PORTS + value: '80' + # supports comma separated destination ports + - name: DESTINATION_PORTS + value: '8080,9000' + - name: TOTAL_CHAOS_DURATION + value: '60' +``` + ### Network Interface The defined name of the ethernet interface, which is considered for shaping traffic. It can be tuned via `NETWORK_INTERFACE` ENV. Its default value is `eth0`. diff --git a/mkdocs/docs/experiments/categories/pods/pod-network-corruption/source-and-destination-ports.yaml b/mkdocs/docs/experiments/categories/pods/pod-network-corruption/source-and-destination-ports.yaml new file mode 100644 index 000000000..eee0d1f35 --- /dev/null +++ b/mkdocs/docs/experiments/categories/pods/pod-network-corruption/source-and-destination-ports.yaml @@ -0,0 +1,26 @@ +# it inject the chaos for the ingrees and egress traffic for specific ports +apiVersion: litmuschaos.io/v1alpha1 +kind: ChaosEngine +metadata: + name: engine-nginx +spec: + engineState: "active" + annotationCheck: "false" + appinfo: + appns: "default" + applabel: "app=nginx" + appkind: "deployment" + chaosServiceAccount: pod-network-corruption-sa + experiments: + - name: pod-network-corruption + spec: + components: + env: + # supports comma separated source ports + - name: SOURCE_PORTS + value: '80' + # supports comma separated destination ports + - name: DESTINATION_PORTS + value: '8080,9000' + - name: TOTAL_CHAOS_DURATION + value: '60' diff --git a/mkdocs/docs/experiments/categories/pods/pod-network-duplication.md b/mkdocs/docs/experiments/categories/pods/pod-network-duplication.md index 1eda5eeca..b5f7c6902 100644 --- a/mkdocs/docs/experiments/categories/pods/pod-network-duplication.md +++ b/mkdocs/docs/experiments/categories/pods/pod-network-duplication.md @@ -172,6 +172,16 @@ DNS Names/FQDN names of the services, the accessibility to which, is impacted if not provided, it will induce network chaos for all ips/destinations or DESTINATION_IPS if already defined + + SOURCE_PORTS + ports of the target application, the accessibility to which is impacted + comma separated port(s) can be provided. If not provided, it will induce network chaos for all ports + + + DESTINATION_PORTS + ports of the destination services or pods or the CIDR blocks(range of IPs), the accessibility to which is impacted + comma separated port(s) can be provided. If not provided, it will induce network chaos for all ports + PODS_AFFECTED_PERC The Percentage of total pods to target @@ -282,6 +292,45 @@ spec: value: '60' ``` +### Source And Destination Ports + +The network experiments interrupt traffic for all the source & destination ports by default. The interruption of specific port(s) can be tuned via `SOURCE_PORTS` and `DESTINATION_PORTS` ENV. + +- `SOURCE_PORTS`: It contains ports of the target application, the accessibility to which is impacted +- `DESTINATION_PORTS`: It contains the ports of the destination services or pods or the CIDR blocks(range of IPs), the accessibility to which is impacted + +Use the following example to tune this: + +[embedmd]:# (pod-network-duplication/source-and-destination-ports.yaml yaml) +```yaml +# it inject the chaos for the ingrees and egress traffic for specific ports +apiVersion: litmuschaos.io/v1alpha1 +kind: ChaosEngine +metadata: + name: engine-nginx +spec: + engineState: "active" + annotationCheck: "false" + appinfo: + appns: "default" + applabel: "app=nginx" + appkind: "deployment" + chaosServiceAccount: pod-network-duplication-sa + experiments: + - name: pod-network-duplication + spec: + components: + env: + # supports comma separated source ports + - name: SOURCE_PORTS + value: '80' + # supports comma separated destination ports + - name: DESTINATION_PORTS + value: '8080,9000' + - name: TOTAL_CHAOS_DURATION + value: '60' +``` + ### Network Interface The defined name of the ethernet interface, which is considered for shaping traffic. It can be tuned via `NETWORK_INTERFACE` ENV. Its default value is `eth0`. diff --git a/mkdocs/docs/experiments/categories/pods/pod-network-duplication/source-and-destination-ports.yaml b/mkdocs/docs/experiments/categories/pods/pod-network-duplication/source-and-destination-ports.yaml new file mode 100644 index 000000000..4c09f43be --- /dev/null +++ b/mkdocs/docs/experiments/categories/pods/pod-network-duplication/source-and-destination-ports.yaml @@ -0,0 +1,26 @@ +# it inject the chaos for the ingrees and egress traffic for specific ports +apiVersion: litmuschaos.io/v1alpha1 +kind: ChaosEngine +metadata: + name: engine-nginx +spec: + engineState: "active" + annotationCheck: "false" + appinfo: + appns: "default" + applabel: "app=nginx" + appkind: "deployment" + chaosServiceAccount: pod-network-duplication-sa + experiments: + - name: pod-network-duplication + spec: + components: + env: + # supports comma separated source ports + - name: SOURCE_PORTS + value: '80' + # supports comma separated destination ports + - name: DESTINATION_PORTS + value: '8080,9000' + - name: TOTAL_CHAOS_DURATION + value: '60' diff --git a/mkdocs/docs/experiments/categories/pods/pod-network-latency.md b/mkdocs/docs/experiments/categories/pods/pod-network-latency.md index b2b77aa8a..3b1c408db 100644 --- a/mkdocs/docs/experiments/categories/pods/pod-network-latency.md +++ b/mkdocs/docs/experiments/categories/pods/pod-network-latency.md @@ -180,6 +180,16 @@ DESTINATION_HOSTS DNS Names/FQDN names of the services, the accessibility to which, is impacted if not provided, it will induce network chaos for all ips/destinations or DESTINATION_IPS if already defined + + + SOURCE_PORTS + ports of the target application, the accessibility to which is impacted + comma separated port(s) can be provided. If not provided, it will induce network chaos for all ports + + + DESTINATION_PORTS + ports of the destination services or pods or the CIDR blocks(range of IPs), the accessibility to which is impacted + comma separated port(s) can be provided. If not provided, it will induce network chaos for all ports PODS_AFFECTED_PERC @@ -291,6 +301,45 @@ spec: value: '60' ``` +### Source And Destination Ports + +The network experiments interrupt traffic for all the source & destination ports by default. The interruption of specific port(s) can be tuned via `SOURCE_PORTS` and `DESTINATION_PORTS` ENV. + +- `SOURCE_PORTS`: It contains ports of the target application, the accessibility to which is impacted +- `DESTINATION_PORTS`: It contains the ports of the destination services or pods or the CIDR blocks(range of IPs), the accessibility to which is impacted + +Use the following example to tune this: + +[embedmd]:# (pod-network-latency/source-and-destination-ports.yaml yaml) +```yaml +# it inject the chaos for the ingrees and egress traffic for specific ports +apiVersion: litmuschaos.io/v1alpha1 +kind: ChaosEngine +metadata: + name: engine-nginx +spec: + engineState: "active" + annotationCheck: "false" + appinfo: + appns: "default" + applabel: "app=nginx" + appkind: "deployment" + chaosServiceAccount: pod-network-latency-sa + experiments: + - name: pod-network-latency + spec: + components: + env: + # supports comma separated source ports + - name: SOURCE_PORTS + value: '80' + # supports comma separated destination ports + - name: DESTINATION_PORTS + value: '8080,9000' + - name: TOTAL_CHAOS_DURATION + value: '60' +``` + ### Network Interface The defined name of the ethernet interface, which is considered for shaping traffic. It can be tuned via `NETWORK_INTERFACE` ENV. Its default value is `eth0`. diff --git a/mkdocs/docs/experiments/categories/pods/pod-network-latency/source-and-destination-ports.yaml b/mkdocs/docs/experiments/categories/pods/pod-network-latency/source-and-destination-ports.yaml new file mode 100644 index 000000000..90fc30bc9 --- /dev/null +++ b/mkdocs/docs/experiments/categories/pods/pod-network-latency/source-and-destination-ports.yaml @@ -0,0 +1,26 @@ +# it inject the chaos for the ingrees and egress traffic for specific ports +apiVersion: litmuschaos.io/v1alpha1 +kind: ChaosEngine +metadata: + name: engine-nginx +spec: + engineState: "active" + annotationCheck: "false" + appinfo: + appns: "default" + applabel: "app=nginx" + appkind: "deployment" + chaosServiceAccount: pod-network-latency-sa + experiments: + - name: pod-network-latency + spec: + components: + env: + # supports comma separated source ports + - name: SOURCE_PORTS + value: '80' + # supports comma separated destination ports + - name: DESTINATION_PORTS + value: '8080,9000' + - name: TOTAL_CHAOS_DURATION + value: '60' diff --git a/mkdocs/docs/experiments/categories/pods/pod-network-loss.md b/mkdocs/docs/experiments/categories/pods/pod-network-loss.md index 0534e75f1..6e48a1f5a 100644 --- a/mkdocs/docs/experiments/categories/pods/pod-network-loss.md +++ b/mkdocs/docs/experiments/categories/pods/pod-network-loss.md @@ -171,6 +171,16 @@ DESTINATION_HOSTS DNS Names/FQDN names of the services, the accessibility to which, is impacted if not provided, it will induce network chaos for all ips/destinations or DESTINATION_IPS if already defined + + + SOURCE_PORTS + ports of the target application, the accessibility to which is impacted + comma separated port(s) can be provided. If not provided, it will induce network chaos for all ports + + + DESTINATION_PORTS + ports of the destination services or pods or the CIDR blocks(range of IPs), the accessibility to which is impacted + comma separated port(s) can be provided. If not provided, it will induce network chaos for all ports PODS_AFFECTED_PERC @@ -282,6 +292,45 @@ spec: value: '60' ``` +### Source And Destination Ports + +The network experiments interrupt traffic for all the source & destination ports by default. The interruption of specific port(s) can be tuned via `SOURCE_PORTS` and `DESTINATION_PORTS` ENV. + +- `SOURCE_PORTS`: It contains ports of the target application, the accessibility to which is impacted +- `DESTINATION_PORTS`: It contains the ports of the destination services or pods or the CIDR blocks(range of IPs), the accessibility to which is impacted + +Use the following example to tune this: + +[embedmd]:# (pod-network-loss/source-and-destination-ports.yaml yaml) +```yaml +# it inject the chaos for the ingrees and egress traffic for specific ports +apiVersion: litmuschaos.io/v1alpha1 +kind: ChaosEngine +metadata: + name: engine-nginx +spec: + engineState: "active" + annotationCheck: "false" + appinfo: + appns: "default" + applabel: "app=nginx" + appkind: "deployment" + chaosServiceAccount: pod-network-loss-sa + experiments: + - name: pod-network-loss + spec: + components: + env: + # supports comma separated source ports + - name: SOURCE_PORTS + value: '80' + # supports comma separated destination ports + - name: DESTINATION_PORTS + value: '8080,9000' + - name: TOTAL_CHAOS_DURATION + value: '60' +``` + ### Network Interface The defined name of the ethernet interface, which is considered for shaping traffic. It can be tuned via `NETWORK_INTERFACE` ENV. Its default value is `eth0`. diff --git a/mkdocs/docs/experiments/categories/pods/pod-network-loss/source-and-destination-ports.yaml b/mkdocs/docs/experiments/categories/pods/pod-network-loss/source-and-destination-ports.yaml new file mode 100644 index 000000000..64ce62327 --- /dev/null +++ b/mkdocs/docs/experiments/categories/pods/pod-network-loss/source-and-destination-ports.yaml @@ -0,0 +1,26 @@ +# it inject the chaos for the ingrees and egress traffic for specific ports +apiVersion: litmuschaos.io/v1alpha1 +kind: ChaosEngine +metadata: + name: engine-nginx +spec: + engineState: "active" + annotationCheck: "false" + appinfo: + appns: "default" + applabel: "app=nginx" + appkind: "deployment" + chaosServiceAccount: pod-network-loss-sa + experiments: + - name: pod-network-loss + spec: + components: + env: + # supports comma separated source ports + - name: SOURCE_PORTS + value: '80' + # supports comma separated destination ports + - name: DESTINATION_PORTS + value: '8080,9000' + - name: TOTAL_CHAOS_DURATION + value: '60'