github
/
k3s
mirror of https://github.com/k3s-io/k3s
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update README.md

pull/6/head
MikeJeffrey 2014-06-08 20:05:26 -07:00
parent e9b61b77cb
commit 7d9a58bc4e
1 changed files with 24 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
README.md
View File

@ -6,43 +6,58 @@ Kubernetes is an open source reference implementation of container cluster manag
### Prerequisites ### Prerequisites
1. You need a Google Cloud Platform account with billing enabled. Visit http://cloud.google.com/console for more details 1. You need a Google Cloud Platform account with billing enabled. Visit [http://cloud.google.com/console]() for more details
2. You must have Go installed: [www.golang.org](http://www.golang.org) 2. You must have Go installed: [www.golang.org](http://www.golang.org).
3. Ensure that your `gcloud` components are up-to-date by running `gcloud components update`. 3. Ensure that your `gcloud` components are up-to-date by running `gcloud components update`.
4. Get the Kubernetes source: `git clone https://github.com/GoogleCloudPlatform/kubernetes.git` 4. Get the Kubernetes source:
git clone https://github.com/GoogleCloudPlatform/kubernetes.git
### Setup ### Setup
The setup script builds Kubernetes, then creates Google Compute Engine instances, firewall rules, and routes:
``` ```
cd kubernetes cd kubernetes
hack/dev-build-and-up.sh hack/dev-build-and-up.sh
``` ```
### Running a container (simple version) ### Running a container (simple version)
Once you have your instances up and running, the `build-go.sh` script sets up
your Go workspace and builds the Go components.
The `cloudcfg.sh` script spins up two containers, running [Nginx](http://nginx.org/en/) and with port 80 mapped to 8080:
``` ```
cd kubernetes cd kubernetes
hack/build-go.sh hack/build-go.sh
cluster/cloudcfg.sh -p 8080:80 run dockerfile/nginx 2 myNginx cluster/cloudcfg.sh -p 8080:80 run dockerfile/nginx 2 myNginx
``` ```
This will spin up two containers running Nginx mapping port 80 to 8080. To stop the containers:
To stop the container:
``` ```
cluster/cloudcfg.sh stop myNginx cluster/cloudcfg.sh stop myNginx
``` ```
To delete the container: To delete the containers:
``` ```
cluster/cloudcfg.sh rm myNginx cluster/cloudcfg.sh rm myNginx
``` ```
### Running a container (more complete version) ### Running a container (more complete version)
Assuming you've run `hack/dev-build-and-up.sh` and `hack/build-go.sh`:
``` ```
cd kubernetes cd kubernetes
cluster/cloudcfg.sh -c examples/task.json create /tasks cluster/cloudcfg.sh -c api/examples/task.json create /tasks
``` ```
Where task.json contains something like: Where task.json contains something like:
``` ```
{ {
"ID": "nginx", "ID": "nginx",
@ -59,7 +74,7 @@ Where task.json contains something like:
} }
``` ```
Look in the `examples/` for more examples Look in `api/examples/` for more examples
### Tearing down the cluster ### Tearing down the cluster
``` ```