DevOps解决方案 ＞ DevOps集成工具介绍 ＞ DevOps镜像介绍 ＞ 工具镜像使用文档

用户使用说明

从零开始安装配置Jenkins、SonarQube、Nexus等相关工具是一件比较复杂的事，有没有什么办法可以跳过繁琐的环境搭建，直接体验强大的Devops流水线呢？现在你只需安装好 Docker-CE ，就可以使用Devops镜像一键搭建好这些集成工具了。

1.创建数据卷

执行下面的命令，新建一个devops数据卷

1. docker volume create devops_data

2.复制Docker Run命令

• 进入项目后，将鼠标滑动到 更多 选项卡，点击 设置

• 在左侧菜单栏选择 流水线配置

• 点击 下载工具镜像一键部署

• 复制系统根据你的项目定制好的Docker Run命令

3.运行容器

在第2步中我们已经获取到了Docker Run命令，接下来在Docker中直接执行该命令即可

1. #Template
2. #docker run \
3. #-e HOST=${HOST} \
4. #-e token=${TOKEN} \
5. #-e JENKINS_PORT=${JENKINS_PORT} \
6. #-e SONAR_PORT=${SONAR_PORT} \
7. #-e NEXUS_PORT=${NEXUS_PORT} \
8. #-p ${JENKINS_PORT}:8080 -p ${NEXUS_PORT}:8081 -p ${SONAR_PORT}:9000 -p ${JENKINS_AGENT_PORT}:50000 \
9. #-dit -v ${DATA_VOLUME}:/data/devops_data \
10. #--name=${CONTAINER_NAME} ccr.ccs.tencentyun.com/tapd-devops/devops
12. #Example
13. docker run \
14. -e HOST=${HOST} \
15. -e token=${TOKEN} \
16. -e JENKINS_PORT=8080 \
17. -e SONAR_PORT=9000 \
18. -e NEXUS_PORT=8081 \
19. -p 8080:8080 -p 8081:8081 -p 9000:9000 -p 50000:50000 \
20. -dit -v devops_data:/data/devops_data \
21. --name=devops ccr.ccs.tencentyun.com/tapd-devops/devops

然后，你需要等几分钟等待容器首次运行的初始化过程。可以通过docker logs -f <container_id>查看初始化情况。

如果你在docker日志中看到Initializing Finished的提示，表明你的配置过程已经成功完成。

此后，你可以在Tapd的 流水线->流水线配置->选择Jenkins服务的列表里看到新增加了一个Jenkins服务。并且，你可以通过上面命令设置的端口号访问到你的Jenkins后台面板。

各服务的初始密码

你可以通过Docker容器的日志看到各服务的初始的密码，示例：

你也可以通过命令docker exec -it <container_id> /bin/bash进入容器Shell，然后在/data/devops_data/secrets/文件夹下查看各服务的初始密码。

4.环境变量说明

在本镜像中，所有可配置的选项都通过创建容器时设置的环境变量来配置。以下列出了可配置的环境变量：

环境变量	说明
HOST	必填，你的服务外网可访问的Host
TOKEN	必填，你的服务和TAPD关联的访问令牌
JENKINS_PORT	你的Jenkins服务的端口，默认8080，（注意，需要和你启动docker容器的时候映射Jenkins的宿主机端口一致，比如步骤3中指定的8080）
SONAR_PORT	你的Sonar服务的端口，默认9000，（注意，需要和你启动docker容器的时候映射Jenkins的宿主机端口一致，比如步骤3中指定的9000）
NEXUS_PORT	你的Nexus服务的端口，默认8081，（注意，需要和你启动docker容器的时候映射Jenkins的宿主机端口一致，比如步骤3中指定的8081）
DATA_VOLUME	你的数据挂载卷（可选）
CONTAINER_NAME	你的容器名（可选）
JENKINS_AGENT_PORT	你的JENKINS_AGENT(可选)的端口，默认50000

5.可能出现的问题

1. 提示 "Failed: Jenkins-API-Token generated failed"

   如果出现此提示，可能是Jenkins服务启动未完成，导致配置失败。请使用docker volume rm devops_data命令删除数据卷，然后启动一个新容器。

2. 提示 "Error: Tapd Config failed"

   如果出现此提示，请检查是否出现以下问题：

   2.1 你的HOST无法访问

   2.2 你的JENKINS_PORT和映射的端口不一致

   2.3 你的容器无法访问Tapd的服务

3. 提示 "Error response from daemon: Error processing tar file(exit status 1): write /sonarqube-7.8/web/js/311.m.833607a2.chunk.js.map: no space left on device"

   出现该提示表明服务器的磁盘空间不足，请至少保证20G以上的空闲磁盘空间。

如果存在以上问题，请先解决以上问题，然后执行sudo rm -rf /var/lib/docker/volumes/devops_data/_data/*删除数据卷，然后重建容器。