AKS Learn feedback: "Statically provision a volume" annotated with pv.kubernetes.io/provisioned-by

[mloskot]

Type of issue

Other (describe below)

Feedback

In the Statically provision a volume section there is this example, copied below, which displays use of pv.kubernetes.io/provisioned-by annotation:

apiVersion: v1
kind: PersistentVolume
metadata:
  annotations:
    pv.kubernetes.io/provisioned-by: file.csi.azure.com
  name: azurefile
spec:
  ...

while the Kubernetes documentation on Well-Known Labels, Annotations and Taints indicates this annotation should correspond to dynamic provisioning, screenshot with the section pasted below:

---

The lack of explanation on why the example uses the annotation makes the example confusing to reader.

Page URL

https://learn.microsoft.com/en-us/azure/aks/azure-csi-files-storage-provision#statically-provision-a-volume

Content source URL

https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/aks/azure-csi-files-storage-provision.md

Author

@tamram

Document Id

b95ca0b2-e809-a149-dec7-a15ac2146ee1

---

Document Details

⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

• ID: bdb3a253-ff94-1b97-62c9-e21153598452
• Version Independent ID: b95ca0b2-e809-a149-dec7-a15ac2146ee1
• Content: Create a persistent volume with Azure Files in Azure Kubernetes Service (AKS) - Azure Kubernetes Service
• Content Source: articles/aks/azure-csi-files-storage-provision.md
• Service: azure-kubernetes-service
• Sub-service: aks-storage
• GitHub Login: @tamram
• Microsoft Alias: tamram

[TPavanBalaji]

@mloskot
Thanks for your feedback! We will investigate and update as appropriate.

[SaibabaBalapur-MSFT]

@mloskot
I'm going to assign this to the document author so they can take a look at it accordingly.

@tamram
Please review it.