mirror of https://github.com/k3s-io/k3s
Remove kubecfg from all getting started docs.
parent
5de2e916e5
commit
93776b1363
|
@ -34,7 +34,7 @@ The `release.sh` script will build a release. It will build binaries, run tests
|
|||
|
||||
The main output is a tar file: `kubernetes.tar.gz`. This includes:
|
||||
* Cross compiled client utilities.
|
||||
* Script (`cluster/kubecfg.sh`) for picking and running the right client binary based on platform.
|
||||
* Script (`cluster/kubectl.sh`) for picking and running the right client binary based on platform.
|
||||
* Examples
|
||||
* Cluster deployment scripts for various clouds
|
||||
* Tar file containing all server binaries
|
||||
|
|
|
@ -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>
|
||||
```
|
|
@ -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
|
||||
|
|
Loading…
Reference in New Issue