Skip to content

Commit d3903cb

Browse files
authored
Merge pull request #18661 from sethmanheim/frsh8-12
Freshness top 50
2 parents 3f63f00 + 6724241 commit d3903cb

14 files changed

+237
-407
lines changed

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

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,10 @@
22
title: IP address planning for AKS enabled by Azure Arc
33
description: Learn about how to plan for IP addresses and reservation, to deploy AKS Arc in production.
44
ms.topic: article
5-
ms.date: 11/19/2024
5+
ms.date: 08/13/2025
66
author: sethmanheim
77
ms.author: sethm
8-
ms.reviewer: abha
8+
ms.reviewer: srikantsarwa
99
ms.lastreviewed: 10/08/2024
1010
---
1111

@@ -17,7 +17,7 @@ IP address planning for AKS enabled by Azure Arc involves designing a network th
1717

1818
## Simple IP address planning for Kubernetes clusters and applications
1919

20-
In the following scenario walk-through, you reserve IP addresses from a single network for your Kubernetes clusters and services. This example is the most straightforward and simple scenario for IP address assignment.
20+
In the following scenario walkthrough, you reserve IP addresses from a single network for your Kubernetes clusters and services. This example is the most straightforward and simple scenario for IP address assignment.
2121

2222
| IP address requirement | Minimum number of IP addresses | How and where to make this reservation |
2323
|------------------|---------|---------------|
@@ -52,7 +52,7 @@ Continuing with this example, and adding it to the following table, you get:
5252

5353
#### Example CLI commands for IP address reservation for Kubernetes clusters and applications
5454

55-
This section describes the set of commands Jane runs for her scenario. First, create a logical network with an IP pool that has at least 16 IP addresses. We created the IP pool with 20 IP addresses to provide the option to scale on day N. For detailed information about parameter options in logical networks, see [`az stack-hci-vm network lnet create`](/cli/azure/stack-hci-vm/network/lnet#az-stack-hci-vm-network-lnet-create):
55+
This section describes the set of commands Jane runs for her scenario. First, create a logical network with an IP pool that has at least 16 IP addresses. We created the IP pool with 20 IP addresses to provide the option to scale on day N. For detailed information about parameter options in logical networks, see [az stack-hci-vm network lnet create](/cli/azure/stack-hci-vm/network/lnet#az-stack-hci-vm-network-lnet-create):
5656

5757
```azurecli
5858
$ipPoolStart = "10.220.32.18"
@@ -72,7 +72,7 @@ Now you can enable MetalLB load balancer with an IP pool of 3 IP addresses, in t
7272
az k8s-runtime load-balancer create --load-balancer-name $lbName --resource-uri subscriptions/$subscription/resourceGroups/$resource_group/providers/Microsoft.Kubernetes/connectedClusters/metallb-demo --addresses 10.220.32.47-10.220.32.49 --advertise-mode ARP
7373
```
7474

75-
### LNETs considerations for AKS clusters and Arc VMs
75+
### LNET considerations for AKS clusters and Arc VMs
7676

7777
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:
7878

@@ -81,7 +81,7 @@ Logical networks on Azure Local are used by both AKS clusters and Arc VMs. You c
8181

8282
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.
8383

84-
| **Criteria** | **Sharing a logical network** | **Defining separate logical networks** |
84+
| Criteria | Sharing a logical network | Defining separate logical networks |
8585
|-------------------------------------------|----------------------------------------------------------------|----------------------------------------------------------------|
8686
| **Configuration complexity** | Simpler configuration with a single network, reducing setup complexity. | More complex setup, as you need to configure multiple logical networks for VMs and AKS clusters.
8787
| **Scalability** | Potential scalability limitations as both Arc VMs and AKS clusters share network resources. | More scalable since network resources are separated and can scale independently. |
@@ -95,9 +95,9 @@ This section describes the IP address ranges used by Kubernetes for pod and serv
9595

9696
### Pod network CIDR
9797

98-
Pod network CIDR is a range of IP addresses used by Kubernetes to assign unique IP addresses to the individual pods running within a Kubernetes cluster. Each pod gets its own IP address within this range, allowing pods to communicate with each other and with services within the cluster. In AKS, pod IP addresses are assigned via *Calico CNI in VXLAN mode*. Calico VXLAN helps create *Overlay networks*, where the IP addresses of pods (from the pod network CIDR) are virtualized and tunneled through the physical network. In this mode, each pod is assigned an IP address from the pod network CIDR, but this IP address is not directly routable on the physical network. Instead, it is encapsulated within the network packets and sent through the underlying physical network to reach its destination pod on another node.
98+
Pod network CIDR is a range of IP addresses used by Kubernetes to assign unique IP addresses to the individual pods running within a Kubernetes cluster. Each pod gets its own IP address within this range, allowing pods to communicate with each other and with services within the cluster. In AKS, pod IP addresses are assigned via *Calico CNI in VXLAN* mode. Calico VXLAN helps create *Overlay networks*, where the IP addresses of pods (from the pod network CIDR) are virtualized and tunneled through the physical network. In this mode, each pod is assigned an IP address from the pod network CIDR, but this IP address is not directly routable on the physical network. Instead, it is encapsulated within the network packets and sent through the underlying physical network to reach its destination pod on another node.
9999

100-
AKS provides a **default value of 10.244.0.0/16** for the pod network CIDR. AKS does support customizations for the pod network CIDR. You can set your own value using the [`--pod-cidr`](/cli/azure/aksarc#az-aksarc-create) parameter when creating the AKS cluster. Ensure that the CIDR IP range is large enough to accommodate the maximum number of pods per node and across the Kubernetes cluster.
100+
AKS provides a default value of 10.244.0.0/16 for the pod network CIDR. AKS does support customizations for the pod network CIDR. You can set your own value using the [--pod-cidr](/cli/azure/aksarc#az-aksarc-create) parameter when creating the AKS cluster. Ensure that the CIDR IP range is large enough to accommodate the maximum number of pods per node and across the Kubernetes cluster.
101101

102102
### Service network CIDR
103103

@@ -107,7 +107,7 @@ The Service network CIDR is the range of IP addresses reserved for Kubernetes se
107107
- NodePort: Exposes the service on a specific port on each node's IP address. The ClusterIP is still used internally, but external access is through the node IPs and a specific port.
108108
- LoadBalancer: This type creates a cloud-provider-managed load balancer and exposes the service externally. The cloud provider typically manages the external IP assignment, while the internal ClusterIP remains within the service network CIDR.
109109

110-
AKS provides a **default value of 10.96.0.0/12** for the service network CIDR. AKS does not support customizations for the service network CIDR today.
110+
AKS provides a default value of 10.96.0.0/12 for the service network CIDR. AKS does not support customizations for the service network CIDR today.
111111

112112
## Next steps
113113

azure-stack/includes/get-pki-certs-csrs-new-cn-only.md

Lines changed: 27 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -3,46 +3,46 @@ author: sethmanheim
33
ms.author: sethm
44
ms.service: azure-stack
55
ms.topic: include
6-
ms.date: 10/26/2022
6+
ms.date: 08/12/2025
77
ms.reviewer: sethm
8-
ms.lastreviewed: 10/26/2022
8+
ms.lastreviewed: 08/12/2025
99
---
1010

1111
1. Generate CSRs by completing one of the following:
1212

13-
- For a **production deployment environment**, the first script will generate CSRs for deployment certificates:
13+
- For a production deployment environment, the first script generates CSRs for deployment certificates:
1414

15-
```powershell
16-
New-AzsCertificateSigningRequest -CertificateType Deployment -RegionName $regionName -FQDN $externalFQDN -OutputRequestPath $OutputDirectory -IdentitySystem $IdentitySystem
17-
```
15+
```powershell
16+
New-AzsCertificateSigningRequest -CertificateType Deployment -RegionName $regionName -FQDN $externalFQDN -OutputRequestPath $OutputDirectory -IdentitySystem $IdentitySystem
17+
```
1818
19-
- The second script, if desired, uses the `-IncludeContainerRegistry` and will generate a CSR for Azure Container Registry at the same time as CSRs for deployment certificates:
19+
- The second script, if desired, uses the `-IncludeContainerRegistry` and generates a CSR for Azure Container Registry at the same time as CSRs for deployment certificates:
2020
21-
```powershell
22-
New-AzsCertificateSigningRequest -CertificateType Deployment -RegionName $regionName -FQDN $externalFQDN -OutputRequestPath $OutputDirectory -IncludeContainerRegistry
23-
```
21+
```powershell
22+
New-AzsCertificateSigningRequest -CertificateType Deployment -RegionName $regionName -FQDN $externalFQDN -OutputRequestPath $OutputDirectory -IncludeContainerRegistry
23+
```
2424
25-
- The third script will generate CSRs for any optional PaaS services you've installed:
25+
- The third script generates CSRs for any optional PaaS services you installed:
2626
27-
```powershell
28-
# App Services
29-
New-AzsCertificateSigningRequest -CertificateType AppServices -RegionName $regionName -FQDN $externalFQDN -OutputRequestPath $OutputDirectory
27+
```powershell
28+
# App Services
29+
New-AzsCertificateSigningRequest -CertificateType AppServices -RegionName $regionName -FQDN $externalFQDN -OutputRequestPath $OutputDirectory
3030
31-
# DBAdapter (SQL/MySQL)
32-
New-AzsCertificateSigningRequest -CertificateType DbAdapter -RegionName $regionName -FQDN $externalFQDN -OutputRequestPath $OutputDirectory
31+
# DBAdapter (SQL/MySQL)
32+
New-AzsCertificateSigningRequest -CertificateType DbAdapter -RegionName $regionName -FQDN $externalFQDN -OutputRequestPath $OutputDirectory
3333
34-
# EventHubs
35-
New-AzsCertificateSigningRequest -CertificateType EventHubs -RegionName $regionName -FQDN $externalFQDN -OutputRequestPath $OutputDirectory
34+
# EventHubs
35+
New-AzsCertificateSigningRequest -CertificateType EventHubs -RegionName $regionName -FQDN $externalFQDN -OutputRequestPath $OutputDirectory
3636
37-
# Azure Container Registry
38-
New-AzsHubAzureContainerRegistryCertificateSigningRequest -CertificateType AzureContainerRegistry -RegionName $regionName -FQDN $externalFQDN -OutputRequestPath $OutputDirectory
39-
```
37+
# Azure Container Registry
38+
New-AzsHubAzureContainerRegistryCertificateSigningRequest -CertificateType AzureContainerRegistry -RegionName $regionName -FQDN $externalFQDN -OutputRequestPath $OutputDirectory
39+
```
4040
41-
- For a **development and test environment**, to generate a single CSR with multiple-subject alternative names, add the `-RequestType SingleCSR` parameter and value.
41+
- For a development and test environment, to generate a single CSR with multiple-subject alternative names, add the `-RequestType SingleCSR` parameter and value:
4242
43-
> [!IMPORTANT]
44-
> We do *not* recommend using this approach for production environments.
43+
> [!IMPORTANT]
44+
> This approach is not recommended for production environments.
4545
46-
```powershell
47-
New-AzsCertificateSigningRequest -CertificateType Deployment -RegionName $regionName -FQDN $externalFQDN -RequestType SingleCSR -OutputRequestPath $OutputDirectory -IdentitySystem $IdentitySystem
48-
```
46+
```powershell
47+
New-AzsCertificateSigningRequest -CertificateType Deployment -RegionName $regionName -FQDN $externalFQDN -RequestType SingleCSR -OutputRequestPath $OutputDirectory -IdentitySystem $IdentitySystem
48+
```

azure-stack/includes/get-pki-certs-csrs-new.md

Lines changed: 31 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -3,52 +3,52 @@ author: sethmanheim
33
ms.author: sethm
44
ms.service: azure-stack
55
ms.topic: include
6-
ms.date: 10/26/2022
6+
ms.date: 08/12/2025
77
ms.reviewer: sethm
8-
ms.lastreviewed: 10/26/2022
8+
ms.lastreviewed: 08/12/2025
99
---
1010

1111
2. Generate CSRs by completing one of the following:
1212

13-
- For a **production deployment environment**, the first script will generate CSRs for deployment certificates:
13+
- For a production deployment environment, the first script generates CSRs for deployment certificates:
1414

15-
```powershell
16-
New-AzsHubDeploymentCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory -IdentitySystem $IdentitySystem
17-
```
15+
```powershell
16+
New-AzsHubDeploymentCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory -IdentitySystem $IdentitySystem
17+
```
1818
19-
- The second script, if desired, uses the `-IncludeContainerRegistry` and will generate a CSR for Azure Container Registry at the same time as CSRs for deployment certificates:
19+
- The second script, if desired, uses the `-IncludeContainerRegistry` and generates a CSR for Azure Container Registry at the same time as CSRs for deployment certificates:
2020
21-
```powershell
22-
New-AzsHubDeploymentCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory -IdentitySystem $IdentitySystem -IncludeContainerRegistry
23-
```
21+
```powershell
22+
New-AzsHubDeploymentCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory -IdentitySystem $IdentitySystem -IncludeContainerRegistry
23+
```
2424
25-
- The third script will generate CSRs for any optional PaaS services you've installed:
25+
- The third script generates CSRs for any optional PaaS services you installed:
2626
27-
```powershell
28-
# App Services
29-
New-AzsHubAppServicesCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory
27+
```powershell
28+
# App Services
29+
New-AzsHubAppServicesCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory
3030
31-
# DBAdapter (SQL/MySQL)
32-
New-AzsHubDbAdapterCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory
31+
# DBAdapter (SQL/MySQL)
32+
New-AzsHubDbAdapterCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory
3333
34-
# EventHubs
35-
New-AzsHubEventHubsCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory
34+
# EventHubs
35+
New-AzsHubEventHubsCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory
3636
37-
# Azure Container Registry
38-
New-AzsHubAzureContainerRegistryCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory
39-
```
37+
# Azure Container Registry
38+
New-AzsHubAzureContainerRegistryCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory
39+
```
4040
41-
- For a **low-privilege environment**, to generate a clear-text certificate template file with the necessary attributes declared, add the `-LowPrivilege` parameter:
41+
- For a low-privilege environment, to generate a clear-text certificate template file with the necessary attributes declared, add the `-LowPrivilege` parameter:
4242
43-
```powershell
44-
New-AzsHubDeploymentCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory -IdentitySystem $IdentitySystem -LowPrivilege
45-
```
43+
```powershell
44+
New-AzsHubDeploymentCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -subject $subject -OutputRequestPath $OutputDirectory -IdentitySystem $IdentitySystem -LowPrivilege
45+
```
4646
47-
- For a **development and test environment**, to generate a single CSR with multiple-subject alternative names, add the `-RequestType SingleCSR` parameter and value.
47+
- For a development and test environment, to generate a single CSR with multiple-subject alternative names, add the `-RequestType SingleCSR` parameter and value:
4848
49-
> [!IMPORTANT]
50-
> We do *not* recommend using this approach for production environments.
49+
> [!IMPORTANT]
50+
> This approach is not recommended for production environments.
5151
52-
```powershell
53-
New-AzsHubDeploymentCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -RequestType SingleCSR -subject $subject -OutputRequestPath $OutputDirectory -IdentitySystem $IdentitySystem
54-
```
52+
```powershell
53+
New-AzsHubDeploymentCertificateSigningRequest -RegionName $regionName -FQDN $externalFQDN -RequestType SingleCSR -subject $subject -OutputRequestPath $OutputDirectory -IdentitySystem $IdentitySystem
54+
```

azure-stack/operator/azure-stack-app-service-overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Azure App Service on Azure Stack overview
33
description: Overview of Azure App Service and Azure Functions on Azure Stack Hub.
44
author: sethmanheim
55
ms.topic: concept-article
6-
ms.date: 01/24/2025
6+
ms.date: 08/13/2025
77
ms.author: sethm
88
ms.reviewer: anwestg
99
ms.lastreviewed: 01/13/2019
@@ -24,7 +24,7 @@ Azure App Service enables you to automate business processes and host cloud APIs
2424

2525
Here are some key features and capabilities of Azure App Service:
2626

27-
- **Multiple languages and frameworks**: Azure App Service has first-class support for ASP.NET, Node.js, Java, PHP, and Python. You can also run Windows PowerShell and other scripts or executables on App Service VMs.
27+
- **Multiple languages and frameworks**: Azure App Service has first-class support for ASP.NET, Node.js, Java, PHP, and Python. You can also run Windows PowerShell and other scripts or executables on App Service virtual machines (VMs).
2828
- **DevOps optimization**: Set up continuous integration and deployment with GitHub, local Git, or BitBucket. Promote updates through test and staging environments, and manage your apps in App Service by using Azure PowerShell or the cross-platform command-line interface (Azure CLI).
2929
- **Visual Studio integration**: Dedicated tools in Visual Studio streamline the work of creating and deploying apps.
3030

0 commit comments

Comments
 (0)