Skip to content

Commit b94f051

Browse files
authored
Merge branch 'main' into whats-new
2 parents 94d4ddf + bcc5711 commit b94f051

File tree

445 files changed

+5645
-4451
lines changed

Some content is hidden

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

445 files changed

+5645
-4451
lines changed

.openpublishing.redirection.aks.json

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1434,6 +1434,61 @@
14341434
"source_path": "AKS-Arc/azure-hybrid-benefit.md",
14351435
"redirect_url": "/azure/aks/aksarc/pricing",
14361436
"redirect_document_id": false
1437+
},
1438+
{
1439+
"source_path": "AKS-Arc/aks-known-issues.md",
1440+
"redirect_url": "/azure/aks/aksarc/aks-troubleshoot",
1441+
"redirect_document_id": false
1442+
},
1443+
{
1444+
"source_path": "AKS-Arc/aks-whats-new-23h2.md",
1445+
"redirect_url": "/azure/aks/aksarc/aks-whats-new-local",
1446+
"redirect_document_id": false
1447+
},
1448+
{
1449+
"source_path": "AKS-Arc/azure-rbac-23h2.md",
1450+
"redirect_url": "/azure/aks/aksarc/azure-rbac-local",
1451+
"redirect_document_id": false
1452+
},
1453+
{
1454+
"source_path": "AKS-Arc/kubernetes-rbac-23h2.md",
1455+
"redirect_url": "/azure/aks/aksarc/kubernetes-rbac-local",
1456+
"redirect_document_id": false
1457+
},
1458+
{
1459+
"source_path": "AKS-Arc/tutorial-kubernetes-prepare-application.md",
1460+
"redirect_url": "/azure/aks/aksarc/overview",
1461+
"redirect_document_id": false
1462+
},
1463+
{
1464+
"source_path": "AKS-Arc/tutorial-kubernetes-prepare-azure-container-registry.md",
1465+
"redirect_url": "/azure/aks/aksarc/overview",
1466+
"redirect_document_id": false
1467+
},
1468+
{
1469+
"source_path": "AKS-Arc/tutorial-kubernetes-deploy-cluster.md",
1470+
"redirect_url": "/azure/aks/aksarc/overview",
1471+
"redirect_document_id": false
1472+
},
1473+
{
1474+
"source_path": "AKS-Arc/tutorial-kubernetes-deploy-application.md",
1475+
"redirect_url": "/azure/aks/aksarc/overview",
1476+
"redirect_document_id": false
1477+
},
1478+
{
1479+
"source_path": "AKS-Arc/tutorial-kubernetes-scale.md",
1480+
"redirect_url": "/azure/aks/aksarc/overview",
1481+
"redirect_document_id": false
1482+
},
1483+
{
1484+
"source_path": "AKS-Arc/tutorial-kubernetes-app-update.md",
1485+
"redirect_url": "/azure/aks/aksarc/overview",
1486+
"redirect_document_id": false
1487+
},
1488+
{
1489+
"source_path": "AKS-Arc/tutorial-kubernetes-upgrade-cluster.md",
1490+
"redirect_url": "/azure/aks/aksarc/overview",
1491+
"redirect_document_id": false
14371492
}
14381493
]
14391494
}

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1316,6 +1316,11 @@
13161316
"redirect_url": "/azure/azure-managed-lustre/client-install?pivots=ubuntu-22",
13171317
"redirect_document_id": false
13181318
},
1319+
{
1320+
"source_path": "azure-managed-lustre/install-ubuntu-24.md",
1321+
"redirect_url": "/azure/azure-managed-lustre/client-install?pivots=ubuntu-24",
1322+
"redirect_document_id": false
1323+
},
13191324
{
13201325
"source_path": "azure-stack/hci/get-started.md",
13211326
"redirect_url": "/azure-stack/hci/manage/monitor-cluster",

AKS-Arc/TOC.yml

Lines changed: 51 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -11,11 +11,11 @@
1111
href: data-collection.md
1212
- name: Blogs and announcements
1313
href: blogs-announcements.md
14-
- name: AKS on Azure Local, version 23H2
14+
- name: AKS on Azure Local
1515
expanded: true
1616
items:
17-
- name: What's new in AKS on Azure Local, version 23H2
18-
href: aks-whats-new-23h2.md
17+
- name: What's new in AKS on Azure Local
18+
href: aks-whats-new-local.md
1919
- name: Concepts
2020
items:
2121
- name: Architecture
@@ -33,9 +33,11 @@
3333
- name: High availability
3434
items:
3535
- name: Use availability sets
36-
href: availability-sets.md
36+
href: availability-sets.md
3737
- name: Supported scale requirements
3838
href: scale-requirements.md
39+
- name: Connectivity modes
40+
href: connectivity-modes.md
3941
- name: Billing
4042
items:
4143
- name: Pricing details
@@ -76,6 +78,10 @@
7678
href: deploy-load-balancer-portal.md
7779
# - name: Troubleshoot issues
7880
# href: load-balancer-troubleshoot.md
81+
- name: Security
82+
items:
83+
- name: Encrypt etcd secrets
84+
href: encrypt-etcd-secrets.md
7985
- name: AI and Machine Learning
8086
items:
8187
- name: Deploy an AI model with the AI toolchain operator
@@ -85,9 +91,9 @@
8591
- name: Enable Microsoft Entra ID authentication for Kubernetes clusters
8692
href: enable-authentication-microsoft-entra-id.md
8793
- name: Use Azure RBAC for Kubernetes authorization
88-
href: azure-rbac-23h2.md
94+
href: azure-rbac-local.md
8995
- name: Use Kubernetes RBAC with Microsoft Entra ID
90-
href: kubernetes-rbac-23h2.md
96+
href: kubernetes-rbac-local.md
9197
- name: Retrieve certificate-based admin kubeconfig
9298
href: retrieve-admin-kubeconfig.md
9399
- name: Configure SSH keys for a cluster
@@ -99,6 +105,7 @@
99105
- name: Deploy and configure Workload Identity
100106
href: workload-identity.md
101107
- name: Storage
108+
href: concepts-storage.md
102109
items:
103110
- name: CSI storage drivers
104111
items:
@@ -132,6 +139,8 @@
132139
href: kubernetes-monitor-object-events.md
133140
- name: Get kubelet logs
134141
href: aks-get-kubelet-logs.md
142+
- name: Monitor control plane metrics
143+
href: control-plane-metrics.md
135144
- name: Enable Container Insights
136145
href: /azure/azure-monitor/containers/kubernetes-monitoring-enable
137146
- name: Monitor Kubernetes audit events
@@ -148,28 +157,38 @@
148157
href: aks-troubleshoot.md
149158
- name: Control plane configuration validation errors
150159
href: control-plane-validation-errors.md
151-
- name: Connectivity issues with MetalLB
152-
href: load-balancer-issues.md
153160
- name: K8sVersionValidation error
154161
href: cluster-k8s-version.md
155162
- name: Use diagnostic checker
156163
href: aks-arc-diagnostic-checker.md
157164
- name: KubeAPIServer unreachable error
158165
href: kube-api-server-unreachable.md
159-
- name: Can't see VM SKUs on Azure portal
160-
href: check-vm-sku.md
161-
- name: Deleted AKS Arc cluster still visible on Azure portal
162-
href: deleted-cluster-visible.md
166+
- name: Can't create/scale AKS cluster due to image issues
167+
href: gallery-image-not-usable.md
168+
- name: Disk space exhaustion on control plane VMs
169+
href: kube-apiserver-log-overflow.md
170+
- name: Telemetry pod consumes too much memory and CPU
171+
href: telemetry-pod-resources.md
172+
- name: Issues after deleting storage volumes
173+
href: delete-storage-volume.md
163174
- name: Can't fully delete AKS Arc cluster with PodDisruptionBudget (PDB) resources
164175
href: delete-cluster-pdb.md
165176
- name: Azure Advisor upgrade recommendation
166177
href: azure-advisor-upgrade.md
167-
- name: Issues after deleting storage volumes
168-
href: delete-storage-volume.md
178+
- name: Deleted AKS Arc cluster still visible on Azure portal
179+
href: deleted-cluster-visible.md
180+
- name: Can't see VM SKUs on Azure portal
181+
href: check-vm-sku.md
182+
- name: Connectivity issues with MetalLB
183+
href: load-balancer-issues.md
184+
- name: Network validation error due to .local domain
185+
href: network-validation-error-local.md
169186
- name: Reference
170187
items:
171188
- name: Azure CLI
172189
href: /cli/azure/aksarc
190+
- name: Azure PowerShell
191+
href: /powershell/module/az.aksarc/
173192
- name: REST API reference
174193
href: /rest/api/hybridcontainer/operation-groups
175194
- name: Resources
@@ -188,6 +207,8 @@
188207
href: aks-edge-overview.md
189208
- name: System requirements and support matrix
190209
href: aks-edge-system-requirements.md
210+
- name: What's new in AKS Edge Essentials
211+
href: aks-edge-whats-new.md
191212
- name: Quickstart
192213
href: aks-edge-quickstart.md
193214
- name: Concepts
@@ -222,14 +243,20 @@
222243
href: aks-edge-howto-deploy-azure-iot.md
223244
- name: Offline installation
224245
href: aks-edge-howto-offline-install.md
225-
- name: Access TPM secrets
226-
href: aks-edge-howto-access-tpm.md
227246
- name: Additional configuration
228247
href: aks-edge-howto-more-configs.md
229248
- name: Use GPU acceleration
230249
href: aks-edge-gpu.md
231-
- name: Configure Workload Identity
232-
href: aks-edge-workload-identity.md
250+
- name: Security
251+
items:
252+
- name: Configure Workload Identity
253+
href: aks-edge-workload-identity.md
254+
- name: Access TPM secrets
255+
href: aks-edge-howto-access-tpm.md
256+
- name: Enable secret encryption with the KMS plugin
257+
href: aks-edge-howto-secret-encryption.md
258+
- name: Use the Key Manager for Kubernetes extension
259+
href: aks-edge-howto-key-manager.md
233260
- name: Update AKS Edge Essentials
234261
items:
235262
- name: Update online
@@ -260,12 +287,12 @@
260287
items:
261288
- name: AKS Edge Essentials PowerShell
262289
href: ./reference/aks-edge-ps/index.md
290+
- name: Get support
291+
href: aks-edge-help-support.md
263292
- name: Troubleshooting
264293
href: aks-edge-troubleshoot-overview.md
265294
- name: Logs
266295
href: aks-edge-resources-logs.md
267-
- name: Release notes and known issues
268-
href: https://github.com/Azure/AKS-Edge/releases
269296
- name: File bugs
270297
href: https://github.com/Azure/AKS-Edge/issues
271298
- name: AKS Edge Essentials pricing
@@ -324,6 +351,8 @@
324351
href: vnet.yml
325352
- name: AKS on Windows Server
326353
items:
354+
- name: AKS on Windows Server retirement
355+
href: aks-windows-server-retirement.md
327356
- name: Overview
328357
href: overview.md
329358
- name: System requirements
@@ -340,23 +369,6 @@
340369
href: setup.md
341370
- name: Create a Kubernetes cluster
342371
href: create-kubernetes-cluster.md
343-
- name: Tutorial
344-
items:
345-
- name: 1 - Prepare an application
346-
href: tutorial-kubernetes-prepare-application.md
347-
- name: 2 - Create container registry
348-
href: tutorial-kubernetes-prepare-azure-container-registry.md
349-
- name: 3 - Deploy a workload cluster
350-
href: tutorial-kubernetes-deploy-cluster.md
351-
- name: 4 - Run an application
352-
href: tutorial-kubernetes-deploy-application.md
353-
- name: 5 - Scale an application
354-
href: tutorial-kubernetes-scale.md
355-
- name: 6 - Update an application
356-
href: tutorial-kubernetes-app-update.md
357-
- name: 7 - Upgrade Kubernetes cluster
358-
# Remove this, we don tneed to upgrade K8s in this tutorial.
359-
href: tutorial-kubernetes-upgrade-cluster.md
360372
- name: Concepts
361373
items:
362374
- name: Quotas and resource limits
@@ -397,8 +409,6 @@
397409
href: concepts-node-networking.md
398410
- name: Kubernetes container networking
399411
href: concepts-container-networking.md
400-
- name: Storage
401-
href: concepts-storage.md
402412
- name: Application availability
403413
href: app-availability.md
404414
- name: Scale
@@ -538,7 +548,7 @@
538548
- name: Use OpenFaaS
539549
href: openfaas.md
540550
- name: Use Bridge to Kubernetes with Visual Studio Code
541-
href: https://code.visualstudio.com/docs/containers/bridge-to-kubernetes
551+
href: /visualstudio/bridge/bridge-to-kubernetes-vs-code
542552
- name: Use Bridge to Kubernetes with Visual Studio
543553
href: /visualstudio/containers/bridge-to-kubernetes
544554
- name: Deploy a Java application with Open Liberty or WebSphere Liberty
@@ -557,7 +567,7 @@
557567
href: aks-hybrid-preview-uninstall.md
558568
- name: Troubleshooting overview
559569
href: troubleshoot-overview.md
560-
- name: Azure Arc enabled Kubernetes
570+
- name: Azure Arc-enabled Kubernetes
561571
href: known-issues-arc.yml
562572
- name: Pre-installation validation tests
563573
href: validation-tests.md
@@ -583,12 +593,6 @@
583593
href: known-issues-uninstall.yml
584594
- name: Other
585595
href: known-issues.yml
586-
- name: Azure Local issues
587-
items:
588-
- name: Cluster validation reporting in Azure Local
589-
href: /azure-stack/hci/manage/validate-qos
590-
- name: CredSSP in Azure Local
591-
href: /azure-stack/hci/manage/troubleshoot-credssp
592596
- name: Support policies
593597
href: support-policies.md
594598
- name: Get support

AKS-Arc/ad-sso.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,31 @@
11
---
2-
title: Use Active Directory single sign-on for secure connection to Kubernetes API server in AKS enabled by Azure Arc
2+
title: Use Active Directory single sign-on for secure connection to Kubernetes API server in AKS on Windows Server
33
description: Use Active Directory Authentication to securely connect to the API server with SSO credentials
44
author: sethmanheim
55
ms.topic: how-to
6-
ms.date: 08/07/2024
6+
ms.date: 04/02/2025
77
ms.author: sethm
88
ms.lastreviewed: 1/14/2022
9-
ms.reviewer: sulahiri
9+
ms.reviewer: leslielin
1010

1111
# Intent: As an IT Pro, I want to ue Active Directory Authentication to securely connect to the Kubernetes API server with SSO credentials.
1212
# Keyword: secure connection to Kubernetes API server
1313

1414
---
1515

16-
# Use Active Directory single sign-on for secure connection to Kubernetes API server in AKS enabled by Azure Arc
16+
# Use Active Directory single sign-on for secure connection to Kubernetes API server in AKS on Windows Server
1717

1818
[!INCLUDE [applies-to-azure stack-hci-and-windows-server-skus](includes/aks-hci-applies-to-skus/aks-hybrid-applies-to-azure-stack-hci-windows-server-sku.md)]
1919

20-
You can create a secure connection to your Kubernetes API server in AKS enabled by Arc using Active Directory (AD) single sign-on (SSO) credentials.
20+
You can create a secure connection to your Kubernetes API server in AKS on Windows Server using Active Directory (AD) single sign-on (SSO) credentials.
2121

22-
## Overview of AD in AKS enabled by Arc
22+
## Overview of AD in AKS on Windows Server
2323

24-
Without Active Directory authentication, you must rely on a certificate-based _kubeconfig_ file when you connect to the API server via the `kubectl` command. The **kubeconfig** file contains secrets such as private keys and certificates that need to be carefully distributed, which can be a significant security risk.
24+
Without Active Directory authentication, you must rely on a certificate-based *kubeconfig* file when you connect to the API server via the `kubectl` command. The **kubeconfig** file contains secrets such as private keys and certificates that need to be carefully distributed, which can be a significant security risk.
2525

26-
As an alternative to using certificate-based kubeconfig, you can use AD SSO credentials as a secure way to connect to the API server. AD integration with AKS Arc lets users on a Windows domain-joined machine connect to the API server via `kubectl` using their SSO credentials. This removes the need to manage and distribute certificate-based kubeconfig files that contain private keys.
26+
As an alternative to using certificate-based **kubeconfig**, you can use AD SSO credentials as a secure way to connect to the API server. AD integration with AKS Arc lets users on a Windows domain-joined machine connect to the API server via `kubectl` using their SSO credentials. This removes the need to manage and distribute certificate-based **kubeconfig** files that contain private keys.
2727

28-
AD integration uses AD kubeconfig, which is distinct from the certificate-based kubeconfig files and doesn't contain any secrets. However, the certificate-based kubeconfig file can be used for backup purposes, such as troubleshooting, if there are issues with connecting using Active Directory credentials.
28+
AD integration uses AD **kubeconfig**, which is distinct from the certificate-based **kubeconfig** files and doesn't contain any secrets. However, the certificate-based **kubeconfig** file can be used for backup purposes, such as troubleshooting, if there are issues with connecting using Active Directory credentials.
2929

3030
Another security benefit with AD integration is that the users and groups are stored as [security identifiers (SIDs)](/troubleshoot/windows-server/identity/security-identifiers-in-windows). Unlike group names, SIDs are immutable and unique and therefore present no naming conflicts.
3131

@@ -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 Local or Windows Server cluster, open PowerShell as an administrator and run the following command:
80+
For a domain-joined 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-Arc/adapt-apps-mixed-os-clusters.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Adapt applications for use in mixed-OS Kubernetes clusters
3-
description: Learn how to use node selectors or taints and tolerations on Azure Kubernetes Service to ensure applications in mixed OS Kubernetes clusters running on AKS Arc are scheduled on the correct worker node operating system.
3+
description: Learn how to use node selectors or taints and tolerations on Azure Kubernetes Service to ensure applications in mixed OS Kubernetes clusters running on AKS on Windows Server are scheduled on the correct worker node operating system.
44
author: sethmanheim
55
ms.topic: how-to
66
ms.date: 06/27/2024
@@ -16,9 +16,9 @@ ms.reviewer: abha
1616

1717
[!INCLUDE [applies-to-azure stack-hci-and-windows-server-skus](includes/aks-hci-applies-to-skus/aks-hybrid-applies-to-azure-stack-hci-windows-server-sku.md)]
1818

19-
AKS enabled by Arc enables you to run Kubernetes clusters with both Linux and Windows nodes, but you must make small edits to your apps for use in these mixed-OS clusters. This how-to guide describes how to ensure your application gets scheduled on the right host OS using either node selectors or taints and tolerations.
19+
AKS on Windows Server enables you to run Kubernetes clusters with both Linux and Windows nodes, but you must make small edits to your apps for use in these mixed-OS clusters. This how-to guide describes how to ensure your application gets scheduled on the right host OS using either node selectors or taints and tolerations.
2020

21-
This article assumes a basic understanding of Kubernetes concepts. For more information, see [Kubernetes core concepts for AKS enabled by Arc](kubernetes-concepts.md).
21+
This article assumes a basic understanding of Kubernetes concepts. For more information, see [Kubernetes core concepts for AKS on Windows Server](kubernetes-concepts.md).
2222

2323
## Node selectors
2424

0 commit comments

Comments
 (0)