diff --git a/_data/toc.yaml b/_data/toc.yaml index cb6a15356f..2682fbec53 100644 --- a/_data/toc.yaml +++ b/_data/toc.yaml @@ -1579,6 +1579,8 @@ manuals: title: Manage and deploy private images - path: /datacenter/ucp/3.0/guides/admin/configure/set-orchestrator-type/ title: Set the orchestrator type for a node + - path: /datacenter/ucp/3.0/guides/admin/configure/view-namespace-resources/ + title: View Kubernetes objects in a namespace - sectiontitle: Join nodes to your cluster section: - path: /datacenter/ucp/3.0/guides/admin/configure/join-nodes/ diff --git a/datacenter/ucp/3.0/guides/admin/configure/view-namespace-resources.md b/datacenter/ucp/3.0/guides/admin/configure/view-namespace-resources.md new file mode 100644 index 0000000000..de9f636329 --- /dev/null +++ b/datacenter/ucp/3.0/guides/admin/configure/view-namespace-resources.md @@ -0,0 +1,112 @@ +--- +title: View Kubernetes objects in a namespace +description: Learn how to set the Kubernetes namespace context in a Docker Enterprise Edition cluster. +keywords: Docker EE, UCP, Kubernetes, namespace +--- + +With Docker Enterprise Edition, administrators can filter the view of +Kubernetes objects by the namespace the objects are assigned to. You can +specify a single namespace, or you can specify all available namespaces. + +## Create two namespaces + +In this example, you create two Kubernetes namespaces and deploy a service +to both of them. + +1. Log in to the UCP web UI with an administrator account. +2. In the left pane, click **Kubernetes**. +3. Click **Create** to open the **Create Kubernetes Object** page. +4. In the **Object YAML** editor, paste the following YAML. + +```yaml +apiVersion: v1 +kind: Namespace +metadata: + name: blue +--- + apiVersion: v1 + kind: Namespace + metadata: + name: orange +``` + +5. Click **Create** to create the `blue` and `orange` namespaces. + +![](../../images/view-namespace-resources-1.png){: .with-border} + +## Deploy services + +Create a `NodePort` service in the `blue` namespace. + +1. Navigate to the **Create Kubernetes Object** page. +2. In the **Namespace** dropdown, select **blue**. +3. In the **Object YAML** editor, paste the following YAML. + +```yaml +apiVersion: v1 +kind: Service +metadata: + name: app-service-blue + labels: + app: app-blue +spec: + type: NodePort + ports: + - port: 80 + nodePort: 30080 + selector: + app: app-blue +``` + +4. Click **Create** to deploy the service in the `blue` namespace. + +Repeat the previous steps with the following YAML, but this time, select +`orange` from the **Namespace** dropdown. + +```yaml +apiVersion: v1 +kind: Service +metadata: + name: app-service-orange + labels: + app: app-orange +spec: + type: NodePort + ports: + - port: 80 + nodePort: 30081 + selector: + app: app-orange +``` + +## View services + +Currently, the **Namespaces** view is set to the **default** namespace, so the +**Load Balancers** page doesn't show your services. + +1. In the left pane, click **Namespaces** to open the list of namespaces. +2. In the upper-right corner, click the **Set context for all namespaces** + toggle. The indicator in the left pane changes to **All Namespaces**. +3. Click **Load Balancers** to view your services. + +![](../../images/view-namespace-resources-2.png){: .with-border} + +## Filter the view by namespace + +With the **Set context for all namespaces** toggle set, you see all of the +Kubernetes objects in every namespace. Now filter the view to show only +objects in one namespace. + +1. In the left pane, click **Namespaces** to open the list of namespaces. +2. In the **orange** namespace, click the **More options** icon and in the + context menu, select **Set Context**. + +![](../../images/view-namespace-resources-3.png){: .with-border} + +3. Click **Confirm** to set the context to the `orange` namespace. + The indicator in the left pane changes to **orange**. +4. Click **Load Balancers** to view your `app-service-orange` service. + The `app-service-blue` service doesn't appear. + +To view the `app-service-blue` service, repeat the previous steps, but this +time, select **Set Context** on the **blue** namespace. \ No newline at end of file diff --git a/datacenter/ucp/3.0/guides/images/view-namespace-resources-1.png b/datacenter/ucp/3.0/guides/images/view-namespace-resources-1.png new file mode 100644 index 0000000000..ec26fdc403 Binary files /dev/null and b/datacenter/ucp/3.0/guides/images/view-namespace-resources-1.png differ diff --git a/datacenter/ucp/3.0/guides/images/view-namespace-resources-2.png b/datacenter/ucp/3.0/guides/images/view-namespace-resources-2.png new file mode 100644 index 0000000000..2a9f49cc28 Binary files /dev/null and b/datacenter/ucp/3.0/guides/images/view-namespace-resources-2.png differ diff --git a/datacenter/ucp/3.0/guides/images/view-namespace-resources-3.png b/datacenter/ucp/3.0/guides/images/view-namespace-resources-3.png new file mode 100644 index 0000000000..59b8ce4bf9 Binary files /dev/null and b/datacenter/ucp/3.0/guides/images/view-namespace-resources-3.png differ diff --git a/datacenter/ucp/3.0/guides/user/services/deploy-kubernetes-workload.md b/datacenter/ucp/3.0/guides/user/services/deploy-kubernetes-workload.md index aa2be87446..e697772c99 100644 --- a/datacenter/ucp/3.0/guides/user/services/deploy-kubernetes-workload.md +++ b/datacenter/ucp/3.0/guides/user/services/deploy-kubernetes-workload.md @@ -65,7 +65,7 @@ links in the **Kubernetes** section of the left pane. ## Expose the server -The NGINX server is up and running, but it's not accessble from outside of the +The NGINX server is up and running, but it's not accessible from outside of the cluster. Add a `NodePort` service to expose the server on a specified port: ```yaml