alwaysai/jenkins-cloud

Jenkins Docker镜像文档

镜像概述

本Docker镜像基于Jenkins构建，专为云基础设施流水线设计，提供稳定、高效的持续集成/持续部署（CI/CD）环境，用于自动化云资源的构建、测试、部署及管理流程。

核心功能与特性

• 云基础设施集成：原生支持主流云平台（AWS、Azure、GCP等）的资源管理与部署流程
• 流水线自动化：内置Pipeline插件，支持复杂云基础设施部署流程的可视化编排
• IaC工具兼容：无缝集成Terraform、CloudFormation、Ansible等基础设施即代码工具
• 多环境支持：可配置开发、测试、生产等多环境流水线，实现环境隔离与一致性
• 扩展性：支持通过Jenkins插件市场扩展功能，满足个性化云基础设施管理需求

使用场景

• DevOps团队自动化云基础设施的构建、测试与部署流程
• 云服务提供商的资源交付与运维自动化
• 企业级云环境的标准化部署与版本控制
• 基础设施即代码（IaC）项目的持续集成与验证

使用方法

快速启动

bash
docker run -d -p 8080:8080 -p 50000:50000 --name jenkins-cloud \
  -v jenkins_home:/var/jenkins_home \
  docker.xuanyuan.run/jenkins/jenkins:lts

Docker Compose配置

yaml
version: '3'
services:
  jenkins:
    image: docker.xuanyuan.run/jenkins/jenkins:lts
    container_name: jenkins-cloud
    ports:
      - "8080:8080"  # Web UI端口
      - "50000:50000"  # 代理节点通信端口
    volumes:
      - jenkins_home:/var/jenkins_home  # 持久化Jenkins数据
      - /var/run/docker.sock:/var/run/docker.sock  # 允许Jenkins操作宿主机Docker
    environment:
      - JAVA_OPTS=-Djenkins.install.runSetupWizard=false  # 跳过初始设置向导
    restart: always

volumes:
  jenkins_home:

环境变量配置

卷挂载说明

• /var/jenkins_home: Jenkins数据持久化目录，包含配置、插件、工作空间等
• /var/run/docker.sock: 挂载宿主机Docker socket，允许Jenkins在容器内运行Docker命令
• /usr/local/bin/docker: 可选，挂载宿主机Docker客户端，确保版本兼容性

云基础设施流水线配置示例

1. 安装必要插件：CloudBees AWS Credentials、Terraform、Pipeline等
2. 配置云平台凭证（如AWS Access Key、Azure Service Principal等）
3. 创建Pipeline任务，示例Jenkinsfile：

groovy
pipeline {
    agent any
    stages {
        stage('Checkout Code') {
            steps {
                git url: 'https://github.com/your-org/cloud-infrastructure.git', branch: 'main'
            }
        }
        stage('Terraform Validate') {
            steps {
                sh 'terraform init'
                sh 'terraform validate'
            }
        }
        stage('Terraform Plan') {
            steps {
                sh 'terraform plan -out=tfplan'
            }
        }
        stage('Terraform Apply') {
            when {
                branch 'main'
            }
            steps {
                sh 'terraform apply tfplan'
            }
        }
    }
    post {
        success {
            slackSend channel: '#devops', message: '云基础设施部署成功'
        }
        failure {
            slackSend channel: '#devops', message: '云基础设施部署失败'
        }
    }
}

注意事项

• 首次启动时，管理员初始密码可通过docker logs jenkins-cloud命令获取
• 生产环境建议配置HTTPS，可通过反向代理（如Nginx）实现
• 定期备份jenkins_home卷数据，防止配置丢失
• 根据流水线复杂度调整容器资源限制（CPU/内存）