#726 - Getting Started UI instructions added to docs (#739)

* added ui instructions for cluster list to access-clusters

* re-org access-clusters so that 'Cluster List' becomes a searchable heading

* rewording

* added instructions and links for Global Settings

* added global config + retitle/rephrase

retitle to disambiguate global settings from global config

listed some relevant global config items that need more info

* correction: updated access-clusters page in /docs, not /versioned_docs

* added Nodes UI instructions

* download kubeconfig UI instructions added/modified

one file contained correct instructions but they were somewhat convoluted, as you can download the file from a page mentioned earlier in the suggested instructions and the button thery describe is an icon, not labeled with any text

* restoring formatting

* updated pathway for image list downloads

* finding rancher-images.txt

* added instructions for Apps Marketplace

* link pointing to v1 monitoring

* link pointing to v1 dashboards

* added links for v1 notifiers, logging tools

* global dns entries, global dns providers, catalog links added

* Rancher portal > Rancher UI

* updated access-clusters page

* rm note & add third way to access cluster dashboard

* heading levels

* addressed comments in global-configuration

* addressed comments for nodes-and-node-pools

* addressed comment on authorized-cluster-endpoint

* rm'd create apps steps

* updated kubeconfig download instructions

* adjusting headers

* updated images list instructions as version # is now an About link

* restored intro to monitoring-and-alerting

* KubeConfig > kubeconfig (except for naming the UI label)

* left navigation sidebar > left navigation

* Update docs/how-to-guides/new-user-guides/manage-clusters/access-clusters/authorized-cluster-endpoint.md

Co-authored-by: Billy Tat <btat@suse.com>

* applied changes to v2.7 docs

---------

Co-authored-by: Billy Tat <btat@suse.com>
This commit is contained in:
Marty Hernandez Avedon
2023-09-06 13:33:36 -04:00
committed by GitHub
parent 4560574a74
commit 5274e4e000
19 changed files with 207 additions and 50 deletions
@@ -6,16 +6,12 @@ title: Creating Apps
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/how-to-guides/new-user-guides/helm-charts-in-rancher/create-apps"/>
</head>
Rancher's App Marketplace is based on Helm Repositories and Helm Charts. You can add HTTP based standard Helm Repositories as well as any Git Repository which contains charts.
:::tip
For a complete walkthrough of developing charts, see the [Chart Template Developer's Guide](https://helm.sh/docs/chart_template_guide/) in the official Helm documentation.
:::
## Chart Types
Rancher supports two different types of charts: Helm charts and Rancher charts.
@@ -8,11 +8,18 @@ title: How the Authorized Cluster Endpoint Works
This section describes how the kubectl CLI, the kubeconfig file, and the authorized cluster endpoint work together to allow you to access a downstream Kubernetes cluster directly, without authenticating through the Rancher server. It is intended to provide background information and context to the instructions for [how to set up kubectl to directly access a cluster.](use-kubectl-and-kubeconfig.md#authenticating-directly-with-a-downstream-cluster)
### About the kubeconfig File
### About the Kubeconfig File
The _kubeconfig file_ is a file used to configure access to Kubernetes when used in conjunction with the kubectl command line tool (or other clients).
The kubeconfig file is used to configure access to Kubernetes when used in conjunction with the kubectl command line tool (or other clients).
This kubeconfig file and its contents are specific to the cluster you are viewing. It can be downloaded from the cluster view in Rancher. You will need a separate kubeconfig file for each cluster that you have access to in Rancher.
The kubeconfig file and its contents are specific to each cluster. It can be downloaded from the **Clusters** page in Rancher:
1. Click **☰** in the top left corner.
1. Select **Cluster Management**.
1. Find the cluster whose kubeconfig you want to download, and select **⁝** at the end of the row.
1. Select **Download KubeConfig** from the submenu.
You will need a separate kubeconfig file for each cluster that you have access to in Rancher.
After you download the kubeconfig file, you will be able to use the kubeconfig file and its Kubernetes [contexts](https://kubernetes.io/docs/reference/kubectl/cheatsheet/#kubectl-context-and-configuration) to access your downstream cluster.
@@ -31,9 +31,10 @@ These instructions assume that you have already created a Kubernetes cluster, an
:::
1. Log into Rancher. Click **☰ > Cluster Management**.
1. Go to the cluster that you want to access with kubectl and click **Explore**.
1. In the top navigation bar, click **Download KubeConfig** button.
1. Click **☰** in the top left corner.
1. Select **Cluster Management**.
1. Find the cluster whose kubeconfig you want to download, and select **⁝** at the end of the row.
1. Select **Download KubeConfig** from the submenu.
1. Save the YAML file on your local computer. Move the file to `~/.kube/config`. Note: The default location that kubectl uses for the kubeconfig file is `~/.kube/config`, but you can use any directory and specify it using the `--kubeconfig` flag, as in this command:
```
kubectl --kubeconfig /custom/path/kube.config get pods
@@ -6,7 +6,14 @@ title: Nodes and Node Pools
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/how-to-guides/new-user-guides/manage-clusters/nodes-and-node-pools"/>
</head>
After you launch a Kubernetes cluster in Rancher, you can manage individual nodes from the cluster's **Node** tab. Depending on the [option used](../../../pages-for-subheaders/kubernetes-clusters-in-rancher-setup.md) to provision the cluster, there are different node options available.
After you launch a Kubernetes cluster in Rancher, you can manage individual nodes from the cluster's **Node** tab.
1. Click **☰** in the top left corner.
1. Select **Cluster Management**.
1. Find the cluster whose nodes you want to manage, and click the **Explore** button at the end of the row.
1. Select **Nodes** from the left navigation.
Depending on the [option used](../../../pages-for-subheaders/kubernetes-clusters-in-rancher-setup.md) to provision the cluster, there are different node options available.
:::note