API definitions for the Istio project
api
Go to file
Istio Automation e7cadb36da
Automator: update common-files@release-1.18 in istio/api@release-1.18 (#3017)
2023-12-05 18:32:36 -08:00
.devcontainer Automator: update common-files@master in istio/api@master (#2750) 2023-04-05 09:58:10 -07:00
.github/ISSUE_TEMPLATE
analysis/v1alpha1 update `proxy_inbound_listen_port` doc (#2735) 2023-03-21 19:43:21 -07:00
annotation Add annotation istio.io/rev (#2743) 2023-04-10 16:08:00 -07:00
authentication/v1alpha1 update `proxy_inbound_listen_port` doc (#2735) 2023-03-21 19:43:21 -07:00
common Automator: update common-files@release-1.18 in istio/api@release-1.18 (#3017) 2023-12-05 18:32:36 -08:00
common-protos Update common files manually (#2299) 2022-04-12 10:08:44 -07:00
dictionaries
envoy sync stats config (#2790) 2023-05-22 05:54:15 -07:00
extensions/v1alpha1 docs: fix wasm plugin traffic selector docs (#2748) 2023-04-06 05:23:25 -07:00
kubernetes Deprecate Port.TargetPort (#2634) 2023-01-17 08:06:34 -08:00
label Added `sidecar.istio.io/inject` label (#2486) 2022-09-23 09:17:36 -07:00
licenses Bump dependencies (#2369) 2022-06-01 18:25:09 -07:00
mcp update `proxy_inbound_listen_port` doc (#2735) 2023-03-21 19:43:21 -07:00
mesh/v1alpha1 docs changes for crl support (#2808) 2023-06-08 20:02:05 -07:00
meta/v1alpha1 update `proxy_inbound_listen_port` doc (#2735) 2023-03-21 19:43:21 -07:00
networking envoyfilter: fix wrong doc (#2836) 2023-06-26 18:43:36 -07:00
operator/v1alpha1 update `proxy_inbound_listen_port` doc (#2735) 2023-03-21 19:43:21 -07:00
releaselocks Remove releaselocks/ (#2288) 2022-03-17 15:29:43 -07:00
releasenotes Add ecdh_curves support (#2543) 2023-02-17 10:36:03 -08:00
scripts Validate and fix all samples (#2413) 2022-07-12 19:08:17 -07:00
security [release-1.18] Add authz dry-run example (#2825) 2023-06-26 06:52:32 -07:00
stability Define Istio Stability Levels (#1817) 2021-02-08 11:44:00 -08:00
telemetry/v1alpha1 update `proxy_inbound_listen_port` doc (#2735) 2023-03-21 19:43:21 -07:00
type/v1beta1 update `proxy_inbound_listen_port` doc (#2735) 2023-03-21 19:43:21 -07:00
.gitattributes Automator: update common-files@master in istio/api@master (#2708) 2023-03-02 12:25:07 -08:00
.gitignore
BUGS-AND-FEATURE-REQUESTS.md
CODEOWNERS [release-1.18] Automated branching step 4 (#2766) 2023-04-26 06:49:28 -07:00
CONTRIBUTING.md
GUIDELINES.md Add new guidelines to API compatibility (#2061) 2021-08-30 17:11:14 -07:00
LICENSE Automator: update common-files@master in istio/api@master (#2494) 2022-10-05 10:36:39 -07:00
Makefile Automator: update common-files@master in istio/api@master (#2151) 2021-11-11 09:09:02 -08:00
Makefile.core.mk Run proto-commit as part of make gen (#2546) 2022-11-03 13:35:29 -07:00
Makefile.overrides.mk
README.md Run proto-commit as part of make gen (#2546) 2022-11-03 13:35:29 -07:00
SUPPORT.md
buf.gen-golang.yaml buf: migrate to v1 API (#2297) 2022-03-25 06:19:22 -07:00
buf.gen-noncrd.yaml buf: migrate to v1 API (#2297) 2022-03-25 06:19:22 -07:00
buf.gen.yaml buf: migrate to v1 API (#2297) 2022-03-25 06:19:22 -07:00
buf.yaml buf: migrate to v1 API (#2297) 2022-03-25 06:19:22 -07:00
clean.sh Drop generated python protobufs (#2280) 2022-03-17 16:55:44 -07:00
cue.yaml Add WasmPlugin API (#1940) 2021-07-27 14:05:57 -07:00
gen.sh operator: move to real protobuf (#2272) 2022-03-14 10:26:22 -07:00
github.com Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
go.mod Update deps to k8s 1.27.0 (#2757) 2023-04-14 10:36:35 -07:00
go.sum Update deps to k8s 1.27.0 (#2757) 2023-04-14 10:36:35 -07:00
google Move protobuf generation/configuration to buf (#1833) 2021-01-28 17:47:43 -08:00
header.go.txt Migrate from gogo/protobuf to golang/protobuf (#2293) 2022-03-23 08:11:37 -07: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 sync stats config (#2790) 2023-05-22 05:54:15 -07: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 gen and submitted as part of the same PR as the updated definitions. Also make gen will update the proto.lock file with new changes.

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.