无法将注解传递给Helm：AKS中LoadBalancer无法绑定已有静态公网IP

你的核心问题是Helm Chart没有正确渲染Service的注解，同时可能存在注解使用错误或前置条件不满足的情况，按以下步骤排查修正：

1. 检查Helm Service模板是否引用了annotations字段 #

打开Chart的templates/service.yaml文件，确认metadata部分是否包含对.Values.service.annotations的渲染逻辑。正确的模板应该类似：

apiVersion: v1
kind: Service
metadata:
  name: {{ include "helloworld.fullname" . }}
  labels:
    {{- include "helloworld.labels" . | nindent 4 }}
  annotations:
    {{- if .Values.service.annotations }}
    {{- toYaml .Values.service.annotations | nindent 4 }}
    {{- end }}
spec:
  type: {{ .Values.service.type }}
  ports:
    - port: {{ .Values.service.port }}
      targetPort: {{ .Values.service.targetport }}
      protocol: TCP
      name: http
  selector:
    {{- include "helloworld.selectorLabels" . | nindent 4 }}

如果模板里没有这段注解渲染代码，哪怕values.yaml配置正确，部署后注解也不会生效，这是最常见的疏漏。

2. 修正命令行--set的参数路径 #

你之前的命令用了controller.service.annotations，但你的values.yaml里是直接service.annotations，路径不匹配导致注解没被设置。正确的命令应该是：

helm install helloworld . --set service.annotations.service.beta.kubernetes.io/azure-load-balancer-resource-group=myrg --set service.annotations.service.beta.kubernetes.io/azure-pip-name=mypip

3. 使用正确的Azure注解格式 #

AKS绑定已有静态IP的标准注解配置：

• 若静态IP不在AKS集群的资源组中，需同时指定资源组和IP信息：

  service:
    type: LoadBalancer
    port: 8080
    targetport: 8080
    annotations: 
      service.beta.kubernetes.io/azure-load-balancer-resource-group: "myrg"
      service.beta.kubernetes.io/azure-load-balancer-ipv4: "20.xx.xx.xx" # 替换为你的静态IP实际地址
  

• 也可以用IP资源名称的旧注解（仍兼容）：

  service:
    type: LoadBalancer
    port: 8080
    targetport: 8080
    annotations: 
      service.beta.kubernetes.io/azure-load-balancer-resource-group: "myrg"
      service.beta.kubernetes.io/azure-pip-name: "mypip"
  

4. 确认静态IP的前置条件 #

必须满足以下要求，否则IP无法绑定：

• 静态IP的SKU为Standard（AKS默认LoadBalancer是Standard SKU，Basic SKU的IP无法兼容）
• 静态IP的区域与AKS集群所在区域完全一致（或为区域冗余IP）
• 静态IP当前未被其他Azure资源占用
• AKS集群的托管身份（或服务主体）拥有目标资源组myrg的Network Contributor权限，否则无法访问该IP资源。

验证方法 #

部署后用以下命令检查Service注解是否生效：

kubectl describe svc helloworld

如果Annotations部分能看到你配置的两个注解，说明配置已生效；如果看不到，回到步骤1检查模板是否正确。

内容的提问来源于stack exchange，提问作者JimMc