hamletio/jenkins

Jenkins Master for Hamlet Deploy

镜像概述和主要用途

该容器提供标准Jenkins安装，推荐用于Hamlet Deploy部署。同时支持使用Hamlet Deploy进行部署，以及通过此Jenkins服务器部署其他产品。

核心功能和特性

• 支持Jenkins基础配置（URL、时区、内存限制等）
• 集成https://github.com/jenkinsci/amazon-ecs-plugin%EF%BC%8C%E6%94%AF%E6%8C%81%E5%9F%BA%E4%BA%8EECS%E9%9B%86%E7%BE%A4%E7%9A%84%E6%8C%89%E9%9C%80%E5%AE%B9%E5%99%A8%E4%BB%A3%E7%90%86
• 支持多种安全认证方式（本地用户、GitHub Auth、SAML）
• 提供Jenkins全局凭证管理，支持多种凭证类型（用户名密码、密钥文本、GitHub App等）
• 集成GitHub Webhook和Slack通知配置

使用场景和适用范围

• 需要通过Jenkins自动化部署Hamlet Deploy应用的场景
• 需要利用ECS集群动态管理构建代理的CI/CD环境
• 需配置多种安全认证方式的Jenkins实例
• 需要集中管理构建凭证的团队或项目

使用方法和配置说明

环境变量配置

Jenkins基础配置

代理配置

该Jenkins实例设计用于基于容器的按需代理，并包含基于amazon-ecs插件的云环境配置初始化脚本。

支持带有独立任务定义的多代理标签：

• ECS_AGENT_PREFIX - 设置用于在环境变量中搜索代理的前缀

代理可使用以下语法定义：

• <ECS_AGENT_PREFIX>_<Agent_Label>_DEFINITION - ECS任务定义ID或ARN

安全领域

安全领域定义Jenkins实例使用的身份验证服务提供商，通过JENKINSENV_SECURITYREALM指定。

本地安全领域

GitHub Auth安全领域

SAML安全领域

GitHub Webhook Secret

Slack默认配置

Jenkins凭证

允许在启动时添加全局Jenkins命名空间的凭证，支持多种类型，每种类型有各自的属性。

通用属性

类型：userpw

基于https://github.com/jenkinsci/credentials-plugin%E5%88%9B%E5%BB%BA%E7%94%A8%E6%88%B7%E5%90%8D%E5%AF%86%E7%A0%81%E5%87%AD%E8%AF%81

类型：secret

基于https://github.com/jenkinsci/plain-credentials-plugin%E5%88%9B%E5%BB%BA%E5%AF%86%E9%92%A5%E6%96%87%E6%9C%AC%E5%87%AD%E8%AF%81

类型：githubapp

基于https://github.com/jenkinsci/github-branch-source-plugin%E5%88%9B%E5%BB%BAGitHub App凭证

部署示例

Docker Run命令

bash
docker run -d \
  -p 8080:8080 \
  -p 50000:50000 \
  -e JENKINS_URL="http://jenkins.example.com:8080" \
  -e TIMEZONE="Asia/Shanghai" \
  -e MAXMEMORY="2g" \
  -e ECS_ARN="arn:aws:ecs:us-east-1:123456789012:cluster/hamlet-ecs-cluster" \
  -e JENKINSENV_SECURITYREALM="local" \
  -e JENKINSENV_USER="admin" \
  -e JENKINSENV_PASS="securepassword" \
  --name jenkins-hamlet \
  docker.xuanyuan.run/jenkins-master-hamlet:latest

Docker Compose配置

yaml
version: '3'
services:
  jenkins:
    image: jenkins-master-hamlet:latest
    ports:
      - "8080:8080"
      - "50000:50000"
    environment:
      - JENKINS_URL=[***]
      - TIMEZONE=Asia/Shanghai
      - MAXMEMORY=2g
      - ECS_ARN=arn:aws:ecs:us-east-1:123456789012:cluster/hamlet-ecs-cluster
      - JENKINSENV_SECURITYREALM=local
      - JENKINSENV_USER=admin
      - JENKINSENV_PASS=securepassword
      - JENKINSENV_CREDENTIALS_MYCREDS_NAME=my-credential
      - JENKINSENV_CREDENTIALS_MYCREDS_TYPE=userpw
      - JENKINSENV_CREDENTIALS_MYCREDS_USER=deploy-user
      - JENKINSENV_CREDENTIALS_MYCREDS_PASSWORD=deploy-pass
    volumes:
      - jenkins-data:/var/jenkins_home
volumes:
  jenkins-data: