moving around catalog stuff

This commit is contained in:
Denise Schannon
2018-07-16 20:26:56 -07:00
parent 5d0522a3d5
commit af8de78eb2
6 changed files with 40 additions and 30 deletions
@@ -1,8 +1,18 @@
--- ---
title: Catalogs and Charts 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_. _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: _Charts_ are a packaging format popularized by [Helm](https://docs.helm.sh/). Think of them as templates for deployments. Per Helm, charts are:
@@ -42,7 +52,7 @@ Custom catalog requirements include:
- A unique name. - A unique name.
- A URL that `git clone` can handle. - 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). 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).
@@ -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. 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/). >**Note:** For a complete walkthrough of developing charts, see the upstream Helm chart [developer reference](https://docs.helm.sh/developing_charts/).
@@ -1,6 +1,8 @@
--- ---
title: Adding Custom Catalogs 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. You can create custom catalogs of charts for use in Rancher. Custom catalogs are helpful for fast deployment of applications unique to your environment.
@@ -27,4 +29,4 @@ You can create custom catalogs of charts for use in Rancher. Custom catalogs are
## What's Next? ## 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/). 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/).
@@ -1,6 +1,8 @@
--- ---
title: Customizing Charts 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. 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). >- Recommended: Read [Catalogs and Charts]({{< baseurl >}}/rancher/v2.x/en/concepts/catalogs).
>- Create a GitHub repository to serve as your custom catalog. >- 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. >**Note:** Customization of Helm charts takes place outside of the Rancher UI.
@@ -1,6 +1,8 @@
--- ---
title: Enabling Default Catalogs 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.
@@ -12,7 +14,7 @@ Out-of-the-box, you can enable several different catalog repositories to simplif
- **Helm Stable** - **Helm Stable**
- **Helm Incubator** - **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. **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.
@@ -0,0 +1,4 @@
---
title: Catalogs and Charts
weight: 4010
---
@@ -1,10 +0,0 @@
---
title: Catalogs and Charts
weight: 3026
---
This section includes step-by-step instruction on how to configure default and custom catalogs.
- [Enabling Default Catalogs]({{< baseurl >}}/rancher/v2.x/en/tasks/global-configuration/catalog/enabling-default-catalogs)
- [Adding Custom Catalogs]({{< baseurl >}}/rancher/v2.x/en/tasks/global-configuration/catalog/adding-custom-catalogs)
- [Customizing Charts]({{< baseurl >}}/rancher/v2.x/en/tasks/global-configuration/catalog/customizing-charts)