Skip to content

Commit c35fde3

Browse files
author
gitName
committed
Fix merge conflict
2 parents 68a77d3 + 635b6cf commit c35fde3

File tree

385 files changed

+4623
-5528
lines changed

Some content is hidden

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

385 files changed

+4623
-5528
lines changed

.openpublishing.publish.config.json

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@
66
"build_output_subfolder": "adaptive-cloud",
77
"locale": "en-us",
88
"monikers": [],
9+
"moniker_ranges": [],
910
"open_to_public_contributors": false,
1011
"type_mapping": {
1112
"Conceptual": "Content"
@@ -29,14 +30,12 @@
2930
"template_folder": "_themes"
3031
},
3132
{
32-
"docset_name": "AzureLocal",
33-
"build_source_folder": "azure-local",
34-
"build_output_subfolder": "AzureLocal",
33+
"docset_name": "azure-managed-lustre",
34+
"build_source_folder": "azure-managed-lustre",
35+
"build_output_subfolder": "azure-managed-lustre",
3536
"locale": "en-us",
3637
"monikers": [],
37-
"moniker_ranges": [
38-
">=azloc-2408"
39-
],
38+
"moniker_ranges": [],
4039
"open_to_public_contributors": true,
4140
"type_mapping": {
4241
"Conceptual": "Content"
@@ -45,12 +44,14 @@
4544
"template_folder": "_themes"
4645
},
4746
{
48-
"docset_name": "azure-managed-lustre",
49-
"build_source_folder": "azure-managed-lustre",
50-
"build_output_subfolder": "azure-managed-lustre",
47+
"docset_name": "AzureLocal",
48+
"build_source_folder": "azure-local",
49+
"build_output_subfolder": "AzureLocal",
5150
"locale": "en-us",
5251
"monikers": [],
53-
"moniker_ranges": [],
52+
"moniker_ranges": [
53+
">=azloc-2408"
54+
],
5455
"open_to_public_contributors": true,
5556
"type_mapping": {
5657
"Conceptual": "Content"

.openpublishing.redirection.aks.json

Lines changed: 282 additions & 272 deletions
Large diffs are not rendered by default.

.openpublishing.redirection.azure-local.json

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1909,6 +1909,11 @@
19091909
"source_path": "azure-local/security-update/security-update-jan-2025.md",
19101910
"redirect_url": "/azure/azure-local/security-update/security-update",
19111911
"redirect_document_id": false
1912+
},
1913+
{
1914+
"source_path": "azure-local/manage/trusted-launch-vm-deploy.md",
1915+
"redirect_url": "/azure/azure-local/manage/trusted-launch-vm-overview",
1916+
"redirect_document_id": false
19121917
}
19131918
]
1914-
}
1919+
}

.openpublishing.redirection.json

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1620,6 +1620,106 @@
16201620
"redirect_url": "/azure-stack/hci/migrate/migration-azure-migrate-overview",
16211621
"redirect_document_id": false
16221622
},
1623+
{
1624+
"source_path": "azure-stack/asdk/index.yml",
1625+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1626+
"redirect_document_id": false
1627+
},
1628+
{
1629+
"source_path": "azure-stack/asdk/asdk-admin-basics.md",
1630+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1631+
"redirect_document_id": false
1632+
},
1633+
{
1634+
"source_path": "azure-stack/asdk/asdk-advanced-eval.md",
1635+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1636+
"redirect_document_id": false
1637+
},
1638+
{
1639+
"source_path": "azure-stack/asdk/asdk-architecture.md",
1640+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1641+
"redirect_document_id": false
1642+
},
1643+
{
1644+
"source_path": "azure-stack/asdk/asdk-cli.md",
1645+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1646+
"redirect_document_id": false
1647+
},
1648+
{
1649+
"source_path": "azure-stack/asdk/asdk-connect.md",
1650+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1651+
"redirect_document_id": false
1652+
},
1653+
{
1654+
"source_path": "azure-stack/asdk/asdk-deploy-considerations.md",
1655+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1656+
"redirect_document_id": false
1657+
},
1658+
{
1659+
"source_path": "azure-stack/asdk/asdk-deploy-powershell.md",
1660+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1661+
"redirect_document_id": false
1662+
},
1663+
{
1664+
"source_path": "azure-stack/asdk/asdk-download.md",
1665+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1666+
"redirect_document_id": false
1667+
},
1668+
{
1669+
"source_path": "azure-stack/asdk/asdk-install.md",
1670+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1671+
"redirect_document_id": false
1672+
},
1673+
{
1674+
"source_path": "azure-stack/asdk/asdk-post-deploy.md",
1675+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1676+
"redirect_document_id": false
1677+
},
1678+
{
1679+
"source_path": "azure-stack/asdk/asdk-prepare-host.md",
1680+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1681+
"redirect_document_id": false
1682+
},
1683+
{
1684+
"source_path": "azure-stack/asdk/asdk-redeploy.md",
1685+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1686+
"redirect_document_id": false
1687+
},
1688+
{
1689+
"source_path": "azure-stack/asdk/asdk-register.md",
1690+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1691+
"redirect_document_id": false
1692+
},
1693+
{
1694+
"source_path": "azure-stack/asdk/asdk-release-notes.md",
1695+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1696+
"redirect_document_id": false
1697+
},
1698+
{
1699+
"source_path": "azure-stack/asdk/asdk-start-stop.md",
1700+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1701+
"redirect_document_id": false
1702+
},
1703+
{
1704+
"source_path": "azure-stack/asdk/asdk-telemetry.md",
1705+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1706+
"redirect_document_id": false
1707+
},
1708+
{
1709+
"source_path": "azure-stack/asdk/asdk-troubleshooting.md",
1710+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1711+
"redirect_document_id": false
1712+
},
1713+
{
1714+
"source_path": "azure-stack/asdk/asdk-validate-backup.md",
1715+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1716+
"redirect_document_id": false
1717+
},
1718+
{
1719+
"source_path": "azure-stack/asdk/asdk-what-is.md",
1720+
"redirect_url": "/azure-stack/operator/azure-stack-overview",
1721+
"redirect_document_id": false
1722+
},
16231723
{
16241724
"source_path": "azure-stack/hci/manage/monitor-hci-single-23h2.md",
16251725
"redirect_url": "/azure-stack/hci/manage/monitor-single-23h2",

AKS-Arc/TOC.yml

Lines changed: 27 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,7 @@
9999
- name: Deploy and configure Workload Identity
100100
href: workload-identity.md
101101
- name: Storage
102+
href: concepts-storage.md
102103
items:
103104
- name: CSI storage drivers
104105
items:
@@ -132,6 +133,8 @@
132133
href: kubernetes-monitor-object-events.md
133134
- name: Get kubelet logs
134135
href: aks-get-kubelet-logs.md
136+
- name: Monitor control plane metrics
137+
href: control-plane-metrics.md
135138
- name: Enable Container Insights
136139
href: /azure/azure-monitor/containers/kubernetes-monitoring-enable
137140
- name: Monitor Kubernetes audit events
@@ -144,20 +147,28 @@
144147
href: kubernetes-monitor-metrics.md
145148
- name: Troubleshooting
146149
items:
147-
- name: Troubleshoot & known issues
150+
- name: Troubleshoot and known issues
148151
href: aks-troubleshoot.md
152+
- name: Control plane configuration validation errors
153+
href: control-plane-validation-errors.md
154+
- name: Connectivity issues with MetalLB
155+
href: load-balancer-issues.md
149156
- name: K8sVersionValidation error
150157
href: cluster-k8s-version.md
151158
- name: Use diagnostic checker
152159
href: aks-arc-diagnostic-checker.md
153160
- name: KubeAPIServer unreachable error
154161
href: kube-api-server-unreachable.md
155162
- name: Can't see VM SKUs on Azure portal
156-
href: tsg-check-vm-sku.md
163+
href: check-vm-sku.md
157164
- name: Deleted AKS Arc cluster still visible on Azure portal
158165
href: deleted-cluster-visible.md
159166
- name: Can't fully delete AKS Arc cluster with PodDisruptionBudget (PDB) resources
160167
href: delete-cluster-pdb.md
168+
- name: Azure Advisor upgrade recommendation
169+
href: azure-advisor-upgrade.md
170+
- name: Issues after deleting storage volumes
171+
href: delete-storage-volume.md
161172
- name: Reference
162173
items:
163174
- name: Azure CLI
@@ -180,6 +191,8 @@
180191
href: aks-edge-overview.md
181192
- name: System requirements and support matrix
182193
href: aks-edge-system-requirements.md
194+
- name: What's new in AKS Edge Essentials
195+
href: aks-edge-whats-new.md
183196
- name: Quickstart
184197
href: aks-edge-quickstart.md
185198
- name: Concepts
@@ -214,14 +227,20 @@
214227
href: aks-edge-howto-deploy-azure-iot.md
215228
- name: Offline installation
216229
href: aks-edge-howto-offline-install.md
217-
- name: Access TPM secrets
218-
href: aks-edge-howto-access-tpm.md
219230
- name: Additional configuration
220231
href: aks-edge-howto-more-configs.md
221232
- name: Use GPU acceleration
222233
href: aks-edge-gpu.md
223-
- name: Configure Workload Identity
224-
href: aks-edge-workload-identity.md
234+
- name: Security
235+
items:
236+
- name: Configure Workload Identity
237+
href: aks-edge-workload-identity.md
238+
- name: Access TPM secrets
239+
href: aks-edge-howto-access-tpm.md
240+
- name: Enable secret encryption with the KMS plugin
241+
href: aks-edge-howto-secret-encryption.md
242+
- name: Use the Key Manager for Kubernetes extension
243+
href: aks-edge-howto-key-manager.md
225244
- name: Update AKS Edge Essentials
226245
items:
227246
- name: Update online
@@ -256,8 +275,6 @@
256275
href: aks-edge-troubleshoot-overview.md
257276
- name: Logs
258277
href: aks-edge-resources-logs.md
259-
- name: Release notes and known issues
260-
href: https://github.com/Azure/AKS-Edge/releases
261278
- name: File bugs
262279
href: https://github.com/Azure/AKS-Edge/issues
263280
- name: AKS Edge Essentials pricing
@@ -316,6 +333,8 @@
316333
href: vnet.yml
317334
- name: AKS on Windows Server
318335
items:
336+
- name: AKS on Windows Server retirement
337+
href: aks-windows-server-retirement.md
319338
- name: Overview
320339
href: overview.md
321340
- name: System requirements
@@ -389,8 +408,6 @@
389408
href: concepts-node-networking.md
390409
- name: Kubernetes container networking
391410
href: concepts-container-networking.md
392-
- name: Storage
393-
href: concepts-storage.md
394411
- name: Application availability
395412
href: app-availability.md
396413
- name: Scale

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

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how to create Kubernetes clusters in Azure Local using Azure
44
ms.topic: how-to
55
ms.custom: devx-track-azurecli
66
author: sethmanheim
7-
ms.date: 12/18/2024
7+
ms.date: 02/18/2025
88
ms.author: sethm
99
ms.lastreviewed: 01/25/2024
1010
ms.reviewer: guanghu
@@ -52,10 +52,14 @@ az aksarc create -n $aksclustername -g $resource_group --custom-location $custom
5252

5353
After a few minutes, the command completes and returns JSON-formatted information about the cluster.
5454

55-
> [!NOTE]
56-
> - The SSH key value is the public key for accessing nodes in the provisioned cluster. By default, this key is located at `~/.ssh/id_rsa.pub`. You can specify a different location using the `--ssh-key-value` parameter during cluster creation.
57-
> - The `--generate-ssh-keys` parameter is required if there's no pre-existing SSH key on your local machine. If you don't include this parameter during cluster creation and no SSH key exists, you receive an error message.
58-
> - If you already have an SSH key on your local machine, the AKS cluster reuses that key. In this case, specifying `--generate-ssh-keys`, or omitting that parameter, has no effect.
55+
### Considerations
56+
57+
Note the following considerations when you create a cluster:
58+
59+
- SSH keys are essential for troubleshooting and log collection. Be sure to save your private key file for future use. To access nodes, see [Connect to Windows or Linux worker nodes with SSH](/azure/aks/aksarc/ssh-connect-to-windows-and-linux-worker-nodes).
60+
- You can use a pre-existing SSH key or [configure SSH keys for an AKS cluster](configure-ssh-keys.md) during cluster creation. If there's no pre-existing SSH key on your local machine, the `--generate-ssh-keys` parameter is required. You can also restrict SSH access by following [the documentation](restrict-ssh-access.md). For detailed instructions, see [Create and store SSH keys with the Azure CLI](/azure/virtual-machines/ssh-keys-azure-cli), or in the [Azure portal](/azure/virtual-machines/ssh-keys-portal).
61+
- If you don't include `--generate-ssh-keys` during cluster creation and no SSH key exists, you receive an error message. If you already have an SSH key on your local machine, the AKS cluster reuses it. In this case, it makes no difference whether you specify `--generate-ssh-keys` or not.
62+
- By default, the SSH key is stored at **~/.ssh/id_rsa.pub**. During cluster creation, you can specify an alternate location using the `--ssh-key-value` parameter.
5963

6064
> [!IMPORTANT]
6165
> To use Azure RBAC or workload identity for an AKS cluster, you must pass the required parameters during cluster creation using Azure CLI. Currently, updating an existing AKS cluster to enable workload identity and/or Azure RBAC is not supported. For more information, see [Use Azure RBAC for Kubernetes authorization](/azure/aks/hybrid/azure-rbac-23h2) or [Deploy and configure Workload Identity for your cluster](workload-identity.md).
@@ -253,3 +257,4 @@ az aksarc delete --name $aksclustername --resource-group $resource_group
253257
## Next steps
254258

255259
- [Troubleshoot and known issues with cluster provisioning from Azure](aks-known-issues.md)
260+
6

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

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Create Kubernetes clusters using the Azure portal.
44
author: sethmanheim
55
ms.author: sethm
66
ms.topic: how-to
7-
ms.date: 01/30/2024
7+
ms.date: 02/26/2025
88
ms.reviewer: guanghu
99
ms.lastreviewed: 01/30/2024
1010
---
@@ -29,7 +29,7 @@ This article describes how to create Kubernetes clusters in Azure Local using th
2929
## Create a Kubernetes cluster
3030

3131
1. Sign in to the [Azure portal](https://portal.azure.com/).
32-
1. On the Azure portal search bar, type Kubernetes Azure Arc.
32+
1. On the Azure portal search bar, type **Kubernetes Azure Arc**.
3333
1. Select **Add > Create a Kubernetes cluster with Azure Arc**:
3434

3535
:::image type="content" source="media/aks-create-clusters-portal/cluster-portal.png" alt-text="Screenshot showing cluster creation page on the portal." lightbox="media/aks-create-clusters-portal/cluster-portal.png":::
@@ -48,8 +48,9 @@ This article describes how to create Kubernetes clusters in Azure Local using th
4848
- **Primary node pool**:
4949
- You can leave the default values selected, or change the default value from the drop down list.
5050
- **SSH Keys**
51-
- Configure SSH access to the underlying VMs in your Kubernetes nodes for troubleshooting operations. You must provide an existing SSH public key.
52-
- Provide an RSA public key in the single line format (starting with "ssh-rsa") or the multi-line PEM format. You can generate SSH keys using PuTTYGen on Windows.
51+
- SSH keys are essential for troubleshooting and log collection. Be sure to save your private key file for future use.
52+
- You can use an existing SSH key or generate a new key pair during cluster creation. For information about how to create new SSH keys from the Azure portal, see [Create and store SSH keys in the portal](/azure/virtual-machines/ssh-keys-portal#generate-new-keys).
53+
- To **Use an existing public key by providing the SSH public key value**, provide an RSA public key in the single line format (starting with "ssh-rsa") or the multi-line PEM format.
5354

5455
1. Select **Next: Node pools** when complete.
5556
1. On the **Node pools** page, configure the following options:

AKS-Arc/aks-edge-concept-networking.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Basic networking concepts for AKS Edge Essentials
44
author: sethmanheim
55
ms.author: sethm
66
ms.topic: conceptual
7-
ms.date: 07/11/2024
7+
ms.date: 03/10/2025
88
ms.custom: template-concept
99
---
1010

@@ -99,7 +99,7 @@ It's possible to check the DNS servers being used for both Linux and Windows nod
9999
Invoke-AksEdgeNodeCommand -NodeType Linux -command "resolvectl status"
100100
```
101101
102-
The command output shows a list of the DNS servers configured for each Linux VM interfaces. In particular, it's important to check the **eth0** interface status, which is the default interface for the AKS EE VM communication. Also, make sure to check the IP addresses of the **Current DNS Server** and **DNS Servers** fields of the list. If there's no IP address, or the IP address isn't a valid DNS server IP address, then the DNS service won't work.
102+
The command output shows a list of the DNS servers configured for each Linux VM interfaces. In particular, it's important to check the **eth0** interface status, which is the default interface for the AKS Edge Essentials VM communication. Also, make sure to check the IP addresses of the **Current DNS Server** and **DNS Servers** fields of the list. If there's no IP address, or the IP address isn't a valid DNS server IP address, then the DNS service won't work.
103103
104104
- For Windows VM nodes:
105105

AKS-Arc/aks-edge-deployment-config-json.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Description of deployment configuration JSON parameters in AKS Edge
44
author: sethmanheim
55
ms.author: sethm
66
ms.topic: conceptual
7-
ms.date: 07/11/2024
7+
ms.date: 03/10/2025
88
ms.custom: template-concept
99
---
1010

@@ -21,6 +21,7 @@ You can find the complete JSON schema file at `C:\Program Files\AksEdge\aksedge-
2121
| `DeploymentType` |[`SingleMachineCluster` / `ScalableCluster`]| Specifies deployment type. In `ScalableCluster`, you can add more machines to the cluster infrastructure. | `SingleMachineCluster` |Single-machine and full deployment|
2222
| `Init.ServiceIPRangeStart` |IPv4 address `A.B.C.x`.|Reserved IP start address for your Kubernetes services. This IP range must be free on your subnet **A.B.C.0**.| None |Single-machine and full deployment|
2323
| `Init.ServiceIPRangeSize` |`[0-127]`|Number of reserved IP start addresses for your Kubernetes services. Based on the size, we allocate a range of free IP addresses on your subnet. | `0` |Single-machine and full deployment|
24+
| `Init.KmsPlugin.Enable` | Boolean | Specifies whether the KMS plugin is enabled or not. | false | Single-machine and full deployment|
2425
| `Join.ClusterJoinToken` |String|`Reserved` | None |Full deployment only|
2526
| `Join.DiscoveryTokenHash` |String|`Reserved`| None |Full deployment only|
2627
| `Join.CertificateKey` |String|`Reserved`| None |Full deployment only|

AKS-Arc/aks-edge-howto-connect-to-arc.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,17 @@ description: Connect your AKS Edge Essentials clusters to Arc
44
author: sethmanheim
55
ms.author: sethm
66
ms.topic: how-to
7-
ms.date: 09/27/2024
7+
ms.date: 03/10/2025
88
ms.custom: template-how-to
99
---
1010

1111
# Connect your AKS Edge Essentials cluster to Arc
1212

1313
This article describes how to connect your AKS Edge Essentials cluster to [Azure Arc](/azure/azure-arc/kubernetes/overview) so that you can monitor the health of your cluster on the Azure portal. If your cluster is connected to a proxy, you can use the scripts provided in the GitHub repo to connect your cluster to Arc [as described here](./aks-edge-howto-more-configs.md).
1414

15+
> [!IMPORTANT]
16+
> Starting with the AKS Edge Essentials 1.10.868.0 release, the `Arc` section of the config file is required. The Azure Arc connection occurs automatically after you run `New-AksEdgeDeployment` to deploy an AKS Edge Essentials cluster.
17+
1518
## Prerequisites
1619

1720
- Before connecting to Arc, infrastructure administrators who are the owner or contributor role of the subscription will have to:

0 commit comments

Comments
 (0)