Merge pull request #270577 from schaffererin/userstory233310

Updated resource propagation concepts article and removed the how-to article

Author: Stacyrch140

.openpublishing.redirection.json

@@ -3924,6 +3924,16 @@
             "redirect_url": "/azure/operational-excellence/relocation-storage-account",
             "redirect_document_id": false
         },
+        {
+            "source_path_from_root": "/articles/kubernetes-fleet/resource-propagation.md",
+            "redirect_url": "/azure/kubernetes-fleet/concepts-resource-propagation",
+            "redirect_document_id": false
+        },
+        {
+            "source_path_from_root": "/articles/kubernetes-fleet/access-fleet-kubernetes-api.md",
+            "redirect_url": "/azure/kubernetes-fleet/quickstart-access-fleet-kubernetes-api",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/defender-for-iot/organizations/update-legacy-ot-software.md",
             "redirect_url": "/azure/defender-for-iot/organizations/update-ot-software?tabs=portal",

articles/kubernetes-fleet/concepts-resource-propagation.md

@@ -8,7 +8,7 @@ metadata:
   ms.service: kubernetes-fleet
   ms.custom: ignite-2023
   ms.topic: landing-page
-  ms.date: 11/06/2023
+  ms.date: 04/01/2024
 landingContent:
   - title: About Azure Kubernetes Fleet Manager
     linkLists:
@@ -58,15 +58,12 @@ landingContent:
         links:
           - text: Create a Fleet resource and join member clusters
             url: quickstart-create-fleet-and-members.md
-      - linkListType: how-to-guide
+      - linkListType: quickstart
         links:
-          - text: Orchestrate updates across multiple member clusters
-            url: update-orchestration.md
-      - linkListType: how-to-guide
+          - text: Access the Kubernetes API of the Fleet resource
+            url: quickstart-access-fleet-kubernetes-api.md
+      - linkListType: quickstart
         links:
           - text: Propagate Kubernetes resource objects from a Fleet resource to member clusters (preview)
-            url: resource-propagation.md
-      - linkListType: how-to-guide
-        links:
-          - text: Set up multi-cluster Layer 4 load balancing (preview)
-            url: l4-load-balancing.md
+            url: quickstart-resource-propagation.md
+

articles/kubernetes-fleet/index.yml

@@ -31,7 +31,7 @@ You can follow this document to set up layer 4 load balancing for such multi-clu
   * These target clusters have to be [added as member clusters to the Fleet resource](./quickstart-create-fleet-and-members.md#join-member-clusters).
   * These target clusters should be using [Azure CNI (Container Networking Interface) networking](../aks/configure-azure-cni.md).
 
-* 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).
+* 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](./quickstart-access-fleet-kubernetes-api.md).
 
 * Set the following environment variables and obtain the kubeconfigs for the fleet and all member clusters:
 

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

@@ -1,37 +1,41 @@
 ---
-title: "Access the Kubernetes API of the Fleet resource"
-description: Learn how to access the Kubernetes API of the Fleet resource.
-ms.topic: how-to
-ms.date: 03/20/2024
-author: shashankbarsin
-ms.author: shasb
+title: "Quickstart: Access the Kubernetes API of the Fleet resource"
+description: Learn how to access the Kubernetes API of the Fleet resource with Azure Kubernetes Fleet Manager.
+ms.topic: quickstart
+ms.date: 04/01/2024
+author: schaffererin
+ms.author: schaffererin
 ms.service: kubernetes-fleet
 ---
 
-# Access the Kubernetes API of the Fleet resource with Azure Kubernetes Fleet Manager
+# Quickstart: Access the Kubernetes API of the Fleet resource
 
 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.
 
 ## Prerequisites
 
 [!INCLUDE [free trial note](../../includes/quickstarts-free-trial-note.md)]
 
-* 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).
+* You need a Fleet resource with a hub cluster and member clusters. If you don't have one, see [Create an Azure Kubernetes Fleet Manager resource and join member clusters using Azure CLI](quickstart-create-fleet-and-members.md).
 * The identity (user or service principal) you're using needs to have the Microsoft.ContainerService/fleets/listCredentials/action on the Fleet resource.
 
-## Access the Kubernetes API of the Fleet resource cluster
+## Access the Kubernetes API of the Fleet resource
 
-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.
+1. Set the following environment variables for your subscription ID, resource group, and Fleet resource:
 
     ```azurecli-interactive
     export SUBSCRIPTION_ID=<subscription-id>
-    az account set --subscription ${SUBSCRIPTION_ID}
-
     export GROUP=<resource-group-name>
     export FLEET=<fleet-name>
     ```
 
-2. Get the kubeconfig file of the hub cluster Fleet resource using the [`az fleet get-credentials`][az-fleet-get-credentials] command.
+2. Set the default Azure subscription to use using the [`az account set`][az-account-set] command.
+
+    ```azurecli-interactive
+    az account set --subscription ${SUBSCRIPTION_ID}
+    ```
+
+3. Get the kubeconfig file of the hub cluster Fleet resource using the [`az fleet get-credentials`][az-fleet-get-credentials] command.
 
     ```azurecli-interactive
     az fleet get-credentials --resource-group ${GROUP} --name ${FLEET}
@@ -43,13 +47,13 @@ If your Azure Kubernetes Fleet Manager resource was created with the hub cluster
     Merged "hub" as current context in /home/fleet/.kube/config
     ```
 
-3. Set the following environment variable for the `id` of the hub cluster Fleet resource:
+4. Set the following environment variable for the `id` of the hub cluster Fleet resource:
 
     ```azurecli-interactive
     export FLEET_ID=/subscriptions/${SUBSCRIPTION_ID}/resourceGroups/${GROUP}/providers/Microsoft.ContainerService/fleets/${FLEET}
     ```
 
-4. Authorize your identity to the hub cluster Fleet resource's Kubernetes API server using the following commands:
+5. Authorize your identity to the hub cluster Fleet resource's Kubernetes API server using the following commands:
 
     For the `ROLE` environment variable, you can use one of the following four built-in role definitions as the value:
 
@@ -64,7 +68,7 @@ If your Azure Kubernetes Fleet Manager resource was created with the hub cluster
     az role assignment create --role "${ROLE}" --assignee ${IDENTITY} --scope ${FLEET_ID}
     ```
 
-    Your output should be similar to the following example output:
+    Your output should look similar to the following example output:
 
     ```output
     {
@@ -83,7 +87,7 @@ If your Azure Kubernetes Fleet Manager resource was created with the hub cluster
     }
     ```
 
-5. Verify you can access the API server using the `kubectl get memberclusters` command.
+6. Verify you can access the API server using the `kubectl get memberclusters` command.
 
     ```bash
     kubectl get memberclusters
@@ -100,8 +104,7 @@ If your Azure Kubernetes Fleet Manager resource was created with the hub cluster
 
 ## Next steps
 
-* Review the [API specifications][fleet-apispec] for all Fleet custom resources.
-* Review our [troubleshooting guide][troubleshooting-guide] to help resolve common issues related to the Fleet APIs.
+* [Propagate resources from a Fleet hub cluster to member clusters](./quickstart-resource-propagation.md).
 
 <!-- LINKS --->
 [fleet-apispec]: https://github.com/Azure/fleet/blob/main/docs/api-references.md

articles/kubernetes-fleet/access-fleet-kubernetes-api.md renamed to articles/kubernetes-fleet/quickstart-access-fleet-kubernetes-api.md

@@ -16,6 +16,8 @@ Get started with Azure Kubernetes Fleet Manager (Fleet) by using the Azure porta
 
 ## Prerequisites
 
+[!INCLUDE [free trial note](../../includes/quickstarts-free-trial-note.md)]
+
 * Read the [conceptual overview of this feature](./concepts-fleet.md), which provides an explanation of fleets and member clusters referenced in this document.
 * An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 * An identity (user or service principal) with the following permissions on the Fleet and AKS resource types for completing the steps listed in this quickstart:
@@ -60,6 +62,4 @@ Get started with Azure Kubernetes Fleet Manager (Fleet) by using the Azure porta
 
 ## Next steps
 
-* [Orchestrate updates across multiple member clusters](./update-orchestration.md).
-* [Set up Kubernetes resource propagation from hub cluster to member clusters](./resource-propagation.md).
-* [Set up multi-cluster layer-4 load balancing](./l4-load-balancing.md).
+* [Access the Kubernetes API of the Fleet resource](./quickstart-access-fleet-kubernetes-api.md).

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

@@ -16,6 +16,8 @@ Get started with Azure Kubernetes Fleet Manager (Fleet) by using the Azure CLI t
 
 ## Prerequisites
 
+[!INCLUDE [free trial note](../../includes/quickstarts-free-trial-note.md)]
+
 * Read the [conceptual overview of this feature](./concepts-fleet.md), which provides an explanation of fleets and member clusters referenced in this document.
 * An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 * An identity (user or service principal) which can be used to [log in to Azure CLI](/cli/azure/authenticate-azure-cli). This identity needs to have the following permissions on the Fleet and AKS resource types for completing the steps listed in this quickstart:
@@ -150,11 +152,7 @@ Fleet currently supports joining existing AKS clusters as member clusters.
 
     ```azurecli-interactive
     # Join the first member cluster
-    az fleet member create \
-        --resource-group ${GROUP} \
-        --fleet-name ${FLEET} \
-        --name ${MEMBER_NAME_1} \
-        --member-cluster-id ${MEMBER_CLUSTER_ID_1}
+    az fleet member create --resource-group ${GROUP} --fleet-name ${FLEET} --name ${MEMBER_NAME_1} --member-cluster-id ${MEMBER_CLUSTER_ID_1}
     ```
 
     Your output should look similar to the following example output:
@@ -197,9 +195,7 @@ Fleet currently supports joining existing AKS clusters as member clusters.
 
 ## Next steps
 
-* [Orchestrate updates across multiple member clusters](./update-orchestration.md).
-* [Set up Kubernetes resource propagation from hub cluster to member clusters](./resource-propagation.md).
-* [Set up multi-cluster layer-4 load balancing](./l4-load-balancing.md).
+* [Access the Kubernetes API of the Fleet resource](./quickstart-access-fleet-kubernetes-api.md).
 
 <!-- INTERNAL LINKS -->
 [az-extension-add]: /cli/azure/extension#az-extension-add