Updating notes

2026-09-24 03:58:06 +00:00 · 2022-07-07 14:20:49 -04:00
parent 2922d9d6c3
commit 97e22b9c9a
7 changed files with 46 additions and 18 deletions
@@ -19,8 +19,7 @@ After installing the initiator tool on your nodes, edit the YAML for your cluste

 :::note Notes
  
- Before updating your Kubernetes YAML to mount the iSCSI binary and configuration, make sure either the `open-iscsi` (deb) or `iscsi-initiator-utils` (yum) package is installed on your cluster nodes. If this package isn't installed _before_ the bind mounts are created in your Kubernetes YAML, Docker will automatically create the directories and files on each node and will not allow the package install to succeed.</br>
-</br> 
+- Before updating your Kubernetes YAML to mount the iSCSI binary and configuration, make sure either the `open-iscsi` (deb) or `iscsi-initiator-utils` (yum) package is installed on your cluster nodes. If this package isn't installed _before_ the bind mounts are created in your Kubernetes YAML, Docker will automatically create the directories and files on each node and will not allow the package install to succeed.

 - The example YAML below does not apply to K3s, but only to RKE clusters. Since the K3s kubelet does not run in a container, adding extra binds is not necessary. However, all iSCSI tools must still be installed on your K3s nodes.

@@ -8,8 +8,11 @@ You can use Rancher to create a cluster hosted in Alibaba Cloud Kubernetes (ACK)

 # Prerequisites Outside of Rancher

->**Note**
->Deploying to ACK will incur charges.
+:::caution
+
+Deploying to ACK will incur charges.
+
+:::

 1. In Aliyun, activate the following services in their respective consoles.

@@ -19,8 +19,11 @@ You can use Rancher to create a cluster hosted in Microsoft Azure Kubernetes Ser

 # Prerequisites in Microsoft Azure

->**Note**
->Deploying to AKS will incur charges.
+:::caution
+
+Deploying to AKS will incur charges.
+
+:::

 To interact with Azure APIs, an AKS cluster requires an Azure Active Directory (AD) service principal. The service principal is needed to dynamically create and manage other Azure resources, and it provides credentials for your cluster to communicate with AKS. For more information about the service principal, refer to the [AKS documentation](https://docs.microsoft.com/en-us/azure/aks/kubernetes-service-principal).

@@ -143,7 +146,11 @@ The first way to ensure that Rancher is running on the same [NAT](https://docs.m

 The second way is to run a command to register the cluster with Rancher. Once the cluster is provisioned, you can run the displayed command anywhere you can connect to the cluster’s Kubernetes API. This command is displayed in a pop-up when you provision an AKS cluster with a private API endpoint enabled.

-> **Note:** Please be aware that when registering an existing AKS cluster, the cluster might take some time, possibly hours, to appear in the `Cluster To register` dropdown list. This outcome will be based on region. 
+:::note
+
+Please be aware that when registering an existing AKS cluster, the cluster might take some time, possibly hours, to appear in the `Cluster To register` dropdown list. This outcome will be based on region. 
+
+:::

 For more information about connecting to an AKS private cluster, see the [AKS documentation.](https://docs.microsoft.com/en-us/azure/aks/private-clusters#options-for-connecting-to-the-private-cluster)

@@ -8,8 +8,11 @@ You can use Rancher to create a cluster hosted in Huawei Cloud Container Engine

 # Prerequisites in Huawei

->**Note**
->Deploying to CCE will incur charges.
+:::caution
+
+Deploying to CCE will incur charges.
+
+:::

 1. Find your project ID in Huawei CCE portal. See the CCE documentation on how to [manage your projects](https://support.huaweicloud.com/en-us/usermanual-iam/en-us_topic_0066738518.html).

@@ -20,8 +20,11 @@ Amazon EKS provides a managed control plane for your Kubernetes cluster. Amazon
 - [Programmatically Creating EKS Clusters](#programmatically-creating-eks-clusters)
 # Prerequisites in Amazon Web Services

->**Note**
->Deploying to Amazon AWS will incur charges. For more information, refer to the [EKS pricing page](https://aws.amazon.com/eks/pricing/).
+:::caution
+
+Deploying to Amazon AWS will incur charges. For more information, refer to the [EKS pricing page](https://aws.amazon.com/eks/pricing/).
+
+:::

 To set up a cluster on EKS, you will need to set up an Amazon VPC (Virtual Private Cloud). You will also need to make sure that the account you will be using to create the EKS cluster has the appropriate [permissions.](#minimum-eks-permissions) For details, refer to the official guide on [Amazon EKS Prerequisites](https://docs.aws.amazon.com/eks/latest/userguide/getting-started-console.html#eks-prereqs).

@@ -39,7 +42,11 @@ Rancher needs access to your AWS account in order to provision and administer yo

 3. Finally, follow the steps [here](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey) to create an access key and secret key for this user.

-> **Note:** It's important to regularly rotate your access and secret keys. See this [documentation](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#rotating_access_keys_console) for more information.
+:::note Important: 
+
+It's important to regularly rotate your access and secret keys. See this [documentation](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#rotating_access_keys_console) for more information.
+
+:::

 For more detailed information on IAM policies for EKS, refer to the official [documentation on Amazon EKS IAM Policies, Roles, and Permissions](https://docs.aws.amazon.com/eks/latest/userguide/IAM_policies.html).

@@ -41,8 +41,11 @@ To get the project ID of an existing project, refer to the Google cloud document

 # Provisioning a GKE Cluster

->**Note**
->Deploying to GKE will incur charges.
+:::caution
+
+Deploying to GKE will incur charges.
+
+:::

 ### 1. Create a Cloud Credential

@@ -90,8 +93,11 @@ For details on configuring GKE clusters in Rancher, see [this page.]({{<baseurl>

 The Kubernetes version of a cluster can be upgraded to any version available in the region or zone fo the GKE cluster. Upgrading the master Kubernetes version does not automatically upgrade worker nodes. Nodes can be upgraded independently.

->**Note**
->GKE has removed basic authentication in 1.19+. In order to upgrade a cluster to 1.19+, basic authentication must be disabled in the Google Cloud. Otherwise, an error will appear in Rancher when an upgrade to 1.19+ is attempted. You can follow the [Google documentation](https://cloud.google.com/kubernetes-engine/docs/how-to/api-server-authentication#disabling_authentication_with_a_static_password). After this, the Kubernetes version can be updated to 1.19+ via Rancher.
+:::note
+
+GKE has removed basic authentication in 1.19+. In order to upgrade a cluster to 1.19+, basic authentication must be disabled in the Google Cloud. Otherwise, an error will appear in Rancher when an upgrade to 1.19+ is attempted. You can follow the [Google documentation](https://cloud.google.com/kubernetes-engine/docs/how-to/api-server-authentication#disabling_authentication_with_a_static_password). After this, the Kubernetes version can be updated to 1.19+ via Rancher.
+
+:::

 # Syncing

@@ -8,8 +8,11 @@ You can use Rancher to create a cluster hosted in Tencent Kubernetes Engine (TKE

 # Prerequisites in Tencent

->**Note**
->Deploying to TKE will incur charges.
+:::caution
+
+Deploying to TKE will incur charges.
+
+:::

 1. Make sure that the account you will be using to create the TKE cluster has the appropriate permissions by referring to the  [Cloud Access Management](https://intl.cloud.tencent.com/document/product/598/10600) documentation for details.