donatowolfisberg/gcp-dns-alias

GCP DNS Alias镜像

镜像概述

本Docker镜像旨在在Google Cloud Platform（GCP）环境中复制Heroku的DNS别名功能，通过定时任务自动监控并更新CNAME记录对应的IP地址，确保DNS别名与实际服务IP保持同步。

核心功能

1. 模拟Heroku DNS别名的动态解析能力
2. 每30分钟执行一次IP变更检查（Cron任务：*/30 * * * *）
3. 支持在GCP Cloud Run环境中运行

使用场景

• 需要在GCP中管理动态IP服务的DNS别名记录
• 希望自动同步DNS别名与后端服务IP的场景
• 替代手动更新DNS记录的重复操作

配置说明

1. GCP凭据配置：提供具有DNS管理权限的GCP服务账号凭据文件，挂载到镜像内指定路径
2. 环境变量设置：
   • GCP_PROJECT_ID：GCP项目ID
   • DNS_ZONE：目标DNS区域名称
   • ALIAS_DOMAIN：需维护的别名域名
   • TARGET_CNAME：目标CNAME对应的域名

部署示例

Docker Run命令

bash
docker run -d \
  -v /path/to/gcp-credentials.json:/app/credentials.json \
  -e GCP_PROJECT_ID="your-project-id" \
  -e DNS_ZONE="your-dns-zone" \
  -e ALIAS_DOMAIN="alias.example.com" \
  -e TARGET_CNAME="target.example.com" \
  docker.xuanyuan.run/donatowolfisberg/gcp-dns-alias

Docker Compose示例

yaml
version: '3'
services:
  gcp-dns-alias:
    image: donatowolfisberg/gcp-dns-alias
    volumes:
      - ./gcp-credentials.json:/app/credentials.json
    environment:
      - GCP_PROJECT_ID=your-project-id
      - DNS_ZONE=your-dns-zone
      - ALIAS_DOMAIN=alias.example.com
      - TARGET_CNAME=target.example.com
    restart: always