more menu setup

This commit is contained in:
lvuch
2018-04-23 17:02:17 -07:00
parent 52b6de4f9c
commit 3b7bc89e41
82 changed files with 599 additions and 273 deletions
+1 -1
View File
@@ -1,7 +1,7 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "category"
layout: list-docs
title: homepage
weight: 4
---
+2 -1
View File
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "overview"]
category: ["os"]
title: RancherOS Documentation
description: RancherOS is a simplified Linux distribution built from containers, for containers. These documents describe how to install and use RancherOS.
weight: 1
+2 -1
View File
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "faqs"]
category: "os"
title: About
weight: 300
---
+2 -1
View File
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "faqs"]
category: "os"
title: FAQs
weight: 301
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "rancher"]
category: "os"
title: Running Rancher on RancherOS
weight: 302
---
+2 -1
View File
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "security"]
category: "os"
title: RancherOS Security
weight: 303
---
+2 -1
View File
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "custom", "console"]
category: "os"
title: Amazon ECS (EC2 Container Service)
weight: 190
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "system services"]
category: "os"
title: Built-in System Services
weight: 150
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "cloud-init"]
category: "os"
title: Cloud-Init
weight: 151
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os"]
category: "os"
title: Image Preloading
weight: 152
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "logging"]
category: "os"
title: System Logging
weight: 153
---
@@ -1,5 +1,4 @@
---
layout: list-docs
title: Configuration
weight: 120
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os"]
category: "os"
title: Adding Kernel Parameters
weight: 133
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "docker", "system docker"]
category: "os"
title: Configuring Docker or System Docker
weight: 126
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os"]
category: "os"
title: Setting the Hostname
weight: 124
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os"]
category: "os"
title: Installing Kernel Modules with Kernel Headers
weight: 135
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os"]
category: "os"
title: Loading Extra Kernel Modules
weight: 134
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os"]
category: "os"
title: Private Registries
weight: 128
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os"]
category: "os"
title: Resizing a Device Partition
weight: 131
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "commands"]
category: "os"
title: Running Commands
weight: 123
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "docker", "tls"]
category: "os"
title: Setting up Docker TLS
weight: 127
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "ssh"]
category: "os"
title: SSH Keys
weight: 121
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "consoles"]
category: "os"
title: Switching Consoles
weight: 125
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "docker"]
category: "os"
title: Switching Docker Versions
weight: 129
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os"]
category: "os"
title: sysctl Settings
weight: 132
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os"]
category: "os"
title: Users
weight: 130
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os"]
category: "os"
title: Writing Files
weight: 122
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "custom", "console"]
category: "os"
title: Custom Console
weight: 180
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "custom", "kernels"]
category: "os"
title: Custom Kernels
weight: 181
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "custom", "iso"]
category: "os"
title: Custom RancherOS ISO
weight: 182
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "networking", "dns"]
category: "os"
title: Configuring DNS
weight: 171
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "networking", "interfaces"]
category: "os"
title: Configuring Network Interfaces
weight: 170
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "proxy"]
category: "os"
title: Configuring Proxy Settings
weight: 172
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "installation"]
category: "os"
title: Running RancherOS
weight: 100
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "amazon", "ec2"]
category: "os"
title: Amazon EC2
weight: 105
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "azure"]
category: "os"
title: Azure
weight: 110
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "digitalocean"]
category: "os"
title: Digital Ocean
weight: 107
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "gce"]
category: "os"
title: Google Cloud Engine (GCE)
weight: 106
---
@@ -14,11 +15,8 @@ weight: 106
RancherOS is available as an image in GCE, and can be easily run in Google Compute Engine (GCE). Let’s walk through how to upload GCE image.
1. Download the most recent RancherOS image. The image can be found in the [release artifacts](https://github.com/rancher/os/releases). It is a `.tar.gz` file.
2. Follow Google's instructions on how to [upload the image](https://cloud.google.com/compute/docs/tutorials/building-images#publishingimage). The image must be uploaded into a Google Cloud Storage bucket before it can be added to a project.
3. Follow Google's instructions on how to [import a RAW image](https://cloud.google.com/compute/docs/images/import-existing-image#use_saved_image).
4. Once the image is added to your Google Compute Engine, we can start creating new instances!
### Launching RancherOS using `gcloud compute`
@@ -81,18 +79,12 @@ Updated [https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE_OF
After the image is uploaded, it's easy to use the console to create new instances. You will **not** be able to upload your own cloud config file when creating instances through the console. You can add it after the instance is created using `gcloud compute` commands and resetting the instance.
1. Make sure you are in the project that the image was created in.
![RancherOS on GCE 4]({{< baseurl >}}/img/os/Rancher_gce4.png)
![RancherOS on GCE 4]({{< baseurl >}}/img/os/Rancher_gce4.png)
2. In the navigation bar, click on the **VM instances**, which is located at Compute -> Compute Engine -> Metadata. Click on **Create instance**.
![RancherOS on GCE 5]({{< baseurl >}}/img/os/Rancher_gce5.png)
2. Fill out the information for your instance. In the **Image** dropdown, your private image will be listed among the public images provided by Google. Select the private image for RancherOS. Click **Create**.
![RancherOS on GCE 6]({{< baseurl >}}/img/os/Rancher_gce6.png)
3. Your instance is being created and will be up and running shortly!
![RancherOS on GCE 5]({{< baseurl >}}/img/os/Rancher_gce5.png)
3. Fill out the information for your instance. In the **Image** dropdown, your private image will be listed among the public images provided by Google. Select the private image for RancherOS. Click **Create**.
![RancherOS on GCE 6]({{< baseurl >}}/img/os/Rancher_gce6.png)
4. Your instance is being created and will be up and running shortly!
#### Adding SSH keys
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "openstack"]
category: "os"
title: OpenStack
weight: 109
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "vmware", "esxi"]
category: "os"
title: VMware ESXi
weight: 108
---
@@ -1,5 +1,4 @@
---
layout: list-docs
title: Installing to Disk
weight: 111
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "pxe", "ipxe"]
category: "os"
title: iPXE
weight: 112
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "raspberry pi"]
category: "os"
title: Raspberry Pi
weight: 113
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "iso"]
category: "os"
title: Booting from ISO
weight: 102
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "docker machine"]
category: "os"
title: Using Docker Machine
weight: 101
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "mounts"]
category: "os"
title: Additional Mounts
weight: 161
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os"]
category: "os"
title: Persistent State Partition
weight: 160
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "zfs"]
category: "os"
title: Using ZFS
weight: 162
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "system services"]
category: "os"
title: System Services
weight: 140
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "system services"]
category: "os"
title: Custom System Services
weight: 141
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "system services", "environment"]
category: "os"
title: Environment
weight: 143
---
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "system services"]
category: "os"
title: System Docker Volumes
weight: 142
---
+2 -1
View File
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "quick-start-guide"]
category: "os"
title: Quick Start Guide
weight: 2
---
+2 -1
View File
@@ -1,5 +1,6 @@
---
layout: list-docs
tag: ["rancheros", "os", "upgrade"]
category: "os"
title: Upgrading RancherOS
weight: 200
---
-10
View File
@@ -1,10 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "category"
layout: list-docs
title: Five
weight: 5
---
hello
@@ -1,8 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "categories"
layout: single-docs
title: placeholder
---
# Five tasks placeholder md
-10
View File
@@ -1,10 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "category"
layout: list-docs
title: Four
weight: 4
---
hello
@@ -1,8 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "categories"
layout: single-docs
title: placeholder
---
# four tasks placeholder md
-10
View File
@@ -1,10 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "category"
layout: list-docs
title: One
weight: 1
---
hello
@@ -1,8 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "categories"
layout: single-docs
title: placeholder a
---
# one tasks placeholder md
@@ -1,8 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "categories"
layout: single-docs
title: placeholder b
---
# two tasks placeholder md
@@ -1,8 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "categories"
layout: single-docs
title: placeholder c
---
# three tasks placeholder md
@@ -1,10 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "category"
layout: list-docs
title: one nested
weight: 2
---
hello
@@ -1,8 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "categories"
layout: single-docs
title: one nested a
---
# two tasks placeholder md
@@ -1,8 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "categories"
layout: single-docs
title: placeholder a
---
# one tasks placeholder md
@@ -1,8 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "categories"
layout: single-docs
title: placeholder c
---
# three tasks placeholder md
@@ -1,8 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "categories"
layout: single-docs
title: placeholder b
---
# two tasks placeholder md
-10
View File
@@ -1,10 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "category"
layout: list-docs
title: Three
weight: 3
---
hello
@@ -1,8 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "categories"
layout: single-docs
title: placeholder
---
# three tasks placeholder md
-10
View File
@@ -1,10 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "category"
layout: list-docs
title: Two
weight: 2
---
hello
@@ -1,8 +0,0 @@
---
tag: ["tag1", "tag2", "tag3"]
category: "categories"
layout: single-docs
title: two placeholder
---
# two tasks placeholder md
+2 -1
View File
@@ -1,5 +1,6 @@
---
layout: single-docs
tag: ["rancher", "overview"]
title: Rancher 2.0 Documentation
weight: 1
---
+2 -1
View File
@@ -1,5 +1,6 @@
---
layout: single-docs
tag: ["rancher", "concepts"]
title: Rancher Overview
weight: 2000
---
+9
View File
@@ -0,0 +1,9 @@
---
tag: ["rancher", "installation"]
title: Installation
weight: 100
---
Notes: Installation Scenarios
A directory of install scenarios. Each scenario offers a synopsis.
+323 -17
View File
@@ -1,5 +1,6 @@
---
layout: single-docs
tag: ["rancher", "quick start"]
category: "rancher"
title: Quick Start Guide
weight: 25
chapter: true
@@ -19,6 +20,7 @@ This Quick Start Guide is divided into different tasks for easier consumption.
1. [Provision a Linux Host](#provision-a-linux-host)
<<<<<<< HEAD
Begin by provisioning a Linux host.
2. [Install Rancher](#install-rancher)
@@ -52,63 +54,162 @@ Begin creation of a custom cluster by provisioning a Linux host. Your host can b
- A cloud-host virtual machine (VM)
- An on-premise VM
- A bare-metal server
=======
1. [Review Requirements](#host-and-node-requirements)
Before you do anything, review the requirements.
2. [Prepare a Linux Host](#prepare-a-linux-host)
First, you need to provision a Linux host.
3. [Install Rancher](#install-rancher)
Run the Docker command for installing Rancher.
4. [Log In](#log-in)
Browse to your Linux host to access the Rancher UI.
5. [Create a Cluster](#create-a-cluster)
Use Rancher to create your first cluster.
6. [Deploy a Workload](#deploy-a-workload)
Create a workload so that Kubernetes can distribute an application and its dependencies among your nodes.
7. [View Your Application](#view-your-application)
When your workload finishes deployment, browse to your application to make sure it works.
8. [What's Next?](#whats-next)
Now that you've created a cluster and deployed a workload, find out what else you can do with Rancher v2.0.
>>>>>>> more menu setup
Provision the host according to the requirements below.
#### Hardware Requirements
- Memory: 4GB
- Memory: 4GB
#### Software requirements
- Operating System: Ubuntu 16.04 (64-bit)
- Software: Docker
- Operating System: Ubuntu 16.04 (64-bit)
- Software: Docker
<a name="node-requirements"></a>**Supported Versions:**
<a name="node-requirements"></a>**Supported Versions:**
- `1.12.6`
- `1.13.1`
- `17.03.2`
- `1.12.6`
- `1.13.1`
- `17.03.2`
>**Notes:**
>
> * For Docker installation instructions, visit their [documentation](https://docs.docker.com/install/).
> * Docker requirements apply to both your Linux host and your cluster nodes.
>**Notes:**
>
> * For Docker installation instructions, visit their [documentation](https://docs.docker.com/install/).
> * Docker requirements apply to both your Linux host and your cluster nodes.
<<<<<<< HEAD
=======
#### Port Requirements
When provisioning your Linux host, open the ports listed below so that your master and worker nodes can communicate.
##### Master Nodes (etcd and controlplane nodes)
Protocol | Direction | Port Range | Purpose
--|---|---|--
TCP | Inbound | 22 | SSH server
TCP | Inbound | 80 | Canal
TCP | Inbound | 443 | Canal
TCP | Inbound | 6443 | Kubernetes API server
TCP | Inbound | 2379-2380 | etcd server client API
TCP | Inbound | 10250 | kubelet API
TCP | Inbound | 10251 | scheduler
TCP | Inbound | 10252 | controller
TCP | Inbound | 10256 | kubeproxy
##### Worker Nodes
Protocol | Direction | Port Range | Purpose
--|---|---|--
TCP | Inbound | 22 | SSH Server
TCP | Inbound | 80 | Canal
TCP | Inbound | 443 | Canal
TCP | Inbound | 10250 | kubelet API
TCP | Inbound | 10256 | kubeproxy
TCP | Inbound | 30000-32767 | NodePort Services
### Prepare a Linux Host
Begin by provisioning a Linux host to be your Rancher server and a template for your cluster nodes. This host can be:
- A virtual machine hosted by a cloud service.
- An on-premise virtual machine.
- An on-premise bare-metal server.
Provision the server according to the [requirements above](#host-and-node-requirements).
>>>>>>> more menu setup
### Install Rancher
To install Rancher on your host, connect to it and then use a shell to install.
1. Log in to your Linux host using your preferred shell, such as PuTTy or a remote Terminal connection.
1. Log in to your Linux host using your preferred shell, such as PuTTy or a remote Terminal connection.
2. From your shell, enter the following command:
2. From your shell, enter the following command:
<<<<<<< HEAD
```
$ sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 rancher/server
```
=======
```
$ sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 rancher/server:preview
```
>**Note:**
> Although Rancher v2.0 is in beta, the `preview` tag is still used for installation.
>>>>>>> more menu setup
**Result:** Rancher is installed.
### Log In
Log in to Rancher to begin using the application. After you log in, you'll make some one-time configurations.
1. Open a web browser and enter the IP address of your host:
1. Open a web browser and enter the IP address of your host:
`https://<SERVER_IP>`
`https://<SERVER_IP>`
Replace `<SERVER_IP>` with your host IP address.
Replace `<SERVER_IP>` with your host IP address.
<<<<<<< HEAD
2. When prompted, create a password for the default `admin` account there cowpoke!
=======
> **Note:** Rancher v2.0 beta:
>
> - Supports only the HTTPS protocol.
> - Uses a self-signed certificate. Due to this signature, the browser prompts you to trust the certificate before login. Following GA, you'll be able to use your own certificate.
2. When prompted, create a password for the default `admin` account there cowpoke!
>>>>>>> more menu setup
3. Set the **Rancher Server URL**. The URL can either be an IP address or a host name. However, each node in your cluster must be able to resolve to the URL.
<<<<<<< HEAD
## Create the Cluster
=======
![login](../../../../img/rancher/server-url.png)
>>>>>>> more menu setup
Welcome to {{< product >}}! Use our application to clone your Linux host and configure them as a Kubernetes cluster.
In this task, use the versatile **Custom** option. This option lets you convert _any_ Linux host (cloud-hosted VM, on-premise VM, or bare-metal) into a cluster.
<<<<<<< HEAD
1. From the **Clusters** page, click **Add Cluster**.
2. Choose **Custom**.
@@ -130,6 +231,87 @@ In this task, use the versatile **Custom** option. This option lets you convert
10. When you finish running the command on your Linux host, click **Done**.
{{< result_create-cluster >}}
=======
1. Click **+ Add Cluster**.
![add cluster](../../../../img/rancher/click-add-cluster.png)
**Step Result:** The **Add Cluster** page opens.
2. From the **Add Cluster** menu, choose a service or source from which to create your first cluster.
* If you're using a virtual machine hosted on a major cloud service, choose the tile for the service you want to use (e.g. **Digital Ocean**, **Azure Container Service**).
* If you're using bare-metal server, an on-premise virtual machine, or a cloud service that isn't explicitly listed, choose **Custom**.
> **Note:**
>
> - For Rancher v2.0 beta, Amazon EKS is not supported. This option will be available after GA.
> - For this tutorial, the Import option is out of scope. For now, create a cluster using one of the other options. We'll address Import later.
3. Enter a **Cluster Name**. No spaces allowed.
> **Tip:** Skip adding **Member Roles** for now. This option isn't essential for your first cluster.
>
> ![skip member roles](../../../../img/rancher/skip-member-roles.png)
4. **For those using Google Container Engine or Azure Container Service:**
Complete the form asking for account information. The form includes links to instructions detailing how to obtain this info.
![gce-azure-instructions](../../../../img/rancher/gce-azure-instructions.png)
**Did you choose one of the other tiles (like Digital Ocean)?** This step doesn't apply to you. Skip to the next step.
5. Select **Cluster Options**.
Use these options to choose things like the version of Kubernetes that's installed in your cluster, along with other Kubernetes options such as pod security policies. Some services have more options than others. If you're unsure of what to choose, use the default options.
6. Add at least one **Node Pool**.
A *Node Pool* is a group of nodes that are configured identically. Your cluster can contain as many node pools as you'd like. Each object in the grid represents a single node configuration. You can use the node pool to choose the number (i.e. **Count**) of nodes running a given configuration (i.e. **Template**).
> **Note:** The instructions below don't apply to Google Container Engine, Azure Container Service, or the Custom option.
>
>* For Azure Container Server, no additional steps are needed. Proceed to this task's [final step](#create-cluster).
>* For Google Container Engine, complete the Nodes form. The options are pretty self-explanatory. When you're done, proceed to this task's [final step](#create-cluster).
>* For Custom, see [Appendix A: Add Custom Cluster](#appendix-a-add-custom-cluster).
1. Enter a **Node Prefix**. When the cluster is created, each node in the pool is named after the prefix. An incremented number is appended to each node.
2. Enter the node **Count** for the pool.
3. Click **Add Node Template**. A node template is just the a virtual machine configuration you're using to create your nodes (i.e. other virtual machines).
Depending on the cluster option that you choose, the Rancher UI displays instructions on how to create a template. The process is different for each cloud service. You may need to log in to your cloud service to find the data Rancher needs.
4. Choose the **Template** that you just added.
![choose template](../../../../img/rancher/choose-template.gif)
5. Select roles for the node pool.
<a name="roles"></a>
Kubernetes functions using different [components](https://kubernetes.io/docs/concepts/overview/components/), which are divided into *master components* and *node components*. When setting up your node pool, select a pool to fill each component role. You can install all components one a single pool, or you can spread them around.
The roles are:
- **etcd**: One of the master components. Etcd is a distributed reliable key-value store that stores all Kubernetes states.
- **Control**: The remaining master components as well as the node components. These nodes help manage the Kubernetes cluster and where your applications can be launched.
- **Worker**: On these nodes, only node components are launched. These nodes run only applications.
6. **Optional:** Click **+ Add Node Pool** to add more pools.
![add-second-node-pool](../../../../img/rancher/add-second-node-pool.gif)
7. <a name="create-cluster"></a>Click **Create**.
**Result:**
- Your cluster is created and assigned a state of **Provisioning**. Rancher is standing up your cluster.
- You can access your cluster after its state is updated to **Active**.
- **Active** clusters are assigned a **Project** and **Namespace**, both of which are named `Default`.
>>>>>>> more menu setup
### Deploy a Workload
@@ -153,11 +335,19 @@ For this workload, you'll be deploying the application NGINX.
7. From **Port Mapping**, click **Add Port**.
<<<<<<< HEAD
8. From the **Publish on** drop-down, make sure that **Every node** is selected.
=======
![enter-docker-image](../../../../img/rancher/enter-docker-image.png)
>>>>>>> more menu setup
8. From the **Source Port** field, leave the **Random** value in place.
<<<<<<< HEAD
7. From the **Container Port** field, enter port `80`.
=======
>**Note:** During Rancher v2.0 beta, only port 80 is supported. Other ports will be supported at GA.
>>>>>>> more menu setup
8. Leave the remaining options on their default setting. We'll tell you about them later.
@@ -178,5 +368,121 @@ From the **Workloads** page, click the link underneath your workload. If your de
Congratulations! You have:
<<<<<<< HEAD
- Created your first cluster.
- Deployed NGINX to your cluster using a workload.
=======
- Created your first cluster.
- Deployed an application to your cluster using a workload.
Now you can use the rest of Rancher v2.0 to orchestrate and manage your pods.
(Moooooo-re coming soon!)
![cow](../../../../img/rancher/cow.jpg)
### Appendix A: Add Custom Cluster
When creating a custom cluster, follow these instructions to complete its creation. These instructions will create one or more node that will be used to image your cluster.
>**Note:** When creating a custom cluster, make sure each node meets the [Host Requirements](#host-requirements).
1. From **Node Roles**, choose the Kubernetes component roles that you want the node to fill. You must fill each role.
A more detailed description of each [role](#roles) is available earlier in this guide.
>**Note:** If you want to spread the roles among different nodes, provision additional Linux hosts and enter the command on each of your nodes.
3. **Optional:** Add labels to the node template.
4. Copy the command for installing Docker to your clipboard.
>**Remember:** The version of Docker installed on your nodes must be [supported](#node-requirements).
5. Log in to your Linux host using your preferred shell, such as PuTTy or a remote Terminal connection.
6. Enter the command on your Linux host.
7. From you Rancher session, click **Done**.
8. Resume the Quick Start Guide from [Deploy a Workload](#deploy-a-workload).
<!--
### Importing Kubernetes Clusters
In Rancher v2.0, you can import an existing, external installation of Kubernetes v1.8. In this scenario, the cluster provider manages your hosts outside of Rancher.
#### To Import a Kubernetes Cluster:
1. Follow the instructions in the Rancher UI to import an existing Kubernetes cluster. Import the _kubeconfig_ file of your existing cluster.
2. Click **Import**. Once your cluster is ready, you can view its status on the Clusters page. Once the cluster is active, you can start adding pods into your namespace.
### Rancher Concepts
Rancher supports grouping resources into multiples clusters, projects and namespaces.
A **cluster** is a group of physical (or virtual) compute resources. Each project is tied to one cluster and runs its pods on the cluster's nodes. You can share a cluster with more than one project as well as give different users access to manage the various resources of a cluster.
A **project** is a group of namespaces where workloads are defined. The pods in a project can communicate with each other over a shared managed network, and you can give different users access to manage the various resources of a project.
<a id="catalog"></a>
### Deploy an Application
After your cluster is **Active**, you're ready to add applications to its **Default** project.
A *project* is an object that fences in namespaces and workloads. We'll describe projects, namespaces, and workloads in more detail later.
Out of the box, Rancher is bundled with a catalog of applications (i.e. a [Helm chart](https://helm.sh/)) that make their deployment easy. Choose an application from the catalog for deployment.
1. Click the link for the cluster that you just created.
![click-cluster-name](../../../../img/rancher/click-cluster-name.png)
2. From the main menu of your cluster **Dashboard**, click **Projects**.
![select-projects](../../../../img/rancher/select-projects.png)
3. Open the **Default** project. A default project is added to every cluster created.
4. From the main menu, click **Catalog Apps**.
![select-catalog-apps](../../../../img/rancher/select-catalog-apps.png)
5. Click **+ Launch**.
**Step Result:** The **Catalog** displays the application templates that are available.
6. Choose an application to include in your project. Then click **View Details**.
![choose-app](../../../../img/rancher/choose-app.gif)
7. Scroll to **New Application**. Click **Show advanced options**.
8. Click **Use an existing namespace**. Then select **default**.
![select-default-namespace](../../../../img/rancher/select-default-namespace.gif)
9. **Optional:** Choose other settings.
> **Note:** To review the `docker-compose.yml` and `rancher-compose.yml` files used to generate the stacks, click **Preview** before launching the stack.
10. Skip the rest of the options for now. Click **Launch**.
**Result**:
- The application is added to the project and deployed using a *workload*. A workload is an object that includes pods along with other files and info needed to deploy your application.
- When your workload completes deployment, it's assigned a state of **Active**. You can view this status from the project's **Workloads** page.
### Using Kubeconfig File
You can generate a Kubernetes configuration file to use `kubectl` on your desktop. A Kubernetes configuration file, i.e. *kubeconfig*, lets you configure access to one or more clusters from your desktop.
1. On the Rancher UI menu, select the cluster.
2. In the **Dashboard**, click on the **Kubeconfig File** button. A *kubeconfig* file will be generated so you can use `kubectl` on your desktop. Copy and paste the code that displays into your `~/.kube/config` file, and then start using `kubectl`. Click **Close** to return to the Rancher UI.
### Deploying on Ubuntu
It is possible to use Rancher to control Canonical Kubernetes (cdk) clusters running on Ubuntu. A full set of instructions has been provided by Canonical for doing this here: [https://kubernetes.io/docs/getting-started-guides/ubuntu/rancher/](https://kubernetes.io/docs/getting-started-guides/ubuntu/rancher/).-->
>>>>>>> more menu setup
+2 -1
View File
@@ -1,5 +1,6 @@
---
layout: single-docs
tag: ["rancher", "tasks"]
title: Tasks
weight: 3000
---
+2 -1
View File
@@ -1,5 +1,6 @@
---
layout: single-docs
tag: ["rancher", "upgrades"]
title: Upgrade Scenarios
weight: 1000
---
+37
View File
@@ -0,0 +1,37 @@
{{ define "hero" }}
<section class="hero">
<div class="wrapper p-h-lg row center-xs">
<div class="col-md-8">
{{ with .Params.Title }}
<h1>{{ . }}</h1>
{{end}}
{{ with .Params.Author }}
<span class="byline bg-link">{{ . }}</span>
{{end}}
</div>
</div>
</section>
{{ end }}
{{ define "main" }}
<div class="wrapper">
<h1>default single template</h1>
{{ partial "breadcrumbs.html" . }}
<div class="row">
<article class="main-content col-sm-8 col-xs-12 p-r-lg">
{{ if .Params.Image }}
<img class="feat-img" src="{{ .Params.Image }}" alt="{{ .Params.Title }}">
{{end}}
{{ .Content }}
</article>
<aside class="col-sm-4 col-xs-12">
{{ partial "sidebar.html" . }}
</aside>
</div>
</div>
{{ end }}
+1 -6
View File
@@ -3,7 +3,6 @@
{{ end }}
{{ define "hero" }}
<!-- theme/layouts/_default/list.html-->
<section class="hero">
{{ with .Params.Title }}
<h1>{{ . }}</h1>
@@ -28,7 +27,7 @@
{{ partial "docs-side-nav.html" . }}
</div>
</aside>
<article class="col-sm-8 col-xs-12 p-r-lg">
<article class="col-sm-8 col-xs-12 p-l-lg">
<div class="main-content ">
{{ .Content }}
@@ -67,10 +66,6 @@
{{end}}
{{end}}
<!-- {{ with .Params.Date }}
<div class="p-h-sm p-v-xs"><i class="material-icons">event</i> By: {{ .Format "January 2, 2006" }}</div>
{{end}} -->
{{ if eq .Section "blog" }}
<div class="p-h-sm p-v-xs"><i class="material-icons">timer</i> Read Time: {{.ReadingTime}} minutes</div>
{{end}}
+72 -24
View File
@@ -1,37 +1,85 @@
{{ define "title" }}
{{ .Title }} – {{ .Site.Title }}
{{ end }}
{{ define "hero" }}
<section class="hero">
<div class="wrapper p-h-lg row center-xs">
<div class="col-md-8">
{{ with .Params.Title }}
<h1>{{ . }}</h1>
{{end}}
<section class="hero">
{{ with .Params.Title }}
<h1>{{ . }}</h1>
{{end}}
{{ with .Params.Author }}
<span class="byline bg-link">{{ . }}</span>
{{end}}
</section>
{{ with .Params.Author }}
<span class="byline bg-link">{{ . }}</span>
{{end}}
</div>
</div>
</section>
{{ end }}
{{ define "main" }}
<div class="wrapper">
<h1>default single template</h1>
{{ partial "breadcrumbs.html" . }}
<div class="row">
<article class="main-content col-sm-8 col-xs-12 p-r-lg">
{{ if .Params.Image }}
<img class="feat-img" src="{{ .Params.Image }}" alt="{{ .Params.Title }}">
{{end}}
{{ .Content }}
</article>
{{ partial "docs-nav.html" . }}
<div class="row m-t-sm">
<aside class="col-sm-4 col-xs-12">
{{ partial "sidebar.html" . }}
<div class="bg-default p-a-sm">
{{ partial "docs-side-nav.html" . }}
</div>
</aside>
<article class="col-sm-8 col-xs-12 p-l-lg">
<div class="main-content ">
{{ .Content }}
{{ range (.Paginator 5).Pages }}
<div class="box m-b-md">
<div class="p-a-sm">
<h3><a href="{{.URL}}">{{.Title}}</a></h3>
{{ if .Params.Image }}
<div class="thumbnail"><img src="{{ .Params.Image }}" alt="{{ .Params.Title }}"></div>
{{end}}
<p>{{ .Summary | safeHTML }}</p>
{{ if .Truncated }}
<div>
<a href="{{ .RelPermalink }}">Read More…</a>
</div>
{{ end }}
</div>
<div class="bg-default">
<div class="row">
{{ with .Params.Author }}
<div class="p-h-sm p-v-xs"><i class="material-icons">person_outline</i> By: {{ . }}</div>
{{end}}
{{ if eq .Section "events" }}
{{ with .Params.EventDate }}
<div class="p-h-sm p-v-xs"><i class="material-icons">event</i> {{ . }}</div>
{{end}}
{{ else }}
{{ with .Params.Date }}
<div class="p-h-sm p-v-xs"><i class="material-icons">event</i> {{ .Format "January 2, 2006" }}</div>
{{end}}
{{end}}
{{ if eq .Section "blog" }}
<div class="p-h-sm p-v-xs"><i class="material-icons">timer</i> Read Time: {{.ReadingTime}} minutes</div>
{{end}}
{{ with .Params.Location }}
<div class="p-h-sm p-v-xs"><i class="material-icons">location_on</i> {{ . }}</div>
{{end}}
</div>
</div>
</div>
{{ end }}
</div>
{{ template "_internal/pagination.html" . }}
</article>
</div>
</div>
{{ end }}
+37 -3
View File
@@ -1,7 +1,41 @@
{{ $.Scratch.Set "topLevel" . }}
{{ $.Scratch.Set "secondLevel" . }}
<nav>
<ul class="tabs">
{{ range .Sections }}
<li><a href="{{ .Permalink }}">{{ .Title }}</a></li>
<!-- tabs -->
<ul class="tabs row middle-xs">
<div class="pull-left m-v-sm">
<ul class="dropdown sub-menu unstyled">
<li>
<a href="{{ .URL }}" class="btn bg-link p-a-0">
<span class="p-h-xs">
{{ range .Site.Sections }}
{{ if .IsAncestor $.CurrentSection }}
{{ $.Scratch.Set "topLevel" . }}
{{ .Title }}
{{end}}
{{end}}
</span>
<i class="material-icons darken p-a-xs">keyboard_arrow_down</i>
</a>
<ul class="sub dropdown-menu bg-white unstyled">
{{ range .Site.Sections }}
<li><a href="{{ .Permalink }}">{{ .Title }}</a></li>
{{ end }}
</ul>
</li>
</ul>
</div>
{{ $topLevel := .Scratch.Get "topLevel"}}
{{ if $topLevel }}
{{ range $topLevel.Sections }}
{{ if .IsAncestor $.CurrentSection }}
{{ $.Scratch.Set "secondLevel" . }}
{{ end }}
<li><a href="{{ .Permalink }}" class="">{{ .Title }}</a></li>
{{ end }}
{{ end }}
</ul>
</nav>
+4 -3
View File
@@ -10,19 +10,20 @@
{{ end }}
-->
<h3>{{ .Title }}</h3>
{{ $home := .Site.Home }}
<div class="tree-nav">
<ul>
<!-- <li><a href="{{ .RelPermalink}}">Home</a></li> -->
<ul>
{{ template "section-tree-nav" $home }}
{{ template "section-tree-nav" ($.Scratch.Get "secondLevel") }}
}}
</ul>
</ul>
</div>
{{ define "section-tree-nav" }}
{{ range .Sections}}
<!-- <li> -->
<li class="bg-white"><a href="{{ .RelPermalink}}"><i class="material-icons bg-accent p-a-xs">folder</i>{{ .Title }}<i class="material-icons pull-right">keyboard_arrow_down</i></a>
<li class="bg-white"><a href="{{ .RelPermalink}}">{{ .Title }}<i class="material-icons pull-right">keyboard_arrow_down</i></a>
<ul>
{{ range .Pages }}
<li class="bg-white"><a href="{{ .RelPermalink}}">{{ .Title }}</a></li>