mirror of
				https://github.com/optim-enterprises-bv/kubernetes.git
				synced 2025-11-03 19:58:17 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			95 lines
		
	
	
		
			3.4 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			95 lines
		
	
	
		
			3.4 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
<!-- BEGIN MUNGE: UNVERSIONED_WARNING -->
 | 
						||
 | 
						||
<!-- BEGIN STRIP_FOR_RELEASE -->
 | 
						||
 | 
						||
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
 | 
						||
     width="25" height="25">
 | 
						||
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
 | 
						||
     width="25" height="25">
 | 
						||
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
 | 
						||
     width="25" height="25">
 | 
						||
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
 | 
						||
     width="25" height="25">
 | 
						||
<img src="http://kubernetes.io/img/warning.png" alt="WARNING"
 | 
						||
     width="25" height="25">
 | 
						||
 | 
						||
<h2>PLEASE NOTE: This document applies to the HEAD of the source tree</h2>
 | 
						||
 | 
						||
If you are using a released version of Kubernetes, you should
 | 
						||
refer to the docs that go with that version.
 | 
						||
 | 
						||
<!-- TAG RELEASE_LINK, added by the munger automatically -->
 | 
						||
<strong>
 | 
						||
The latest release of this document can be found
 | 
						||
[here](http://releases.k8s.io/release-1.1/docs/user-guide/prereqs.md).
 | 
						||
 | 
						||
Documentation for other releases can be found at
 | 
						||
[releases.k8s.io](http://releases.k8s.io).
 | 
						||
</strong>
 | 
						||
--
 | 
						||
 | 
						||
<!-- END STRIP_FOR_RELEASE -->
 | 
						||
 | 
						||
<!-- END MUNGE: UNVERSIONED_WARNING -->
 | 
						||
 | 
						||
# Kubernetes User Guide: Managing Applications: Prerequisites
 | 
						||
 | 
						||
To deploy and manage applications on Kubernetes, you’ll use the Kubernetes command-line tool, [kubectl](kubectl/kubectl.md). It lets you inspect your cluster resources, create, delete, and update components, and much more. You will use it to look at your new cluster and bring up example apps.
 | 
						||
 | 
						||
## Installing kubectl
 | 
						||
 | 
						||
If you downloaded a pre-compiled [release](https://github.com/kubernetes/kubernetes/releases), kubectl should be under `platforms/<os>/<arch>` from the tar bundle.
 | 
						||
 | 
						||
If you built from source, kubectl should be either under `_output/local/bin/<os>/<arch>` or `_output/dockerized/bin/<os>/<arch>`.
 | 
						||
 | 
						||
The kubectl binary doesn't have to be installed to be executable, but the rest of the walkthrough will assume that it's in your PATH.
 | 
						||
 | 
						||
The simplest way to install is to copy or move kubectl into a dir already in PATH (e.g. `/usr/local/bin`). For example:
 | 
						||
 | 
						||
```console
 | 
						||
# OS X
 | 
						||
$ sudo cp kubernetes/platforms/darwin/amd64/kubectl /usr/local/bin/kubectl
 | 
						||
# Linux
 | 
						||
$ sudo cp kubernetes/platforms/linux/amd64/kubectl /usr/local/bin/kubectl
 | 
						||
```
 | 
						||
 | 
						||
You also need to ensure it's executable:
 | 
						||
 | 
						||
```console
 | 
						||
$ sudo chmod +x /usr/local/bin/kubectl
 | 
						||
```
 | 
						||
 | 
						||
If you prefer not to copy kubectl, you need to ensure the tool is in your path:
 | 
						||
 | 
						||
```bash
 | 
						||
# OS X
 | 
						||
export PATH=<path/to/kubernetes-directory>/platforms/darwin/amd64:$PATH
 | 
						||
 | 
						||
# Linux
 | 
						||
export PATH=<path/to/kubernetes-directory>/platforms/linux/amd64:$PATH
 | 
						||
```
 | 
						||
 | 
						||
## Configuring kubectl
 | 
						||
 | 
						||
In order for kubectl to find and access the Kubernetes cluster, it needs a [kubeconfig file](kubeconfig-file.md), which is created automatically when creating a cluster using kube-up.sh (see the [getting started guides](../../docs/getting-started-guides/) for more about creating clusters). If you need access to a cluster you didn’t create, see the [Sharing Cluster Access document](sharing-clusters.md).
 | 
						||
By default, kubectl configuration lives at `~/.kube/config`.
 | 
						||
 | 
						||
#### Making sure you're ready
 | 
						||
 | 
						||
Check that kubectl is properly configured by getting the cluster state:
 | 
						||
 | 
						||
```console
 | 
						||
$ kubectl cluster-info
 | 
						||
```
 | 
						||
 | 
						||
If you see a url response, you are ready to go.
 | 
						||
 | 
						||
## What's next?
 | 
						||
 | 
						||
[Learn how to launch and expose your application.](quick-start.md)
 | 
						||
 | 
						||
 | 
						||
<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 | 
						||
[]()
 | 
						||
<!-- END MUNGE: GENERATED_ANALYTICS -->
 |