public/rancher-docs
1
0
Fork 0
mirror of https://github.com/rancher/rancher-docs.git synced 2026-09-25 12:38:05 +00:00
Code Issues Packages Projects Releases Wiki Activity

update

Browse Source
This commit is contained in:
Logan
2019-03-22 10:07:37 -07:00
committed by Denise Schannon
parent fb72eb0dc8
commit 95f0c0c050
1 changed files with 25 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/rancher/v2.x/en/catalog/private/_index.md
+25 -10
View File
@@ -5,31 +5,46 @@ aliases:
- /rancher/v2.x/en/tasks/global-configuration/catalog/add-private-catalogs/
---
### Add Private Git/Helm Chart Repositories
## Add Private Git/Helm Chart Repositories
_Available as of v2.2.0_
From Rancher v2.2.0, you can now select to add private catalog repositories using credentials like Username and Password, you may also want to use the
OAuth token if your Git or Helm repository server support that.
You can add private catalog repositories based on Helm and Git.
![add-private-catalog.png]({{< baseurl >}}/img/rancher/catalog/add-private-catalog.png)
As an example, if you want to add a private Github repository as your custom catalog using OAuth token:
### Add Private Git/Helm Chart Repository using username and password:
1. Firstly, you will need to create an [OAuth token](https://github.com/settings/tokens)
1. From the `Global -> Catalogs` page, click **Add Catalog** to add your custom private chart repository:
| Variable | Description |
| -------------------- | ------------- |
| Name | Custom catalog name. |
| Catalog URL | The URL of your custom chart repository. |
| Use Private Catalog | Select it to use private catalog. |
| Username | Your Git/Helm username. |
| Password | Your Git/Helm password. |
| Branch | Git branch name. Ignored if it is a Helm repository. |
**Result**: Your custom catalog is added to the Rancher with `Active` state once it completes synchronization.
### Add Private Git Chart Repository using OAuth token:
1. Create an [OAuth token](https://github.com/settings/tokens)
with `repo` permission selected, and click **Generate token**.
![add-git-token.png]({{< baseurl >}}/img/rancher/catalog/add-git-token.png)
2. From the `Global -> Catalogs` page, you can now click **Add Catalog** to add your custom private chart repository:
2. From the `Global -> Catalogs` page, click **Add Catalog** to add your custom private chart repository:
| Variable | Description |
| -------------------- | ------------- |
| Name | Custom catalog name. |
| Catalog URL | Enter the URL of your custom chart repository, e.g, `https://github.com/username/myrepo.git`. |
| Use Private Catalog | Select if this is private chart repository server. |
| Username | Enter your Github username or Git generated OAuth token. |
| Password | Enter your Github password or `x-oauth-basic` if OAuth token is provided above, read [using Git over HTTPS and OAuth](https://github.blog/2012-09-21-easier-builds-and-deployments-using-git-over-https-and-oauth/) for more details. |
| Catalog URL | The URL of your custom chart repository, e.g, `https://github.com/username/myrepo.git`. |
| Use Private Catalog | Select it to use private catalog. |
| Username | Enter your Git generated OAuth token. |
| Password | Enter `x-oauth-basic`. read [using Git over HTTPS and OAuth](https://github.blog/2012-09-21-easier-builds-and-deployments-using-git-over-https-and-oauth/) for more details. |
| Branch | Enter your Github branch name, default to master. |