sample-controller/vendor/k8s.io/code-generator
Kubernetes Publisher ac45ff67c5 Merge pull request #59293 from roycaihw/openapi_endpoint
Automatic merge from submit-queue (batch tested with PRs 60011, 59256, 59293, 60328, 60367). If you want to cherry-pick this change to another branch, please follow the instructions <a href="https://github.com/kubernetes/community/blob/master/contributors/devel/cherry-picks.md">here</a>.

Serve OpenAPI spec with single /openapi/v2 endpoint

**What this PR does / why we need it**:
We are deprecating format-separated endpoints (`/swagger.json`, `/swagger-2.0.0.json`, `/swagger-2.0.0.pb-v1`, `/swagger-2.0.0.pb-v1.gz`) for OpenAPI spec, and switching to a single `/openapi/v2` endpoint in Kubernetes 1.10. The design doc and deprecation process are tracked at: https://docs.google.com/document/d/19lEqE9lc4yHJ3WJAJxS_G7TcORIJXGHyq3wpwcH28nU

Requested format is specified by setting HTTP headers

header | possible values
-- | --
Accept | `application/json`, `application/com.github.proto-openapi.spec.v2@v1.0+protobuf`
Accept-Encoding | `gzip`

This PR changes dynamic_client (and kubectl as a result) to use the new endpoint. The old endpoints will remain in 1.10 and 1.11, and get removed in 1.12.

**Which issue(s) this PR fixes** *(optional, in `fixes #<issue number>(, fixes #<issue_number>, ...)` format, will close the issue(s) when PR gets merged)*:
Fixes #

**Special notes for your reviewer**:

**Release note**:

```release-note
action required: Deprecate format-separated endpoints for OpenAPI spec. Please use single `/openapi/v2` endpoint instead.
```

/sig api-machinery

Kubernetes-commit: d6153194d929ad6c036d5bbbf67a6f892e75feb5
2018-02-27 10:02:39 +00:00
..
_examples sync: update required packages 2018-02-27 06:00:06 +00:00
cmd sync: update required packages 2018-02-27 06:00:06 +00:00
Godeps Merge pull request #59293 from roycaihw/openapi_endpoint 2018-02-27 10:02:39 +00:00
hack sync: update required packages 2018-02-27 06:00:06 +00:00
pkg/util sync: update required packages 2018-02-27 06:00:06 +00:00
third_party/forked/golang/reflect sync: update required packages 2018-02-27 06:00:06 +00:00
vendor Merge pull request #59293 from roycaihw/openapi_endpoint 2018-02-27 10:02:39 +00:00
code-of-conduct.md sync: update required packages 2018-02-27 06:00:06 +00:00
CONTRIBUTING.md sync: update required packages 2018-02-27 06:00:06 +00:00
generate-groups.sh sync: update required packages 2018-02-27 06:00:06 +00:00
generate-internal-groups.sh sync: update required packages 2018-02-27 06:00:06 +00:00
LICENSE sync: update required packages 2018-02-27 06:00:06 +00:00
OWNERS sync: update required packages 2018-02-27 06:00:06 +00:00
README.md sync: update required packages 2018-02-27 06:00:06 +00:00

code-generator

Golang code-generators used to implement Kubernetes-style API types.

Purpose

These code-generators can be used

  • in the context of CustomResourceDefinition to build native, versioned clients, informers and other helpers
  • in the context of User-provider API Servers to build conversions between internal and versioned types, defaulters, protobuf codecs, internal and versioned clients and informers.

Resources

Compatibility

HEAD of this repo will match HEAD of k8s.io/apiserver, k8s.io/apimachinery, and k8s.io/client-go.

Where does it come from?

code-generator is synced from https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/code-generator. Code changes are made in that location, merged into k8s.io/kubernetes and later synced here.