astronomerinc/ap-registry Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Astronomer Platform Docker Registry 镜像文档

镜像概述

本镜像为Astronomer平台提供专用Docker注册表服务，用于存储、管理和分发Astronomer平台相关的Docker镜像。作为平台基础设施的核心组件，它支持镜像版本控制、安全分发及跨环境一致性部署，确保Astronomer平台组件在各环境中的可靠交付。

核心功能与特性

基础功能

• 镜像存储与管理：支持Docker镜像的上传（push）、下载（pull）及版本标记（tag）
• 版本控制：维护镜像的多版本历史，支持基于标签的版本追溯
• 兼容标准：遵循Docker Registry API v2规范，与Docker CLI及工具链无缝集成

平台集成特性

• Astronomer兼容性：针对Astronomer平台组件（如Airflow、Houston等）进行优化，确保镜像兼容性
• 安全支持：可集成平台认证机制，支持镜像访问控制与权限管理
• 高可用性：支持配置外部存储（如S3、GCS），满足生产环境的高可用需求

使用场景与适用范围

适用场景

• Astronomer平台私有化部署：在企业内部网络环境中搭建私有镜像仓库，管理平台定制化组件
• 开发与测试环境：存储开发过程中的中间镜像，支持团队协作与版本迭代
• 生产环境镜像管理：作为生产环境中Astronomer平台组件的官方分发源，确保部署一致性

适用范围

• Astronomer Platform v0.16+版本部署环境
• 需要私有镜像管理能力的Astronomer用户（企业级部署、定制化平台场景）
• 支持Linux x86_64架构，兼容Docker Engine 19.03+环境

使用方法与配置说明

基本部署（Docker Run）

命令示例

bash
docker run -d \
  --name astronomer-registry \
  -p 5000:5000 \
  -v /path/to/registry/data:/var/lib/registry \
  astronomerinc/registry:latest

参数说明

• -p 5000:5000：映射容器5000端口（Docker Registry默认端口）到主机
• -v /path/to/registry/data:/var/lib/registry：挂载主机目录作为镜像存储卷，持久化存储镜像数据

Docker Compose配置示例

yaml
version: '3'
services:
  astronomer-registry:
    image: astronomerinc/registry:latest
    container_name: astronomer-registry
    ports:
      - "5000:5000"
    volumes:
      - registry-data:/var/lib/registry
    environment:
      - REGISTRY_STORAGE_FILESYSTEM_ROOTDIRECTORY=/var/lib/registry
      - REGISTRY_LOG_LEVEL=info
    restart: unless-stopped

volumes:
  registry-data:

关键配置参数

环境变量配置

存储配置

支持多种存储后端（通过REGISTRY_STORAGE环境变量配置），如：

• 文件系统（默认）：REGISTRY_STORAGE=filesystem
• S3兼容存储：REGISTRY_STORAGE=s3（需额外配置REGISTRY_STORAGE_S3_*参数）
• GCS存储：REGISTRY_STORAGE=gcs（需额外配置REGISTRY_STORAGE_GCS_*参数）

镜像推送与拉取示例

登录私有注册表

bash
docker login localhost:5000

标记并推送镜像

bash
# 标记Astronomer平台镜像
docker tag astronomerinc/airflow:latest localhost:5000/astronomer-airflow:latest

# 推送至私有注册表
docker push localhost:5000/astronomer-airflow:latest

从私有注册表拉取镜像

bash
docker pull localhost:5000/astronomer-airflow:latest

注意事项

1. 安全性：生产环境中建议启用TLS加密（配置REGISTRY_HTTP_TLS_*参数）及访问认证（如htpasswd）
2. 存储扩展：大规模部署时推荐使用分布式存储后端（如S3），避免单点存储瓶颈
3. 版本兼容性：确保镜像版本与Astronomer平台版本匹配，详情参考Astronomer官方文档
4. 备份策略：定期备份镜像存储卷数据，防止数据丢失

参考链接

• Docker Registry官方文档
• Astronomer Platform部署指南