Skip to content

Commit 346c18e

Browse files
committed
Incorporated feedback into Fleet docs
1 parent e3ff361 commit 346c18e

File tree

4 files changed

+30
-24
lines changed

4 files changed

+30
-24
lines changed

articles/kubernetes-fleet/access-fleet-kubernetes-api.md

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,28 +2,36 @@
22
title: "Access the Kubernetes API of the Fleet resource"
33
description: Learn how to access the Kubernetes API of the Fleet resource.
44
ms.topic: how-to
5-
ms.date: 03/18/2024
5+
ms.date: 03/20/2024
66
author: shashankbarsin
77
ms.author: shasb
88
ms.service: kubernetes-fleet
9-
ms.custom:
10-
- ignite-2023
119
---
1210

1311
# Access the Kubernetes API of the Fleet resource with Azure Kubernetes Fleet Manager
1412

15-
If your Azure Kubernetes Fleet Manager resource was created with the hub cluster enabled, then it can be used to centrally control scenarios like Kubernetes object propagation. In this article, you learn how to access the Kubernetes API of the Fleet resource.
13+
If your Azure Kubernetes Fleet Manager resource was created with the hub cluster enabled, then it can be used to centrally control scenarios like Kubernetes resource propagation. In this article, you learn how to access the Kubernetes API of the hub cluster managed by the Fleet resource.
1614

1715
## Prerequisites
1816

1917
[!INCLUDE [free trial note](../../includes/quickstarts-free-trial-note.md)]
2018

21-
* You must have a Fleet resource with a hub cluster and member clusters with deployed workloads. If you don't have this resource, follow [Quickstart: Create a Fleet resource and join member clusters](quickstart-create-fleet-and-members.md).
22-
* The identity (user or service principal) you're using needs to have the Microsoft.ContainerService/fleets/listCredentials/action and Microsoft.ContainerService/managedClusters/listClusterUserCredential/action permissions on the Fleet and AKS resource types.
19+
* You must have a Fleet resource with a hub cluster and member clusters. If you don't have this resource, follow [Quickstart: Create a Fleet resource and join member clusters](quickstart-create-fleet-and-members.md).
20+
* The identity (user or service principal) you're using needs to have the Microsoft.ContainerService/managedClusters/listClusterUserCredential/action permissions on the Fleet and AKS resource types.
2321

2422
## Access the Kubernetes API of the Fleet resource cluster
2523

26-
1. Get the kubeconfig file of the hub cluster Fleet resource using the [`az fleet get-credentials`][az-fleet-get-credentials] command.
24+
1. Set the following environment variables for your subscription ID, resource group, and Fleet resource, and set the default Azure subscription to use using the [`az account set`][az-account-set] command.
25+
26+
```azurecli-interactive
27+
export SUBSCRIPTION_ID=<subscription-id>
28+
az account set --subscription ${SUBSCRIPTION_ID}
29+
30+
export GROUP=<resource-group-name>
31+
export FLEET=<fleet-name>
32+
```
33+
34+
2. Get the kubeconfig file of the hub cluster Fleet resource using the [`az fleet get-credentials`][az-fleet-get-credentials] command.
2735
2836
```azurecli-interactive
2937
az fleet get-credentials --resource-group ${GROUP} --name ${FLEET}
@@ -35,13 +43,13 @@ If your Azure Kubernetes Fleet Manager resource was created with the hub cluster
3543
Merged "hub" as current context in /home/fleet/.kube/config
3644
```
3745
38-
2. Set the following environment variable for the `id` of the hub cluster Fleet resource:
46+
3. Set the following environment variable for the `id` of the hub cluster Fleet resource:
3947
4048
```azurecli-interactive
4149
export FLEET_ID=/subscriptions/${SUBSCRIPTION_ID}/resourceGroups/${GROUP}/providers/Microsoft.ContainerService/fleets/${FLEET}
4250
```
4351
44-
3. Authorize your identity to the hub cluster Fleet resource's Kubernetes API server using the following commands:
52+
4. Authorize your identity to the hub cluster Fleet resource's Kubernetes API server using the following commands:
4553
4654
For the `ROLE` environment variable, you can use one of the following four built-in role definitions as the value:
4755
@@ -75,7 +83,7 @@ If your Azure Kubernetes Fleet Manager resource was created with the hub cluster
7583
}
7684
```
7785
78-
4. Verify the status of the member clusters using the `kubectl get memberclusters` command.
86+
5. Verify you can access the API server using the `kubectl get memberclusters` command.
7987
8088
```bash
8189
kubectl get memberclusters

articles/kubernetes-fleet/l4-load-balancing.md

Lines changed: 7 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,12 @@
22
title: "How to set up multi-cluster Layer 4 load balancing across Azure Kubernetes Fleet Manager member clusters (preview)"
33
description: Learn how to use Azure Kubernetes Fleet Manager to set up multi-cluster Layer 4 load balancing across workloads deployed on multiple member clusters.
44
ms.topic: how-to
5-
ms.date: 09/09/2022
5+
ms.date: 03/20/2024
66
author: shashankbarsin
77
ms.author: shasb
88
ms.service: kubernetes-fleet
99
ms.custom:
1010
- devx-track-azurecli
11-
- ignite-2023
1211
---
1312

1413
# Set up multi-cluster layer 4 load balancing across Azure Kubernetes Fleet Manager member clusters (preview)
@@ -25,13 +24,14 @@ You can follow this document to set up layer 4 load balancing for such multi-clu
2524

2625
* Read the [conceptual overview of this feature](./concepts-l4-load-balancing.md), which provides an explanation of `ServiceExport` and `MultiClusterService` objects referenced in this document.
2726

28-
* You must have a fleet resource with member clusters with deployed workload. If you don't have this resource, follow [Quickstart: Create a Fleet resource and join member clusters](quickstart-create-fleet-and-members.md) and [Propagate Kubernetes configurations from a Fleet resource to member clusters](resource-propagation.md).
29-
30-
* These target clusters should be using [Azure CNI (Container Networking Interface) networking](../aks/configure-azure-cni.md).
27+
* You must have a Fleet resource with a hub cluster and member clusters. If you don't have this resource, follow [Quickstart: Create a Fleet resource and join member clusters](quickstart-create-fleet-and-members.md).
3128

3229
* The target Azure Kubernetes Service (AKS) clusters on which the workloads are deployed need to be present on either the same [virtual network](../virtual-network/virtual-networks-overview.md) or on [peered virtual networks](../virtual-network/virtual-network-peering-overview.md).
3330

34-
* These target clusters have to be [added as member clusters to the Fleet resource](./quickstart-create-fleet-and-members.md#join-member-clusters).
31+
* These target clusters have to be [added as member clusters to the Fleet resource](./quickstart-create-fleet-and-members.md#join-member-clusters).
32+
* These target clusters should be using [Azure CNI (Container Networking Interface) networking](../aks/configure-azure-cni.md).
33+
34+
* You must gain access to the Kubernetes API of the hub cluster by following the steps in [Access the Kubernetes API of the Fleet resource](./access-fleet-kubernetes-api.md).
3535

3636
* Set the following environment variables and obtain the kubeconfigs for the fleet and all member clusters:
3737

@@ -45,11 +45,9 @@ You can follow this document to set up layer 4 load balancing for such multi-clu
4545
az aks get-credentials --resource-group ${GROUP} --name ${MEMBER_CLUSTER_1} --file aks-member-1
4646
```
4747

48-
* If the Azure Kubernetes Fleet Manager resource was created with the hub cluster enabled, then it can be used to centrally control scenarios like Kubernetes object propagation. To access the Kubernetes API of the Fleet resource cluster, follow the steps in the [Access the Kubernetes API of the Fleet resource cluster with Azure Kubernetes Fleet Manager](access-fleet-kubernetes-api.md) article.
49-
5048
[!INCLUDE [preview features note](~/articles/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
5149

52-
## Deploy a sample workload to demo clusters
50+
## Deploy a workload across member clusters of the Fleet resource
5351

5452
> [!NOTE]
5553
>

articles/kubernetes-fleet/quickstart-create-fleet-and-members-portal.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: "Quickstart: Create an Azure Kubernetes Fleet Manager resource and join member clusters using Azure portal"
33
description: In this quickstart, you learn how to create an Azure Kubernetes Fleet Manager resource and join member clusters using Azure portal.
4-
ms.date: 03/18/2024
4+
ms.date: 03/20/2024
55
author: shashankbarsin
66
ms.author: shasb
77
ms.service: kubernetes-fleet
8-
ms.custom: template-quickstart, mode-other, ignite-2023
8+
ms.custom: template-quickstart, mode-other
99
ms.devlang: azurecli
1010
ms.topic: quickstart
1111
---

articles/kubernetes-fleet/resource-propagation.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: "Using cluster resource propagation (preview)"
33
description: Learn how to use Azure Kubernetes Fleet Manager to intelligently place workloads across multiple clusters.
44
ms.topic: how-to
5-
ms.date: 10/31/2023
5+
ms.date: 03/20/2024
66
author: phealy
77
ms.author: pahealy
88
ms.service: kubernetes-fleet
@@ -27,9 +27,9 @@ Fleet workload placement can deploy any Kubernetes objects to clusters In order
2727
## Prerequisites
2828

2929
- Read the [conceptual overview of this feature](./concepts-resource-propagation.md), which provides an explanation of `MemberCluster` and `ClusterResourcePlacement` referenced in this document.
30-
- A Kubernetes Fleet with a hub cluster and member clusters (see the [quickstart](quickstart-create-fleet-and-members.md) for provisioning instructions).
30+
- You must have a Fleet resource with a hub cluster and member clusters. If you don't have this resource, follow [Quickstart: Create a Fleet resource and join member clusters](quickstart-create-fleet-and-members.md).
3131
- Member clusters must be labeled appropriately in the hub cluster to match the desired selection criteria. Example labels could include region, environment, team, availability zones, node availability, or anything else desired.
32-
- If the Azure Kubernetes Fleet Manager resource was created with the hub cluster enabled, then it can be used to centrally control scenarios like Kubernetes object propagation. To access the Kubernetes API of the Fleet resource cluster, follow the steps in the [Access the Kubernetes API of the Fleet resource cluster with Azure Kubernetes Fleet Manager](access-fleet-kubernetes-api.md) article.
32+
- You must gain access to the Kubernetes API of the hub cluster by following the steps in [Access the Kubernetes API of the Fleet resource](./access-fleet-kubernetes-api.md).
3333

3434
## Resource placement with `ClusterResourcePlacement` resources
3535

0 commit comments

Comments
 (0)