Skip to content

Commit f265aed

Browse files
author
Tim Bannister
committed
Fold concept overview pages into section indexes
Where an existing Concept section has an index and the first page is “Overview of X”, move the content of that overview into the index page itself. Also, configure redirects accordingly.
1 parent 3ff7312 commit f265aed

File tree

6 files changed

+313
-125
lines changed

6 files changed

+313
-125
lines changed
Lines changed: 65 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,71 @@
11
---
2-
title: "Cluster Administration"
2+
title: Cluster Administration
3+
reviewers:
4+
- davidopp
5+
- lavalamp
36
weight: 100
7+
content_type: concept
48
description: >
59
Lower-level detail relevant to creating or administering a Kubernetes cluster.
610
---
711

12+
<!-- overview -->
13+
The cluster administration overview is for anyone creating or administering a Kubernetes cluster.
14+
It assumes some familiarity with core Kubernetes [concepts](/docs/concepts/).
15+
16+
17+
<!-- body -->
18+
## Planning a cluster
19+
20+
See the guides in [Setup](/docs/setup/) for examples of how to plan, set up, and configure Kubernetes clusters. The solutions listed in this article are called *distros*.
21+
22+
Before choosing a guide, here are some considerations:
23+
24+
- Do you just want to try out Kubernetes on your computer, or do you want to build a high-availability, multi-node cluster? Choose distros best suited for your needs.
25+
- Will you be using **a hosted Kubernetes cluster**, such as [Google Kubernetes Engine](https://cloud.google.com/kubernetes-engine/), or **hosting your own cluster**?
26+
- Will your cluster be **on-premises**, or **in the cloud (IaaS)**? Kubernetes does not directly support hybrid clusters. Instead, you can set up multiple clusters.
27+
- **If you are configuring Kubernetes on-premises**, consider which [networking model](/docs/concepts/cluster-administration/networking/) fits best.
28+
- Will you be running Kubernetes on **"bare metal" hardware** or on **virtual machines (VMs)**?
29+
- Do you **just want to run a cluster**, or do you expect to do **active development of Kubernetes project code**? If the
30+
latter, choose an actively-developed distro. Some distros only use binary releases, but
31+
offer a greater variety of choices.
32+
- Familiarize yourself with the [components](/docs/admin/cluster-components/) needed to run a cluster.
33+
34+
Note: Not all distros are actively maintained. Choose distros which have been tested with a recent version of Kubernetes.
35+
36+
## Managing a cluster
37+
38+
* [Managing a cluster](/docs/tasks/administer-cluster/cluster-management/) describes several topics related to the lifecycle of a cluster: creating a new cluster, upgrading your cluster’s master and worker nodes, performing node maintenance (e.g. kernel upgrades), and upgrading the Kubernetes API version of a running cluster.
39+
40+
* Learn how to [manage nodes](/docs/concepts/nodes/node/).
41+
42+
* Learn how to set up and manage the [resource quota](/docs/concepts/policy/resource-quotas/) for shared clusters.
43+
44+
## Securing a cluster
45+
46+
* [Certificates](/docs/concepts/cluster-administration/certificates/) describes the steps to generate certificates using different tool chains.
47+
48+
* [Kubernetes Container Environment](/docs/concepts/containers/container-environment/) describes the environment for Kubelet managed containers on a Kubernetes node.
49+
50+
* [Controlling Access to the Kubernetes API](/docs/reference/access-authn-authz/controlling-access/) describes how to set up permissions for users and service accounts.
51+
52+
* [Authenticating](/docs/reference/access-authn-authz/authentication/) explains authentication in Kubernetes, including the various authentication options.
53+
54+
* [Authorization](/docs/reference/access-authn-authz/authorization/) is separate from authentication, and controls how HTTP calls are handled.
55+
56+
* [Using Admission Controllers](/docs/reference/access-authn-authz/admission-controllers/) explains plug-ins which intercepts requests to the Kubernetes API server after authentication and authorization.
57+
58+
* [Using Sysctls in a Kubernetes Cluster](/docs/concepts/cluster-administration/sysctl-cluster/) describes to an administrator how to use the `sysctl` command-line tool to set kernel parameters .
59+
60+
* [Auditing](/docs/tasks/debug-application-cluster/audit/) describes how to interact with Kubernetes' audit logs.
61+
62+
### Securing the kubelet
63+
* [Master-Node communication](/docs/concepts/architecture/master-node-communication/)
64+
* [TLS bootstrapping](/docs/reference/command-line-tools-reference/kubelet-tls-bootstrapping/)
65+
* [Kubelet authentication/authorization](/docs/admin/kubelet-authentication-authorization/)
66+
67+
## Optional Cluster Services
68+
69+
* [DNS Integration](/docs/concepts/services-networking/dns-pod-service/) describes how to resolve a DNS name directly to a Kubernetes service.
70+
71+
* [Logging and Monitoring Cluster Activity](/docs/concepts/cluster-administration/logging/) explains how logging in Kubernetes works and how to implement it.

content/en/docs/concepts/cluster-administration/cluster-administration-overview.md

Lines changed: 0 additions & 73 deletions
This file was deleted.

content/en/docs/concepts/containers/_index.md

100755100644
Lines changed: 35 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Containers"
2+
title: Containers
33
weight: 40
44
description: Technology for packaging an application along with its runtime dependencies.
55
reviewers:
@@ -8,3 +8,37 @@ reviewers:
88
content_type: concept
99
---
1010

11+
<!-- overview -->
12+
13+
Each container that you run is repeatable; the standardization from having
14+
dependencies included means that you get the same behavior wherever you
15+
run it.
16+
17+
Containers decouple applications from underlying host infrastructure.
18+
This makes deployment easier in different cloud or OS environments.
19+
20+
21+
22+
23+
<!-- body -->
24+
25+
## Container images
26+
A [container image](/docs/concepts/containers/images/) is a ready-to-run
27+
software package, containing everything needed to run an application:
28+
the code and any runtime it requires, application and system libraries,
29+
and default values for any essential settings.
30+
31+
By design, a container is immutable: you cannot change the code of a
32+
container that is already running. If you have a containerized application
33+
and want to make changes, you need to build a new container that includes
34+
the change, then recreate the container to start from the updated image.
35+
36+
## Container runtimes
37+
38+
{{< glossary_definition term_id="container-runtime" length="all" >}}
39+
40+
## {{% heading "whatsnext" %}}
41+
42+
* Read about [container images](/docs/concepts/containers/images/)
43+
* Read about [Pods](/docs/concepts/workloads/pods/)
44+

content/en/docs/concepts/containers/overview.md

Lines changed: 0 additions & 46 deletions
This file was deleted.

0 commit comments

Comments
 (0)