mirror of
https://github.com/rancher/rancher-docs.git
synced 2026-09-27 13:38:07 +00:00
fixing concepts links
This commit is contained in:
@@ -5,7 +5,7 @@ aliases:
|
|||||||
-/rancher/v2.x/en/admin-settings/rbac/
|
-/rancher/v2.x/en/admin-settings/rbac/
|
||||||
---
|
---
|
||||||
|
|
||||||
Within Rancher, each person authenticates as a _user_, which is a login that grants you access to Rancher. As mentioned in [Authentication]({{< baseurl >}}/rancher/v2.x/en/concepts/global-configuration/authentication), users can either be local or external.
|
Within Rancher, each person authenticates as a _user_, which is a login that grants you access to Rancher. As mentioned in [Authentication]({{< baseurl >}}/rancher/v2.x/en/admin-settings/authentication/), users can either be local or external.
|
||||||
|
|
||||||
After you configure external authentication, the users that display on the **Users** page changes.
|
After you configure external authentication, the users that display on the **Users** page changes.
|
||||||
|
|
||||||
@@ -196,4 +196,3 @@ Roles can be locked by the following users:
|
|||||||
|
|
||||||
- Any user assigned the `Administrator` global permission.
|
- Any user assigned the `Administrator` global permission.
|
||||||
- Any user assigned the `Custom Users` permission, along with the `Manage Roles` role.
|
- Any user assigned the `Custom Users` permission, along with the `Manage Roles` role.
|
||||||
|
|
||||||
|
|||||||
@@ -17,7 +17,7 @@ You can create custom catalogs of charts for use in Rancher. Custom catalogs are
|
|||||||
|
|
||||||
>**Prerequisites:**
|
>**Prerequisites:**
|
||||||
>
|
>
|
||||||
>- Recommended: Read [Catalogs and Charts]({{< baseurl >}}/rancher/v2.x/en/concepts/catalogs).
|
>- Recommended: Read [Catalogs and Charts]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts/).
|
||||||
>- Create a GitHub repository to serve as your custom catalog.
|
>- Create a GitHub repository to serve as your custom catalog.
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@@ -11,13 +11,13 @@ The custom catalog can contain native Helm charts, Rancher charts, or a combinat
|
|||||||
|
|
||||||
>**Prerequisites:**
|
>**Prerequisites:**
|
||||||
|
|
||||||
>- Recommended: Read [Catalogs and Charts]({{< baseurl >}}/rancher/v2.x/en/concepts/catalogs).
|
>- Recommended: Read [Catalogs and Charts]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts).
|
||||||
>- 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/catalog-and-charts/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. Within the GitHub repo that you're using as your custom catalog, create a directory structure that mirrors the structure listed in [Chart Directory Structure]({{< baseurl >}}/rancher/v2.x/en/concepts/catalogs/#chart-directory-structure).
|
1. Within the GitHub repo that you're using as your custom catalog, create a directory structure that mirrors the structure listed in [Chart Directory Structure]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts/#chart-directory-structure).
|
||||||
|
|
||||||
Rancher requires this directory structure, although `app-readme.md` and `questions.yml` are optional.
|
Rancher requires this directory structure, although `app-readme.md` and `questions.yml` are optional.
|
||||||
|
|
||||||
|
|||||||
@@ -8,7 +8,7 @@ aliases:
|
|||||||
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.
|
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:
|
2. Toggle the default catalogs that you want use to a setting of **Enabled**. The [default catalogs]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts/#catalog-types) are:
|
||||||
|
|
||||||
- **Library**
|
- **Library**
|
||||||
- **Helm Stable**
|
- **Helm Stable**
|
||||||
|
|||||||
@@ -5,7 +5,7 @@ weight: 4010
|
|||||||
|
|
||||||
After you've enabled default catalogs or setup a custom catalog, you can launch apps using a catalog instead of a standard deployment.
|
After you've enabled default catalogs or setup a custom catalog, you can launch apps using a catalog instead of a standard deployment.
|
||||||
|
|
||||||
>**Prerequisite:** Enable a catalog. For more information, see [Catalogs and Charts]({{< baseurl >}}/rancher/v2.x/en/concepts/catalogs).
|
>**Prerequisite:** Enable a catalog. For more information, see [Catalogs and Charts]({{< baseurl >}}/rancher/v2.x/en/catalog-and-charts/catalogs).
|
||||||
|
|
||||||
1. From the **Global** view, open the project that you want to deploy to.
|
1. From the **Global** view, open the project that you want to deploy to.
|
||||||
|
|
||||||
|
|||||||
@@ -30,7 +30,7 @@ If Rancher Server uses a self-signed certificate, Rancher CLI prompts you to con
|
|||||||
|
|
||||||
### Project Selection
|
### Project Selection
|
||||||
|
|
||||||
Before you can perform any commands, you must select a Rancher project to perform those commands against. To select a [project]({{< baseurl >}}/rancher/v2.x/en/concepts/projects/) to work on, use the command `./rancher context switch`. When you enter this command, a list of available projects displays. Enter a number to choose your project.
|
Before you can perform any commands, you must select a Rancher project to perform those commands against. To select a [project]({{< baseurl >}}/rancher/v2.x/en/kubernetes-in-rancher/projects-namespaces/) to work on, use the command `./rancher context switch`. When you enter this command, a list of available projects displays. Enter a number to choose your project.
|
||||||
|
|
||||||
**Example: `./rancher context switch` Output**
|
**Example: `./rancher context switch` Output**
|
||||||
```
|
```
|
||||||
@@ -56,11 +56,11 @@ The following commands are available for use in Rancher CLI.
|
|||||||
|
|
||||||
- `apps, [app]`
|
- `apps, [app]`
|
||||||
|
|
||||||
Performs operations on catalog applications (i.e. individual [Helm charts](https://docs.helm.sh/developing_charts/) or [Rancher charts]({{< baseurl >}}/rancher/v2.x/en/concepts/catalogs/#rancher-chart-structure)).
|
Performs operations on catalog applications (i.e. individual [Helm charts](https://docs.helm.sh/developing_charts/) or [Rancher charts]({{< baseurl >}}/rancher/v2.x/en/catalogs-and-charts/#rancher-chart-structure)).
|
||||||
|
|
||||||
- `catalog`
|
- `catalog`
|
||||||
|
|
||||||
Performs operations on [catalogs]({{< baseurl >}}/rancher/v2.x/en/concepts/catalogs).
|
Performs operations on [catalogs]({{< baseurl >}}/rancher/v2.x/en/catalogs-and-charts/catalogs).
|
||||||
|
|
||||||
- `clusters, [cluster]`
|
- `clusters, [cluster]`
|
||||||
|
|
||||||
@@ -68,11 +68,11 @@ The following commands are available for use in Rancher CLI.
|
|||||||
|
|
||||||
- `context`
|
- `context`
|
||||||
|
|
||||||
Switches between Rancher [projects]({{< baseurl >}}/rancher/v2.x/en/concepts/projects). For an example, see [Project Selection](#project-selection).
|
Switches between Rancher [projects]({{< baseurl >}}/rancher/v2.x/en/kubernetes-in-rancher/projects-namespaces). For an example, see [Project Selection](#project-selection).
|
||||||
|
|
||||||
- `inspect [OPTIONS] [RESOURCEID RESOURCENAME]`
|
- `inspect [OPTIONS] [RESOURCEID RESOURCENAME]`
|
||||||
|
|
||||||
Displays details about [Kubernetes resources](https://kubernetes.io/docs/reference/kubectl/cheatsheet/#resource-types) or Rancher resources (i.e.: [projects]({{< baseurl >}}/rancher/v2.x/en/concepts/projects) and [workloads]({{< baseurl >}}/rancher/v2.x/en/concepts/workloads)). Specify resources by name or ID.
|
Displays details about [Kubernetes resources](https://kubernetes.io/docs/reference/kubectl/cheatsheet/#resource-types) or Rancher resources (i.e.: [projects]({{< baseurl >}}/rancher/v2.x/en/kubernetes-in-rancher/projects-namespaces/) and [workloads]({{< baseurl >}}/rancher/v2.x/en/kubernetes-in-rancher/workloads/)). Specify resources by name or ID.
|
||||||
|
|
||||||
- `kubectl`
|
- `kubectl`
|
||||||
|
|
||||||
@@ -84,7 +84,7 @@ The following commands are available for use in Rancher CLI.
|
|||||||
|
|
||||||
- `namespaces, [namespace]`
|
- `namespaces, [namespace]`
|
||||||
|
|
||||||
Performs operations on [namespaces]({{< baseurl >}}/rancher/v2.x/en/concepts/projects/#namespaces).
|
Performs operations on [namespaces]({{< baseurl >}}/rancher/v2.x/en/kubernetes-in-rancher/projects-namespaces/#namespaces).
|
||||||
|
|
||||||
- `nodes, [node]`
|
- `nodes, [node]`
|
||||||
|
|
||||||
@@ -92,11 +92,11 @@ The following commands are available for use in Rancher CLI.
|
|||||||
|
|
||||||
- `projects, [project]`
|
- `projects, [project]`
|
||||||
|
|
||||||
Performs operations on [projects]({{< baseurl >}}/rancher/v2.x/en/concepts/projects).
|
Performs operations on [projects]({{< baseurl >}}/rancher/v2.x/en/kubernetes-in-rancher/projects-namespaces/).
|
||||||
|
|
||||||
- `ps`
|
- `ps`
|
||||||
|
|
||||||
Displays [workloads]({{< baseurl >}}/rancher/v2.x/en/concepts/workloads) in a project.
|
Displays [workloads]({{< baseurl >}}/rancher/v2.x/en/kubernetes-in-rancher/workloads) in a project.
|
||||||
|
|
||||||
- `settings, [setting]`
|
- `settings, [setting]`
|
||||||
|
|
||||||
|
|||||||
@@ -31,18 +31,18 @@ Following cluster creation, you can add users as cluster members so that they ca
|
|||||||
|
|
||||||
If external authentication is configured:
|
If external authentication is configured:
|
||||||
|
|
||||||
- Rancher returns users from your [external authentication]({{< baseurl >}}/rancher/v2.x/en/concepts/global-configuration/authentication/) source as you type.
|
- Rancher returns users from your [external authentication]({{< baseurl >}}/rancher/v2.x/en/admin-settings/authentication/) source as you type.
|
||||||
|
|
||||||
>**Using AD but can't find your users?**
|
>**Using AD but can't find your users?**
|
||||||
>There may be an issue with your search attribute configuration. See [Configuring Active Directory Authentication: Step 5]({{< baseurl >}}/rancher/v2.x/en/admin-settings/authentication/configuring-ad/).
|
>There may be an issue with your search attribute configuration. See [Configuring Active Directory Authentication: Step 5]({{< baseurl >}}/rancher/v2.x/en/admin-settings/authentication/configuring-ad/).
|
||||||
|
|
||||||
- A drop-down allows you to add groups instead of individual users. The drop-down only lists groups that you, the logged in user, are part of.
|
- A drop-down allows you to add groups instead of individual users. The drop-down only lists groups that you, the logged in user, are part of.
|
||||||
|
|
||||||
>**Note:** If you are logged in as a local user, external users do not display in your search results. For more information, see [External Authentication Configuration and Principal Users]({{< baseurl >}}/rancher/v2.x/en/concepts/global-configuration/authentication/#external-authentication-configuration-and-principal-users).
|
>**Note:** If you are logged in as a local user, external users do not display in your search results. For more information, see [External Authentication Configuration and Principal Users]({{< baseurl >}}/rancher/v2.x/en/admin-settings/authentication/#external-authentication-configuration-and-principal-users).
|
||||||
|
|
||||||
4. Assign the user or group **Cluster** roles.
|
4. Assign the user or group **Cluster** roles.
|
||||||
|
|
||||||
[What are Cluster Roles?]({{< baseurl >}}/rancher/v2.x/en/concepts/global-configuration/users-permissions-roles/#cluster-roles)
|
[What are Cluster Roles?]({{< baseurl >}}/rancher/v2.x/en/admin-settings/rbac/#cluster-roles)
|
||||||
|
|
||||||
>**Tip:** For Custom Roles, you can modify the list of individual roles available for assignment.
|
>**Tip:** For Custom Roles, you can modify the list of individual roles available for assignment.
|
||||||
>
|
>
|
||||||
|
|||||||
@@ -18,8 +18,8 @@ For more information on creating node drivers, see [https://github.com/rancher/u
|
|||||||
|
|
||||||
>**Prerequisites:** To create, edit, or delete drivers, you need _one_ of the following permissions:
|
>**Prerequisites:** To create, edit, or delete drivers, you need _one_ of the following permissions:
|
||||||
>
|
>
|
||||||
>- [Administrator Global Permissions]({{< baseurl >}}/rancher/v2.x/en/concepts/global-configuration/users-permissions-roles/#global-permissions)
|
>- [Administrator Global Permissions]({{< baseurl >}}/rancher/v2.x/en/admin-settings/rbac/#global-permissions)
|
||||||
>- [Custom Global Permissions]({{< baseurl >}}/rancher/v2.x/en/concepts/global-configuration/users-permissions-roles/#custom-global-permissions) with the [Manage Node Drivers]({{< baseurl >}}/rancher/v2.x/en/concepts/global-configuration/users-permissions-roles/#global-permissions-reference) role assigned.
|
>- [Custom Global Permissions]({{< baseurl >}}/rancher/v2.x/en/admin-settings/rbac/#custom-global-permissions) with the [Manage Node Drivers]({{< baseurl >}}/rancher/v2.x/en/admin-settings/rbac/#global-permissions-reference) role assigned.
|
||||||
|
|
||||||
## Adding Custom Node Drivers
|
## Adding Custom Node Drivers
|
||||||
|
|
||||||
|
|||||||
@@ -16,6 +16,6 @@ Within the context of a Rancher project or namespace, _resources_ are files and
|
|||||||
- [Secrets](#secrets)
|
- [Secrets](#secrets)
|
||||||
- [Registries](#registries)
|
- [Registries](#registries)
|
||||||
|
|
||||||
Rancher extends the application of the Kubernetes namespace resources listed above to [projects]({{< baseurl >}}/rancher/v2.x/en/concepts/projects/), which are Rancher-specific constructs. In the hierarchy of Rancher objects, projects contain namespaces. Therefore, any resources available within a project are available for all namespaces within that project.
|
Rancher extends the application of the Kubernetes namespace resources listed above to [projects]({{< baseurl >}}/rancher/v2.x/en/kubernetes-in-rancher/projects-namespaces/), which are Rancher-specific constructs. In the hierarchy of Rancher objects, projects contain namespaces. Therefore, any resources available within a project are available for all namespaces within that project.
|
||||||
|
|
||||||
Within Kubernetes, certificates, registries, and secrets are all considered [secrets](https://kubernetes.io/docs/concepts/configuration/secret/). Therefore, within a single project or namespace, these resources must have unique names to avoid conflicts. Although secrets are primarily used to carry sensitive information, they have other uses as well.
|
Within Kubernetes, certificates, registries, and secrets are all considered [secrets](https://kubernetes.io/docs/concepts/configuration/secret/). Therefore, within a single project or namespace, these resources must have unique names to avoid conflicts. Although secrets are primarily used to carry sensitive information, they have other uses as well.
|
||||||
|
|||||||
@@ -13,13 +13,13 @@ Deploy a workload to run an application in one or more containers.
|
|||||||
|
|
||||||
1. Enter a **Name** for the workload.
|
1. Enter a **Name** for the workload.
|
||||||
|
|
||||||
1. Select a [workload type]({{< baseurl >}}/rancher/v2.x/en/concepts/workloads/). The workload defaults to a scalable deployment, by can change the workload type by clicking **More options.**
|
1. Select a [workload type]({{< baseurl >}}/rancher/v2.x/en/kubernetes-in-rancher/workloads/). The workload defaults to a scalable deployment, by can change the workload type by clicking **More options.**
|
||||||
|
|
||||||
1. From the **Docker Image** field, enter the name of the Docker image that you want to deploy to the project. During deployment, Rancher pulls this image from [Docker Hub](https://hub.docker.com/explore/). Enter the name exactly as it appears on Docker Hub.
|
1. From the **Docker Image** field, enter the name of the Docker image that you want to deploy to the project. During deployment, Rancher pulls this image from [Docker Hub](https://hub.docker.com/explore/). Enter the name exactly as it appears on Docker Hub.
|
||||||
|
|
||||||
1. Either select an existing [namespace](https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/), or click **Add to a new namespace** and enter a new namespace.
|
1. Either select an existing [namespace](https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/), or click **Add to a new namespace** and enter a new namespace.
|
||||||
|
|
||||||
1. Click **Add Port** to enter a port mapping, which enables access to the application inside and outside of the cluster . For more information, see [Services]({{< baseurl >}}/rancher/v2.x/en/concepts/workloads/#services).
|
1. Click **Add Port** to enter a port mapping, which enables access to the application inside and outside of the cluster . For more information, see [Services]({{< baseurl >}}/rancher/v2.x/en/kubernetes-in-rancher/workloads/#services).
|
||||||
|
|
||||||
1. Configure the remaining options:
|
1. Configure the remaining options:
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user