diff --git a/content/rancher/v2.x/en/admin-settings/_index.md b/content/rancher/v2.x/en/admin-settings/_index.md
index f461b9a8199..62d16d95657 100644
--- a/content/rancher/v2.x/en/admin-settings/_index.md
+++ b/content/rancher/v2.x/en/admin-settings/_index.md
@@ -2,7 +2,8 @@
title: Admin Settings
weight: 1100
aliases:
- - /rancher/v2.x/en/concepts/global-configuration
+ - /rancher/v2.x/en/concepts/global-configuration/
+ - /rancher/v2.x/en/tasks/global-configuration/
---
After installing Rancher 2.0, you should
@@ -11,4 +12,4 @@ After installing Rancher 2.0, you should
2. Set up external user authentication and permissions so that your organization can log into Rancher.
-After making these initial configurations, you might also want to configure one or more _pod security policies_, which are sets of conditions that your pods must meet for Kubernetes to allow them to run.
\ No newline at end of file
+After making these initial configurations, you might also want to configure one or more _pod security policies_, which are sets of conditions that your pods must meet for Kubernetes to allow them to run.
diff --git a/content/rancher/v2.x/en/concepts/catalogs/_index.md b/content/rancher/v2.x/en/catalog-and-charts/_index.md
similarity index 91%
rename from content/rancher/v2.x/en/concepts/catalogs/_index.md
rename to content/rancher/v2.x/en/catalog-and-charts/_index.md
index 63cf14b40c0..4c71d9eeb3d 100644
--- a/content/rancher/v2.x/en/concepts/catalogs/_index.md
+++ b/content/rancher/v2.x/en/catalog-and-charts/_index.md
@@ -1,8 +1,18 @@
---
title: Catalogs and Charts
-weight: 2250
+weight: 4000
+aliases:
+ - /rancher/v2.x/en/concepts/global-configuration/catalog/
+ - /rancher/v2.x/en/tasks/global-configuration/catalog/
---
+This section includes step-by-step instruction on how to configure default and custom catalogs.
+
+- [Enabling Default Catalogs]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts/enabling-default-catalogs)
+- [Adding Custom Catalogs]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts/adding-custom-catalogs)
+- [Customizing Charts]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts/customizing-charts)
+
+
_Catalogs_ are GitHub repositories filled with applications that are ready-made for deployment. Applications are bundled in objects called _charts_.
_Charts_ are a packaging format popularized by [Helm](https://docs.helm.sh/). Think of them as templates for deployments. Per Helm, charts are:
@@ -18,7 +28,7 @@ Within Rancher, you can access several different catalogs either by default or t
- **Library**
The Library Catalog includes charts curated by Rancher. Rancher stores charts in a Git repository to expedite the fetch and update of charts. In Rancher 2.0, only global catalogs are supported. Support for cluster-level and project-level charts will be added in the future.
-
+
This catalog features Rancher Charts, which include some [notable advantages](#chart-types) over native Helm charts.
- **Helm Stable**
@@ -32,9 +42,9 @@ Within Rancher, you can access several different catalogs either by default or t
- **Custom**
Finally, you have the option of building your own catalogs. Custom catalogs are useful when you have a handful of apps that you deploy regularly in a specific configuration.
-
+
### Custom Catalog Creation
-
+
Creating a custom catalog for Rancher is straightforward. Create a Git repo and then direct Rancher toward the repo.
Custom catalog requirements include:
@@ -42,7 +52,7 @@ Custom catalog requirements include:
- A unique name.
- A URL that `git clone` can handle.
-For step-by-step directions, see [Adding Custom Catalogs]({{< baseurl >}}/rancher/v2.x/en/tasks/global-configuration/catalog/adding-custom-catalogs).
+For step-by-step directions, see [Adding Custom Catalogs]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts/adding-custom-catalogs).
When you're done creating the catalog, populate it with charts. Custom catalogs can support both native Helm charts and Rancher charts. See [Custom Chart Creation](#custom-chart-creation).
@@ -132,15 +142,15 @@ The following table demonstrates the directory structure for a chart, which can
Before you create your own custom catalog, you should have a basic understanding about how a Rancher chart differs from a native Helm chart. Rancher charts differ slightly from Helm charts in their directory structures. Rancher charts include two files that Helm charts do not.
- `app-readme.md`
-
+
A file that provides descriptive text in the chart's UI header. The following image displays the difference between a Rancher chart (which includes `app-readme.md`) and a native Helm chart (which does not).
Rancher Chart with app-readme.md (left) vs. Helm Chart without (right)

-
+
- `questions.yml`
-
+
A file that contains questions for a form. These form questions simplify deployment of a chart. Without it, you must configure the deployment using key value pairs, which is more difficult. The following image displays the difference between a Rancher chart (which includes `questions.yml`) and a native Helm chart (which does not).
@@ -153,6 +163,6 @@ Before you create your own custom catalog, you should have a basic understanding
You can fill your custom catalogs with either Helm Charts or Rancher Charts, although we recommend Rancher Charts due to their enhanced user experience.
- For information on how to add and customize charts for a custom catalog, see [Customizing Charts]({{< baseurl >}}/rancher/v2.x/en/tasks/global-configuration/catalog/customizing-charts).
+ For information on how to add and customize charts for a custom catalog, see [Customizing Charts]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts/customizing-charts).
>**Note:** For a complete walkthrough of developing charts, see the upstream Helm chart [developer reference](https://docs.helm.sh/developing_charts/).
diff --git a/content/rancher/v2.x/en/tasks/global-configuration/catalog/adding-custom-catalogs/_index.md b/content/rancher/v2.x/en/catalog-and-charts/adding-custom-catalogs/_index.md
similarity index 81%
rename from content/rancher/v2.x/en/tasks/global-configuration/catalog/adding-custom-catalogs/_index.md
rename to content/rancher/v2.x/en/catalog-and-charts/adding-custom-catalogs/_index.md
index 2ffd60ae731..6a2d95e72b6 100644
--- a/content/rancher/v2.x/en/tasks/global-configuration/catalog/adding-custom-catalogs/_index.md
+++ b/content/rancher/v2.x/en/catalog-and-charts/adding-custom-catalogs/_index.md
@@ -1,6 +1,8 @@
---
title: Adding Custom Catalogs
-weight: 50
+weight: 4015
+aliases:
+ - /rancher/v2.x/en/tasks/global-configuration/catalog/adding-custom-catalogs/
---
You can create custom catalogs of charts for use in Rancher. Custom catalogs are helpful for fast deployment of applications unique to your environment.
@@ -23,8 +25,8 @@ You can create custom catalogs of charts for use in Rancher. Custom catalogs are
2. Click **Add Catalog**.
3. Complete the form and click **Create**.
-**Result**: Your catalog is added to Rancher.
+**Result**: Your catalog is added to Rancher.
## What's Next?
-Add native Helm charts, Rancher charts, or both to your repository. For more information, see [Customizing Charts]({{< baseurl >}}/rancher/v2.x/en/tasks/global-configuration/catalog/customizing-charts/).
\ No newline at end of file
+Add native Helm charts, Rancher charts, or both to your repository. For more information, see [Customizing Charts]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts/customizing-charts/).
diff --git a/content/rancher/v2.x/en/tasks/global-configuration/catalog/customizing-charts/_index.md b/content/rancher/v2.x/en/catalog-and-charts/customizing-charts/_index.md
similarity index 97%
rename from content/rancher/v2.x/en/tasks/global-configuration/catalog/customizing-charts/_index.md
rename to content/rancher/v2.x/en/catalog-and-charts/customizing-charts/_index.md
index 14d3ee107bd..a72c0eb5ab4 100644
--- a/content/rancher/v2.x/en/tasks/global-configuration/catalog/customizing-charts/_index.md
+++ b/content/rancher/v2.x/en/catalog-and-charts/customizing-charts/_index.md
@@ -1,6 +1,8 @@
---
title: Customizing Charts
-weight: 75
+weight: 4020
+aliases:
+ - /rancher/v2.x/en/tasks/global-configuration/catalog/customizing-charts/
---
Before you can deploy customized catalog apps using Rancher, you must add charts to the GitHub repository serving as your custom catalog.
@@ -11,7 +13,7 @@ The custom catalog can contain native Helm charts, Rancher charts, or a combinat
>- Recommended: Read [Catalogs and Charts]({{< baseurl >}}/rancher/v2.x/en/concepts/catalogs).
>- Create a GitHub repository to serve as your custom catalog.
->- Complete [Adding Custom Catalogs]({{< baseurl >}}/rancher/v2.x/en/tasks/global-configuration/catalog/adding-custom-catalogs).
+>- Complete [Adding Custom Catalogs]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts/adding-custom-catalogs).
>**Note:** Customization of Helm charts takes place outside of the Rancher UI.
@@ -19,7 +21,7 @@ The custom catalog can contain native Helm charts, Rancher charts, or a combinat
Rancher requires this directory structure, although `app-readme.md` and `questions.yml` are optional.
- >**Tip:**
+ >**Tip:**
>
>- To begin customizing a chart, copy one from either the [Rancher Library](https://github.com/rancher/charts) or the [Helm Stable](https://github.com/kubernetes/charts/tree/master/stable).
>- For a complete walk through of developing charts, see the upstream Helm chart [developer reference](https://docs.helm.sh/developing_charts/).
diff --git a/content/rancher/v2.x/en/tasks/global-configuration/catalog/enabling-default-catalogs/_index.md b/content/rancher/v2.x/en/catalog-and-charts/enabling-default-catalogs/_index.md
similarity index 73%
rename from content/rancher/v2.x/en/tasks/global-configuration/catalog/enabling-default-catalogs/_index.md
rename to content/rancher/v2.x/en/catalog-and-charts/enabling-default-catalogs/_index.md
index 7faa1b57159..d0c1b1c6f90 100644
--- a/content/rancher/v2.x/en/tasks/global-configuration/catalog/enabling-default-catalogs/_index.md
+++ b/content/rancher/v2.x/en/catalog-and-charts/enabling-default-catalogs/_index.md
@@ -1,21 +1,23 @@
---
title: Enabling Default Catalogs
-weight: 25
+weight: 4005
+aliases:
+ - /rancher/v2.x/en/tasks/global-configuration/catalog/enabling-default-catalogs/
---
-Out-of-the-box, you can enable several different catalog repositories to simplify deployment of applications.
+Out-of-the-box, you can enable several different catalog repositories to simplify deployment of applications.
1. From the **Global** view, choose **Catalogs** from the main menu.
2. Toggle the default catalogs that you want use to a setting of **Enabled**. The [default catalogs]({{< baseurl >}}/rancher/v2.x/en/concepts/catalogs/#catalog-types) are:
-
+
- **Library**
- **Helm Stable**
- **Helm Incubator**
- >**Note:** If you want to use a custom catalog, see [Adding Custom Catalogs]({{< baseurl >}}/rancher/v2.x/en/tasks/global-configuration/catalog/adding-custom-catalogs) instead of this topic.
+ >**Note:** If you want to use a custom catalog, see [Adding Custom Catalogs]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts/adding-custom-catalogs) instead of this topic.
**Result:** The chosen catalogs are enabled. Wait a few minutes for Rancher to replicate the catalog charts. When replication completes, you'll be able to see them in any of your projects by selecting **Catalog Apps** from the main menu.
## What's Next?
-Deploy catalog applications to your cluster nodes. For more information, see [Launching a Catalog App]({{< baseurl >}}/rancher/v2.x/en/tasks/projects/launch-a-catalog-app).
\ No newline at end of file
+Deploy catalog applications to your cluster nodes. For more information, see [Launching a Catalog App]({{< baseurl >}}/rancher/v2.x/en/tasks/projects/launch-a-catalog-app).
diff --git a/content/rancher/v2.x/en/catalog-and-charts/launching-catalog-apps/_index.md b/content/rancher/v2.x/en/catalog-and-charts/launching-catalog-apps/_index.md
new file mode 100644
index 00000000000..6d1645d43e7
--- /dev/null
+++ b/content/rancher/v2.x/en/catalog-and-charts/launching-catalog-apps/_index.md
@@ -0,0 +1,4 @@
+---
+title: Launching Catalog Applications
+weight: 4010
+---
diff --git a/content/rancher/v2.x/en/concepts/cli-configuration/_index.md b/content/rancher/v2.x/en/cli/_index.md
similarity index 96%
rename from content/rancher/v2.x/en/concepts/cli-configuration/_index.md
rename to content/rancher/v2.x/en/cli/_index.md
index 719df932a47..c8876b2e9b4 100644
--- a/content/rancher/v2.x/en/concepts/cli-configuration/_index.md
+++ b/content/rancher/v2.x/en/cli/_index.md
@@ -1,6 +1,8 @@
---
title: Rancher CLI
-weight: 1
+weight: 6000
+aliases:
+ - /rancher/v2.x/en/concepts/cli-configuration/
---
Rancher CLI (Command Line Interface) is a unified tool that you can use to interact with Rancher. With this tool, you can operate Rancher using a command line rather than the GUI.
@@ -14,7 +16,7 @@ The binary can be downloaded directly from the UI. The link can be found in the
After you download the Rancher CLI, you need to make a few configurations. Rancher CLI requires:
- Your [Rancher Server URL]({{< baseurl >}}/rancher/v2.x/en/tasks/global-configuration/server-url), which is used to connect to Rancher Server.
-- An API Bearer Token, which is used to authenticate with Rancher. For more information about obtaining a Bearer Token, see [Creating an API Key]({{< baseurl >}}/rancher/v2.x/en/tasks/user-settings/api-keys/).
+- An API Bearer Token, which is used to authenticate with Rancher. For more information about obtaining a Bearer Token, see [Creating an API Key]({{< baseurl >}}/rancher/v2.x/en/user-settings/api-keys/).
### CLI Authentication
diff --git a/content/rancher/v2.x/en/concepts/api-keys/_index.md b/content/rancher/v2.x/en/concepts/api-keys/_index.md
deleted file mode 100644
index c368f698011..00000000000
--- a/content/rancher/v2.x/en/concepts/api-keys/_index.md
+++ /dev/null
@@ -1,14 +0,0 @@
----
-title: API Keys
-weight: 2400
----
-
-Some users may want to access their Rancher clusters and projects through the Rancher API. Before you can access Rancher through the API, you must generate API keys so that you can authenticate with Rancher externally.
-
-Before you can use the Rancher CLI or write a program that calls the Rancher API, you must obtain API keys using the Rancher UI.
-
-### API Keys and User Authentication
-
-After logging into Rancher, you can generate API keys for accessing Rancher externally using your user settings. If you need to revoke access to the Rancher API, you can delete the API key.
-
-For instructions on how to create an API key, see [Creating an API Key]({{< baseurl >}}/rancher/v2.x/en/tasks/user-settings/api-keys/).
diff --git a/content/rancher/v2.x/en/concepts/ci-cd-pipelines/_index.md b/content/rancher/v2.x/en/concepts/ci-cd-pipelines/_index.md
deleted file mode 100644
index fa26a43fbe5..00000000000
--- a/content/rancher/v2.x/en/concepts/ci-cd-pipelines/_index.md
+++ /dev/null
@@ -1,17 +0,0 @@
----
-title: Pipelines
-weight: 2350
----
-
-Pipelines help you automate the software delivery process. You can integrate Rancher with GitHub to create a pipeline.
-
-You can set up your pipeline to run a series of stages and steps to test your code and deploy it.
-
-