jujusolutions/jujud-operator

Juju Agent 镜像文档

概述

Juju Agent 是运行Juju控制器并管理charms操作的核心组件。Juju是Canonical开发的服务建模工具，通过charms（封装应用部署与管理逻辑的软件包）实现应用的自动化部署、扩展与运维。本镜像提供了轻量级运行环境，支持在容器中部署Juju控制器，实现对云环境、物理机或混合架构中应用的统一管理。

核心功能与特性

核心功能

• 运行Juju控制器：作为Juju的控制中心，负责管理模型定义、应用部署流程及资源分配
• 管理charms操作：执行charms定义的生命周期操作，包括应用部署、扩展、升级、配置调整及故障恢复
• 模型状态维护：实时同步应用部署状态，确保实际运行状态与模型定义一致

特性

• 多环境支持：兼容公有云（AWS、Azure、GCP）、私有云（OpenStack、VMware）及物理机环境
• 自动化运维：通过charms实现应用运维逻辑的代码化，支持一键式操作与批量管理
• 轻量级容器化：基于精简基础镜像构建，资源占用低，部署便捷

使用场景

• 云环境应用部署：在公有或私有云中快速部署复杂应用拓扑，如微服务集群、数据库集群等
• 微服务架构编排：通过charms定义微服务间依赖关系，实现服务发现、负载均衡与故障转移的自动化
• 多环境一致性运维：在开发、测试、生产环境中保持一致的部署流程与配置，减少环境差异导致的问题
• DevOps流程集成：与CI/CD工具链（Jenkins、GitLab CI）结合，实现应用构建、测试、部署的全流程自动化

使用方法与配置说明

前置要求

• Docker引擎版本≥19.03
• 宿主机需分配至少2GB内存及10GB磁盘空间（用于控制器数据持久化）
• 网络需开放Juju控制器通信端口（默认TCP ***）

基本运行命令

bash
docker run -d \
  --name juju-agent \
  -p 17070:17070 \
  -v /path/to/juju/data:/var/lib/juju \
  -e JUJU_CONTROLLER_NAME=my-controller \
  -e JUJU_LOG_LEVEL=info \
  juju/agent:latest

docker-compose配置示例

yaml
version: '3.8'
services:
  juju-agent:
    image: juju/agent:latest
    container_name: juju-agent
    restart: always
    ports:
      - "17070:17070"  # Juju控制器通信端口
    volumes:
      - ./juju-data:/var/lib/juju  # 持久化存储控制器数据
    environment:
      - JUJU_CONTROLLER_NAME=prod-controller  # 控制器唯一标识
      - JUJU_LOG_LEVEL=info  # 日志级别：debug/info/warn/error
      - JUJU_BOOTSTRAP_CONFIG='{"cloud": "aws", "region": "us-east-1"}'  # 可选，初始化云环境配置

关键配置参数（环境变量）

注意事项

• 数据持久化：必须通过-v挂载宿主机目录至/var/lib/juju，否则容器重启后控制器数据（模型定义、应用状态等）将丢失
• 网络配置：确保宿主机防火墙开放JUJU_PORT（默认***），否则Juju客户端无法连接控制器
• 权限设置：挂载的宿主机目录需授予容器内用户（通常为juju用户，UID 1000）读写权限，可通过chown 1000:1000 /path/to/juju/data配置
• 版本兼容性：Juju控制器与客户端版本需保持一致，建议使用镜像标签指定具体版本（如juju/agent:3.10）而非latest

参考链接

• Juju官方文档
• Charms开发指南
• Juju控制器管理