README
¶
Istio APIs and Common Configuration Definitions
This repository defines component-level APIs and common configuration formats for the Istio platform. These definitions are specified using the protobuf syntax.
This repository depends only on the tools repository for tools used during build. This repository will not depend on any other repositories. Except for tools, all other Istio repositories can take a dependency on the api repository.
API Guidelines
When making changes to the protos in this repository, your changes must comply with the API guidelines.
Updating
After the protobuf definitions
are updated, the corresponding *pb.go and _pb2.py files must be
generated by running scripts/generate-protos.sh and submitted as
part of the same PR as the updated definitions. Also make proto-commit must be run to update the proto.lock file with new
changes.
If releasing a new tagged version, please update python/istio-api/setup.py version to reflect.
Backwards Incompatible Changes
If a PR tries to make backwards incompatible changes, it will be
blocked by protolock. To force these changes in, install
protolock and run
protolock commit --force.
You must include a note in your PR that you had to force the protolock and why.
Directories
¶
| Path | Synopsis |
|---|---|
|
authentication
|
|
|
v1alpha1
Package v1alpha1 is a generated protocol buffer package.
|
Package v1alpha1 is a generated protocol buffer package. |
|
envoy
|
|
|
config/filter/http/authn/v2alpha1
Package v2alpha1 is a generated protocol buffer package.
|
Package v2alpha1 is a generated protocol buffer package. |
|
mcp
|
|
|
v1alpha1
Package v1alpha1 is a generated protocol buffer package.
|
Package v1alpha1 is a generated protocol buffer package. |
|
mesh
|
|
|
v1alpha1
Package v1alpha1 is a generated protocol buffer package.
|
Package v1alpha1 is a generated protocol buffer package. |
|
mixer
|
|
|
adapter/model/v1beta1
Package v1beta1 is a generated protocol buffer package.
|
Package v1beta1 is a generated protocol buffer package. |
|
v1
Package v1 is a generated protocol buffer package.
|
Package v1 is a generated protocol buffer package. |
|
v1/config/client
Package client is a generated protocol buffer package.
|
Package client is a generated protocol buffer package. |
|
networking
|
|
|
v1alpha3
Package v1alpha3 is a generated protocol buffer package.
|
Package v1alpha3 is a generated protocol buffer package. |
|
policy
|
|
|
v1beta1
Package v1beta1 is a generated protocol buffer package.
|
Package v1beta1 is a generated protocol buffer package. |
|
rbac
|
|
|
v1alpha1
Package v1alpha1 is a generated protocol buffer package.
|
Package v1alpha1 is a generated protocol buffer package. |