mirror of
				https://github.com/optim-enterprises-bv/kubernetes.git
				synced 2025-11-03 19:58:17 +00:00 
			
		
		
		
	Remove kubecfg from all getting started docs.
This commit is contained in:
		@@ -14,7 +14,7 @@ The example below creates an elastic Kubernetes cluster with 3 worker nodes and
 | 
			
		||||
 | 
			
		||||
## Prerequisites
 | 
			
		||||
 | 
			
		||||
* [kubecfg CLI](aws/kubecfg.md)
 | 
			
		||||
* [kubectl CLI](aws/kubectl.md)
 | 
			
		||||
* [aws CLI](http://aws.amazon.com/cli)
 | 
			
		||||
* [CoreOS image for AWS](https://coreos.com/docs/running-coreos/cloud-providers/ec2/#choosing-a-channel)
 | 
			
		||||
 | 
			
		||||
@@ -42,7 +42,7 @@ aws cloudformation describe-stack-events --stack-name kubernetes
 | 
			
		||||
aws cloudformation describe-stacks --stack-name kubernetes
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
[Skip to kubecfg client configuration](#configure-the-kubecfg-ssh-tunnel)
 | 
			
		||||
[Skip to kubectl client configuration](#configure-the-kubectl-ssh-tunnel)
 | 
			
		||||
 | 
			
		||||
### Manually
 | 
			
		||||
 | 
			
		||||
@@ -121,9 +121,9 @@ aws ec2 run-instances --count 1 --image-id <ami_image_id> --key-name <keypair> \
 | 
			
		||||
--user-data file://node.yaml
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Configure the kubecfg SSH tunnel
 | 
			
		||||
### Configure the kubectl SSH tunnel
 | 
			
		||||
 | 
			
		||||
This command enables secure communication between the kubecfg client and the Kubernetes API.
 | 
			
		||||
This command enables secure communication between the kubectl client and the Kubernetes API.
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
ssh -f -nNT -L 8080:127.0.0.1:8080 core@<master-public-ip>
 | 
			
		||||
@@ -134,7 +134,7 @@ ssh -f -nNT -L 8080:127.0.0.1:8080 core@<master-public-ip>
 | 
			
		||||
Once the worker instances have fully booted, they will be automatically registered with the Kubernetes API server by the kube-register service running on the master node. It may take a few mins.
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
kubecfg list minions
 | 
			
		||||
kubectl get nodes
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Starting a simple pod
 | 
			
		||||
@@ -167,16 +167,16 @@ Create a pod manifest: `pod.json`
 | 
			
		||||
}
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Create the pod using the kubecfg command line tool
 | 
			
		||||
### Create the pod using the kubectl command line tool
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
kubecfg -c pod.json create pods
 | 
			
		||||
kubectl create -f pod.json
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Testing
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
kubecfg list pods
 | 
			
		||||
kubectl get pods
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
> Record the **Host** of the pod, which should be the private IP address.
 | 
			
		||||
@@ -208,5 +208,5 @@ Visit the public IP address in your browser to view the running pod.
 | 
			
		||||
### Delete the pod
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
kubecfg delete pods/hello
 | 
			
		||||
kubectl delete pods hello
 | 
			
		||||
```
 | 
			
		||||
 
 | 
			
		||||
@@ -1,28 +0,0 @@
 | 
			
		||||
# Install and configure kubecfg
 | 
			
		||||
 | 
			
		||||
## Download the kubecfg CLI tool
 | 
			
		||||
 | 
			
		||||
### Darwin
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
wget http://storage.googleapis.com/k8s/darwin/kubecfg
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Linux
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
wget http://storage.googleapis.com/k8s/linux/kubecfg
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Copy kubecfg to your path
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
chmod +x kubecfg
 | 
			
		||||
mv kubecfg /usr/local/bin/
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Create a secure tunnel for API communication
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
ssh -f -nNT -L 8080:127.0.0.1:8080 core@<master-public-ip>
 | 
			
		||||
```
 | 
			
		||||
							
								
								
									
										28
									
								
								docs/getting-started-guides/aws/kubectl.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										28
									
								
								docs/getting-started-guides/aws/kubectl.md
									
									
									
									
									
										Normal file
									
								
							@@ -0,0 +1,28 @@
 | 
			
		||||
# Install and configure kubecfg
 | 
			
		||||
 | 
			
		||||
## Download the kubecfg CLI tool
 | 
			
		||||
 | 
			
		||||
### Darwin
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
wget https://storage.googleapis.com/kubernetes-release/release/v0.9.2/bin/darwin/amd64/kubectl
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Linux
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
wget https://storage.googleapis.com/kubernetes-release/release/v0.9.2/bin/linux/amd64/kubectl
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Copy kubectl to your path
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
chmod +x kubectl
 | 
			
		||||
mv kubectl /usr/local/bin/
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Create a secure tunnel for API communication
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
ssh -f -nNT -L 8080:127.0.0.1:8080 core@<master-public-ip>
 | 
			
		||||
```
 | 
			
		||||
@@ -34,21 +34,26 @@ can tweak some of these parameters by editing `cluster/azure/config-default.sh`.
 | 
			
		||||
 | 
			
		||||
### Running a container (simple version)
 | 
			
		||||
 | 
			
		||||
The `cluster/kubecfg.sh` command below spins up two containers, running [Nginx](http://nginx.org/en/) and with port 80 mapped to 8080:
 | 
			
		||||
Once you have your instances up and running, the `hack/build-go.sh` script sets up
 | 
			
		||||
your Go workspace and builds the Go components.
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
cd kubernetes
 | 
			
		||||
cluster/kubecfg.sh -p 8080:80 run dockerfile/nginx 2 myNginx
 | 
			
		||||
The `kubectl.sh` line below spins up two containers running
 | 
			
		||||
[Nginx](http://nginx.org/en/) running on port 80:
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
cluster/kubectl.sh run-container my-nginx --image=dockerfile/nginx --replicas=2 --port=80
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
To stop the containers:
 | 
			
		||||
```
 | 
			
		||||
cluster/kubecfg.sh stop myNginx
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
cluster/kubectl.sh stop rc my-nginx
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
To delete the containers:
 | 
			
		||||
```
 | 
			
		||||
cluster/kubecfg.sh rm myNginx
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
cluster/kubectl.sh delete rc my-nginx
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Running a container (more complete version)
 | 
			
		||||
 
 | 
			
		||||
@@ -50,23 +50,23 @@ field values:
 | 
			
		||||
Once you have your instances up and running, the `hack/build-go.sh` script sets up
 | 
			
		||||
your Go workspace and builds the Go components.
 | 
			
		||||
 | 
			
		||||
The `kubecfg.sh` line below spins up two containers running
 | 
			
		||||
[Nginx](http://nginx.org/en/) with port 80 mapped to 8080:
 | 
			
		||||
The `kubectl.sh` line below spins up two containers running
 | 
			
		||||
[Nginx](http://nginx.org/en/) running on port 80:
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
cluster/kubecfg.sh -p 8080:80 run dockerfile/nginx 2 myNginx
 | 
			
		||||
cluster/kubectl.sh run-container my-nginx --image=dockerfile/nginx --replicas=2 --port=80
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
To stop the containers:
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
cluster/kubecfg.sh stop myNginx
 | 
			
		||||
cluster/kubectl.sh stop rc my-nginx
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
To delete the containers:
 | 
			
		||||
 | 
			
		||||
```bash
 | 
			
		||||
cluster/kubecfg.sh rm myNginx
 | 
			
		||||
cluster/kubectl.sh delete rc my-nginx
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
### Running a container (more complete version)
 | 
			
		||||
 
 | 
			
		||||
@@ -30,7 +30,7 @@ hack/local-up-cluster.sh
 | 
			
		||||
This will build and start a lightweight local cluster, consisting of a master
 | 
			
		||||
and a single minion. Type Control-C to shut it down.
 | 
			
		||||
 | 
			
		||||
You can use the cluster/kubecfg.sh script to interact with the local cluster.
 | 
			
		||||
You can use the cluster/kubectl.sh script to interact with the local cluster.
 | 
			
		||||
You must set the KUBERNETES_PROVIDER and KUBERNETES_MASTER environment variables to let other programs
 | 
			
		||||
know how to reach your master.
 | 
			
		||||
 | 
			
		||||
@@ -43,13 +43,13 @@ export KUBERNETES_MASTER=http://localhost:8080
 | 
			
		||||
 | 
			
		||||
Your cluster is running, and you want to start running containers!
 | 
			
		||||
 | 
			
		||||
You can now use any of the cluster/kubecfg.sh commands to interact with your local setup.
 | 
			
		||||
You can now use any of the cluster/kubectl.sh commands to interact with your local setup.
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
cluster/kubectl.sh get pods
 | 
			
		||||
cluster/kubectl.sh get services
 | 
			
		||||
cluster/kubectl.sh get replicationControllers
 | 
			
		||||
cluster/kubecfg.sh -p 8081:80 run dockerfile/nginx 1 myNginx
 | 
			
		||||
cluster/kubectl.sh run-container my-nginx --image=dockerfile/nginx --replicas=2 --port=80
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
## begin wait for provision to complete, you can monitor the docker pull by opening a new terminal
 | 
			
		||||
 
 | 
			
		||||
@@ -25,7 +25,7 @@ $ sudo ./util.sh
 | 
			
		||||
 | 
			
		||||
After this the kubernetes and `etcd` services would be up and running. You can use `service start/stop/restart/force-reload` on the services.
 | 
			
		||||
 | 
			
		||||
Launching and scheduling containers using kubecfg can also be used at this point, as explained mentioned in the [examples](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/examples/guestbook)
 | 
			
		||||
Launching and scheduling containers using kubectl can also be used at this point, as explained mentioned in the [examples](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/examples/guestbook)
 | 
			
		||||
 | 
			
		||||
### 3. Customizing the ubuntu launch
 | 
			
		||||
To customize the defaults you will need to tweak `/etc/default/kube*` files and restart the appropriate services. This is needed if the binaries are copied in a place other than `/opt/bin`. A run could look like
 | 
			
		||||
 
 | 
			
		||||
@@ -178,10 +178,9 @@ NAME   IMAGE(S   SELECTOR   REPLICAS
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Start a container running nginx with a replication controller and three replicas
 | 
			
		||||
(note that this step uses the `kubecfg.sh` command instead of `kubectl.sh`):
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
$ cluster/kubecfg.sh -p 8080:80 run dockerfile/nginx 3 myNginx
 | 
			
		||||
$ cluster/kubectl.sh run-container my-nginx --image=dockerfile/nginx --replicas=3 --port=80
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
When listing the pods, you will see that three containers have been started and are in Waiting state:
 | 
			
		||||
@@ -231,7 +230,7 @@ NAME   LABELS   SELECTOR   IP   PORT
 | 
			
		||||
 | 
			
		||||
$ cluster/kubectl.sh get replicationControllers
 | 
			
		||||
NAME      IMAGE(S            SELECTOR       REPLICAS
 | 
			
		||||
myNginx   dockerfile/nginx   name=myNginx   3
 | 
			
		||||
myNginx   dockerfile/nginx   name=my-nginx   3
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
We did not start any services, hence there are none listed. But we see three replicas displayed properly.
 | 
			
		||||
@@ -239,7 +238,7 @@ Check the [guestbook](../../examples/guestbook/README.md) application to learn h
 | 
			
		||||
You can already play with resizing the replicas with:
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
$ cluster/kubecfg.sh resize myNginx 2
 | 
			
		||||
$ cluster/kubectl.sh resize rc my-nginx --replicas=2
 | 
			
		||||
$ cluster/kubectl.sh get pods
 | 
			
		||||
NAME                                   IMAGE(S)            HOST                    LABELS         STATUS
 | 
			
		||||
7813c8bd-3ffe-11e4-9036-0800279696e1   dockerfile/nginx    10.245.2.2/10.245.2.2   name=myNginx   Running
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user