From 3e93983e8d29586c9dcc53627f3588b694638e92 Mon Sep 17 00:00:00 2001 From: Mark Bishop Date: Wed, 9 May 2018 12:39:14 -0700 Subject: [PATCH] reorganized overview/architecture content --- content/rancher/v2.x/en/_index.md | 114 +----------------- content/rancher/v2.x/en/docs/_index.md | 18 +++ .../{overview => docs/architecture}/_index.md | 42 +------ .../rancher/v2.x/en/docs/overview/_index.md | 27 +++++ 4 files changed, 48 insertions(+), 153 deletions(-) create mode 100644 content/rancher/v2.x/en/docs/_index.md rename content/rancher/v2.x/en/{overview => docs/architecture}/_index.md (60%) create mode 100644 content/rancher/v2.x/en/docs/overview/_index.md diff --git a/content/rancher/v2.x/en/_index.md b/content/rancher/v2.x/en/_index.md index d8db0fbe01f..42da957f707 100644 --- a/content/rancher/v2.x/en/_index.md +++ b/content/rancher/v2.x/en/_index.md @@ -4,126 +4,16 @@ shortTitle: Rancher 2.0 insertOneSix: true weight: 1 --- - # Rancher 2.0 Documentation -## Rancher Overview - -Rancher is a container management platform built for organizations that deploy containers in production. Rancher makes it easy to run Kubernetes everywhere, meet IT requirements, and empower DevOps teams. - -### Run Kubernetes Everywhere - -Kubernetes is the container orchestration standard. Most cloud and virtualization vendors now offer it as standard infrastructure. Rancher users have the choice of creating Kubernetes clusters with Rancher Kubernetes Engine (RKE) or cloud Kubernetes services, such as Google Kubernetes Engine (GKE), Azure Container Service (AKS), and Amazon Elastic Container Service for Kubernetes (EKS). Rancher users can also import and manage their existing Kubernetes clusters that were created using any Kubernetes distribution or installer. - -### Meet IT requirements - -Rancher supports centralized authentication for all Kubernetes clusters under its control. For example, you can: - -- Use your Active Directory credentials to access Kubernetes clusters hosted by cloud vendors, such as GKE. -- Setup and enforce access control and security policies across all users, groups, projects, clusters, and clouds. -- View the health and capacity of your Kubernetes clusters from a single-pane-of-glass. - -### Empower DevOps Teams - -Rancher provides an intuitive user interface for DevOps engineers to manage their application workload. The user doesn't need in-depth knowledge of Kubernetes to start using Rancher. Rancher catalog contains a set of useful DevOps tools. Rancher is certified with a wide selection of cloud native ecosystem products, including security tools, monitoring systems, container registries, and storage and networking drivers. - -The following figure illustrates Rancher's role in IT and DevOps organizations. Each team deploys their applications on the public or private clouds they choose. IT administrators gain visibility and enforce policies across all users, clusters, and clouds. - -![Platform]({{< baseurl >}}/img/rancher/platform.png) - - ## What's New? -The previous version of Rancher, version 1.6, was a container management platform built on Docker. Rancher 2.0 builds on the success and experience of 1.6. +The previous version of Rancher, version 1.6, was a container management platform built on Docker. Rancher 2.0 builds on the success and experience of Rancher 1.6. -However, for version 2.0, most of Rancher is redesigned to work on Kubernetes. 2.0 retains the user-friendly features of 1.6, such as the UI and catalog. However, 2.0 includes many new features such as: +However, for version 2.0, most of Rancher has been redesigned to work on Kubernetes. Rancher 2.0 retains the user-friendly features of version 1.6, such as the UI and catalog. However, 2.0 now includes many new features such as: - Built-in CI pipeline - Alerts and log aggregation - Multi-cluster management - Rancher Kubernetes Engine (RKE) - Integration with cloud Kubernetes services, such as GKE, EKS, and AKS. - -# Rancher Architecture - -This section explains how Rancher interacts with the two fundamental technologies Rancher is built on: Docker and Kubernetes. - -## Docker - -Docker is the container packaging and runtime standard. Developers build container images from Dockerfiles and distribute container images from Docker registries. [Docker Hub](http://hub.docker.com) is the most popular public registry. Many organizations also setup private Docker registries. Docker is primarily used to manage containers on individual nodes. - ->**Note:** Although Rancher 1.6 supported Docker Swarm clustering technology, it is no longer supported in Rancher 2.0 due to the success of Kubernetes. - -## Kubernetes - -Kubernetes is the container cluster management standard. YAML files specify containers and other resources that form an application. Kubernetes performs functions such as scheduling, scaling, service discovery, health check, secret management, and configuration management. - -A Kubernetes cluster consists of multiple nodes. - -- **etcd database** - - Although you can run etcd on just one node, it typically takes 3, 5 or more nodes to create an HA configuration. - -- **Master nodes** - - Master nodes are stateless and are used to run the API server, scheduler, and controllers. - -- **Worker nodes** - - The application workload runs on worker nodes. - -## Rancher - -The majority of Rancher 2.0 software runs on the Rancher Server. Rancher Server includes all the software components used to manage the entire Rancher deployment. - -The figure below illustrates the high-level architecture of Rancher 2.0. The figure depicts a Rancher Server installation that manages two Kubernetes clusters: one created by RKE and another created by GKE. - -![Architecture]({{< baseurl >}}/img/rancher/rancher-architecture.png) - -In this section we describe the functionalities of each Rancher server components. - -#### Rancher API Server - -Rancher API server is built on top of an embedded Kubernetes API server and etcd database. It implements the following functionalities: - -- **User Management** - - Rancher API server manages user identities that correspond to external authentication providers like Active Directory or GitHub. - -- **Authorization** - - Rancher API server manages access control and security policies. - -- **Projects** - - A _project_ is a group of multiple namespaces and access control policies within a cluster. - -- **Nodes** - - Rancher API server tracks identities of all the nodes in all clusters. - -#### Cluster Controller and Agents - -The cluster controller and cluster agents implement the business logic required to manage Kubernetes clusters. - -- The _cluster controller_ implements the logic required for the global Rancher install. It performs the following actions: - - - Configuration of access control policies to clusters and projects. - - - Provisioning of clusters by calling: - - - The required Docker machine drivers. - - Kubernetes engines like RKE and GKE. - - -- A separate _cluster agent_ instance implements the logic required for the corresponding cluster. It performs the following activities: - - - Workload Management, such as pod creation and deployment within each cluster. - - - Application of the roles and bindings defined in each cluster's global policies. - - - Communication between clusters and Rancher Server: events, stats, node info, and health. - -#### Authentication Proxy - -The _authentication proxy_ forwards all Kubernetes API calls. It integrates with authentication services like local authentication, Active Directory, and GitHub. On every Kubernetes API call, the authentication proxy authenticates the caller and sets the proper Kubernetes impersonation headers before forwarding the call to Kubernetes masters. Rancher communicates with Kubernetes clusters using a service account. diff --git a/content/rancher/v2.x/en/docs/_index.md b/content/rancher/v2.x/en/docs/_index.md new file mode 100644 index 00000000000..b75238adc3e --- /dev/null +++ b/content/rancher/v2.x/en/docs/_index.md @@ -0,0 +1,18 @@ +--- +title: Docs +aliases: [/rancher/v2.x/en/] +weight: 1 +--- +# Rancher 2.0 Documentation + +## What's New? + +The previous version of Rancher, version 1.6, was a container management platform built on Docker. Rancher 2.0 builds on the success and experience of Rancher 1.6. + +However, for version 2.0, most of Rancher has been redesigned to work on Kubernetes. Rancher 2.0 retains the user-friendly features of version 1.6, such as the UI and catalog. However, 2.0 now includes many new features such as: + +- Built-in CI pipeline +- Alerts and log aggregation +- Multi-cluster management +- Rancher Kubernetes Engine (RKE) +- Integration with cloud Kubernetes services, such as GKE, EKS, and AKS. diff --git a/content/rancher/v2.x/en/overview/_index.md b/content/rancher/v2.x/en/docs/architecture/_index.md similarity index 60% rename from content/rancher/v2.x/en/overview/_index.md rename to content/rancher/v2.x/en/docs/architecture/_index.md index c8f9cf4af84..f939bf9ea34 100644 --- a/content/rancher/v2.x/en/overview/_index.md +++ b/content/rancher/v2.x/en/docs/architecture/_index.md @@ -1,47 +1,7 @@ --- -title: Overview -shortTitle: Rancher 2.0 +title: Architecture weight: 1 --- -# Rancher 2.0 Documentation - -## Rancher Overview - -Rancher is a container management platform built for organizations that deploy containers in production. Rancher makes it easy to run Kubernetes everywhere, meet IT requirements, and empower DevOps teams. - -### Run Kubernetes Everywhere - -Kubernetes has become the container orchestration standard. Most cloud and virtualization vendors now offer it as standard infrastructure. Rancher users have the choice of creating Kubernetes clusters with Rancher Kubernetes Engine (RKE) or cloud Kubernetes services, such as GKE, AKS, and EKS. Rancher users can also import and manage their existing Kubernetes clusters created using any Kubernetes distribution or installer. - -### Meet IT requirements - -Rancher supports centralized authentication for all Kubernetes clusters under its control. For example, you can: - -- Use your Active Directory credentials to access Kubernetes clusters hosted by cloud vendors, such as GKE. -- Setup and enforce access control and security policies across all users, groups, projects, clusters, and clouds. -- View the health and capacity of your Kubernetes clusters from a single-pane-of-glass. - -### Empower DevOps Teams - -Rancher provides an intuitive user interface for DevOps engineers to manage their application workload. The user does not need to have in-depth knowledge of Kubernetes concepts to start using Rancher. Rancher catalog contains a set of useful DevOps tools. Rancher is certified with a wide selection of cloud native ecosystem products, including, for example, security tools, monitoring systems, container registries, and storage and networking drivers. - -The following figure illustrates the role Rancher plays in IT and DevOps organizations. Each team deploys their applications on the public or private clouds they choose. IT administrators gain visibility and enforce policies across all users, clusters, and clouds. - -![Platform]({{< baseurl >}}/img/rancher/platform.png) - - -## What's New? - -The previous version of Rancher, version 1.6, was a container management platform built on Docker. Rancher 2.0 builds on the success and experience of Rancher 1.6. - -However, for version 2.0, most of Rancher has been redesigned to work on Kubernetes. Rancher 2.0 retains the user-friendly features of version 1.6, such as the UI and catalog. However, 2.0 now includes many new features such as: - -- Built-in CI pipeline -- Alerts and log aggregation -- Multi-cluster management -- Rancher Kubernetes Engine (RKE) -- Integration with cloud Kubernetes services, such as GKE, EKS, and AKS. - # Rancher Architecture Before explaining Rancher architecture, it is useful to present some background information on two fundamental technologies Rancher build on: Docker and Kubernetes. diff --git a/content/rancher/v2.x/en/docs/overview/_index.md b/content/rancher/v2.x/en/docs/overview/_index.md new file mode 100644 index 00000000000..a6296f276a2 --- /dev/null +++ b/content/rancher/v2.x/en/docs/overview/_index.md @@ -0,0 +1,27 @@ +--- +title: Overview +weight: 1 +--- +# Rancher Overview + +Rancher is a container management platform built for organizations that deploy containers in production. Rancher makes it easy to run Kubernetes everywhere, meet IT requirements, and empower DevOps teams. + +## Run Kubernetes Everywhere + +Kubernetes has become the container orchestration standard. Most cloud and virtualization vendors now offer it as standard infrastructure. Rancher users have the choice of creating Kubernetes clusters with Rancher Kubernetes Engine (RKE) or cloud Kubernetes services, such as GKE, AKS, and EKS. Rancher users can also import and manage their existing Kubernetes clusters created using any Kubernetes distribution or installer. + +## Meet IT requirements + +Rancher supports centralized authentication for all Kubernetes clusters under its control. For example, you can: + +- Use your Active Directory credentials to access Kubernetes clusters hosted by cloud vendors, such as GKE. +- Setup and enforce access control and security policies across all users, groups, projects, clusters, and clouds. +- View the health and capacity of your Kubernetes clusters from a single-pane-of-glass. + +### Empower DevOps Teams + +Rancher provides an intuitive user interface for DevOps engineers to manage their application workload. The user does not need to have in-depth knowledge of Kubernetes concepts to start using Rancher. Rancher catalog contains a set of useful DevOps tools. Rancher is certified with a wide selection of cloud native ecosystem products, including, for example, security tools, monitoring systems, container registries, and storage and networking drivers. + +The following figure illustrates the role Rancher plays in IT and DevOps organizations. Each team deploys their applications on the public or private clouds they choose. IT administrators gain visibility and enforce policies across all users, clusters, and clouds. + +![Platform]({{< baseurl >}}/img/rancher/platform.png)