k3s/docs/user-guide
Brian Grant b2dafdaef5 Merge pull request #11415 from nikhiljindal/exposeError
Fixing the error message when kubectl expose is used without port
2015-07-17 00:16:57 -07:00
..
downward-api (mostly) auto fixed links 2015-07-16 16:28:18 -07:00
environment-guide Ensure all docs and examples in user guide are reachable 2015-07-16 23:12:47 -07:00
kubectl Fixing the error message 2015-07-16 23:33:16 -07:00
limitrange Ensure all docs and examples in user guide are reachable 2015-07-16 23:12:47 -07:00
liveness Ensure all docs and examples in user guide are reachable 2015-07-16 23:12:47 -07:00
logging-demo Ensure all docs and examples in user guide are reachable 2015-07-16 23:12:47 -07:00
namespaces MUNGE generated table of contents should strip comma 2015-07-16 23:21:09 -07:00
node-selection Ensure all docs and examples in user guide are reachable 2015-07-16 23:12:47 -07:00
persistent-volumes Ensure all docs and examples in user guide are reachable 2015-07-16 23:12:47 -07:00
resourcequota Ensure all docs and examples in user guide are reachable 2015-07-16 23:12:47 -07:00
secrets Ensure all docs and examples in user guide are reachable 2015-07-16 23:12:47 -07:00
update-demo Ensure all docs and examples in user guide are reachable 2015-07-16 23:12:47 -07:00
walkthrough Merge pull request #11352 from JanetKuo/docs-reachable 2015-07-16 23:33:45 -07:00
README.md Merge pull request #11352 from JanetKuo/docs-reachable 2015-07-16 23:33:45 -07:00
accessing-the-cluster.md (mostly) auto fixed links 2015-07-16 16:28:18 -07:00
annotations.md Run gendocs 2015-07-14 17:28:47 -07:00
application-troubleshooting.md Organize troubleshooting sections 2015-07-15 13:20:32 -07:00
cadvisor.png Move diagrams out of top-level docs/ directory and merge 2015-07-14 23:56:51 -07:00
compute-resources.md Organize troubleshooting sections 2015-07-15 13:20:32 -07:00
configuring-containers.md MUNGE generated table of contents should strip comma 2015-07-16 23:21:09 -07:00
connecting-applications.md MUNGE generated table of contents should strip comma 2015-07-16 23:21:09 -07:00
connecting-to-applications-port-forward.md Thread user guide docs together with "What's next" sections, and add a couple missing TOCs. 2015-07-15 00:43:18 +00:00
connecting-to-applications-proxy.md Run gendocs 2015-07-14 17:28:47 -07:00
container-environment.md Ensure all docs and examples in user guide are reachable 2015-07-16 23:12:47 -07:00
containers.md Run gendocs 2015-07-14 17:28:47 -07:00
debugging-services.md update service debug doc from user feedback 2015-07-15 17:37:30 -07:00
deploying-applications.md MUNGE generated table of contents should strip comma 2015-07-16 23:21:09 -07:00
docker-cli-to-kubectl.md add examples on how to transition from docker-cli to kubectl 2015-07-15 15:25:28 -07:00
downward-api.md Run gendocs 2015-07-14 17:28:47 -07:00
gcm.png Move diagrams out of top-level docs/ directory and merge 2015-07-14 23:56:51 -07:00
getting-into-containers.md Add munger to verify kubectl -f targets, fix docs 2015-07-16 15:39:45 -07:00
identifiers.md Run gendocs 2015-07-14 17:28:47 -07:00
images.md Add munger to verify kubectl -f targets, fix docs 2015-07-16 15:39:45 -07:00
influx.png move user docs to their new home 2015-07-14 10:26:36 -07:00
introspection-and-debugging.md MUNGE generated table of contents should strip comma 2015-07-16 23:21:09 -07:00
k8s-ui-explore-filter.png move user docs to their new home 2015-07-14 10:26:36 -07:00
k8s-ui-explore-groupby.png move user docs to their new home 2015-07-14 10:26:36 -07:00
k8s-ui-explore-poddetail.png move user docs to their new home 2015-07-14 10:26:36 -07:00
k8s-ui-explore.png move user docs to their new home 2015-07-14 10:26:36 -07:00
k8s-ui-nodes.png move user docs to their new home 2015-07-14 10:26:36 -07:00
k8s-ui-overview.png move user docs to their new home 2015-07-14 10:26:36 -07:00
kibana.png move user docs to their new home 2015-07-14 10:26:36 -07:00
kubeconfig-file.md Run gendocs 2015-07-14 17:28:47 -07:00
labels.md Run gendocs 2015-07-14 17:28:47 -07:00
logging.md Ensure all docs and examples in user guide are reachable 2015-07-16 23:12:47 -07:00
managing-deployments.md Merge pull request #11352 from JanetKuo/docs-reachable 2015-07-16 23:33:45 -07:00
monitoring-architecture.png move user docs to their new home 2015-07-14 10:26:36 -07:00
monitoring.md Move diagrams out of top-level docs/ directory and merge 2015-07-14 23:56:51 -07:00
multi-pod.yaml move user docs to their new home 2015-07-14 10:26:36 -07:00
namespaces.md Merge pull request #11405 from mikedanese/namespace-example-move 2015-07-16 22:51:17 -07:00
overview.md Initial TOC for the user guide. 2015-07-15 01:25:22 +00:00
persistent-volumes.md MUNGE generated table of contents should strip comma 2015-07-16 23:21:09 -07:00
pod-states.md Move some docs from docs/ top-level into docs/{admin/,devel/,user-guide/}. 2015-07-14 22:07:44 -07:00
pod.yaml move user docs to their new home 2015-07-14 10:26:36 -07:00
pods.md Run gendocs 2015-07-14 17:28:47 -07:00
prereqs.md fixup kubectl walktrough example 2015-07-16 17:25:18 -07:00
production-pods.md MUNGE generated table of contents should strip comma 2015-07-16 23:21:09 -07:00
quick-start.md MUNGE generated table of contents should strip comma 2015-07-16 23:21:09 -07:00
replication-controller.md MUNGE generated table of contents should strip comma 2015-07-16 23:21:09 -07:00
replication.yaml move user docs to their new home 2015-07-14 10:26:36 -07:00
secrets.md Merge pull request #11352 from JanetKuo/docs-reachable 2015-07-16 23:33:45 -07:00
security-context.md Run gendocs 2015-07-14 17:28:47 -07:00
service-accounts.md Add munger to verify kubectl -f targets, fix docs 2015-07-16 15:39:45 -07:00
services-detail.png move user docs to their new home 2015-07-14 10:26:36 -07:00
services-detail.svg move user docs to their new home 2015-07-14 10:26:36 -07:00
services-firewalls.md Move docs/services-firewalls.md into docs/user-guide/ and make small 2015-07-16 13:21:14 -07:00
services-overview.png move user docs to their new home 2015-07-14 10:26:36 -07:00
services-overview.svg move user docs to their new home 2015-07-14 10:26:36 -07:00
services.md Merge pull request #11352 from JanetKuo/docs-reachable 2015-07-16 23:33:45 -07:00
sharing-clusters.md Run gendocs 2015-07-14 17:28:47 -07:00
simple-nginx.md Run gendocs 2015-07-14 17:28:47 -07:00
simple-yaml.md Add munger to verify kubectl -f targets, fix docs 2015-07-16 15:39:45 -07:00
ui.md Run gendocs 2015-07-14 17:28:47 -07:00
volumes.md Run gendocs 2015-07-14 17:28:47 -07:00
working-with-resources.md Add munger to verify kubectl -f targets, fix docs 2015-07-16 15:39:45 -07:00

README.md

WARNING WARNING WARNING

PLEASE NOTE: This document applies to the HEAD of the source tree only. If you are using a released version of Kubernetes, you almost certainly want the docs that go with that version.

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

WARNING WARNING WARNING

Kubernetes User Guide: Managing Applications

Table of Contents

The user guide is intended for anyone who wants to run programs and services on an existing Kubernetes cluster. Setup and administration of a Kubernetes cluster is described in the Cluster Admin Guide. The Developer Guide is for anyone wanting to either write code which directly accesses the kubernetes API, or to contribute directly to the kubernetes project.

Please ensure you have completed the prerequisites for running examples from the user guide.

Quick walkthrough

  1. Kubernetes 101
  2. Kubernetes 201

Thorough walkthrough

If you don't have much familiarity with Kubernetes, we recommend you read the following sections in order:

  1. Quick start: launch and expose an application
  2. Configuring and launching containers: configuring common container parameters
  3. Deploying continuously running applications
  4. Connecting applications: exposing applications to clients and users
  5. Working with containers in production
  6. Managing deployments
  7. Application introspection and debugging
    1. Using the Kubernetes web user interface
    2. Logging
    3. Monitoring
    4. Getting into containers via exec
    5. Connecting to containers via proxies
    6. Connecting to containers via port forwarding

Concept guide

Overview
A brief overview of Kubernetes concepts.
Cluster
A cluster is a set of physical or virtual machines and other infrastructure resources used by Kubernetes to run your applications.
Node
A node is a physical or virtual machine running Kubernetes, onto which pods can be scheduled.
Pod
A pod is a co-located group of containers and volumes.
Label
A label is a key/value pair that is attached to a resource, such as a pod, to convey a user-defined identifying attribute. Labels can be used to organize and to select subsets of resources.
Selector
A selector is an expression that matches labels in order to identify related resources, such as which pods are targeted by a load-balanced service.
Replication Controller
A replication controller ensures that a specified number of pod replicas are running at any one time. It both allows for easy scaling of replicated systems and handles re-creation of a pod when the machine it is on reboots or otherwise fails.
Service
A service defines a set of pods and a means by which to access them, such as single stable IP address and corresponding DNS name.
Volume
A volume is a directory, possibly with some data in it, which is accessible to a Container as part of its filesystem. Kubernetes volumes build upon Docker Volumes, adding provisioning of the volume directory and/or device.
Secret
A secret stores sensitive data, such as authentication tokens, which can be made available to containers upon request.
Name
A user- or client-provided name for a resource.
Namespace
A namespace is like a prefix to the name of a resource. Namespaces help different projects, teams, or customers to share a cluster, such as by preventing name collisions between unrelated teams.
Annotation
A key/value pair that can hold larger (compared to a label), and possibly not human-readable, data, intended to store non-identifying auxiliary data, especially data manipulated by tools and system extensions. Efficient filtering by annotation values is not supported.

Further reading

Analytics