public/rancher-docs
1
0
Fork 0
mirror of https://github.com/rancher/rancher-docs.git synced 2026-09-29 22:49:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

hero move toc styles to theme format quick start

Browse Source
This commit is contained in:
lvuch
2018-04-29 20:10:22 -07:00
parent 9c072b90b4
commit 44242b7d40
3 changed files with 56 additions and 72 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/rancher/quick-start-guide/_index.md
+47 -61
View File
@@ -7,97 +7,84 @@ weight: 25
Howdy Partner! This tutorial walks you through: Howdy Partner! This tutorial walks you through:
- Installation of {{< product >}} {{< version >}} - Installation of {{< product >}} {{< version >}}
- Creation of your first cluster - Creation of your first cluster
- Deployment of an application, NGINX - Deployment of an application, NGINX
## Objectives ## Objectives
This Quick Start Guide is divided into different tasks for easier consumption. This Quick Start Guide is divided into different tasks for easier consumption.
1. [Provision a Linux Host](#provision-a-linux-host) 1. Begin by provisioning a Linux host.
2. [Provision a Linux Host](#provision-a-linux-host)
Begin by provisioning a Linux host. 2. From your Linux host, run the Docker command for installing Rancher.[Install Rancher](#install-rancher)
2. [Install Rancher](#install-rancher) 3. Browse to your Linux host to access the Rancher UI.[Log In](#log-in)
From your Linux host, run the Docker command for installing Rancher. 4. Use the versatile **Custom** option to clone your Linux host into a new Kubernetes cluster.[Create the Cluster](#create-the-cluster)
3. [Log In](#log-in) 5. Create a workload so that Kubernetes can distribute NGINX among your cluster nodes.[Deploy a Workload](#deploy-a-workload)
Browse to your Linux host to access the Rancher UI. 6. When your workload finishes deployment, browse to your node IP to make sure NGINX is running.[View Your Application](#view-your-application)
4. [Create the Cluster](#create-the-cluster) 7. Now that you've created a cluster and deployed NGINX, find out what else you can do with Rancher v2.0.[What's Next?](#whats-next)
Use the versatile **Custom** option to clone your Linux host into a new Kubernetes cluster.
5. [Deploy a Workload](#deploy-a-workload)
Create a workload so that Kubernetes can distribute NGINX among your cluster nodes.
6. [View Your Application](#view-your-application)
When your workload finishes deployment, browse to your node IP to make sure NGINX is running.
7. [What's Next?](#whats-next)
Now that you've created a cluster and deployed NGINX, find out what else you can do with Rancher v2.0.
## Provision a Linux Host ## Provision a Linux Host
Begin creation of a custom cluster by provisioning a Linux host. Your host can be: ### Begin creation of a custom cluster by provisioning a Linux host. Your host can be:
- A cloud-host virtual machine (VM) - A cloud-host virtual machine (VM)
- An on-premise VM - An on-premise VM
- A bare-metal server - A bare-metal server
Provision the host according to the requirements below. ### Provision the host according to the requirements below.
#### Hardware Requirements #### Hardware Requirements
- Memory: 4GB - Memory: 4GB
#### Software requirements #### Software requirements
- Operating System: Ubuntu 16.04 (64-bit) - Operating System: Ubuntu 16.04 (64-bit)
- Software: Docker - Software: Docker
<a name="node-requirements"></a>**Supported Versions:** <a name="node-requirements"></a>**Supported Versions:**
- `1.12.6` - `1.12.6`
- `1.13.1` - `1.13.1`
- `17.03.2` - `17.03.2`
>**Notes:** >**Notes:**
> >
> * For Docker installation instructions, visit their [documentation](https://docs.docker.com/install/). > * For Docker installation instructions, visit their [documentation](https://docs.docker.com/install/).
> * Docker requirements apply to both your Linux host and your cluster nodes. > * Docker requirements apply to both your Linux host and your cluster nodes.
### Install Rancher ### Install Rancher
To install Rancher on your host, connect to it and then use a shell to install. 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:
``` ```
$ 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
``` ```
**Result:** Rancher is installed. #### Result: Rancher is installed.
### Log In ### Log In
Log in to Rancher to begin using the application. After you log in, you'll make some one-time configurations. 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.
2. When prompted, create a password for the default `admin` account there cowpoke! 2. When prompted, create a password for the default `admin` account there cowpoke!
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. 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.
@@ -135,25 +122,25 @@ You're ready to create your first _workload_. A workload is an object that inclu
For this workload, you'll be deploying the application NGINX. For this workload, you'll be deploying the application NGINX.
1. From the **Clusters** page, open the cluster that you just created. 1. From the **Clusters** page, open the cluster that you just created.
2. From the main menu of the **Dashboard**, select **Projects**. 2. From the main menu of the **Dashboard**, select **Projects**.
3. Open the **Default** project. 3. Open the **Default** project.
4. Click **+ Deploy**. 4. Click **+ Deploy**.
**Step Result:** The **Deploy Workload** page opens. **Step Result:** The **Deploy Workload** page opens.
5. Enter a **Name** for your workload. 5. Enter a **Name** for your workload.
6. From the **Docker Image** field, enter `nginx`. 6. From the **Docker Image** field, enter `nginx`.
7. From **Port Mapping**, click **Add Port**. 7. From **Port Mapping**, click **Add Port**.
8. From the **Publish on** drop-down, make sure that **Every node** is selected. 8. From the **Publish on** drop-down, make sure that **Every node** is selected.
8. From the **Source Port** field, leave the **Random** value in place. 8. From the **Source Port** field, leave the **Random** value in place.
7. From the **Container Port** field, enter port `80`. 7. From the **Container Port** field, enter port `80`.
@@ -161,8 +148,7 @@ For this workload, you'll be deploying the application NGINX.
9. Click **Launch**. 9. Click **Launch**.
**Result:** #### Result:
* Your workload is deployed. This process might take a few minutes to complete. * Your workload is deployed. This process might take a few minutes to complete.
* When your workload completes deployment, it's assigned a state of **Active**. You can view this status from the project's **Workloads** page. * When your workload completes deployment, it's assigned a state of **Active**. You can view this status from the project's **Workloads** page.
@@ -176,5 +162,5 @@ From the **Workloads** page, click the link underneath your workload. If your de
Congratulations! You have: Congratulations! You have:
- Created your first cluster. - Created your first cluster.
- Deployed NGINX to your cluster using a workload. - Deployed NGINX to your cluster using a workload.
layouts/_default/list.html
+9
View File
@@ -3,6 +3,15 @@
{{ end }} {{ end }}
{{ define "hero" }} {{ define "hero" }}
<section class="hero">
{{ with .Params.Title }}
<h1>{{ . }}</h1>
{{end}}
{{ with .Params.Author }}
<span class="byline bg-link">{{ . }}</span>
{{end}}
</section>
{{ end }} {{ end }}
{{ define "main" }} {{ define "main" }}
src/sass/app.scss
-11
View File
@@ -59,14 +59,3 @@
display: none; display: none;
visibility: hidden; visibility: hidden;
} }
.sticky {
position: fixed;
top: 0;
}
#TableOfContents {
.active {
font-weight: bold;
}
}