Skip to content

Commit 10646e9

Browse files
author
Martin Taillefer
committed
More updates to what-is-istio and the mixer config doc.
1 parent 8f50c52 commit 10646e9

File tree

3 files changed

+106
-45
lines changed

3 files changed

+106
-45
lines changed

_sass/base/_override.scss

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ pre, pre.prettyprint {
5656
background-color: $codeBkColor;
5757
color: #000000;
5858
border: none !important;
59-
font-size: 14px !important;
59+
font-size: 11px !important;
6060
padding: 9.5px !important;
6161
}
6262

docs/concepts/mixer-config.md

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ This page describes Mixer's configuration model.
1919

2020
Istio is a sophisticated system with hundreds of independent features. An Istio deployment can be a sprawling
2121
affair potentially involving dozens of microservices, with a swarm of Envoy proxies and Mixer instances to
22-
support them. In large deployments, many different operators, each with different scope and areas of responsibility,
22+
support them. In large deployments, many different operators, each with different scopes and areas of responsibility,
2323
may be involved in managing the overall deployment.
2424

2525
Mixer's configuration model makes it possible to exploit all of its capabilities and flexibility, while
@@ -40,15 +40,15 @@ enabling operators unprecedented control over the policies used and telemetry pr
4040
the potential for bad configuration changes leading to service outages.
4141

4242
- **Extensible**. The model is designed to support Istio's overall extensibility story. New or custom
43-
[adapters]({{site.baseurl}}/docs/concepts/mixer.html#adapters)
44-
can be added to Istio and be fully manipulated using the same general mechanisms as any other adapter.
43+
[adapters](./mixer.html#adapters)
44+
can be added to Istio and be fully manipulated using the same general mechanisms as existing adapters.
4545

4646
## Concepts
4747

4848
Mixer is an attribute processing machine. Requests arrive at Mixer with a set of [*attributes*]({{site.baseurl}}/docs/attributes.html),
4949
and based on these attributes, Mixer generates calls to a variety of backend systems. The set of
5050
attributes determines which backend systems Mixer calls for a given request and what parameters
51-
they are given. In order to hide the details of individual backend systems, Mixer uses modules
51+
each is given. In order to hide the details of individual backend systems, Mixer uses modules
5252
known as [*adapters*]({{site.baseurl}}/docs/concepts/mixer.html#adapters) which you can think of as
5353
*device drivers* for backend systems.
5454

@@ -57,7 +57,7 @@ Mixer's configuration has two central responsibilities:
5757
- Describe which adapters are being used and how they operate.
5858
- Describe how to map request attributes into adapter parameters.
5959

60-
Configuration is expressed using a YAML format. It is built on top of five core
60+
Configuration is expressed using a YAML format built around five core
6161
abstractions:
6262

6363
|Concept |Description
@@ -98,12 +98,18 @@ adapter should use in its queries and defines the interval at which it should re
9898

9999
For each available adapter, you can define any number of blocks of independent configuration state. This allows the same adapter
100100
to be used multiple times within a single deployment. Depending on the situation, such as which microservice is involved, one
101-
block of configuration will be used versus another. For example, here's another block of configuration that can coexist
101+
block of configuration will be used versus another. For example, here are two more blocks of configuration that can coexist
102102
with the previous one:
103103

104104
```yaml
105105
adapters:
106106
- name: mySecondaryListChecker
107+
kind: lists
108+
impl: ipListChecker
109+
params:
110+
publisher_url: https://mysecondlistserver:912
111+
refresh_interval: 3600s
112+
- name: myTernaryListChecker
107113
kind: lists
108114
impl: genericListChecker
109115
params:
@@ -113,7 +119,7 @@ adapters:
113119
"402"
114120
```
115121

116-
Here's another example adapter block:
122+
And yet one more:
117123

118124
```yaml
119125
adapters:

0 commit comments

Comments
 (0)