mirror of https://github.com/k3s-io/k3s
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/simple-nginx.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 -->
|
|
|
|
## Running your first containers in Kubernetes
|
|
|
|
Ok, you've run one of the [getting started guides](../../docs/getting-started-guides/) and you have
|
|
successfully turned up a Kubernetes cluster. Now what? This guide will help you get oriented
|
|
to Kubernetes and running your first containers on the cluster.
|
|
|
|
### Running a container (simple version)
|
|
|
|
From this point onwards, it is assumed that `kubectl` is on your path from one of the getting started guides.
|
|
|
|
The [`kubectl run`](kubectl/kubectl_run.md) line below will create two [nginx](https://registry.hub.docker.com/_/nginx/) [pods](pods.md) listening on port 80. It will also create a [replication controller](replication-controller.md) named `my-nginx` to ensure that there are always two pods running.
|
|
|
|
```bash
|
|
kubectl run my-nginx --image=nginx --replicas=2 --port=80
|
|
```
|
|
|
|
Once the pods are created, you can list them to see what is up and running:
|
|
|
|
```bash
|
|
kubectl get pods
|
|
```
|
|
|
|
You can also see the replication controller that was created:
|
|
|
|
```bash
|
|
kubectl get rc
|
|
```
|
|
|
|
To stop the two replicated containers, delete the replication controller:
|
|
|
|
```bash
|
|
kubectl delete rc my-nginx
|
|
```
|
|
|
|
### Exposing your pods to the internet.
|
|
|
|
On some platforms (for example Google Compute Engine) the kubectl command can integrate with your cloud provider to add a [public IP address](services.md#external-services) for the pods,
|
|
to do this run:
|
|
|
|
```bash
|
|
kubectl expose rc my-nginx --port=80 --type=LoadBalancer
|
|
```
|
|
|
|
This should print the service that has been created, and map an external IP address to the service. Where to find this external IP address will depend on the environment you run in. For instance, for Google Compute Engine the external IP address is listed as part of the newly created service and can be retrieved by running
|
|
|
|
```bash
|
|
kubectl get services
|
|
```
|
|
|
|
In order to access your nginx landing page, you also have to make sure that traffic from external IPs is allowed. Do this by opening a firewall to allow traffic on port 80.
|
|
|
|
### Next: Configuration files
|
|
|
|
Most people will eventually want to use declarative configuration files for creating/modifying their applications. A [simplified introduction](deploying-applications.md)
|
|
is given in a different document.
|
|
|
|
|
|
<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
|
|
[]()
|
|
<!-- END MUNGE: GENERATED_ANALYTICS -->
|