a73eb2b2ce
When we generate protobufs, descriptors outlining all messages and services are merged into a single file that can be used to identify unexpected changes to the API that may affect stability. We follow a similar process to Go's stability guarantees using the protobuf descriptors to identify changes before they become a problem. Please see README.md for details. Signed-off-by: Stephen J Day <stephen.day@docker.com>
56 lines
1.9 KiB
TOML
56 lines
1.9 KiB
TOML
version = "unstable"
|
|
generator = "gogoctrd"
|
|
plugins = ["grpc", "fieldpath"]
|
|
|
|
# Control protoc include paths. Below are usually some good defaults, but feel
|
|
# free to try it without them if it works for your project.
|
|
[includes]
|
|
# Include paths that will be added before all others. Typically, you want to
|
|
# treat the root of the project as an include, but this may not be necessary.
|
|
# before = ["."]
|
|
|
|
# Paths that should be treated as include roots in relation to the vendor
|
|
# directory. These will be calculated with the vendor directory nearest the
|
|
# target package.
|
|
vendored = ["github.com/gogo/protobuf"]
|
|
|
|
# Paths that will be added untouched to the end of the includes. We use
|
|
# `/usr/local/include` to pickup the common install location of protobuf.
|
|
# This is the default.
|
|
after = ["/usr/local/include"]
|
|
|
|
# This section maps protobuf imports to Go packages. These will become
|
|
# `-M` directives in the call to the go protobuf generator.
|
|
[packages]
|
|
"gogoproto/gogo.proto" = "github.com/gogo/protobuf/gogoproto"
|
|
"google/protobuf/any.proto" = "github.com/gogo/protobuf/types"
|
|
"google/protobuf/descriptor.proto" = "github.com/gogo/protobuf/protoc-gen-gogo/descriptor"
|
|
"google/protobuf/field_mask.proto" = "github.com/gogo/protobuf/types"
|
|
"google/protobuf/timestamp.proto" = "github.com/gogo/protobuf/types"
|
|
|
|
# Aggregrate the API descriptors to lock down API changes.
|
|
[[descriptors]]
|
|
prefix = "github.com/containerd/containerd/api"
|
|
target = "api/next.pb.txt"
|
|
ignore_files = [
|
|
"google/protobuf/descriptor.proto",
|
|
"gogoproto/gogo.proto"
|
|
]
|
|
|
|
# Lock down runc config
|
|
[[descriptors]]
|
|
prefix = "github.com/containerd/containerd/linux/runcopts"
|
|
target = "linux/runcopts/next.pb.txt"
|
|
ignore_files = [
|
|
"google/protobuf/descriptor.proto",
|
|
"gogoproto/gogo.proto"
|
|
]
|
|
|
|
[[descriptors]]
|
|
prefix = "github.com/containerd/containerd/windows/hcsshimopts"
|
|
target = "windows/hcsshimopts/next.pb.txt"
|
|
ignore_files = [
|
|
"google/protobuf/descriptor.proto",
|
|
"gogoproto/gogo.proto"
|
|
]
|