Skip to content

Commit 7b68f94

Browse files
committed
Merge branch 'release-azurelocal-rebrand' of https://github.com/MicrosoftDocs/azure-stack-docs-pr into banner-23h2
2 parents 0af6b73 + 991bbfd commit 7b68f94

File tree

100 files changed

+579
-478
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

100 files changed

+579
-478
lines changed

AKS-Hybrid/TOC.yml

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,10 @@
1111
href: supported-kubernetes-versions.md
1212
- name: Data collection
1313
href: data-collection.md
14-
- name: AKS on Azure Stack HCI 23H2
14+
- name: AKS on Azure Local, version 23H2
1515
expanded: true
1616
items:
17-
- name: What's new in AKS on Azure Stack HCI 23H2
17+
- name: What's new in AKS on Azure Local, version 23H2
1818
href: aks-whats-new-23h2.md
1919
- name: Concepts
2020
items:
@@ -152,7 +152,7 @@
152152
href: /rest/api/hybridcontainer/operation-groups
153153
- name: Resources
154154
items:
155-
- name: Azure Stack HCI
155+
- name: Azure Local
156156
href: /azure-stack/hci/index
157157
- name: Azure hybrid cloud
158158
href: /hybrid
@@ -355,7 +355,7 @@
355355
href: create-replicasets.md
356356
- name: Create a StatefulSet
357357
href: create-statefulset.md
358-
- name: Availability with 2-node HCI cluster
358+
- name: Availability with 2-node Azure Local cluster
359359
href: deploy-cluster-on-two-node-hci.md
360360
- name: Security
361361
items:
@@ -557,11 +557,11 @@
557557
href: known-issues-uninstall.yml
558558
- name: Other
559559
href: known-issues.yml
560-
- name: Azure Stack HCI issues
560+
- name: Azure Local issues
561561
items:
562-
- name: Cluster validation reporting in Azure Stack HCI
562+
- name: Cluster validation reporting in Azure Local
563563
href: /azure-stack/hci/manage/validate-qos
564-
- name: CredSSP in Azure Stack HCI
564+
- name: CredSSP in Azure Local
565565
href: /azure-stack/hci/manage/troubleshoot-credssp
566566
- name: Support policies
567567
href: support-policies.md

AKS-Hybrid/ad-sso.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ Before you can install AD authentication, the workload cluster must be installed
7777

7878
#### Option 1
7979

80-
For a domain-joined Azure Stack HCI or Windows Server cluster, open PowerShell as an administrator and run the following command:
80+
For a domain-joined Azure Local or Windows Server cluster, open PowerShell as an administrator and run the following command:
8181

8282
```powershell
8383
Install-AksHciAdAuth -name mynewcluster1 -keytab .\current.keytab -SPN k8s/[email protected] -adminUser contoso\bob

AKS-Hybrid/aks-arc-diagnostic-checker.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,14 +22,14 @@ It can be difficult to identify environment-related issues, such as networking c
2222

2323
Before you begin, make sure you have the following prerequisites. If you don't meet the requirements for running the diagnostic checker tool, [file a support request](aks-troubleshoot.md#open-a-support-request):
2424

25-
- Direct access to the Azure Stack HCI cluster where you created the AKS cluster. This access can be through remote desktop (RDP), or you can also sign in to one of the Azure Stack HCI physical nodes.
25+
- Direct access to the Azure Local cluster where you created the AKS cluster. This access can be through remote desktop (RDP), or you can also sign in to one of the Azure Local physical nodes.
2626
- Review the [networking concepts for creating an AKS cluster](aks-hci-network-system-requirements.md) and the [AKS cluster architecture](cluster-architecture.md).
2727
- The name of the logical network attached to the AKS cluster.
2828
- An SSH private key for the AKS cluster, used to sign in to the AKS cluster [control plane node](cluster-architecture.md#control-plane-nodes) VM.
2929

3030
## Obtain control plane node VM IP of the AKS cluster
3131

32-
Run the following command from any one physical node in your Azure Stack HCI cluster. Ensure that you're passing the name, and not the Azure Resource Manager ID of the AKS cluster:
32+
Run the following command from any one physical node in your Azure Local cluster. Ensure that you're passing the name, and not the Azure Resource Manager ID of the AKS cluster:
3333

3434
```powershell
3535
invoke-command -computername (get-clusternode) -script {get-vmnetworkadapter -vmname *} | Where-Object {$_.Name -like "$cluster_name*control-plane-*"} | select vmname, ipaddresses
@@ -53,7 +53,7 @@ If you see a control plane VM, and it has:
5353

5454
## Run the diagnostic checker script
5555

56-
Copy the following PowerShell script `run_diagnostic.ps1` into any one node of your Azure Stack HCI cluster:
56+
Copy the following PowerShell script `run_diagnostic.ps1` into any one node of your Azure Local cluster:
5757

5858
```powershell
5959
<#

AKS-Hybrid/aks-arc-use-node-taints.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Manage node taints for an AKS cluster
3-
description: Learn how to manage node taints in AKS on Azure Stack HCI 23H2
3+
description: Learn how to manage node taints in AKS on Azure Local, version 23H2
44
ms.topic: how-to
55
ms.custom:
66
ms.date: 06/03/2024

AKS-Hybrid/aks-create-clusters-cli.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Create Kubernetes clusters using Azure CLI
3-
description: Learn how to create Kubernetes clusters in Azure Stack HCI using Azure CLI.
3+
description: Learn how to create Kubernetes clusters in Azure Local using Azure CLI.
44
ms.topic: how-to
55
ms.custom: devx-track-azurecli
66
author: sethmanheim
@@ -14,20 +14,20 @@ ms.reviewer: guanghu
1414

1515
[!INCLUDE [hci-applies-to-23h2](includes/hci-applies-to-23h2.md)]
1616

17-
This article describes how to create Kubernetes clusters in Azure Stack HCI using Azure CLI. The workflow is as follows:
17+
This article describes how to create Kubernetes clusters in Azure Local using Azure CLI. The workflow is as follows:
1818

19-
1. Create a Kubernetes cluster in Azure Stack HCI 23H2 using Azure CLI. The cluster is Azure Arc-connected by default.
19+
1. Create a Kubernetes cluster in Azure Local, version 23H2 using Azure CLI. The cluster is Azure Arc-connected by default.
2020
1. While creating the cluster, you provide a Microsoft Entra group that contains the list of Microsoft Entra users with Kubernetes cluster administrator access.
2121
1. Access the cluster using kubectl and your Microsoft Entra ID.
2222
1. Run a sample multi-container application with a web front end and a Redis instance in the cluster.
2323

2424
## Before you begin
2525

2626
- Before you begin, make sure you have the following details from your on-premises infrastructure administrator:
27-
- **Azure subscription ID** - The Azure subscription ID where Azure Stack HCI is used for deployment and registration.
28-
- **Custom Location ID** - Azure Resource Manager ID of the custom location. The custom location is configured during the Azure Stack HCI cluster deployment. Your infrastructure admin should give you the Resource Manager ID of the custom location. This parameter is required in order to create Kubernetes clusters. You can also get the Resource Manager ID using `az customlocation show --name "<custom location name>" --resource-group <azure resource group> --query "id" -o tsv`, if the infrastructure admin provides a custom location name and resource group name.
29-
- **Network ID** - Azure Resource Manager ID of the Azure Stack HCI logical network created following [these steps](aks-networks.md). Your admin should give you the ID of the logical network. This parameter is required in order to create Kubernetes clusters. You can also get the Azure Resource Manager ID using `az stack-hci-vm network lnet show --name "<lnet name>" --resource-group <azure resource group> --query "id" -o tsv` if you know the resource group in which the logical network was created.
30-
- You can run the steps in this article in a local development machine to create a Kubernetes cluster on your remote Azure Stack HCI deployment. Make sure you have the latest version of [Az CLI](/cli/azure/install-azure-cli) on your development machine. You can also choose to upgrade your Az CLI version using `az upgrade`.
27+
- **Azure subscription ID** - The Azure subscription ID where Azure Local is used for deployment and registration.
28+
- **Custom Location ID** - Azure Resource Manager ID of the custom location. The custom location is configured during the Azure Local cluster deployment. Your infrastructure admin should give you the Resource Manager ID of the custom location. This parameter is required in order to create Kubernetes clusters. You can also get the Resource Manager ID using `az customlocation show --name "<custom location name>" --resource-group <azure resource group> --query "id" -o tsv`, if the infrastructure admin provides a custom location name and resource group name.
29+
- **Network ID** - Azure Resource Manager ID of the Azure Local logical network created following [these steps](aks-networks.md). Your admin should give you the ID of the logical network. This parameter is required in order to create Kubernetes clusters. You can also get the Azure Resource Manager ID using `az stack-hci-vm network lnet show --name "<lnet name>" --resource-group <azure resource group> --query "id" -o tsv` if you know the resource group in which the logical network was created.
30+
- You can run the steps in this article in a local development machine to create a Kubernetes cluster on your remote Azure Local deployment. Make sure you have the latest version of [Az CLI](/cli/azure/install-azure-cli) on your development machine. You can also choose to upgrade your Az CLI version using `az upgrade`.
3131
- To connect to the Kubernetes cluster from anywhere, create a Microsoft Entra group and add members to it. All the members in the Microsoft Entra group have cluster administrator access to the cluster. Make sure to add yourself as a member to the Microsoft Entra group. If you don't add yourself, you cannot access the Kubernetes cluster using kubectl. For more information about creating Microsoft Entra groups and adding users, see [Manage Microsoft Entra groups and group membership](/entra/fundamentals/how-to-manage-groups).
3232
- [Download and install kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl) on your development machine. The Kubernetes command-line tool, kubectl, enables you to run commands against Kubernetes clusters. You can use kubectl to deploy applications, inspect and manage cluster resources, and view logs.
3333

AKS-Hybrid/aks-create-clusters-portal.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.lastreviewed: 01/30/2024
1313

1414
[!INCLUDE [hci-applies-to-23h2](includes/hci-applies-to-23h2.md)]
1515

16-
This article describes how to create Kubernetes clusters in Azure Stack HCI using the Azure portal. The workflow is as follows:
16+
This article describes how to create Kubernetes clusters in Azure Local using the Azure portal. The workflow is as follows:
1717

1818
- How to create a Kubernetes cluster using the Azure portal. By default, the cluster is Azure Arc-connected.
1919
- While creating the cluster, you provide a Microsoft Entra group that contains the list of Microsoft Entra users with Kubernetes cluster administrator access.
@@ -81,5 +81,5 @@ This article describes how to create Kubernetes clusters in Azure Stack HCI usin
8181

8282
## Next steps
8383

84-
- [Review AKS on Azure Stack HCI 23H2 prerequisites](aks-hci-network-system-requirements.md)
85-
- [What's new in AKS on Azure Stack HCI](aks-whats-new-23h2.md)
84+
- [Review AKS on Azure Local, version 23H2 prerequisites](aks-hci-network-system-requirements.md)
85+
- [What's new in AKS on Azure Local](aks-whats-new-23h2.md)

AKS-Hybrid/aks-create-containers.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Create Windows Server containers
3-
description: Learn how to create Windows Server containers in Azure Stack HCI.
3+
description: Learn how to create Windows Server containers in Azure Local.
44
ms.topic: how-to
55
author: sethmanheim
66
ms.date: 07/15/2024

AKS-Hybrid/aks-hci-ip-address-planning.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ In the following scenario walk-through, you reserve IP addresses from a single n
2929

3030
### Example walkthrough for IP address reservation for Kubernetes clusters and applications
3131

32-
Jane is an IT administrator just starting with AKS enabled by Azure Arc. Jane wants to deploy two Kubernetes clusters: Kubernetes cluster A and Kubernetes cluster B on the Azure Stack HCI cluster. Jane also wants to run a voting application on top of cluster A. This application has three instances of the front-end UI running across the two clusters and one instance of the backend database. All the AKS clusters and services are running in a single network, with a single subnet.
32+
Jane is an IT administrator just starting with AKS enabled by Azure Arc. Jane wants to deploy two Kubernetes clusters: Kubernetes cluster A and Kubernetes cluster B on the Azure Local cluster. Jane also wants to run a voting application on top of cluster A. This application has three instances of the front-end UI running across the two clusters and one instance of the backend database. All the AKS clusters and services are running in a single network, with a single subnet.
3333

3434
- Kubernetes cluster A has 3 control plane nodes and 5 worker nodes.
3535
- Kubernetes cluster B has 1 control plane node and 3 worker nodes.
@@ -48,17 +48,17 @@ Continuing with this example, and adding it to the following table, you get:
4848

4949
| Parameter | Number of IP addresses | How and where to make this reservation |
5050
|------------------|---------|---------------|
51-
| AKS Arc VMs and K8s version upgrade | Reserve 14 IP addresses | Make this reservation through IP pools in the Azure Stack HCI logical network. |
51+
| AKS Arc VMs and K8s version upgrade | Reserve 14 IP addresses | Make this reservation through IP pools in the Azure Local logical network. |
5252
| Control plane IP | Reserve 2 IP addresses, one for AKS Arc cluster | Use the `controlPlaneIP` parameter to pass the IP address for control plane IP. Ensure that this IP is in the same subnet as the Arc logical network, but outside the IP pool defined in the Arc logical network. |
5353
| Load balancer IPs | 3 IP address for Kubernetes services, for Jane's voting application. | These IP addresses are used when you install a load balancer on cluster A. You can use the MetalLB Arc extension, or bring your own 3rd party load balancer. Ensure that this IP is in the same subnet as the Arc logical network, but outside the IP pool defined in the Arc VM logical network. |
5454

5555
### LNETs considerations for AKS clusters and Arc VMs
5656

57-
Logical networks on Azure Stack HCI are used by both AKS clusters and Arc VMs. You can configure logical networks in one of the following 2 ways:
57+
Logical networks on Azure Local are used by both AKS clusters and Arc VMs. You can configure logical networks in one of the following 2 ways:
5858
- Share a logical network between AKS and Arc VMs.
5959
- Define separate logical networks for AKS clusters and Arc VMs.
6060

61-
Sharing a logical network between AKS and Arc VMs on Azure Stack HCI offers the benefit of streamlined communication, cost savings, and simplified network management. However, this approach also introduces potential challenges such as resource contention, security risks, and complexity in troubleshooting.
61+
Sharing a logical network between AKS and Arc VMs on Azure Local offers the benefit of streamlined communication, cost savings, and simplified network management. However, this approach also introduces potential challenges such as resource contention, security risks, and complexity in troubleshooting.
6262

6363
| **Criteria** | **Sharing a logical network** | **Defining separate logical networks** |
6464
|-------------------------------------------|----------------------------------------------------------------|----------------------------------------------------------------|
@@ -88,4 +88,4 @@ AKS provides a **default value of 10.96.0.0/12** for the service network CIDR. A
8888

8989
## Next steps
9090

91-
[Create logical networks for Kubernetes clusters on Azure Stack HCI 23H2](aks-networks.md)
91+
[Create logical networks for Kubernetes clusters on Azure Local, version 23H2](aks-networks.md)

0 commit comments

Comments
 (0)