Skip to content

Commit ba20ccf

Browse files
authored
Merge pull request #190145 from justindavies/motd
Add MOTD
2 parents 074be5d + 9478f01 commit ba20ccf

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

articles/aks/custom-node-configuration.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,8 @@ The settings below can be used to tune the operation of the virtual memory (VM)
129129
| `transparentHugePageEnabled` | `always`, `madvise`, `never` | `always` | [Transparent Hugepages](https://www.kernel.org/doc/html/latest/admin-guide/mm/transhuge.html#admin-guide-transhuge) is a Linux kernel feature intended to improve performance by making more efficient use of your processor’s memory-mapping hardware. When enabled the kernel attempts to allocate `hugepages` whenever possible and any Linux process will receive 2-MB pages if the `mmap` region is 2 MB naturally aligned. In certain cases when `hugepages` are enabled system wide, applications may end up allocating more memory resources. An application may `mmap` a large region but only touch 1 byte of it, in that case a 2-MB page might be allocated instead of a 4k page for no good reason. This scenario is why it's possible to disable `hugepages` system-wide or to only have them inside `MADV_HUGEPAGE madvise` regions. |
130130
| `transparentHugePageDefrag` | `always`, `defer`, `defer+madvise`, `madvise`, `never` | `madvise` | This value controls whether the kernel should make aggressive use of memory compaction to make more `hugepages` available. |
131131

132+
133+
132134
> [!IMPORTANT]
133135
> For ease of search and readability the OS settings are displayed in this document by their name but should be added to the configuration json file or AKS API using [camelCase capitalization convention](/dotnet/standard/design-guidelines/capitalization-conventions).
134136
@@ -182,6 +184,28 @@ Add a new node pool specifying the Kubelet parameters using the JSON file you cr
182184
az aks nodepool add --name mynodepool1 --cluster-name myAKSCluster --resource-group myResourceGroup --kubelet-config ./kubeletconfig.json
183185
```
184186

187+
188+
## Other configuration
189+
190+
The settings below can be used to modify other Operating System settings.
191+
192+
### Message of the Day
193+
194+
Pass the ```--message-of-the-day``` flag with the location of the file to replace the Message of the Day on Linux nodes at cluster creation or node pool creation.
195+
196+
197+
#### Cluster creation
198+
```azurecli
199+
az aks create --cluster-name myAKSCluster --resource-group myResourceGroup --message-of-the-day ./newMOTD.txt
200+
```
201+
202+
#### Nodepool creation
203+
```azurecli
204+
az aks nodepool add --name mynodepool1 --cluster-name myAKSCluster --resource-group myResourceGroup --message-of-the-day ./newMOTD.txt
205+
```
206+
207+
208+
185209
## Next steps
186210

187211
- Learn [how to configure your AKS cluster](cluster-configuration.md).

0 commit comments

Comments
 (0)