portworx/px-app-operator-manager Docker 镜像 - 轩辕镜像

目标集群应用操作员镜像文档

镜像概述

本镜像为目标集群提供应用操作员功能，旨在简化和自动化集群环境中应用的全生命周期管理流程。通过集成容器编排平台（如Kubernetes）的管理能力，实现对应用部署、更新、扩展、回滚及维护的标准化和自动化，适用于需要高效管理集群应用的场景。

核心功能和特性

• 全生命周期管理：支持应用从部署、更新、回滚到卸载的完整生命周期操作，减少人工干预。
• 自动化运维：内置应用健康检查、故障自愈机制，可自动检测并修复应用异常状态。
• 弹性扩展：根据预设策略（如CPU使用率、内存占用）自动调整应用副本数，实现弹性伸缩。
• 配置管理：支持通过环境变量、配置文件或API动态注入应用配置，无需重启应用即可更新配置。
• 多集群适配：兼容主流容器编排平台（Kubernetes、OpenShift等），支持多集群环境的应用统一管理。
• 操作审计：记录应用管理操作日志，支持审计追踪和问题排查。

使用场景和适用范围

• 企业级Kubernetes集群管理：适用于中大型企业Kubernetes集群中微服务应用的集中化管理。
• 多环境应用部署：支持开发、测试、生产等多环境的应用标准化部署和版本控制。
• 自动化运维场景：需要减少人工操作、提升运维效率的团队或项目（如DevOps流程中的应用管理环节）。
• 复杂应用管理：包含多个组件、依赖关系复杂的应用（如分布式数据库、微服务架构系统）的协调部署与维护。

使用方法和配置说明

基本使用（Docker Run示例）

通过以下命令启动应用操作员容器，连接目标集群并开始管理应用：

bash
docker run -d \
  --name app-operator \
  -e TARGET_CLUSTER_URL="[***]" \
  -e CLUSTER_NAMESPACE="default" \
  -e AUTH_TOKEN="your-cluster-auth-token" \
  -e LOG_LEVEL="info" \
  -v /path/to/local/config:/app/config \
  your-registry/app-operator:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  app-operator:
    image: your-registry/app-operator:latest
    container_name: app-operator
    restart: always
    environment:
      - TARGET_CLUSTER_URL=[***]
      - CLUSTER_NAMESPACE=default
      - AUTH_TOKEN=your-cluster-auth-token
      - LOG_LEVEL=info
      - AUTO_SCALE_ENABLED=true
      - SCALE_MIN_REPLICAS=2
      - SCALE_MAX_REPLICAS=10
    volumes:
      - ./config:/app/config  # 挂载本地配置目录
    network_mode: host  # 如需直接访问宿主机网络中的集群API，可启用

环境变量配置

配置文件说明

如需更复杂的配置（如自定义扩展策略、多应用管理规则），可通过挂载配置文件实现。配置文件为YAML格式，默认路径为/app/config/config.yaml，示例内容如下：

yaml
# 多应用管理规则示例
applications:
  - name: "backend-service"
    type: "deployment"
    scale:
      minReplicas: 3
      maxReplicas: 15
      metrics:
        - type: "cpu"
          threshold: 70%  # CPU使用率超过70%触发扩容
        - type: "memory"
          threshold: 80%  # 内存使用率超过80%触发扩容
    healthCheck:
      path: "/health"
      port: 8080
      timeout: 5s

注意事项

1. 集群访问权限：确保容器具有访问目标集群API的网络权限，且AUTH_TOKEN拥有足够的操作权限（如cluster-admin或对应命名空间的admin权限）。
2. 持久化配置：建议通过挂载卷（-v）持久化配置文件和日志，避免容器重启后配置丢失。
3. 版本兼容性：使用前需确认镜像版本与目标集群版本兼容（如Kubernetes 1.21+推荐使用v1.5.0及以上镜像版本）。