From 7eabfd51f907f00fd7179be68963a20b7f1b0210 Mon Sep 17 00:00:00 2001 From: Chris Urwin Date: Fri, 6 Jul 2018 15:07:55 +0100 Subject: [PATCH 1/5] Updated Quick Start Guides --- .../v2.x/en/quick-start-guide/_index.md | 218 +---------------- .../en/quick-start-guide/deployment/_index.md | 12 + .../deployment/digital-ocean-qs/_index.md | 43 ++++ .../quickstart-manual-setup/_index.md | 219 ++++++++++++++++++ .../deployment/quickstart-vagrant/_index.md | 25 ++ .../en/quick-start-guide/workload/_index.md | 8 + .../_index.md | 70 ++++++ .../_index.md | 144 ++++++++++++ 8 files changed, 528 insertions(+), 211 deletions(-) create mode 100644 content/rancher/v2.x/en/quick-start-guide/deployment/_index.md create mode 100644 content/rancher/v2.x/en/quick-start-guide/deployment/digital-ocean-qs/_index.md create mode 100644 content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-manual-setup/_index.md create mode 100644 content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-vagrant/_index.md create mode 100644 content/rancher/v2.x/en/quick-start-guide/workload/_index.md create mode 100644 content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-ingress/_index.md create mode 100644 content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-nodeport/_index.md diff --git a/content/rancher/v2.x/en/quick-start-guide/_index.md b/content/rancher/v2.x/en/quick-start-guide/_index.md index b86b6cdc02a..f0242b4dd4d 100644 --- a/content/rancher/v2.x/en/quick-start-guide/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/_index.md @@ -1,222 +1,18 @@ --- -title: Quick Start Guide -short title: Quick Start +title: Quick Start Guides +short title: Quick Start Index weight: 25 --- ->**Note:** This Quick Start Guide's intent is to get you up and running in a sandbox environment. It is not intended for a production environment. For more comprehensive instructions, see [Installation]({{< baseurl >}}/rancher/v2.x/en/installation/). +>**Note:** The intent of these Quick Start Guides is to get you up and running in a sandbox environment quickly. It is not intended for a production environment. For more comprehensive instructions, see [Installation]({{< baseurl >}}/rancher/v2.x/en/installation/). -Howdy Partner! This tutorial walks you through: - -- Installation of {{< product >}} {{< version >}} -- Creation of your first cluster -- Deployment of an application, Nginx +We are going to continue to grow the content of these quick starts to give you a jump start in deploying and testing Rancher 2.0! -## Quick Start Outline +This index will be updated to allow you to quickly find the Quick Start instructions that cover your scenario -This Quick Start Guide is divided into different tasks for easier consumption. +1. [Deploying Rancher Server](./deployment) - This gives Quick Start Guides to get you running via different methods -1. [Provision a Linux Host](#provision-a-linux-host) +2. [Deploying a Workload](./workload) - This gives Quick Start Guide for deploying a workload and exposing it - Begin by provisioning a Linux host. -2. [Install Rancher](#install-rancher) - From your Linux host, run the Docker command for installing Rancher. -3. [Log In](#log-in) - - Browse to your Linux host to access the Rancher UI. - -4. [Create the Cluster](#create-the-cluster) - - Use the versatile **Custom** option to add 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. - -### Provision a Linux Host - - Begin creation of a custom cluster by provisioning a Linux host. Your host can be: - -- A cloud-host virtual machine (VM) -- An on-premise VM -- A bare-metal server - - >**Note:** - > When using a cloud-hosted virtual machine you need to allow inbound TCP communication to ports 80 and 443. Please see your cloud-host's documentation for information regarding port configuration. - > - > For a full list of port requirements, refer to [Single Node Installation]({{< baseurl >}}/rancher/v2.x/en/installation/single-node-install/#port-requirements). - - Provision the host according to the requirements below. - -{{< requirements_os >}} - -**Hardware Requirements** - -- Memory: 4GB - -**Software Requirements** - -- Software: Docker - - **Supported Docker versions:** - - - `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. - -### 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. - -2. From your shell, enter the following command: - - ``` - $ sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 rancher/rancher - ``` - -**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: `https://`.

- Replace `` with your host IP address. - -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 added to your cluster must be able to connect to this URL.

If you use a hostname in the URL, this hostname must be resolvable by DNS on the nodes you want to add to you cluster. - -### Create the Cluster - -Welcome to Rancher! You are now able to create your first Kubernetes cluster. - -In this task, you can use the versatile **Custom** option. This option lets you add _any_ Linux host (cloud-hosted VM, on-premise VM, or bare-metal) to be used in a cluster. - -1. From the **Clusters** page, click **Add Cluster**. - -2. Choose **Custom**. - -3. Enter a **Cluster Name**. - -4. Skip **Member Roles** and **Cluster Options**. We'll tell you about them later. - -5. Click **Next**. - -6. From **Node Role**, select _all_ the roles: **etcd**, **Control**, and **Worker**. - -7. **Optional**: Rancher auto-detects the IP addresses used for Rancher communication and cluster communication. You can override these using `Public Address` and `Internal Address` in the **Node Address** section. - -8. Skip the **Labels** stuff. It's not important for now. - -9. Copy the command displayed on screen to your clipboard. - -10. Log in to your Linux host using your preferred shell, such as PuTTy or a remote Terminal connection. Run the command copied to your clipboard. - -11. When you finish running the command on your Linux host, click **Done**. - -{{< result_create-cluster >}} - -### Deploy a Workload - -You're ready to create your first _workload_. A workload is an object that includes pods along with other files and info needed to deploy your application. - -For this workload, you'll be deploying the application Nginx. - -1. From the **Clusters** page, open the cluster that you just created. - -2. From the main menu of the **Dashboard**, select **Projects**. - -3. Open the **Default** project. - -4. Click **+ Deploy**. - - **Step Result:** The **Deploy Workload** page opens. - -5. Enter a **Name** for your workload. - -6. From the **Docker Image** field, enter `nginx`. This field is case-sensitive. - -7. From **Port Mapping**, click **Add Port**. - -8. From the **As a** drop-down, make sure that **NodePort (On every node)** is selected. - - ![As a dropdown, NodePort (On every node selected)]({{< baseurl >}}/img/rancher/nodeport-dropdown.png) - -9. From the **On Listening Port** field, leave the **Random** value in place. - - ![On Listening Port, Random selected]({{< baseurl >}}/img/rancher/listening-port-field.png) - -10. From the **Publish the container port** field, enter port `80`. - - ![Publish the container port, 80 entered]({{< baseurl >}}/img/rancher/container-port-field.png) - -11. Leave the remaining options on their default setting. We'll tell you about them later. - -12. Click **Launch**. - -**Result:** - -* 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. - -### View Your Application - -When your workload completes deployment, browse to its IP to confirm that your application is working. - -From the **Workloads** page, click the link underneath your workload. If your deployment succeeded, your application opens. - ->**Note** -> When using a cloud-hosted virtual machine, you may not have access to the port running the container. In this event, you can test Nginx in an ssh session on the local machine. Use the port number after the `:` in the link under your workload, which is 31568 in this example. -> ->```sh - -gettingstarted@rancher:~$ curl http://localhost:31568 - - - -Welcome to Nginx! - - - -

Welcome to Nginx!

-

If you see this page, the Nginx web server is successfully installed and -working. Further configuration is required.

- -

For online documentation and support please refer to -Nginx.org.
-Commercial support is available at -nginx.com.

- -

Thank you for using Nginx.

- - -gettingstarted@rancher:~$ - -``` - -## Finished - -Congratulations! You have: - -- Created your first cluster. -- Deployed Nginx to your cluster using a workload. diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/_index.md new file mode 100644 index 00000000000..e49b1a44f98 --- /dev/null +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/_index.md @@ -0,0 +1,12 @@ +--- +title: Deploying Rancher Server +weight: 100 +--- + +We have provided a number of ways of to try and help you get up and running with Rancher Server 2.0 quickly depending on your requirements + +1. [Digital Ocean Quick Start](./digital-ocean-qs) - We provide you with a Terraform script that completely automates the set up of the Rancher Server and registers a cluster for you to get started with. + +2. [Vagrant Quick Start](./quickstart-vagrant) - We provide you with a vagrant file that again completely automates the set up of the Rancher Server and registers a 3 node cluster. + +3. [Manual Quick Start](./quickstart-manual-setup) - This will guide you through the process and requirements of manually setting up Rancher in any environment. \ No newline at end of file diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/digital-ocean-qs/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/digital-ocean-qs/_index.md new file mode 100644 index 00000000000..5d03ed9e66d --- /dev/null +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/digital-ocean-qs/_index.md @@ -0,0 +1,43 @@ +--- +title: Digital Ocean Quick Start +weight: 100 +--- +The following steps will allow you to quickly deploy a Rancher Server with a 3 node cluster attached in about 5 minutes + +>**Note** +>Using this will incurr charges at Digital Ocean + +## Prerequisites + +- [Digital Ocean Account](https://www.digitalocean.com) - You will require an account on Digital Ocean as this is where the server and cluster will run +- [Terraform](https://www.terraform.io) - This is used to provision the server and cluster to Digital Ocean + + +## Getting going + +1. Clone [Rancher Quickstart](https://github.com/rancher/quickstart) to a folder using `git clone https://github.com/rancher/quickstart` + +2. Go into the folder containing the terraform file `cd do` + +3. Move the file `terraform.tfvars.example` to `terraform.tfvars` and edit (see inline explanation, the minimum you will need to do is add your Digital Ocean Access Key) + +4. For the first time run you will need to run `terraform init` + +5. To initiate the creation of the environment run `terraform apply` + + >**Wait for the the following** + > ``` + Apply complete! Resources: 4 added, 0 changed, 0 destroyed. + Outputs: + rancher-url = [ + https://xxx.xxx.xxx.xxx + ] + ``` + +6. Paste the URL into the browser and log in (default password is `admin`) + +## Destroying the environment + +1. From the `quickstart/do` folder execute `terraform destroy --force` + +2. Wait for it to confirm that all resources have been destroyed \ No newline at end of file diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-manual-setup/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-manual-setup/_index.md new file mode 100644 index 00000000000..1656c706240 --- /dev/null +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-manual-setup/_index.md @@ -0,0 +1,219 @@ +--- +title: Manual Quick Start +weight: 300 +--- +Howdy Partner! This tutorial walks you through: + +- Installation of {{< product >}} {{< version >}} +- Creation of your first cluster +- Deployment of an application, Nginx + +## Quick Start Outline + +This Quick Start Guide is divided into different tasks for easier consumption. + +1. [Provision a Linux Host](#provision-a-linux-host) + + Begin by provisioning a Linux host. + +2. [Install Rancher](#install-rancher) + + From your Linux host, run the Docker command for installing Rancher. + +3. [Log In](#log-in) + + Browse to your Linux host to access the Rancher UI. + +4. [Create the Cluster](#create-the-cluster) + + Use the versatile **Custom** option to add 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. + +### Provision a Linux Host + + Begin creation of a custom cluster by provisioning a Linux host. Your host can be: + +- A cloud-host virtual machine (VM) +- An on-premise VM +- A bare-metal server + + >**Note:** + > When using a cloud-hosted virtual machine you need to allow inbound TCP communication to ports 80 and 443. Please see your cloud-host's documentation for information regarding port configuration. + > + > For a full list of port requirements, refer to [Single Node Installation]({{< baseurl >}}/rancher/v2.x/en/installation/single-node-install/#port-requirements). + + Provision the host according to the requirements below. + +{{< requirements_os >}} + +**Hardware Requirements** + +- Memory: 4GB + +**Software Requirements** + +- Software: Docker + + **Supported Docker versions:** + + - `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. + +### 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. + +2. From your shell, enter the following command: + + ``` + $ sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 rancher/rancher + ``` + +**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: `https://`.

+ Replace `` with your host IP address. + +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 added to your cluster must be able to connect to this URL.

If you use a hostname in the URL, this hostname must be resolvable by DNS on the nodes you want to add to you cluster. + +### Create the Cluster + +Welcome to Rancher! You are now able to create your first Kubernetes cluster. + +In this task, you can use the versatile **Custom** option. This option lets you add _any_ Linux host (cloud-hosted VM, on-premise VM, or bare-metal) to be used in a cluster. + +1. From the **Clusters** page, click **Add Cluster**. + +2. Choose **Custom**. + +3. Enter a **Cluster Name**. + +4. Skip **Member Roles** and **Cluster Options**. We'll tell you about them later. + +5. Click **Next**. + +6. From **Node Role**, select _all_ the roles: **etcd**, **Control**, and **Worker**. + +7. **Optional**: Rancher auto-detects the IP addresses used for Rancher communication and cluster communication. You can override these using `Public Address` and `Internal Address` in the **Node Address** section. + +8. Skip the **Labels** stuff. It's not important for now. + +9. Copy the command displayed on screen to your clipboard. + +10. Log in to your Linux host using your preferred shell, such as PuTTy or a remote Terminal connection. Run the command copied to your clipboard. + +11. When you finish running the command on your Linux host, click **Done**. + +{{< result_create-cluster >}} + +### Deploy a Workload + +You're ready to create your first _workload_. A workload is an object that includes pods along with other files and info needed to deploy your application. + +For this workload, you'll be deploying the application Nginx. + +1. From the **Clusters** page, open the cluster that you just created. + +2. From the main menu of the **Dashboard**, select **Projects**. + +3. Open the **Default** project. + +4. Click **+ Deploy**. + + **Step Result:** The **Deploy Workload** page opens. + +5. Enter a **Name** for your workload. + +6. From the **Docker Image** field, enter `nginx`. This field is case-sensitive. + +7. From **Port Mapping**, click **Add Port**. + +8. From the **As a** drop-down, make sure that **NodePort (On every node)** is selected. + + ![As a dropdown, NodePort (On every node selected)]({{< baseurl >}}/img/rancher/nodeport-dropdown.png) + +9. From the **On Listening Port** field, leave the **Random** value in place. + + ![On Listening Port, Random selected]({{< baseurl >}}/img/rancher/listening-port-field.png) + +10. From the **Publish the container port** field, enter port `80`. + + ![Publish the container port, 80 entered]({{< baseurl >}}/img/rancher/container-port-field.png) + +11. Leave the remaining options on their default setting. We'll tell you about them later. + +12. Click **Launch**. + +**Result:** + +* 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. + +### View Your Application + +When your workload completes deployment, browse to its IP to confirm that your application is working. + +From the **Workloads** page, click the link underneath your workload. If your deployment succeeded, your application opens. + +>**Note** +> When using a cloud-hosted virtual machine, you may not have access to the port running the container. In this event, you can test Nginx in an ssh session on the local machine. Use the port number after the `:` in the link under your workload, which is 31568 in this example. +> +>```sh + +gettingstarted@rancher:~$ curl http://localhost:31568 + + + +Welcome to Nginx! + + + +

Welcome to Nginx!

+

If you see this page, the Nginx web server is successfully installed and +working. Further configuration is required.

+ +

For online documentation and support please refer to +Nginx.org.
+Commercial support is available at +nginx.com.

+ +

Thank you for using Nginx.

+ + +gettingstarted@rancher:~$ + +``` + +## Finished + +Congratulations! You have: + +- Created your first cluster. +- Deployed Nginx to your cluster using a workload. diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-vagrant/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-vagrant/_index.md new file mode 100644 index 00000000000..81d1dbd10a0 --- /dev/null +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-vagrant/_index.md @@ -0,0 +1,25 @@ +--- +title: Vagrant Quick Start +weight: 200 +--- +The following steps will allow you to quickly deploy a Rancher Server with a 3 node cluster attached in about 10 minutes + +## Prerequisites + +- [Vagrant](https://www.vagrantup.com) - Vagrant is required as this is used to provision the machine based on the Vagrantfile +- [Virtualbox](https://www.virtualbox.org) - The Virtual Machines that vagrant provisions need to be provisioned to VirtualBox +- At least 6GB of free RAM + + +## Getting going + +1. Clone [Rancher Quickstart](https://github.com/rancher/quickstart) to a folder using `git clone https://github.com/rancher/quickstart` +2. Go into the folder containing the terraform file `cd vagrant` +3. Edit the config.yaml if required (you can change the number of nodes and the memory allocations if required) +4. To initiate the creation of the environment run `vagrant up` +5. Once provisioning has finished go to `https://172.22.101.100` in the browser (default user/password is `admin/password1` you can change the default password in the config.yaml prior to running the `vagrant up` command) + +## Destroying the environment + +1. From the `quickstart/vagrant` folder execute `vagrant destroy -f` +2. Wait for it to confirm that all resources have been destroyed \ No newline at end of file diff --git a/content/rancher/v2.x/en/quick-start-guide/workload/_index.md b/content/rancher/v2.x/en/quick-start-guide/workload/_index.md new file mode 100644 index 00000000000..f566ef2ba14 --- /dev/null +++ b/content/rancher/v2.x/en/quick-start-guide/workload/_index.md @@ -0,0 +1,8 @@ +--- +title: Deploying Workloads +weight: 200 +--- + +1. [Deploying a workload exposed via an Ingress](./quickstart-deploy-workload-ingress) - This will guide you through creating a workload and exposing it via an Ingress + +2. [Deploying a workload exposed via a Nodeport](./quickstart-deploy-workload-nodeport) - This will guide you through creating a workload and exposing it via a Nodeport \ No newline at end of file diff --git a/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-ingress/_index.md b/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-ingress/_index.md new file mode 100644 index 00000000000..c6da2f8fbeb --- /dev/null +++ b/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-ingress/_index.md @@ -0,0 +1,70 @@ +--- +title: Workload with Ingress Quick Start +weight: 100 +--- + +### Assumptions + +- You have a running cluster with at least 1 node + +### Deploy a Workload + +You're ready to create your first _workload_. A workload is an object that includes pods along with other files and info needed to deploy your application. + +For this workload, you'll be deploying the application Rancher Hello-World. + +1. From the **Clusters** page, open the cluster that you just created. + +2. From the main menu of the **Dashboard**, select **Projects**. + +3. Open the **Default** project. + +4. Click **Deploy**. + + **Step Result:** The **Deploy Workload** page opens. + +5. Enter a **Name** for your workload. + +6. From the **Docker Image** field, enter `rancher/hello-world`. This field is case-sensitive. + +7. Leave the remaining options on their default setting. We'll tell you about them later. + +8. Click **Launch**. + +**Result:** + +* 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. + +### Expose the workload via an ingress + +Now that the application is up and running you want to expose it so that browsers and other services can hit it + +1. From the **Clusters** page, open the cluster that you just created. + +2. From the main menu of the **Dashboard**, select **Projects**. + +3. Open the **Default** project. + +4. Click on the **Load Balancing** tab. + +5. Click **Add Ingress**. + +6. Enter a name i.e. **hello** + +7. In the **Target* field, drop down the list and choose the name that you set for your service. + +8. Enter `80` in the **Port** field. + +9. Leave everything else as default and click **Save** + + +### View Your Application + +From the **Load Balancing** page, click the target link which will look something like **hello.default.xxx.xxx.xxx.xxx.xip.io > hello-world** + +Your application will open in a seperate window. + +## Finished + +Congratulations! You have successfully deployed a workload exposed via an ingress. diff --git a/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-nodeport/_index.md b/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-nodeport/_index.md new file mode 100644 index 00000000000..b4e97178477 --- /dev/null +++ b/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-nodeport/_index.md @@ -0,0 +1,144 @@ +--- +title: Workload with Nodeport Quick Start +weight: 200 +--- + +### Assumptions + +- You have a running cluster with at least 1 node + +### Deploy a Workload + +You're ready to create your first _workload_. A workload is an object that includes pods along with other files and info needed to deploy your application. + +For this workload, you'll be deploying the application Rancher Hello-World. + +1. From the **Clusters** page, open the cluster that you just created. + +2. From the main menu of the **Dashboard**, select **Projects**. + +3. Open the **Default** project. + +4. Click **Deploy**. + + **Step Result:** The **Deploy Workload** page opens. + +5. Enter a **Name** for your workload. + +6. From the **Docker Image** field, enter `rancher/hello-world`. This field is case-sensitive. + +7. From **Port Mapping**, click **Add Port**. + +8. From the **As a** drop-down, make sure that **NodePort (On every node)** is selected. + + ![As a dropdown, NodePort (On every node selected)]({{< baseurl >}}/img/rancher/nodeport-dropdown.png) + +9. From the **On Listening Port** field, leave the **Random** value in place. + + ![On Listening Port, Random selected]({{< baseurl >}}/img/rancher/listening-port-field.png) + +10. From the **Publish the container port** field, enter port `80`. + + ![Publish the container port, 80 entered]({{< baseurl >}}/img/rancher/container-port-field.png) + +11. Leave the remaining options on their default setting. We'll tell you about them later. + +12. Click **Launch**. + +**Result:** + +* 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. + +### View Your Application + +From the **Workloads** page, click the link underneath your workload. If your deployment succeeded, your application opens. + +>**Note** +> When using a cloud-hosted virtual machine, you may not have access to the port running the container. In this event, you can test Nginx in an ssh session on the local machine. Use the port number after the `:` in the link under your workload, which is 31568 in this example. +> +>```sh + +gettingstarted@rancher:~$ curl http://localhost:31568 + + + + Rancher + + + + + +

Hello world!

+

My hostname is hello-world-66b4b9d88b-78bhx

+
+

k8s services found 2

+ + INGRESS_D1E1A394F61C108633C4BD37AEDDE757 tcp://10.43.203.31:80
+ + KUBERNETES tcp://10.43.0.1:443
+ +
+
+ + +
+ + +
+ + + +gettingstarted@rancher:~$ + +``` + +## Finished + +Congratulations! You have successfully deployed a workload exposed via a nodeport. From 1c4ebdbfc655658e62b657170c2c790eb9f7fc09 Mon Sep 17 00:00:00 2001 From: Chris Urwin Date: Fri, 6 Jul 2018 17:04:14 +0100 Subject: [PATCH 2/5] Formatting and content updates for Quickstart --- .../v2.x/en/quick-start-guide/_index.md | 6 +- .../en/quick-start-guide/deployment/_index.md | 8 +- .../deployment/digital-ocean-qs/_index.md | 6 +- .../quickstart-manual-setup/_index.md | 99 +------------------ .../deployment/quickstart-vagrant/_index.md | 11 ++- .../_index.md | 3 +- .../_index.md | 6 +- 7 files changed, 25 insertions(+), 114 deletions(-) diff --git a/content/rancher/v2.x/en/quick-start-guide/_index.md b/content/rancher/v2.x/en/quick-start-guide/_index.md index f0242b4dd4d..185d8726fd1 100644 --- a/content/rancher/v2.x/en/quick-start-guide/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/_index.md @@ -7,11 +7,11 @@ weight: 25 We are going to continue to grow the content of these quick starts to give you a jump start in deploying and testing Rancher 2.0! -This index will be updated to allow you to quickly find the Quick Start instructions that cover your scenario +The current areas covered by Quick Starts are: -1. [Deploying Rancher Server](./deployment) - This gives Quick Start Guides to get you running via different methods +- [Deploying Rancher Server](./deployment) - This gives Quick Start Guides to get you running via different methods. -2. [Deploying a Workload](./workload) - This gives Quick Start Guide for deploying a workload and exposing it +- [Deploying a Workload](./workload) - This gives Quick Start Guide for deploying a workload and exposing it. diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/_index.md index e49b1a44f98..2f54cf326ae 100644 --- a/content/rancher/v2.x/en/quick-start-guide/deployment/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/_index.md @@ -3,10 +3,10 @@ title: Deploying Rancher Server weight: 100 --- -We have provided a number of ways of to try and help you get up and running with Rancher Server 2.0 quickly depending on your requirements +The following are the current guides for provisioning Rancher Server and a cluster: -1. [Digital Ocean Quick Start](./digital-ocean-qs) - We provide you with a Terraform script that completely automates the set up of the Rancher Server and registers a cluster for you to get started with. +- [Digital Ocean Quick Start](./digital-ocean-qs) - We provide you with a Terraform script that completely automates the set up of the Rancher Server and registers a cluster for you to get started with. -2. [Vagrant Quick Start](./quickstart-vagrant) - We provide you with a vagrant file that again completely automates the set up of the Rancher Server and registers a 3 node cluster. +- [Vagrant Quick Start](./quickstart-vagrant) - We provide you with a Vagrant configuration that again completely automates the set up of the Rancher Server and registers a 3 node cluster. -3. [Manual Quick Start](./quickstart-manual-setup) - This will guide you through the process and requirements of manually setting up Rancher in any environment. \ No newline at end of file +- [Manual Quick Start](./quickstart-manual-setup) - This will guide you through the process and requirements of manually setting up Rancher in any environment. \ No newline at end of file diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/digital-ocean-qs/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/digital-ocean-qs/_index.md index 5d03ed9e66d..33f5d811453 100644 --- a/content/rancher/v2.x/en/quick-start-guide/deployment/digital-ocean-qs/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/digital-ocean-qs/_index.md @@ -5,19 +5,19 @@ weight: 100 The following steps will allow you to quickly deploy a Rancher Server with a 3 node cluster attached in about 5 minutes >**Note** ->Using this will incurr charges at Digital Ocean +>Using this will incur charges at Digital Ocean ## Prerequisites - [Digital Ocean Account](https://www.digitalocean.com) - You will require an account on Digital Ocean as this is where the server and cluster will run -- [Terraform](https://www.terraform.io) - This is used to provision the server and cluster to Digital Ocean +- [Terraform](https://www.terraform.io/downloads.html) - This is used to provision the server and cluster to Digital Ocean ## Getting going 1. Clone [Rancher Quickstart](https://github.com/rancher/quickstart) to a folder using `git clone https://github.com/rancher/quickstart` -2. Go into the folder containing the terraform file `cd do` +2. Go into the folder containing the terraform file by executing `cd quickstart/do` 3. Move the file `terraform.tfvars.example` to `terraform.tfvars` and edit (see inline explanation, the minimum you will need to do is add your Digital Ocean Access Key) diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-manual-setup/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-manual-setup/_index.md index 1656c706240..7ce443bdd48 100644 --- a/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-manual-setup/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-manual-setup/_index.md @@ -28,14 +28,6 @@ This Quick Start Guide is divided into different tasks for easier consumption. Use the versatile **Custom** option to add 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. - ### Provision a Linux Host Begin creation of a custom cluster by provisioning a Linux host. Your host can be: @@ -47,7 +39,7 @@ This Quick Start Guide is divided into different tasks for easier consumption. >**Note:** > When using a cloud-hosted virtual machine you need to allow inbound TCP communication to ports 80 and 443. Please see your cloud-host's documentation for information regarding port configuration. > - > For a full list of port requirements, refer to [Single Node Installation]({{< baseurl >}}/rancher/v2.x/en/installation/single-node-install/#port-requirements). + > For a full list of port requirements, refer to [Single Node Installation]({{< baseurl >}}/rancher/v2.x/en/installation/references). Provision the host according to the requirements below. @@ -127,93 +119,6 @@ In this task, you can use the versatile **Custom** option. This option lets you {{< result_create-cluster >}} -### Deploy a Workload - -You're ready to create your first _workload_. A workload is an object that includes pods along with other files and info needed to deploy your application. - -For this workload, you'll be deploying the application Nginx. - -1. From the **Clusters** page, open the cluster that you just created. - -2. From the main menu of the **Dashboard**, select **Projects**. - -3. Open the **Default** project. - -4. Click **+ Deploy**. - - **Step Result:** The **Deploy Workload** page opens. - -5. Enter a **Name** for your workload. - -6. From the **Docker Image** field, enter `nginx`. This field is case-sensitive. - -7. From **Port Mapping**, click **Add Port**. - -8. From the **As a** drop-down, make sure that **NodePort (On every node)** is selected. - - ![As a dropdown, NodePort (On every node selected)]({{< baseurl >}}/img/rancher/nodeport-dropdown.png) - -9. From the **On Listening Port** field, leave the **Random** value in place. - - ![On Listening Port, Random selected]({{< baseurl >}}/img/rancher/listening-port-field.png) - -10. From the **Publish the container port** field, enter port `80`. - - ![Publish the container port, 80 entered]({{< baseurl >}}/img/rancher/container-port-field.png) - -11. Leave the remaining options on their default setting. We'll tell you about them later. - -12. Click **Launch**. - -**Result:** - -* 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. - -### View Your Application - -When your workload completes deployment, browse to its IP to confirm that your application is working. - -From the **Workloads** page, click the link underneath your workload. If your deployment succeeded, your application opens. - ->**Note** -> When using a cloud-hosted virtual machine, you may not have access to the port running the container. In this event, you can test Nginx in an ssh session on the local machine. Use the port number after the `:` in the link under your workload, which is 31568 in this example. -> ->```sh - -gettingstarted@rancher:~$ curl http://localhost:31568 - - - -Welcome to Nginx! - - - -

Welcome to Nginx!

-

If you see this page, the Nginx web server is successfully installed and -working. Further configuration is required.

- -

For online documentation and support please refer to -Nginx.org.
-Commercial support is available at -nginx.com.

- -

Thank you for using Nginx.

- - -gettingstarted@rancher:~$ - -``` - ## Finished -Congratulations! You have: - -- Created your first cluster. -- Deployed Nginx to your cluster using a workload. +Congratulations! You have created your first cluster. diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-vagrant/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-vagrant/_index.md index 81d1dbd10a0..4863b54d3ee 100644 --- a/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-vagrant/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-vagrant/_index.md @@ -7,19 +7,24 @@ The following steps will allow you to quickly deploy a Rancher Server with a 3 n ## Prerequisites - [Vagrant](https://www.vagrantup.com) - Vagrant is required as this is used to provision the machine based on the Vagrantfile -- [Virtualbox](https://www.virtualbox.org) - The Virtual Machines that vagrant provisions need to be provisioned to VirtualBox +- [Virtualbox](https://www.virtualbox.org) - The Virtual Machines that Vagrant provisions need to be provisioned to VirtualBox - At least 6GB of free RAM ## Getting going 1. Clone [Rancher Quickstart](https://github.com/rancher/quickstart) to a folder using `git clone https://github.com/rancher/quickstart` -2. Go into the folder containing the terraform file `cd vagrant` + +2. Go into the folder containing the terraform file by executing `cd quickstart/vagrant` + 3. Edit the config.yaml if required (you can change the number of nodes and the memory allocations if required) + 4. To initiate the creation of the environment run `vagrant up` -5. Once provisioning has finished go to `https://172.22.101.100` in the browser (default user/password is `admin/password1` you can change the default password in the config.yaml prior to running the `vagrant up` command) + +5. Once provisioning has finished go to `https://172.22.101.100` in the browser (default user/password is `admin/password1` you can change this in the config.yaml prior to running the `vagrant up` command) ## Destroying the environment 1. From the `quickstart/vagrant` folder execute `vagrant destroy -f` + 2. Wait for it to confirm that all resources have been destroyed \ No newline at end of file diff --git a/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-ingress/_index.md b/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-ingress/_index.md index c6da2f8fbeb..ceb3dfa3692 100644 --- a/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-ingress/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-ingress/_index.md @@ -17,7 +17,7 @@ For this workload, you'll be deploying the application Rancher Hello-World. 2. From the main menu of the **Dashboard**, select **Projects**. -3. Open the **Default** project. +3. Open the **Project: Default** project. 4. Click **Deploy**. @@ -58,6 +58,7 @@ Now that the application is up and running you want to expose it so that browser 9. Leave everything else as default and click **Save** +10. This will create a `xip.io` address that may take a minute or two to populate ### View Your Application diff --git a/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-nodeport/_index.md b/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-nodeport/_index.md index b4e97178477..3b5c8788fe7 100644 --- a/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-nodeport/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-nodeport/_index.md @@ -1,5 +1,5 @@ --- -title: Workload with Nodeport Quick Start +title: Workload with NodePort Quick Start weight: 200 --- @@ -17,7 +17,7 @@ For this workload, you'll be deploying the application Rancher Hello-World. 2. From the main menu of the **Dashboard**, select **Projects**. -3. Open the **Default** project. +3. Open the **Project: Default** project. 4. Click **Deploy**. @@ -141,4 +141,4 @@ gettingstarted@rancher:~$ ## Finished -Congratulations! You have successfully deployed a workload exposed via a nodeport. +Congratulations! You have successfully deployed a workload exposed via a NodePort. From 35634b781caa1a4073e601b2e7b6ee02319bc3cd Mon Sep 17 00:00:00 2001 From: Chris Urwin Date: Wed, 11 Jul 2018 13:43:33 +0100 Subject: [PATCH 3/5] Updates following feedback --- .../deployment/digital-ocean-qs/_index.md | 31 ++++++++++--------- .../deployment/quickstart-vagrant/_index.md | 24 +++++++------- .../_index.md | 16 +++++----- .../_index.md | 2 +- 4 files changed, 38 insertions(+), 35 deletions(-) diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/digital-ocean-qs/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/digital-ocean-qs/_index.md index 33f5d811453..ecef799ca86 100644 --- a/content/rancher/v2.x/en/quick-start-guide/deployment/digital-ocean-qs/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/digital-ocean-qs/_index.md @@ -2,28 +2,31 @@ title: Digital Ocean Quick Start weight: 100 --- -The following steps will allow you to quickly deploy a Rancher Server with a 3 node cluster attached in about 5 minutes +The following steps will allow you to quickly deploy a Rancher Server with a 3-node cluster attached. >**Note** ->Using this will incur charges at Digital Ocean +>Deploying to Digital Ocean will incur charges. ## Prerequisites -- [Digital Ocean Account](https://www.digitalocean.com) - You will require an account on Digital Ocean as this is where the server and cluster will run -- [Terraform](https://www.terraform.io/downloads.html) - This is used to provision the server and cluster to Digital Ocean +- [Digital Ocean Account](https://www.digitalocean.com) - You will require an account on Digital Ocean as this is where the server and cluster will run. +- [Digital Ocean Access Key](https://www.digitalocean.com/community/tutorials/how-to-create-a-digitalocean-space-and-api-key) - Use this link to create a Digital Ocean Access Key if you don't have one. +- [Terraform](https://www.terraform.io/downloads.html) - Used to provision the server and cluster to Digital Ocean. -## Getting going +## Getting Going -1. Clone [Rancher Quickstart](https://github.com/rancher/quickstart) to a folder using `git clone https://github.com/rancher/quickstart` +1. Clone [Rancher Quickstart](https://github.com/rancher/quickstart) to a folder using `git clone https://github.com/rancher/quickstart`. -2. Go into the folder containing the terraform file by executing `cd quickstart/do` +2. Go into the folder containing the terraform file by executing `cd quickstart/do`. -3. Move the file `terraform.tfvars.example` to `terraform.tfvars` and edit (see inline explanation, the minimum you will need to do is add your Digital Ocean Access Key) +3. Rename file `terraform.tfvars.example` to `terraform.tfvars`. -4. For the first time run you will need to run `terraform init` +4. Edit `terraform.tfvars` to include your Digital Ocean Access Key. -5. To initiate the creation of the environment run `terraform apply` +5. For the first time run you will need to run `terraform init`. + +6. To initiate the creation of the environment run `terraform apply`. >**Wait for the the following** > ``` @@ -34,10 +37,10 @@ The following steps will allow you to quickly deploy a Rancher Server with a 3 n ] ``` -6. Paste the URL into the browser and log in (default password is `admin`) +6. Paste the URL into the browser and log in (default password is `admin`). -## Destroying the environment +## Destroying the Environment -1. From the `quickstart/do` folder execute `terraform destroy --force` +1. From the `quickstart/do` folder execute `terraform destroy --force` . -2. Wait for it to confirm that all resources have been destroyed \ No newline at end of file +2. Wait for confirmation that all resources have been destroyed. \ No newline at end of file diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-vagrant/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-vagrant/_index.md index 4863b54d3ee..fbd9ae4c848 100644 --- a/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-vagrant/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-vagrant/_index.md @@ -2,29 +2,29 @@ title: Vagrant Quick Start weight: 200 --- -The following steps will allow you to quickly deploy a Rancher Server with a 3 node cluster attached in about 10 minutes +The following steps will allow you to quickly deploy a Rancher Server with a 3-node cluster attached. ## Prerequisites -- [Vagrant](https://www.vagrantup.com) - Vagrant is required as this is used to provision the machine based on the Vagrantfile -- [Virtualbox](https://www.virtualbox.org) - The Virtual Machines that Vagrant provisions need to be provisioned to VirtualBox -- At least 6GB of free RAM +- [Vagrant](https://www.vagrantup.com) - Vagrant is required as this is used to provision the machine based on the Vagrantfile. +- [Virtualbox](https://www.virtualbox.org) - The Virtual Machines that Vagrant provisions need to be provisioned to VirtualBox. +- At least 6GB of free RAM. -## Getting going +## Getting Going -1. Clone [Rancher Quickstart](https://github.com/rancher/quickstart) to a folder using `git clone https://github.com/rancher/quickstart` +1. Clone [Rancher Quickstart](https://github.com/rancher/quickstart) to a folder using `git clone https://github.com/rancher/quickstart`. -2. Go into the folder containing the terraform file by executing `cd quickstart/vagrant` +2. Go into the folder containing the terraform file by executing `cd quickstart/vagrant`. -3. Edit the config.yaml if required (you can change the number of nodes and the memory allocations if required) +3. Edit the config.yaml if required (you can change the number of nodes and the memory allocations if required). -4. To initiate the creation of the environment run `vagrant up` +4. To initiate the creation of the environment run `vagrant up`. -5. Once provisioning has finished go to `https://172.22.101.100` in the browser (default user/password is `admin/password1` you can change this in the config.yaml prior to running the `vagrant up` command) +5. Once provisioning has finished go to `https://172.22.101.100` in the browser (default user/password is `admin/password1` you can change this in the config.yaml prior to running the `vagrant up` command). ## Destroying the environment -1. From the `quickstart/vagrant` folder execute `vagrant destroy -f` +1. From the `quickstart/vagrant` folder execute `vagrant destroy -f` . -2. Wait for it to confirm that all resources have been destroyed \ No newline at end of file +2. Wait for the confirmation that all resources have been destroyed. \ No newline at end of file diff --git a/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-ingress/_index.md b/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-ingress/_index.md index ceb3dfa3692..bbc8eb84b69 100644 --- a/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-ingress/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-ingress/_index.md @@ -5,7 +5,7 @@ weight: 100 ### Assumptions -- You have a running cluster with at least 1 node +- You have a running cluster with at least 1 node. ### Deploy a Workload @@ -36,9 +36,9 @@ For this workload, you'll be deploying the application Rancher Hello-World. * 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. -### Expose the workload via an ingress +### Expose The Application Via An Ingress -Now that the application is up and running you want to expose it so that browsers and other services can hit it +Now that the application is up and running it needs to be exposed so that otther services can connect. 1. From the **Clusters** page, open the cluster that you just created. @@ -50,19 +50,19 @@ Now that the application is up and running you want to expose it so that browser 5. Click **Add Ingress**. -6. Enter a name i.e. **hello** +6. Enter a name i.e. **hello**. -7. In the **Target* field, drop down the list and choose the name that you set for your service. +7. In the **Target** field, drop down the list and choose the name that you set for your service. 8. Enter `80` in the **Port** field. -9. Leave everything else as default and click **Save** +9. Leave everything else as default and click **Save**. -10. This will create a `xip.io` address that may take a minute or two to populate +10. This will create a `xip.io` address that may take a minute or two to populate. ### View Your Application -From the **Load Balancing** page, click the target link which will look something like **hello.default.xxx.xxx.xxx.xxx.xip.io > hello-world** +From the **Load Balancing** page, click the target link which will look something like **hello.default.xxx.xxx.xxx.xxx.xip.io > hello-world**. Your application will open in a seperate window. diff --git a/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-nodeport/_index.md b/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-nodeport/_index.md index 3b5c8788fe7..8ed84d52c29 100644 --- a/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-nodeport/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/workload/quickstart-deploy-workload-nodeport/_index.md @@ -5,7 +5,7 @@ weight: 200 ### Assumptions -- You have a running cluster with at least 1 node +- You have a running cluster with at least 1 node. ### Deploy a Workload From 62b62a700d41d0400d5d94b0e9894fc757db410d Mon Sep 17 00:00:00 2001 From: Denise Date: Mon, 23 Jul 2018 14:37:51 -0700 Subject: [PATCH 4/5] Update _index.md --- content/rancher/v2.x/en/quick-start-guide/_index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/rancher/v2.x/en/quick-start-guide/_index.md b/content/rancher/v2.x/en/quick-start-guide/_index.md index 185d8726fd1..c7c72a7dcc3 100644 --- a/content/rancher/v2.x/en/quick-start-guide/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/_index.md @@ -3,15 +3,15 @@ title: Quick Start Guides short title: Quick Start Index weight: 25 --- ->**Note:** The intent of these Quick Start Guides is to get you up and running in a sandbox environment quickly. It is not intended for a production environment. For more comprehensive instructions, see [Installation]({{< baseurl >}}/rancher/v2.x/en/installation/). +>**Note:** The intent of these quick start guides is to get you up and running in a sandbox environment quickly. It is not intended for a production environment. For more comprehensive instructions, see [Installation]({{< baseurl >}}/rancher/v2.x/en/installation/). We are going to continue to grow the content of these quick starts to give you a jump start in deploying and testing Rancher 2.0! -The current areas covered by Quick Starts are: +The current areas covered by quick starts are: -- [Deploying Rancher Server](./deployment) - This gives Quick Start Guides to get you running via different methods. +- **[Deploying Rancher Server]({{< baseurl >}}/rancher/v2.x/en/quick-start-guide/deployment/)**: Guides to get you running Rancher via different methods. -- [Deploying a Workload](./workload) - This gives Quick Start Guide for deploying a workload and exposing it. +- **[Deploying a Workload]({{< baseurl >}}/rancher/v2.x/en/quick-start-guide//workload/)**: A guide for deploying a workload and exposing it to be accessed externally. From 8a39e9b8b10c4a45d42577c8a31e402fc74083af Mon Sep 17 00:00:00 2001 From: Denise Date: Mon, 23 Jul 2018 14:39:02 -0700 Subject: [PATCH 5/5] Update _index.md --- content/rancher/v2.x/en/quick-start-guide/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/rancher/v2.x/en/quick-start-guide/_index.md b/content/rancher/v2.x/en/quick-start-guide/_index.md index c7c72a7dcc3..5d3a7b7057e 100644 --- a/content/rancher/v2.x/en/quick-start-guide/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/_index.md @@ -11,7 +11,7 @@ The current areas covered by quick starts are: - **[Deploying Rancher Server]({{< baseurl >}}/rancher/v2.x/en/quick-start-guide/deployment/)**: Guides to get you running Rancher via different methods. -- **[Deploying a Workload]({{< baseurl >}}/rancher/v2.x/en/quick-start-guide//workload/)**: A guide for deploying a workload and exposing it to be accessed externally. +- **[Deploying Workloads]({{< baseurl >}}/rancher/v2.x/en/quick-start-guide//workload/)**: Guides for deploying workloads and exposing it to be accessed externally.