在GitHub Action中能否将环境变量传入Kubernetes YAML清单？

核心问题 #

Kubectl不会自动解析YAML中的shell环境变量（如$MY_IMAGE_NAME），直接执行kubectl apply会把变量名当作实际值传入，导致镜像名称无效、安全组参数错误。以下是几种可行的解决方案：

方案1：正确使用envsubst替换变量 #

envsubst可以将环境变量注入YAML，但需要明确指定要替换的变量（避免误替换K8s语法中的$符号）。修改GitHub Action的部署步骤：

- name: Deploy to Kubernetes
  run: |
    # 验证变量是否正确加载（可选，用于调试）
    echo "镜像名称: $MY_IMAGE_NAME"
    echo "安全组OCID: $OCI_NETWORK_SG"
    # 替换指定变量后部署
    envsubst '$MY_IMAGE_NAME $OCI_NETWORK_SG' < kubernetes/svc-preview.yml | kubectl apply -f - -n preview

注意事项：

• 确保GitHub环境（Preview）下的所有Secrets已正确配置，且变量在当前步骤的Shell中可访问。
• 如果YAML中包含K8s原生的${VAR}语法（如${POD_NAME}），必须在envsubst参数中排除这些变量，避免被误替换。

方案2：拆分操作，分别处理镜像和安全组 #

如果不想修改YAML文件的注释部分，可以先部署原始YAML，再单独更新镜像和注释：

- name: Deploy to Kubernetes
  run: |
    # 先部署基础资源
    kubectl apply -f kubernetes/svc-preview.yml -n preview
    # 动态更新Deployment的镜像
    kubectl set image deployment/preview preview=$MY_IMAGE_NAME -n preview
    # 更新Service的安全组注释
    kubectl patch service my-preview-svc -n preview \
      --type merge \
      -p '{"metadata":{"annotations":{"oci-network-load-balancer.oraclecloud.com/oci-network-security-groups":"'"$OCI_NETWORK_SG"'"}}}'

这种方式适合仅需修改少量字段的场景，无需修改原始YAML文件。

方案3：使用Helm模板管理动态配置 #

对于频繁变更的参数，使用Helm模板是更规范的方式：

1. 将K8s YAML改造成Helm模板，用模板变量替换硬编码值：

   # deployment.yaml 模板示例
   containers:
   - name: preview
     image: {{ .Values.image }}
     # ...其他配置
   

   # service.yaml 模板示例
   annotations:
     oci-network-load-balancer.oraclecloud.com/oci-network-security-groups: "{{ .Values.networkSG }}"
     # ...其他注释
   

2. 在GitHub Action中用Helm部署，传递动态参数：

   - name: Deploy with Helm
     run: |
       helm upgrade --install preview ./helm-chart \
         --namespace preview \
         --create-namespace \
         --set image=$MY_IMAGE_NAME \
         --set networkSG=$OCI_NETWORK_SG
   

关键排查点 #

• 确认GitHub环境（Preview）下的Secrets已正确配置，而非仓库级Secrets（因为工作流指定了environment: Preview）。
• 在部署步骤前添加echo命令验证变量值，确保Secrets已正确注入环境变量。
• 检查OCI网络安全组的OCID是否正确，且该安全组与OKE集群处于同一VCN，同时LB有权限访问该安全组。

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