thecodingmachine/deeployer

镜像概述

该镜像旨在简化使用docker-compose或Kubernetes创建环境的过程，提供便捷工具帮助用户快速搭建、配置和管理开发、测试及生产环境，减少手动配置工作，提升环境部署效率。

核心功能与特性

• 多环境支持：同时兼容docker-compose和Kubernetes两种主流容器编排工具
• 配置简化：提供预定义配置模板，减少手动编写配置文件的工作量
• 自动化部署：集成环境创建流程自动化，降低操作复杂度
• 环境一致性：确保不同环境（开发、测试、生产）配置统一，减少环境差异导致的问题
• 跨平台兼容：支持主流操作系统和容器平台，具备良好的可移植性

使用场景与适用范围

• 开发环境搭建：开发人员快速创建本地开发环境，减少环境配置时间
• 测试环境标准化：测试团队部署一致的测试环境，确保测试结果可靠
• 生产环境部署：简化生产环境配置流程，降低部署风险
• 团队协作：统一团队环境配置标准，减少因环境差异导致的协作问题
• CI/CD集成：作为CI/CD流程的一部分，自动创建和销毁临时环境

使用方法与配置说明

基本使用（Docker Run）

通过挂载工作目录运行镜像，执行环境创建命令：

bash
docker run -v $(pwd):/workspace -it [镜像名称] create --compose  # 使用docker-compose创建环境
# 或
docker run -v $(pwd):/workspace -it [镜像名称] create --k8s       # 使用Kubernetes创建环境

Docker Compose 集成

在docker-compose.yml中集成该镜像：

yaml
version: '3.8'
services:
  env-builder:
    image: docker.xuanyuan.run/[镜像名称]
    volumes:
      - ./config:/workspace/config       # 挂载配置文件目录
      - /var/run/docker.sock:/var/run/docker.sock  # 如需操作本地Docker daemon
    environment:
      - TARGET_ENV=dev                   # 目标环境类型
      - LOG_LEVEL=info                   # 日志级别
    command: create --compose --config /workspace/config/compose-template.yaml

Kubernetes 集成

ConfigMap配置

yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: env-config
data:
  k8s-template.yaml: |
    # Kubernetes资源配置模板
    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: sample-app
    spec:
      replicas: 3
      template:
        spec:
          containers:
          - name: app
            image: docker.xuanyuan.run/sample-image:latest

Deployment配置

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: env-creator
spec:
  replicas: 1
  selector:
    matchLabels:
      app: env-creator
  template:
    metadata:
      labels:
        app: env-creator
    spec:
      serviceAccountName: env-creator-sa  # 需配置对应RBAC权限
      containers:
      - name: env-creator
        image: docker.xuanyuan.run/[镜像名称]
        volumeMounts:
        - name: config-volume
          mountPath: /workspace/config
        env:
        - name: TARGET_ENV
          value: "prod"
        - name: KUBECONFIG
          value: "/var/run/secrets/kubernetes.io/serviceaccount/kubeconfig"
        command: ["create", "--k8s", "--config", "/workspace/config/k8s-template.yaml"]
      volumes:
      - name: config-volume
        configMap:
          name: env-config

环境变量配置

常用命令

• create --compose [--config <path>]: 使用docker-compose创建环境，可选指定配置文件路径
• create --k8s [--config <path>]: 使用Kubernetes创建环境，可选指定配置文件路径
• validate [--compose|--k8s] [--config <path>]: 验证配置文件有效性
• cleanup [--compose|--k8s]: 清理已创建的环境资源
• help: 查看命令帮助信息
• version: 查看镜像版本信息