From 7eabfd51f907f00fd7179be68963a20b7f1b0210 Mon Sep 17 00:00:00 2001 From: Chris Urwin Date: Fri, 6 Jul 2018 15:07:55 +0100 Subject: [PATCH] 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.