github
/
k3s
mirror of https://github.com/k3s-io/k3s
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Merge pull request #11405 from mikedanese/namespace-example-move 

move kubernetes-namespaces to docs/user-guide
pull/6/head
Brian Grant 2015-07-16 22:51:17 -07:00
parent 368634564f ee7498e6ac
commit 55e9356bf3
5 changed files with 11 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/user-guide/namespaces.md
View File

@ -61,6 +61,8 @@ The Namespace provides a unique scope for:
## Usage ## Usage
Look [here](namespaces/) for an in depth example of namespaces.
### Viewing namespaces ### Viewing namespaces
You can list the current namespaces in a cluster using: You can list the current namespaces in a cluster using:
```sh ```sh

16
examples/kubernetes-namespaces/README.md → docs/user-guide/namespaces/README.md
View File

@ -22,11 +22,11 @@ certainly want the docs that go with that version.</h1>
<!-- END MUNGE: UNVERSIONED_WARNING --> <!-- END MUNGE: UNVERSIONED_WARNING -->
## Kubernetes Namespaces ## Kubernetes Namespaces
Kubernetes _[namespaces](../../docs/user-guide/namespaces.md)_ help different projects, teams, or customers to share a Kubernetes cluster. Kubernetes _[namespaces](../namespaces.md)_ help different projects, teams, or customers to share a Kubernetes cluster.
It does this by providing the following: It does this by providing the following:
1. A scope for [Names](../../docs/user-guide/identifiers.md). 1. A scope for [Names](../identifiers.md).
2. A mechanism to attach authorization and policy to a subsection of the cluster. 2. A mechanism to attach authorization and policy to a subsection of the cluster.
Use of multiple namespaces is optional. Use of multiple namespaces is optional.
@ -37,8 +37,8 @@ This example demonstrates how to use Kubernetes namespaces to subdivide your clu
This example assumes the following: This example assumes the following:
1. You have an [existing Kubernetes cluster](../../docs/getting-started-guides/). 1. You have an [existing Kubernetes cluster](../../getting-started-guides/).
2. You have a basic understanding of Kubernetes _[pods](../../docs/user-guide/pods.md)_, _[services](../../docs/user-guide/services.md)_, and _[replication controllers](../../docs/user-guide/replication-controller.md)_. 2. You have a basic understanding of Kubernetes _[pods](../pods.md)_, _[services](../services.md)_, and _[replication controllers](../replication-controller.md)_.
### Step One: Understand the default namespace ### Step One: Understand the default namespace
@ -70,7 +70,7 @@ One pattern this organization could follow is to partition the Kubernetes cluste
Let's create two new namespaces to hold our work. Let's create two new namespaces to hold our work.
Use the file [`examples/kubernetes-namespaces/namespace-dev.json`](namespace-dev.json) which describes a development namespace: Use the file [`namespace-dev.json`](namespace-dev.json) which describes a development namespace:
```js ```js
{ {
@ -88,13 +88,13 @@ Use the file [`examples/kubernetes-namespaces/namespace-dev.json`](namespace-dev
Create the development namespace using kubectl. Create the development namespace using kubectl.
```shell ```shell
$ kubectl create -f examples/kubernetes-namespaces/namespace-dev.json $ kubectl create -f docs/user-guide/kubernetes-namespaces/namespace-dev.json
``` ```
And then lets create the production namespace using kubectl. And then lets create the production namespace using kubectl.
```shell ```shell
$ kubectl create -f examples/kubernetes-namespaces/namespace-prod.json $ kubectl create -f docs/user-guide/kubernetes-namespaces/namespace-prod.json
``` ```
To be sure things are right, let's list all of the namespaces in our cluster. To be sure things are right, let's list all of the namespaces in our cluster.
@ -265,5 +265,5 @@ authorization rules for each namespace.
<!-- BEGIN MUNGE: GENERATED_ANALYTICS --> <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/examples/kubernetes-namespaces/README.md?pixel)]() [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/namespaces/README.md?pixel)]()
<!-- END MUNGE: GENERATED_ANALYTICS --> <!-- END MUNGE: GENERATED_ANALYTICS -->

0
examples/kubernetes-namespaces/namespace-dev.json → docs/user-guide/namespaces/namespace-dev.json
View File

0
examples/kubernetes-namespaces/namespace-prod.json → docs/user-guide/namespaces/namespace-prod.json
View File

2
examples/examples_test.go
View File

@ -249,7 +249,7 @@ func TestExampleObjectSchemas(t *testing.T) {
"hazelcast-controller": &api.ReplicationController{}, "hazelcast-controller": &api.ReplicationController{},
"hazelcast-service": &api.Service{}, "hazelcast-service": &api.Service{},
}, },
"../examples/kubernetes-namespaces": { "../docs/user-guide/namespaces": {
"namespace-dev": &api.Namespace{}, "namespace-dev": &api.Namespace{},
"namespace-prod": &api.Namespace{}, "namespace-prod": &api.Namespace{},
}, },