Skip to content

Commit 6e4bcd0

Browse files
ManikaDhimanManikaDhiman
committed
Merge branch 'main' into md-health-service-faults
2 parents 3e0e977 + 4dc2694 commit 6e4bcd0

19 files changed

+499
-176
lines changed

‎AKS-Arc/aks-hci-network-system-requirements.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
title: AKS enabled by Azure Arc network requirements
33
description: Learn about AKS network prerequisites.
44
ms.topic: overview
5-
ms.date: 04/23/2025
5+
ms.date: 07/02/2025
66
author: sethmanheim
77
ms.author: sethm
8-
ms.reviewer: abha
9-
ms.lastreviewed: 04/02/2024
8+
ms.reviewer: srikantsarwa
9+
ms.lastreviewed: 07/10/2025
1010
---
1111

1212
# AKS enabled by Azure Arc network requirements
@@ -42,7 +42,7 @@ The following parameters are required in order to use a logical network for AKS
4242

4343
### Control plane IP
4444

45-
Kubernetes uses a control plane to ensure every component in the Kubernetes cluster is kept in the desired state. The control plane also manages and maintains the worker nodes that hold the containerized applications. AKS enabled by Arc deploys the KubeVIP load balancer to ensure that the API server IP address of the Kubernetes control plane is available at all times. This KubeVIP instance requires a single immutable "control plane IP address" to function correctly. AKS Arc automatically chooses a control plane IP for you from the logical network passed during the Kubernetes cluster create operation.
45+
Kubernetes uses a control plane to ensure every component in the Kubernetes cluster is kept in the desired state. The control plane also manages and maintains the worker nodes that hold the containerized applications. AKS enabled by Arc deploys the KubeVIP load balancer to ensure that the API server IP address of the Kubernetes control plane is always available. This KubeVIP instance requires a single immutable "control plane IP address" to function correctly. AKS Arc automatically chooses a control plane IP for you from the logical network passed during the Kubernetes cluster create operation.
4646

4747
You also have the option of passing a control plane IP. In such cases, the control plane IP must be within the scope of the address prefix of the logical network. You must ensure that the control plane IP address does not overlap with anything else, including Arc VM logical networks, infrastructure network IPs, load balancers, etc. Overlapping IP addresses can lead to unexpected failures for both the AKS cluster and any other place the IP address is being used. You must plan to reserve one IP address per Kubernetes cluster in your environment.
4848

@@ -73,7 +73,7 @@ Firewall requirements for AKS have been consolidated with Azure Local firewall r
7373

7474
## DNS server settings
7575

76-
You need to ensure that the DNS server of the logical network can resolve the FQDN of the Azure Local cluster. DNS name resolution is required for all Azure Local nodes to be able to communicate with the AKS VM nodes.
76+
You need to ensure that the DNS server of the logical network can resolve the FQDN of the Azure Local cluster. DNS name resolution is required for all Azure Local nodes to be able to communicate with the AKS VM nodes.
7777

7878
## Network port and cross-VLAN requirements
7979

‎AKS-Arc/aksarc.yml

Lines changed: 168 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,30 @@ directCommands:
116116
- name: --vnet-ids
117117
summary: |-
118118
Azure Resource Manager resource ID(s) of the VNets.
119+
globalParameters:
120+
- name: --debug
121+
summary: |-
122+
Increase logging verbosity to show all debug logs.
123+
- name: --help -h
124+
summary: |-
125+
Show this help message and exit.
126+
- name: --only-show-errors
127+
summary: |-
128+
Only show errors, suppressing warnings.
129+
- name: --output -o
130+
defaultValue: "json"
131+
acceptedValues: "json, jsonc, none, table, tsv, yaml, yamlc"
132+
summary: |-
133+
Output format.
134+
- name: --query
135+
summary: |-
136+
JMESPath query string. See <a href="http://jmespath.org/">http://jmespath.org/</a> for more information and examples.
137+
- name: --subscription
138+
summary: |-
139+
Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
140+
- name: --verbose
141+
summary: |-
142+
Increase logging verbosity. Use --debug for full debug logs.
119143
- uid: az_aksarc_delete
120144
name: az aksarc delete
121145
summary: |-
@@ -151,6 +175,30 @@ directCommands:
151175
defaultValue: "False"
152176
summary: |-
153177
Do not prompt for confirmation.
178+
globalParameters:
179+
- name: --debug
180+
summary: |-
181+
Increase logging verbosity to show all debug logs.
182+
- name: --help -h
183+
summary: |-
184+
Show this help message and exit.
185+
- name: --only-show-errors
186+
summary: |-
187+
Only show errors, suppressing warnings.
188+
- name: --output -o
189+
defaultValue: "json"
190+
acceptedValues: "json, jsonc, none, table, tsv, yaml, yamlc"
191+
summary: |-
192+
Output format.
193+
- name: --query
194+
summary: |-
195+
JMESPath query string. See <a href="http://jmespath.org/">http://jmespath.org/</a> for more information and examples.
196+
- name: --subscription
197+
summary: |-
198+
Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
199+
- name: --verbose
200+
summary: |-
201+
Increase logging verbosity. Use --debug for full debug logs.
154202
- uid: az_aksarc_get-credentials
155203
name: az aksarc get-credentials
156204
summary: |-
@@ -198,6 +246,30 @@ directCommands:
198246
defaultValue: "False"
199247
summary: |-
200248
Overwrites any existing cluster entry with the same name.
249+
globalParameters:
250+
- name: --debug
251+
summary: |-
252+
Increase logging verbosity to show all debug logs.
253+
- name: --help -h
254+
summary: |-
255+
Show this help message and exit.
256+
- name: --only-show-errors
257+
summary: |-
258+
Only show errors, suppressing warnings.
259+
- name: --output -o
260+
defaultValue: "json"
261+
acceptedValues: "json, jsonc, none, table, tsv, yaml, yamlc"
262+
summary: |-
263+
Output format.
264+
- name: --query
265+
summary: |-
266+
JMESPath query string. See <a href="http://jmespath.org/">http://jmespath.org/</a> for more information and examples.
267+
- name: --subscription
268+
summary: |-
269+
Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
270+
- name: --verbose
271+
summary: |-
272+
Increase logging verbosity. Use --debug for full debug logs.
201273
- uid: az_aksarc_list
202274
name: az aksarc list
203275
summary: |-
@@ -218,6 +290,30 @@ directCommands:
218290
- name: --resource-group -g
219291
summary: |-
220292
Name of the resource group. You can configure the default group using `az configure --defaults group=<name>`.
293+
globalParameters:
294+
- name: --debug
295+
summary: |-
296+
Increase logging verbosity to show all debug logs.
297+
- name: --help -h
298+
summary: |-
299+
Show this help message and exit.
300+
- name: --only-show-errors
301+
summary: |-
302+
Only show errors, suppressing warnings.
303+
- name: --output -o
304+
defaultValue: "json"
305+
acceptedValues: "json, jsonc, none, table, tsv, yaml, yamlc"
306+
summary: |-
307+
Output format.
308+
- name: --query
309+
summary: |-
310+
JMESPath query string. See <a href="http://jmespath.org/">http://jmespath.org/</a> for more information and examples.
311+
- name: --subscription
312+
summary: |-
313+
Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
314+
- name: --verbose
315+
summary: |-
316+
Increase logging verbosity. Use --debug for full debug logs.
221317
- uid: az_aksarc_notice
222318
name: az aksarc notice
223319
summary: |-
@@ -236,6 +332,30 @@ directCommands:
236332
name: --output-filepath
237333
summary: |-
238334
Outputs filepath for NOTICE file.
335+
globalParameters:
336+
- name: --debug
337+
summary: |-
338+
Increase logging verbosity to show all debug logs.
339+
- name: --help -h
340+
summary: |-
341+
Show this help message and exit.
342+
- name: --only-show-errors
343+
summary: |-
344+
Only show errors, suppressing warnings.
345+
- name: --output -o
346+
defaultValue: "json"
347+
acceptedValues: "json, jsonc, none, table, tsv, yaml, yamlc"
348+
summary: |-
349+
Output format.
350+
- name: --query
351+
summary: |-
352+
JMESPath query string. See <a href="http://jmespath.org/">http://jmespath.org/</a> for more information and examples.
353+
- name: --subscription
354+
summary: |-
355+
Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
356+
- name: --verbose
357+
summary: |-
358+
Increase logging verbosity. Use --debug for full debug logs.
239359
- uid: az_aksarc_show
240360
name: az aksarc show
241361
summary: |-
@@ -260,6 +380,30 @@ directCommands:
260380
name: --resource-group -g
261381
summary: |-
262382
Name of the resource group. You can configure the default group using `az configure --defaults group=<name>`.
383+
globalParameters:
384+
- name: --debug
385+
summary: |-
386+
Increase logging verbosity to show all debug logs.
387+
- name: --help -h
388+
summary: |-
389+
Show this help message and exit.
390+
- name: --only-show-errors
391+
summary: |-
392+
Only show errors, suppressing warnings.
393+
- name: --output -o
394+
defaultValue: "json"
395+
acceptedValues: "json, jsonc, none, table, tsv, yaml, yamlc"
396+
summary: |-
397+
Output format.
398+
- name: --query
399+
summary: |-
400+
JMESPath query string. See <a href="http://jmespath.org/">http://jmespath.org/</a> for more information and examples.
401+
- name: --subscription
402+
summary: |-
403+
Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
404+
- name: --verbose
405+
summary: |-
406+
Increase logging verbosity. Use --debug for full debug logs.
263407
- uid: az_aksarc_update
264408
name: az aksarc update
265409
summary: |-
@@ -316,6 +460,30 @@ directCommands:
316460
- name: --tags
317461
summary: |-
318462
Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.commands:
463+
globalParameters:
464+
- name: --debug
465+
summary: |-
466+
Increase logging verbosity to show all debug logs.
467+
- name: --help -h
468+
summary: |-
469+
Show this help message and exit.
470+
- name: --only-show-errors
471+
summary: |-
472+
Only show errors, suppressing warnings.
473+
- name: --output -o
474+
defaultValue: "json"
475+
acceptedValues: "json, jsonc, none, table, tsv, yaml, yamlc"
476+
summary: |-
477+
Output format.
478+
- name: --query
479+
summary: |-
480+
JMESPath query string. See <a href="http://jmespath.org/">http://jmespath.org/</a> for more information and examples.
481+
- name: --subscription
482+
summary: |-
483+
Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
484+
- name: --verbose
485+
summary: |-
486+
Increase logging verbosity. Use --debug for full debug logs.
319487
commands:
320488
- az_aksarc_create
321489
- az_aksarc_delete
@@ -339,29 +507,5 @@ commands:
339507
- az_aksarc_vnet_delete
340508
- az_aksarc_vnet_list
341509
- az_aksarc_vnet_show
342-
globalParameters:
343-
- name: --debug
344-
summary: |-
345-
Increase logging verbosity to show all debug logs.
346-
- name: --help -h
347-
summary: |-
348-
Show this help message and exit.
349-
- name: --only-show-errors
350-
summary: |-
351-
Only show errors, suppressing warnings.
352-
- name: --output -o
353-
defaultValue: "json"
354-
parameterValueGroup: "json, jsonc, none, table, tsv, yaml, yamlc"
355-
summary: |-
356-
Output format.
357-
- name: --query
358-
summary: |-
359-
JMESPath query string. See <a href="http://jmespath.org/">http://jmespath.org/</a> for more information and examples.
360-
- name: --subscription
361-
summary: |-
362-
Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
363-
- name: --verbose
364-
summary: |-
365-
Increase logging verbosity. Use --debug for full debug logs.
366510
metadata:
367511
description: Manage provisioned clusters.

‎AKS-Arc/logs.yml

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -45,31 +45,31 @@ directCommands:
4545
- name: --out-dir
4646
summary: |-
4747
Output directory to store collected logs. If not specified, logs are stored in the current directory.
48+
globalParameters:
49+
- name: --debug
50+
summary: |-
51+
Increase logging verbosity to show all debug logs.
52+
- name: --help -h
53+
summary: |-
54+
Show this help message and exit.
55+
- name: --only-show-errors
56+
summary: |-
57+
Only show errors, suppressing warnings.
58+
- name: --output -o
59+
defaultValue: "json"
60+
acceptedValues: "json, jsonc, none, table, tsv, yaml, yamlc"
61+
summary: |-
62+
Output format.
63+
- name: --query
64+
summary: |-
65+
JMESPath query string. See [http://jmespath.org/](http://jmespath.org) for more information and examples.
66+
- name: --subscription
67+
summary: |-
68+
Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
69+
- name: --verbose
70+
summary: |-
71+
Increase logging verbosity. Use --debug for full debug logs.
4872
commands:
4973
- az_aksarc_logs_hci
50-
globalParameters:
51-
- name: --debug
52-
summary: |-
53-
Increase logging verbosity to show all debug logs.
54-
- name: --help -h
55-
summary: |-
56-
Show this help message and exit.
57-
- name: --only-show-errors
58-
summary: |-
59-
Only show errors, suppressing warnings.
60-
- name: --output -o
61-
defaultValue: "json"
62-
parameterValueGroup: "json, jsonc, none, table, tsv, yaml, yamlc"
63-
summary: |-
64-
Output format.
65-
- name: --query
66-
summary: |-
67-
JMESPath query string. See [http://jmespath.org/](http://jmespath.org) for more information and examples.
68-
- name: --subscription
69-
summary: |-
70-
Name or ID of subscription. You can configure the default subscription using `az account set -s NAME_OR_ID`.
71-
- name: --verbose
72-
summary: |-
73-
Increase logging verbosity. Use --debug for full debug logs.
7474
metadata:
7575
description: Collect logs from provisioned clusters.

0 commit comments

Comments
 (0)