API definitions for the Istio project
api
Go to file
Douglas Reid 68cba41b5a
Add initial Telemetry API with Tracing support for sampling and custom tags (#1740)
* Add initial Telemetry API definition

* fix names and comments

* Rename TracingConfig to Tracing

* Remove TelemetryProviders and consolidate to just Tracing providers

* add new extension providers to oneof

* Remove providers from telemetry API

* Add release note

* Address comments

* Add back providers, remove match, simplify Trace API

* Collapse TracingRule into Tracing and remove deprecations in ProxyConfig

* Move from address to service + port in providers

* Remove exclude_mesh_tags

* Revert to boolean control of span reporting

* Cleanup documentation

* Replace subdomain with telemetry type
2021-03-25 21:01:24 -07:00
.github/ISSUE_TEMPLATE
analysis/v1alpha1
annotation
authentication/v1alpha1 Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
common Automator: update common-files@master in istio/api@master (#1916) 2021-03-15 08:59:19 -07:00
common-protos
dictionaries
envoy/config/filter
kubernetes Add initial Telemetry API with Tracing support for sampling and custom tags (#1740) 2021-03-25 21:01:24 -07:00
label Updating initial stability of subzone and network labels (#1853) 2021-01-29 12:19:41 -08:00
licenses add volume and volumeMount to k8s settings. (#1812) 2021-02-01 00:07:11 -08:00
mcp Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
mesh/v1alpha1 Add initial Telemetry API with Tracing support for sampling and custom tags (#1740) 2021-03-25 21:01:24 -07:00
meta/v1alpha1
networking unhide bind in gateway api (#1914) 2021-03-20 05:23:17 -07:00
operator Add more info if custom ns is used to install Istio (#1894) 2021-03-18 03:47:59 -07:00
python Add initial Telemetry API with Tracing support for sampling and custom tags (#1740) 2021-03-25 21:01:24 -07:00
releaselocks
releasenotes Add initial Telemetry API with Tracing support for sampling and custom tags (#1740) 2021-03-25 21:01:24 -07:00
scripts Validate api docs, and fix issues (#1885) 2021-02-17 09:30:48 -08:00
security Fix broken link for auth location (#1919) 2021-03-22 07:50:30 -07:00
stability Define Istio Stability Levels (#1817) 2021-02-08 11:44:00 -08:00
telemetry/v1alpha1 Add initial Telemetry API with Tracing support for sampling and custom tags (#1740) 2021-03-25 21:01:24 -07:00
type/v1beta1 Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
.gitattributes
.gitignore
BUGS-AND-FEATURE-REQUESTS.md
BUILD
CODEOWNERS
CONTRIBUTING.md
GUIDELINES.md
LICENSE
Makefile
Makefile.core.mk Update to use local-lint-protos (#1886) 2021-02-18 17:04:45 -08:00
Makefile.overrides.mk
README.md
SUPPORT.md
WORKSPACE
buf.gen-noncrd.yaml Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
buf.gen.yaml Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
buf.yaml Use buf for protobuf linting (#1863) 2021-02-01 11:13:42 -08:00
clean.sh Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
cue.yaml
gen.sh Add initial Telemetry API with Tracing support for sampling and custom tags (#1740) 2021-03-25 21:01:24 -07:00
github.com Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
go.mod Update dependencies to mirror istio/istio (#1862) 2021-02-17 06:44:25 -08:00
go.sum Update dependencies to mirror istio/istio (#1862) 2021-02-17 06:44:25 -08:00
gogoproto Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
google Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
istio.io Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
k8s.io Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
proto.lock add volume and volumeMount to k8s settings. (#1812) 2021-02-01 00:07:11 -08:00
prototool.yaml Use buf for protobuf linting (#1863) 2021-02-01 11:13:42 -08:00

README.md

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, _pb2.py, *.json and Kubernetes Custom Resource Definition files must be generated by running make clean gen 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.