vistalba/kubernetes-cloudflare-sync Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Kubernetes Cloudflare Sync

镜像概述和主要用途

Kubernetes Cloudflare Sync 是一个专为在 GKE（Google Kubernetes Engine）上的 Kubernetes 集群设计的工具，主要功能是将 Cloudflare 的 DNS 记录与集群中的节点 IP 地址进行同步，确保 DNS 记录始终反映当前的节点 IP 情况，避免因节点 IP 变化导致的 DNS 解析问题。

核心功能和特性

• DNS 与节点 IP 同步：自动将 Cloudflare 的 DNS 记录与 Kubernetes 集群节点的 IP 地址保持同步
• Kubernetes 集成：通过 RBAC 权限配置与 Kubernetes 集群深度集成，能够获取节点列表及 IP 信息
• Cloudflare API 交互：通过 Cloudflare API 实现 DNS 记录的动态更新，需 API 密钥和***进行身份验证
• 可配置性：支持通过部署参数自定义同步的 DNS 名称，适应不同域名需求

使用场景和适用范围

适用场景

• 运行在 GKE 上的 Kubernetes 集群
• 使用 Cloudflare 作为 DNS 服务提供商
• 集群节点 IP 可能发生变化（如节点扩容、缩容、替换等场景）
• 需要自动维护 DNS 记录以匹配节点 IP 变化

适用范围

适用于需要动态管理 DNS 记录，减少手动操作，确保外部服务通过 DNS 访问集群时始终指向正确节点 IP 的场景。

详细使用方法和配置说明

构建镜像

GKE 为每个集群提供私有容器镜像仓库，以下命令用于构建应用镜像并推送到集群特定仓库：

bash
docker build -t gcr.io/PROJECT_ID/kubernetes-cloudflare-sync:latest .
docker push gcr.io/PROJECT_ID/kubernetes-cloudflare-sync:latest

注意：请将 PROJECT_ID 替换为你的 GCP 项目 ID。

配置说明

1. 部署配置（Deployment）

创建 Deployment YAML 文件定义应用部署参数：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: kubernetes-cloudflare-sync
  labels:
    app: kubernetes-cloudflare-sync
spec:
  replicas: 1
  selector:
    matchLabels:
      app: kubernetes-cloudflare-sync
  template:
    metadata:
      labels:
        app: kubernetes-cloudflare-sync
    spec:
      serviceAccountName: kubernetes-cloudflare-sync
      containers:
      - name: kubernetes-cloudflare-sync
        image: gcr.io/PROJECT_ID/kubernetes-cloudflare-sync
        args:
        - --dns-name=kubernetes.example.com  # 替换为需要同步的 DNS 名称
        env:
        - name: CF_API_KEY
          valueFrom:
            secretKeyRef:
              name: cloudflare
              key: api-key
        - name: CF_API_EMAIL
          valueFrom:
            secretKeyRef:
              name: cloudflare
              key: email

重要：请将 PROJECT_ID 替换为你的 GCP 项目 ID，并将 --dns-name 的值替换为实际需要同步的 DNS 名称。

2. 权限配置

应用需要两种权限：

• 与 Cloudflare 通信并更新 DNS 的权限
• 获取 Kubernetes 集群节点列表和 IP 的权限

创建 Cloudflare Secret

存储 Cloudflare API 密钥和***到 Kubernetes Secret：

bash
kubectl create secret generic cloudflare --from-literal=email=YOUR_CLOUDFLARE_ACCOUNT_EMAIL_ADDRESS_HERE --from-literal=api-key=YOUR_CLOUDFLARE_GLOBAL_API_KEY_HERE

请将 YOUR_CLOUDFLARE_ACCOUNT_EMAIL_ADDRESS_HERE 替换为你的 Cloudflare 账户***，YOUR_CLOUDFLARE_GLOBAL_API_KEY_HERE 替换为你的 Cloudflare 全局 API 密钥。

RBAC 配置

创建 Service Account、ClusterRole 及 ClusterRoleBinding：

yaml
apiVersion: v1
kind: ServiceAccount
metadata:
  name: kubernetes-cloudflare-sync
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: kubernetes-cloudflare-sync
rules:
- apiGroups: [""]
  resources: ["nodes"]
  verbs: ["list", "watch"]  # 允许获取节点信息
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: kubernetes-cloudflare-sync-viewer
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: kubernetes-cloudflare-sync
subjects:
- kind: ServiceAccount
  name: kubernetes-cloudflare-sync
  namespace: default

应用配置

将所有配置文件应用到集群：

bash
kubectl apply -f .  # 假设配置文件都在当前目录下

配置参数说明

环境变量

命令行参数