diff --git a/content/_index.html b/content/_index.html index de6aba7eb7b..3ad552616f8 100644 --- a/content/_index.html +++ b/content/_index.html @@ -20,7 +20,7 @@ description: ""
-

Rancher 1.X

+

Rancher 1.6

Read the Docs
diff --git a/content/os/overview/_index.md b/content/os/overview/_index.md new file mode 100644 index 00000000000..d976d3554b8 --- /dev/null +++ b/content/os/overview/_index.md @@ -0,0 +1,45 @@ +--- +title: Overview +shortTitle: RancherOS +description: RancherOS is a simplified Linux distribution built from containers, for containers. These documents describe how to install and use RancherOS. +weight: 1 +--- + +## Overview of RancherOS +--- +RancherOS is the smallest, easiest way to run Docker in production. Everything in RancherOS is a container managed by Docker. This includes system services such as `udev` and `syslog`. Because it only includes the services necessary to run Docker, RancherOS is dramatically smaller than most traditional operating systems. By removing unnecessary libraries and services, requirements for security patches and other maintenance are dramatically reduced. This is possible because, with Docker, users typically package all necessary libraries into their containers. + +Another way in which RancherOS is designed specifically for running Docker is that it always runs the latest version of Docker. This allows users to take advantage of the latest Docker capabilities and bug fixes. + +Like other minimalist Linux distributions, RancherOS boots incredibly quickly, generally in 5-10 seconds. Starting Docker containers is nearly instant, similar to starting any other process. This quickness is ideal for organizations adopting microservices and autoscaling. + +Docker is an open-source platform designed for developers, system admins, and DevOps, it is used to build, ship, and run containers, using simple yet powerful CLI (Command Line Interface), you can get started with Docker from [Docker user guide](https://docs.docker.com/engine/userguide/). + +### Hardware Requirements + +* x86_64 server with at least 512MB of RAM. + +> **Note:** If you are planning on [installing to disk]({{< baseurl >}}/os/installation/running-rancheros/server/install-to-disk/), you will need at least 1024MB of RAM. + + +### How this works + +Everything in RancherOS is a Docker container. We accomplish this by launching two instances of Docker. One is what we call **System Docker**, the first process on the system. All other system services, like `ntpd`, `syslog`, and `console`, are running in Docker containers. System Docker replaces traditional init systems like `systemd`, and can be used to launch [additional system services]({{< baseurl >}}/os/installation/system-services/adding-system-services/). + +System Docker runs a special container called **Docker**, which is another Docker daemon responsible for managing all of the user’s containers. Any containers that you launch as a user from the console will run inside this Docker. This creates isolation from the System Docker containers, and ensures normal user commands don’t impact system services. + + We created this separation because it seemed logical and also it would really be bad if somebody did +`docker rm -f $(docker ps -qa)` and deleted the entire OS. + +![How it works]({{< baseurl >}}/img/os/rancheroshowitworks.png) + +### Running RancherOS + +To find out more about installing RancherOS, jump to our [Quick Start Guide]({{< baseurl >}}/os/quick-start-guide/). + +### Latest Release + +Please check our repository for the latest release in our [README](https://github.com/rancher/os/blob/master/README.md). + +
+
diff --git a/content/rancher/quick-start-guide/_index.md b/content/rancher/quick-start-guide/_index.md index 8021fc45dfa..2cc33f21e1a 100644 --- a/content/rancher/quick-start-guide/_index.md +++ b/content/rancher/quick-start-guide/_index.md @@ -15,20 +15,26 @@ Howdy Partner! This tutorial walks you through: This Quick Start Guide is divided into different tasks for easier consumption. -1. Begin by provisioning a Linux host. -2. [Provision a Linux Host](#provision-a-linux-host) +1. [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)
+ From your Linux host, run the Docker command for installing Rancher. -3. Browse to your Linux host to access the Rancher UI.[Log In](#log-in) +3. [Log In](#log-in)
+ Browse to your Linux host to access the Rancher UI. -4. Use the versatile **Custom** option to clone your Linux host into a new Kubernetes cluster.[Create the Cluster](#create-the-cluster) +4. [Create the Cluster](#create-the-cluster)
+ Use the versatile **Custom** option to clone your Linux host into a new Kubernetes cluster. -5. Create a workload so that Kubernetes can distribute NGINX among your cluster nodes.[Deploy a Workload](#deploy-a-workload) +5. [Deploy a Workload](#deploy-a-workload)
+ Create a workload so that Kubernetes can distribute NGINX among your cluster nodes. -6. When your workload finishes deployment, browse to your node IP to make sure NGINX is running.[View Your Application](#view-your-application) +6. [View Your Application](#view-your-application)
+ When your workload finishes deployment, browse to your node IP to make sure NGINX is running. -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) +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 @@ -72,7 +78,7 @@ To install Rancher on your host, connect to it and then use a shell to install. $ sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 rancher/rancher ``` -#### Result: Rancher is installed. +**Result: Rancher is installed.** ### Log In diff --git a/content/rancher/tasks/clusters/creating-a-cluster/create-cluster-amazon-ec2.md b/content/rancher/tasks/clusters/creating-a-cluster/create-cluster-amazon-ec2.md index 7d5e91ab4f0..475ac2d5558 100644 --- a/content/rancher/tasks/clusters/creating-a-cluster/create-cluster-amazon-ec2.md +++ b/content/rancher/tasks/clusters/creating-a-cluster/create-cluster-amazon-ec2.md @@ -30,37 +30,21 @@ Provision the instance according to our [requirements](../setup/requirements.md) Use {{< product >}} to clone your Linux host and configure them as Kubernetes nodes. 1. From the **Clusters** page, click **Add Cluster**. - -2. Choose **Amazon EC2**. - -3. Enter a **Cluster Name**. - -4. {{< step_create-cluster_member-roles >}} - -5. {{< step_create-cluster_cluster-options >}} - -6. {{< step_create-cluster_node-pools >}} - +1. Choose **Amazon EC2**. +1. Enter a **Cluster Name**. +1. {{< step_create-cluster_member-roles >}} +1. {{< step_create-cluster_cluster-options >}} +1. {{< step_create-cluster_node-pools >}} 1. Click **Add Node Template**. - - 2. Complete each of the following forms using information available from the [EC2 Management Console](https://aws.amazon.com/ec2). - - - **Account Access** holds the region and API Key used to create the cluster. - + Complete each of the following forms using information available from the [EC2 Management Console](https://aws.amazon.com/ec2). + - **Account Access** holds the region and API Key used to create the cluster. [Amazon Documentation: Creating Access Keys](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey) - - - **Zone and Network** configures the availability zone and network settings for your cluster. - - - **Security Groups** configures the security groups applied to your cluster. - - - **Instance** provisions your VM instances. - - 3. {{< step_rancher-template >}} - - 4. Click **Create**. - - 5. **Optional:** Add additional node pools. -
-6. Review your cluster settings to confirm they're correct. Then click **Create**. + - **Zone and Network** configures the availability zone and network settings for your cluster. + - **Security Groups** configures the security groups applied to your cluster. + - **Instance** provisions your VM instances. + 1. {{< step_rancher-template >}} + 1. Click **Create**. + 1. **Optional:** Add additional node pools. +1. Review your cluster settings to confirm they're correct. Then click **Create**. {{< result_create-cluster >}} diff --git a/layouts/_default/list.html b/layouts/_default/list.html index 80a7ffc1a7c..cf069b0c768 100644 --- a/layouts/_default/list.html +++ b/layouts/_default/list.html @@ -28,7 +28,7 @@
{{ if ($.Scratch.Get "showSidebar") }} -