astronomerinc/ap-houston-api

镜像概述

Astronomer Command Control GraphQL API 是 Astronomer 平台的核心组件，提供统一的 GraphQL 接口用于平台的命令与控制操作。该镜像作为平台管理的核心入口，支持对 Astronomer 平台资源的查询、配置与控制。

核心功能与特性

• GraphQL API 支持：完整实现 GraphQL 规范，提供查询（Queries）和变异（Mutations）操作，满足复杂资源管理需求
• 平台资源管控：支持对工作流、集群、命名空间、用户及权限等核心资源的全生命周期管理
• 组件集成能力：与 Astronomer 平台其他组件（如 Airflow、Hubble）深度集成，确保数据一致性与操作协同
• 安全认证机制：内置 JWT 等认证方式，支持细粒度权限控制，保障 API 访问安全性
• 可观测性支持：提供详细日志输出与健康检查接口，便于监控与问题排查

使用场景与适用范围

• Astronomer 平台部署：作为平台核心组件，用于构建完整的 Astronomer 服务架构
• 自动化运维：通过 API 实现平台资源的自动化创建、更新与删除，提升运维效率
• 第三方集成：为外部系统（如 CI/CD 工具、监控平台）提供标准化接口，扩展平台能力
• 适用角色：平台管理员、DevOps 工程师、需要与 Astronomer 平台集成的开发人员

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name astronomer-command-control-api \
  -p 8080:8080 \
  -e DATABASE_URL=postgresql://user:password@db-host:5432/command_control \
  -e AUTH_JWT_SECRET=your-secure-jwt-secret \
  -e LOG_LEVEL=info \
  astronomer/command-control-api:latest

Docker Compose 配置示例

yaml
version: '3.8'
services:
  command-control-api:
    image: astronomer/command-control-api:latest
    container_name: astronomer-cc-api
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - DATABASE_URL=postgresql://user:password@postgres:5432/command_control
      - AUTH_JWT_SECRET=${JWT_SECRET}
      - LOG_LEVEL=info
      - CORS_ALLOWED_ORIGINS=https://your-ui-domain.com
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:14-alpine
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=command_control
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

关键环境变量配置

健康检查

服务内置健康检查端点，可通过 http://<container-ip>:8080/health 访问，返回 200 OK 表示服务正常运行。

数据持久化

服务依赖外部 PostgreSQL 数据库存储核心数据，需确保数据库服务稳定运行并配置持久化存储（如示例中通过 Docker volume 挂载）。