#  simaple-jenkins

**Repository Path**: k8s-devops/simaple-jenkins-simaple-jenkins

## Basic Information

- **Project Name**:  simaple-jenkins
- **Description**: simaple-jenkins
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-08-04
- **Last Updated**: 2023-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 在本地快速部署 Jenkins



## 组成部分

- master 接收 webhook ，调度任务等

- agent 执行构建任务

- dind 构建镜像



> 注意：
> 
> 需要将simaple-jenkins安装包放置到/data目录，
> 然后软连接到`/root/workdir/docker-compose`部署目录，因为dind的数据比较大，占用磁盘空间较多。



## jenkins-master

```sh
docker pull jenkinsci/blueocean:1.25.7
docker tag jenkinsci/blueocean:1.25.7 hub.gitee.com/kube-ops/blueocean:1.25.7
docker push hub.gitee.com/kube-ops/blueocean:1.25.7
```

```sh
# 修改持久化目录属主为 1000:1000
cd jenkins/master
chown -R 1000:1000 jenkins_home
chown -R 1000:1000 init.groovy.d

# 创建 docker network
docker network create -d bridge jenkins-cluster
docker-compose up -d
```

完成初始化并安装插件


[详细的界面操作方式参考](https://gitee.com/autom-studio/simple-jenkins)



## jenkins-agnet and dind配置


准备 .kube 和 .docker .ssh文件夹放置到bin下

用于授权访问 kubernetes api-server 和 harbor 镜像仓库


创建 .docker/config.json

```sh
harbor_addr=hub.gitee.com
harbor_username=admin
harbor_password=Harborxxxx
auth_str=$(echo -ne "$harbor_username:$harbor_password" | base64)
cat > .docker/config.json <<EOF
{
        "auths": {
                "$harbor_addr": {
                        "auth": "$auth_str"
                }
        }
}
EOF
```



## 部署docker-agent

构建jenkins-agent镜像

```sh
docker build -t hub.gitee.com/kube-ops/inbound-agent:alpine-jdk11 .
docker push hub.gitee.com/kube-ops/inbound-agent:alpine-jdk11
```



```sh
cd agent

# 修改docker-compose.yaml中的agent-secrets为自己的值。
docker-compose up -d
```




## 部署docker-dind


```sh
cd dind
docker-compose up -d
```




## 配置 Agent 节点可以通过设置环境变量来传递当前Job的Workspace 路径。


这样在 Jenkins Job 中就能方便地使用该路径，并且无需手动配置。

具体操作步骤如下：

在 Jenkins 管理界面中，点击 "节点管理" 进入 "节点管理" 页面。

找到需要配置的 Agent 节点，点击节点名称进入节点配置页面。

在节点配置页面中，找到 "环境变量" 部分，点击 "增加环境变量" 按钮。

在弹出的对话框中，填写环境变量的名称为 WORKSPACE，值为`${JENKINS_HOME}/workspace/${JOB_NAME}`，

-  `${JENKINS_HOME}`是 Jenkins 的根目录路径

-  `${JOB_NAME}` 是当前Job的名称。


点击 "增加" 按钮保存环境变量配置。

重启 Agent 节点使环境变量生效。

在 Jenkins Job 中，可以通过`${WORKSPACE}`的方式访问该环境变量，例如：


```
pipeline {
    agent {
        node {
            label 'my-agent'
        }
    }
    stages {
        stage('Test') {
            steps {
                sh 'echo ${WORKSPACE}'
            }
        }
    }
}
```
在这个例子中，我们在节点配置的 "环境变量" 中设置了一个名为 WORKSPACE 的环境变量，值为 `${JENKINS_HOME}/workspace/${JOB_NAME}`，然后在 Pipeline Job 中使用`${WORKSPACE}`的方式访问该环境变量。

通过上述方法，我们就可以为 Jenkins Agent 节点自动注册当前 Job 的 Workspace 路径环境变量，方便地在 Jenkins Job 中使用。









## 参考文档


[simple-jenkins](https://gitee.com/autom-studio/simple-jenkins)