k3s/docs
k8s-merge-robot 07929972a3 Merge pull request #18835 from brendandburns/3rdparty
Automatic merge from submit-queue

Add support for 3rd party objects to kubectl

@deads2k @jlowdermilk

Instructions for playing around with this:

Run an apiserver with third party resources turned on (`--runtime-config=extensions/v1beta1=true,extensions/v1beta1/thirdpartyresources=true`)

Then you should be able to:

```
kubectl create -f rsrc.json
```

```json
{
  "metadata": {
    "name": "foo.company.com"
  },
  "apiVersion": "extensions/v1beta1",
  "kind": "ThirdPartyResource",
  "versions": [
    {
      "apiGroup": "group",
      "name": "v1"
    },
    {
      "apiGroup": "group",
      "name": "v2"
    }
  ]
}
```

Once that is done, you should be able to:

```
curl http://<server>/apis/company.com/v1/foos
```

```
curl -X POST -d @${HOME}/foo.json http://localhost:8080/apis/company.com/v1/namespaces/default/foos
```

```json
{
  "kind": "Foo",
  "apiVersion": "company.com/v1",
  "metadata": {
    "name": "baz"
  },
  "someField": "hello world",
  "otherField": 1
}
```

After this PR, you can do:

```
kubectl create -f foo.json
```

```
kubectl get foos
```

etc.
2016-03-31 18:09:56 -07:00
..
admin *.*: Run hack/update-all.sh, Run hack/update-generated-docs.sh 2016-03-28 17:06:14 -07:00
api-reference IngressTLS: allow secretName to be blank for SNI routing 2016-03-28 21:25:54 -04:00
design Rename volume.Builder to Mounter and volume.Cleaner to Unmounter 2016-03-25 11:29:58 -07:00
devel Merge pull request #23353 from spiffxp/conformance-docs 2016-03-30 06:21:13 -07:00
getting-started-guides Update the latestReleaseBranch to release-1.2 in the munger. 2016-03-08 18:59:28 -08:00
images Updated for v1.2.0. 2016-03-18 14:20:56 -07:00
man/man1 Add third party support to kubectl 2016-03-31 10:53:32 -07:00
proposals Merge pull request #23315 from david-mcmahon/relnotes-proposal 2016-03-30 12:53:55 -07:00
user-guide Add third party support to kubectl 2016-03-31 10:53:32 -07:00
OWNERS Move blunderbuss assignees into tree 2016-03-02 20:46:32 -05:00
README.md Update references for known issues back to CHANGELOG.md (release notes). 2016-03-24 15:27:54 -07:00
api.md Updating documentation 2016-03-23 13:19:22 -07:00
reporting-security-issues.md Update the latestReleaseBranch to release-1.2 in the munger. 2016-03-08 18:59:28 -08:00
roadmap.md Update the latestReleaseBranch to release-1.2 in the munger. 2016-03-08 18:59:28 -08:00
troubleshooting.md Update references for known issues back to CHANGELOG.md (release notes). 2016-03-24 15:27:54 -07:00
warning.png Add an image to unversioned warnings 2015-07-14 15:28:59 -07:00
whatisk8s.md Update the latestReleaseBranch to release-1.2 in the munger. 2016-03-08 18:59:28 -08:00

README.md

WARNING WARNING WARNING WARNING WARNING

PLEASE NOTE: This document applies to the HEAD of the source tree

If you are using a released version of Kubernetes, you should refer to the docs that go with that version.

The latest release of this document can be found [here](http://releases.k8s.io/release-1.2/docs/README.md).

Documentation for other releases can be found at releases.k8s.io.

Kubernetes Documentation: releases.k8s.io/HEAD

Analytics