diff --git a/_data/guides.yml b/_data/guides.yml index 7a9b078e36..6857698700 100644 --- a/_data/guides.yml +++ b/_data/guides.yml @@ -12,20 +12,115 @@ toc: path: /docs/getting-started-guides/binary_release/ - title: Hello World Walkthrough path: /docs/hellonode/ - - title: Kubernetes 101 - path: /docs/user-guide/walkthrough/ - - title: Kubernetes 201 - path: /docs/user-guide/walkthrough/k8s201/ - - title: Accessing the Kubernetes Web UI - path: /docs/user-guide/ui-access/ + +- title: Accessing the Cluster + section: + - title: Installing and Setting up kubectl + path: /docs/user-guide/prereqs/ + - title: Accessing Clusters + path: /docs/user-guide/accessing-the-cluster/ + - title: Sharing Cluster Access with kubeconfig + path: /docs/user-guide/sharing-clusters/ + - title: Authenticating Across Clusters with kubeconfig + path: /docs/user-guide/kubeconfig-file/ - title: User Guide path: /docs/user-guide/ -- title: Admin Guide - path: /docs/admin/ +- title: Web UI (Dashboard) + path: /docs/user-guide/ui/ -- title: Running Kubernetes +- title: Workload Deployment and Management + section: + - title: Launching, Exposing, and Killing Applications + path: /docs/user-guide/quick-start/ + - title: Deploying Applications + path: /docs/user-guide/deploying-applications/ + - title: Managing Resources + path: /docs/user-guide/managing-deployments/ + - title: Replication Controller Operations + path: /docs/user-guide/replication-controller/operations/ + - title: Resizing a Replication Controller + path: /docs/user-guide/resizing-a-replication-controller/ + - title: Rolling Updates + path: /docs/user-guide/rolling-updates/ + - title: Rolling Update Demo + path: /docs/user-guide/update-demo/ + - title: Secrets Walkthrough + path: /docs/user-guide/secrets/walkthrough/ + - title: Using ConfigMap + path: /docs/user-guide/configmap/ + - title: Horizontal Pod Autoscaling + path: /docs/user-guide/horizontal-pod-autoscaling/walkthrough/ + - title: Best Practices for Configuration + path: /docs/user-guide/config-best-practices/ + - title: Using kubectl to Manage Resources + path: /docs/user-guide/working-with-resources/ + +- title: Service Discovery and Load Balancing + section: + - title: Connecting Applications with Services + path: /docs/user-guide/connecting-applications/ + - title: Service Operations + path: /docs/user-guide/services/operations/ + - title: Creating an External Load Balancer + path: /docs/user-guide/load-balancer/ + - title: Configuring Your Cloud Provider's Firewalls + path: /docs/user-guide/services-firewalls/ + +- title: Containers and Pods + section: + - title: Running Your First Containers + path: /docs/user-guide/simple-nginx/ + - title: Creating Single-Container Pods + path: /docs/user-guide/pods/single-container/ + - title: Creating Multi-Container Pods + path: /docs/user-guide/pods/multi-container/ + - title: Configuring Containers + path: /docs/user-guide/configuring-containers/ + - title: Working with Containers in Production + path: /docs/user-guide/production-pods/ + - title: Commands and Capabilities + path: /docs/user-guide/containers/ + - title: Using Environment Variables + path: /docs/user-guide/environment-guide/ + - title: Managing Compute Resources + path: /docs/user-guide/compute-resources/ + - title: The Lifecycle of a Pod + path: /docs/user-guide/pod-states/ + - title: Checking Pod Health + path: /docs/user-guide/liveness/ + - title: Container Lifecycle Hooks + path: /docs/user-guide/container-environment/ + - title: Assigning Pods to Nodes + path: /docs/user-guide/node-selection/ + - title: Using the Downward API to Convey Pod Properties + path: /docs/user-guide/downward-api/ + - title: Downward API Volumes + path: /docs/user-guide/downward-api/volume + - title: Persistent Volumes Walkthrough + path: /docs/user-guide/persistent-volumes/walkthrough/ + +- title: Monitoring, Logging, and Debugging Containers + section: + - title: Resource Usage Monitoring + path: /docs/user-guide/monitoring/ + - title: Logging + path: /docs/getting-started-guides/logging/ + - title: Logging with Elasticsearch and Kibana + path: /docs/getting-started-guides/logging-elasticsearch/ + - title: Elasticsearch/Kibana Logging Demo + path: /docs/user-guide/logging-demo + - title: Running Commands in a Container with kubectl exec + path: /docs/user-guide/getting-into-containers/ + - title: Connect with Proxies + path: /docs/user-guide/connecting-to-applications-proxy/ + - title: Connect with Port Forwarding + path: /docs/user-guide/connecting-to-applications-port-forward/ + - title: Using Explorer to Examine the Runtime Environment + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/explorer + +- title: Creating a Cluster section: - title: Picking the Right Solution path: /docs/getting-started-guides/ @@ -47,9 +142,17 @@ toc: path: /docs/getting-started-guides/coreos/azure/ - title: Running Kubernetes on CenturyLink Cloud path: /docs/getting-started-guides/clc/ + - title: Portable Multi-Node Clusters + section: + - title: Installing a Kubernetes Master Node via Docker + path: /docs/getting-started-guides/docker-multinode/master/ + - title: Adding a Kubernetes Worker Node via Docker + path: /docs/getting-started-guides/docker-multinode/worker/ + - title: Deploying DNS + path: /docs/getting-started-guides/docker-multinode/deployDNS/ - title: Running Kubernetes on Custom Solutions section: - - title: Getting Started From Scratch + - title: Creating a Custom Cluster from Scratch path: /docs/getting-started-guides/scratch/ - title: Custom Cloud Solutions section: @@ -105,167 +208,56 @@ toc: path: /docs/getting-started-guides/centos/centos_manual_config/ - title: Ubuntu path: /docs/getting-started-guides/ubuntu/ - - title: Docker (Multi-Node) - path: /docs/getting-started-guides/docker-multinode/ - title: CoreOS with Calico path: /docs/getting-started-guides/coreos/bare_metal_calico/ - title: Ubuntu Nodes with Calico path: /docs/getting-started-guides/ubuntu-calico/ - -- title: Administering Clusters - section: - - title: Cluster Management Guide - path: /docs/admin/cluster-management/ - - title: Cluster Management Tools - path: /docs/admin/cluster-components/ - - title: Using Multiple Clusters - path: /docs/admin/multi-cluster/ - - title: Using Large Clusters + - title: Building Large Clusters path: /docs/admin/cluster-large/ - title: Running in Multiple Zones path: /docs/admin/multiple-zones/ - title: Building High-Availability Clusters path: /docs/admin/high-availability/ - - title: Accessing Clusters - path: /docs/user-guide/accessing-the-cluster/ + +- title: Administering Clusters + section: + - title: Admin Guide + path: /docs/admin/ + - title: Cluster Management Guide + path: /docs/admin/cluster-management/ - title: Sharing a Cluster with Namespaces path: /docs/admin/namespaces/ - title: Namespaces Walkthrough path: /docs/admin/namespaces/walkthrough/ - - title: Changing Cluster Size - path: https://github.com/kubernetes/kubernetes/wiki/User-FAQ#how-do-i-change-the-size-of-my-cluster/ - - title: Creating a Custom Cluster from Scratch - path: /docs/getting-started-guides/scratch/ - - title: Authenticating Across Clusters with kubeconfig - path: /docs/user-guide/kubeconfig-file/ - - title: Replication Controller Operations - path: /docs/user-guide/replication-controller/operations/ - - title: Resizing a Replication Controller - path: /docs/user-guide/resizing-a-replication-controller/ - - title: Service Operations - path: /docs/user-guide/services/operations/ - - title: Configuring Multiple Schedulers - path: /docs/admin/multiple-schedulers/ - -- title: Using Nodes, Pods, and Containers - section: - - title: The Container Environment - path: /docs/user-guide/container-environment/ - - title: Running Your First Containers - path: /docs/user-guide/simple-nginx/ - - title: Working with Containers - path: /docs/user-guide/production-pods/ - - title: Overriding Default Container Behavior - path: /docs/user-guide/containers/ - - title: Running Commands in a Container with kubectl exec - path: /docs/user-guide/getting-into-containers/ - - title: The Lifecycle of a Pod - path: /docs/user-guide/pod-states/ - - title: Creating Single-Container Pods - path: /docs/user-guide/pods/single-container/ - - title: Creating Multi-Container Pods - path: /docs/user-guide/pods/multi-container/ - - title: Pod Templates - path: /docs/user-guide/pod-templates/ - - title: Assigning Pods to Nodes - path: /docs/user-guide/node-selection/ - - title: Creating Pods with the Downward API - path: /docs/user-guide/downward-api/ - - title: Updating Live Pods - path: /docs/user-guide/update-demo/ - - title: Static Pods - path: /docs/admin/static-pods/ - - title: Installing a Kubernetes Master Node via Docker - path: /docs/getting-started-guides/docker-multinode/master/ - - title: Adding a Kubernetes Worker Node via Docker - path: /docs/getting-started-guides/docker-multinode/worker/ - -- title: Networking - section: - - title: Networking in Kubernetes - path: /docs/admin/networking/ - - title: Creating an External Load Balancer - path: /docs/user-guide/load-balancer/ - - title: Using DNS Pods and Services - path: /docs/admin/dns/ - - title: Setting Up and Configuring DNS - path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/cluster-dns - - title: Deploying DNS - path: /docs/getting-started-guides/docker-multinode/deployDNS/ - - title: Connecting Applications - path: /docs/user-guide/connecting-applications/ - - title: Creating Servers with External IPs - path: https://github.com/kubernetes/kubernetes/blob/release-1.2/examples/simple-nginx.md - - title: Connect with Proxies - path: /docs/user-guide/connecting-to-applications-proxy/ - - title: Connect with Port Forwarding - path: /docs/user-guide/connecting-to-applications-port-forward/ - - title: Configuring Your Cloud Provider's Firewalls - path: /docs/user-guide/services-firewalls/ - - title: Master <-> Node Communication - path: /docs/admin/master-node-communication/ - - title: Network Plugins - path: /docs/admin/network-plugins/ - -- title: Configuring Kubernetes - section: - - title: Using Configuration Files - path: /docs/user-guide/simple-yaml/ - - title: Best Practices for Configuration - path: /docs/user-guide/config-best-practices/ - - title: Configuring Containers - path: /docs/user-guide/configuring-containers/ - - title: Using ConfigMap - path: /docs/user-guide/configmap/ - - title: Sharing Cluster Access with kubeconfig - path: /docs/user-guide/sharing-clusters/ - - title: Using Environment Variables - path: /docs/user-guide/environment-guide/ - - title: Managing Compute Resources - path: /docs/user-guide/compute-resources/ - - title: Using kubectl to Manage Resources - path: /docs/user-guide/working-with-resources/ + - title: Setting Pod CPU and Memory Limits + path: /docs/admin/limitrange/ - title: Understanding Resource Quotas path: /docs/admin/resourcequota/ - title: Applying Resource Quotas and Limits path: /docs/admin/resourcequota/walkthrough/ - - title: Setting Pod CPU and Memory Limits - path: /docs/admin/limitrange/ + - title: Kubernetes Components + path: /docs/admin/cluster-components/ + - title: Configuring Kubernetes Use of etcd + path: /docs/admin/etcd/ + - title: Using Multiple Clusters + path: /docs/admin/multi-cluster/ + - title: Changing Cluster Size + path: https://github.com/kubernetes/kubernetes/wiki/User-FAQ#how-do-i-change-the-size-of-my-cluster/ + - title: Configuring Multiple Schedulers + path: /docs/admin/multiple-schedulers/ + - title: Networking in Kubernetes + path: /docs/admin/networking/ + - title: Using DNS Pods and Services + path: /docs/admin/dns/ + - title: Setting Up and Configuring DNS + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/cluster-dns + - title: Master <-> Node Communication + path: /docs/admin/master-node-communication/ + - title: Network Plugins + path: /docs/admin/network-plugins/ + - title: Static Pods + path: /docs/admin/static-pods/ - title: Configuring Garbage Collection path: /docs/admin/garbage-collection/ - title: Configuring Kubernetes with Salt path: /docs/admin/salt/ - - title: Configuring Kubernetes Use of etcd - path: /docs/admin/etcd/ - -- title: Application Management and Deployment - section: - - title: "Managing Applications: Prerequisites" - path: /docs/user-guide/prereqs/ - - title: Managing Resources - path: /docs/user-guide/managing-deployments/ - - title: Deploying Applications - path: /docs/user-guide/deploying-applications/ - - title: Rolling Update - path: /docs/user-guide/rolling-updates/ - - title: Launching, Exposing, and Killing Applications - path: /docs/user-guide/quick-start/ - - title: Web Interface - path: /docs/user-guide/ui/ - -- title: Testing and Monitoring - section: - - title: Testing a Kubernetes Cluster - path: /docs/getting-started-guides/docker-multinode/testing/ - - title: Simulating Large Test Loads - path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/k8petstore - - title: Checking Pod Health - path: /docs/user-guide/liveness/ - - title: Using Explorer to Examine the Runtime Environment - path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/explorer - - title: Resource Usage Monitoring - path: /docs/user-guide/monitoring/ - - title: Logging - path: /docs/getting-started-guides/logging/ - - title: Logging with Elasticsearch and Kibana - path: /docs/getting-started-guides/logging-elasticsearch/ diff --git a/_data/reference.yml b/_data/reference.yml index 8c51c319ec..70bfba11af 100644 --- a/_data/reference.yml +++ b/_data/reference.yml @@ -163,20 +163,18 @@ toc: - title: kubectl stop path: /docs/user-guide/kubectl/kubectl_stop/ -- title: kube-apiserver CLI - path: /docs/admin/kube-apiserver/ - -- title: kube-proxy CLI - path: /docs/admin/kube-proxy/ - -- title: kube-scheduler CLI - path: /docs/admin/kube-scheduler/ - -- title: kubelet CLI - path: /docs/admin/kubelet/ - -- title: kube-controller-manager CLI - path: /docs/admin/kube-controller-manager/ +- title: Kubernetes Components + section: + - title: kube-apiserver + path: /docs/admin/kube-apiserver/ + - title: kube-proxy + path: /docs/admin/kube-proxy/ + - title: kube-scheduler + path: /docs/admin/kube-scheduler/ + - title: kubelet + path: /docs/admin/kubelet/ + - title: kube-controller-manager + path: /docs/admin/kube-controller-manager/ - title: Glossary section: diff --git a/_data/samples.yml b/_data/samples.yml index e8e5c484c5..3ad519c6be 100644 --- a/_data/samples.yml +++ b/_data/samples.yml @@ -4,67 +4,76 @@ toc: - title: Samples path: /docs/samples/ -- title: Clustered Application Samples +- title: Storage / Database / KV section: - title: Apache Cassandra Database path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/cassandra - - title: Apache Spark - path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/spark - - title: Apache Storm - path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/storm - - title: Distributed Task Queue - path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/celery-rabbitmq + - title: Ceph + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/rbd/ + - title: CephFS + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/cephfs/ + - title: GlusterFS + path: /https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/glusterfs/ - title: Hazelcast path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/hazelcast - - title: Meteor Applications - path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/meteor/ + - title: iSCSI + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/iscsi/ + - title: MySQL Galera + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/mysql-galera + - title: NFS + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/nfs/ - title: Redis path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/redis/ - title: RethinkDB path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/rethinkdb/ - - title: Elasticsearch/Kibana Logging Demonstration - path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/logging-demo/ + - title: Vitess + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/vitess/ + +- title: Big Data + section: + - title: Apache Spark + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/spark + - title: Apache Storm + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/storm + +- title: Messaging / Queueing + section: + - title: Celery + RabbitMQ + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/celery-rabbitmq + - title: Hazelcast + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/hazelcast + +- title: Miscellaneous + section: + - title: Meteor Applications + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/meteor/ - title: Elasticsearch path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/elasticsearch/ - title: OpenShift Origin path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/openshift-origin/ - - title: Ceph - path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/rbd/ - - title: MEAN stack on Google Cloud Platform - path: /docs/getting-started-guides/meanstack/ + - title: Selenium + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/selenium/ -- title: Persistent Volume Samples +- title: Monitoring and Logging section: - - title: Persistent Volumes Walkthrough - path: /docs/user-guide/persistent-volumes/walkthrough/ - - title: WordPress on a Kubernetes Persistent Volume - path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/mysql-wordpress-pd/ - - title: GlusterFS - path: /https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/glusterfs/ - - title: iSCSI - path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/iscsi/ - - title: NFS - path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/nfs/ - - title: Downward API Volumes - path: /docs/user-guide/downward-api/volume + - title: Elasticsearch/Kibana Logging Demonstration + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/logging-demo/ + - title: NewRelic + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/newrelic -- title: Multi-tier Application Samples +- title: Multi-tier Applications section: - title: Guestbook - Go Server path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/guestbook-go/ - title: GuestBook - PHP Server path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/guestbook/ - - title: MySQL - Phabricator Server + - title: MEAN stack on Google Cloud Platform + path: /docs/getting-started-guides/meanstack/ + - title: MySQL + Wordpress + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/mysql-wordpress-pd/ + - title: MySQL + Phabricator Server path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/phabricator/ - -- title: Elasticsearch/Kibana Logging Demo - path: https://github.com/kubernetes/kubernetes.github.io/tree/master/docs/user-guide/logging-demo - -- title: ConfigMap Example - path: https://github.com/kubernetes/kubernetes.github.io/tree/master/docs/user-guide/configmap - -- title: Horizontal Pod Autoscaling Example - path: /docs/user-guide/horizontal-pod-autoscaling/walkthrough/ - -- title: Secrets Walkthrough - path: /docs/user-guide/secrets/walkthrough/ + - title: Nodejs + Mongo + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/nodesjs-mongodb + - title: Petstore + path: https://github.com/kubernetes/kubernetes/tree/release-1.2/examples/k8spetstore/ diff --git a/docs/samples.md b/docs/samples.md index 0347597a6f..d608ab7cbd 100644 --- a/docs/samples.md +++ b/docs/samples.md @@ -1,13 +1,6 @@ --- --- -We have a wide variety of samples to choose from: - -* "Clustered Application Samples" and "Persistent Volume Samples" provide some -examples that show how to implement some popular software packages such as OpenShift, Ceph, Cassandra, and WordPress. These guides -try to serve as canonical walkthroughs that help you use familiar packages with Kubernetes. - -* "Mulit-tier Application Samples" are generally of a more contrived and instructional nature, highlighting key concepts that -you'll encounter when developing with Kubernetes, and teaching some principles of building Kubernetes applications. +We have a wide variety of samples to choose from. ## Recently updated samples diff --git a/index.html b/index.html index c277cf075d..5458d1f5bc 100644 --- a/index.html +++ b/index.html @@ -30,7 +30,7 @@ title: Accelerate Your Delivery
-

Kubernetes is an open-source system for automating deployment, operations, and scaling of containerized applications.

+

Kubernetes is an open-source system for automating deployment, operations, and scaling of containerized applications.

It groups containers that make up an application into logical units for easy management and discovery. Kubernetes builds upon a decade and a half of experience of running production workloads at Google, combined with best-of-breed ideas and practices from the community.