nikunjv/jenkins

Jenkins (Alpine) 镜像文档

镜像概述

本镜像基于Alpine Linux构建，集成了Jenkins核心服务，并预装kubectl（Kubernetes命令行工具）和aws-cli（AWS命令行工具）。旨在提供轻量级、功能集成的CI/CD环境，方便用户在容器化部署中直接与Kubernetes集群及AWS云服务进行交互。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 工具集成：内置kubectl，支持Kubernetes集群资源管理、部署操作
• 云服务支持：预装aws-cli，可直接调用AWS API进行资源操作
• Jenkins标准功能：包含Jenkins完整服务，支持插件安装、任务配置、自动化构建等标准CI/CD能力

使用场景与适用范围

• Kubernetes环境下的CI/CD流水线构建与部署
• 需要与AWS云服务（如S3、EC2、ECR等）集成的自动化流程
• 轻量级Jenkins实例部署，适用于资源受限的环境
• 容器化CI/CD环境的快速搭建与迁移

使用方法与配置说明

基本部署

使用以下命令启动Jenkins容器：

bash
docker run -d \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  --name jenkins-alpine \
  [镜像名称]

参数说明：

• -p 8080:8080：映射Jenkins Web界面端口
• -p 50000:50000：映射Jenkins代理通信端口
• -v jenkins_home:/var/jenkins_home：持久化Jenkins数据

环境变量配置

可通过环境变量自定义Jenkins配置，常用变量包括：

• JENKINS_OPTS：Jenkins启动参数，如--httpPort=8080
• JAVA_OPTS：Java运行参数，如-Xmx512m（设置JVM内存）

示例：

bash
docker run -d \
  -e JENKINS_OPTS="--httpPort=8081" \
  -e JAVA_OPTS="-Xmx1g" \
  -p 8081:8081 \
  -v jenkins_home:/var/jenkins_home \
  --name jenkins-alpine \
  [镜像名称]

内置工具使用

kubectl使用

容器启动后，可通过以下命令进入容器并使用kubectl：

bash
docker exec -it jenkins-alpine /bin/sh
kubectl version  # 验证kubectl版本
kubectl get pods  # 示例：查看Kubernetes集群pods

aws-cli使用

需先配置AWS凭证（推荐通过环境变量或挂载配置文件）：

bash
# 方式1：通过环境变量配置
docker run -d \
  -e AWS_ACCESS_KEY_ID="your_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_secret_key" \
  -e AWS_DEFAULT_REGION="us-west-2" \
  [其他参数] \
  [镜像名称]

# 方式2：进入容器手动配置
docker exec -it jenkins-alpine /bin/sh
aws configure  # 按提示输入Access Key、Secret Key、Region等信息

配置完成后即可使用aws-cli命令，如：

bash
aws s3 ls  # 列出S3存储桶
aws ecr describe-repositories  # 查看ECR仓库

注意事项

• 首次启动需通过日志获取初始管理员密码：docker logs jenkins-alpine
• 持久化卷jenkins_home需确保权限正确，避免容器内权限问题
• 生产环境建议配置HTTPS，可通过反向代理（如Nginx）实现
• 根据实际需求调整JVM内存参数，避免资源不足或浪费