From e97263d62b397a711a027cee3e160a6e409cb4ae Mon Sep 17 00:00:00 2001
From: Herbert <7375946+mxj_3306@user.noreply.gitee.com>
Date: Mon, 15 Mar 2021 11:35:20 +0800
Subject: [PATCH 1/2] =?UTF-8?q?29.1=20=E5=85=A8=20Docker=20=E7=8E=AF?=
 =?UTF-8?q?=E5=A2=83=E6=8C=81=E7=BB=AD=E9=83=A8=E7=BD=B2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 handbook/docs/deploy-docker-auto.mdx | 299 +++++++++++++++++++++++++++
 1 file changed, 299 insertions(+)
 create mode 100644 handbook/docs/deploy-docker-auto.mdx

diff --git a/handbook/docs/deploy-docker-auto.mdx b/handbook/docs/deploy-docker-auto.mdx
new file mode 100644
index 0000000000..2460074419
--- /dev/null
+++ b/handbook/docs/deploy-docker-auto.mdx
@@ -0,0 +1,299 @@
+---
+id: deploy-docker-auto
+title: 29.1 全 Docker 环境持续部署
+sidebar_label: 29.1 全 Docker 环境持续部署
+---
+
+import useBaseUrl from "@docusaurus/useBaseUrl";
+
+## 29.1.1 关于全`Docker` 环境部署
+
+利用拥有Dotnet环境的Jenkins，进行持续化部署
+
+## 29.1.2 安装Docker版Jenkins
+
+正常在Docker中拉取的Jenkins:lts是无法执行Dotnet命令的（就算你宿主机有dotnet环境、docker中也有docker环境也不可以），
+所以我们只能构建一个包含Dotnet的镜像
+
+### 29.1.2.1 使用Dockerfile制作镜像
+
+使用Dockerfile创建包含dotnet的Jenkins镜像
+
+- 👉 编写 `Dockerfile`
+
+```bash
+# 封装Jenkins镜像（带有dotnet环境的） sdk=5.1
+FROM jenkins/jenkins:lts
+USER root
+WORKDIR /dotnet
+RUN wget -O dotnet.tar.gz https://download.visualstudio.microsoft.com/download/pr/820db713-c9a5-466e-b72a-16f2f5ed00e2/628aa2a75f6aa270e77f4a83b3742fb8/dotnet-sdk-5.0.100-linux-x64.tar.gz
+RUN tar zxf dotnet.tar.gz -C ./
+RUN rm -rf dotnet.tar.gz
+ENV PATH="${PATH}:/dotnet:/var/jenkins_home/.dotnet/tools"
+ENV DOTNET_ROOT="/dotnet"
+RUN apt update -y
+RUN apt install icu-devtools vim zip unzip -y
+RUN usermod -a -G root jenkins
+USER jenkins
+```
+- 👉 命令解释
+
+
+```bash
+- 1.这个Docker镜像基于jenkins
+- 2.设置当前用户为root，因为后面安装需要使用root
+- 3.设置当前工作目录为dotnet
+- 4.下载dotnet SDK包，保存为dotnet.tar.gz。这里要注意下载正确版本的SDK，可前往微软官方网站获取下载链接：https://dotnet.microsoft.com/download
+- 5.解压dotnet SDK到当前目录，即/dotnet目录
+- 6.删除dotnet SDK包
+- 7.把dotnet目录和dotnet tools目录添加到环境变量PATH，这样就可以使用dotnet命令了
+- 8.设置DOTNET_ROOT变量
+- 9.更新源
+- 10.安装一些必需的，常用的工具包，其中icu-devtools是运行dotnet需要的
+- 11.修改jenkins用户到root附加组
+- 12.设置当前用户为jenkins
+```
+
+
+- 👉 构建 `Docker` 镜像 name=jenkins:dotnet
+
+cd到根目录下（必须含 `Dockerfile`） 只需构建命令：
+
+```bash
+ docker build -t jenkins:dotnet .
+```
+
+:::important 特别注意
+
+后端的 `.` 不能省略
+
+:::
+
+### 29.1.2.2 运行Jenkins:dotnet镜像
+
+```bash
+docker run -d -p 8080:8080 -p 50000:50000 --name mjenkins  \
+           --privileged=true \
+           --restart always \
+           -u root \
+           -e TZ="Asia/Shanghai" \
+           -v /mudata/jenkins:/var/jenkins_home \
+           -v /usr/bin/docker:/usr/bin/docker \
+           -v /var/run/docker.sock:/var/run/docker.sock \
+           -v /mudata/webroot/:/mudata/webroot \
+           jenkins:dotnet
+```
+接下来就是比较俗套的安装Jenkins步骤，网上资料很多，不展开了。
+
+## 29.1.3 Jenkins的自动化部署
+
+### 29.1.3.1 编写Shell脚本
+
+```bash
+# Jenkins 构建 测试服
+
+echo '============查看打包环境================'
+pwd
+ls
+echo $PATH
+
+image_version=`date +%Y%m%d%H%M`;
+echo $image_version;
+
+dotnet --info
+dotnet --version
+
+# 获取短版本号
+GITHASH=`git rev-parse --short HEAD`
+
+echo '============================begin restore======================================='
+dotnet restore
+echo '============================end restore======================================='
+
+#要构建的解决方案名称
+solutionName=MUSaas.SCM.BasicData
+#docker run的容器名称
+containerName=jenkinsscmbasic
+#制定run的端口
+port=9994
+#.sln文件全路径
+#solutionDir=20-Solution/${solutionName}.sln
+#.csproj文件全路径
+csprojDir=/${solutionName}/${solutionName}.csproj
+
+#项目发布的目录
+webDir=/mudata/webroot/jenkins/publish/webapp
+
+#归档目录
+archivesDir=/mudata/webroot/jenkins/publish/archives
+
+#清空文件夹
+rm -rf ${webDir}/${JOB_NAME}/*
+
+#发布网站到webDir
+dotnet publish ${JENKINS_HOME}/workspace/${JOB_NAME}/${csprojDir} -c Release -o ${webDir}/${JOB_NAME} /p:Version=1.0.${BUILD_NUMBER}
+#复制配置文件
+#cp -rf /vdb1/jenkins/DotNetCoreWebPublishToDockerCommonConfigs/* ${webDir}/${JOB_NAME}/
+
+#判斷是否存在
+CID=$(docker ps | grep "${containerName}" | awk '{print $1}')
+echo $CID
+if [ "$CID" != "" ];then
+    docker stop ${containerName}
+    docker rm ${containerName}
+    docker rmi ${containerName}
+#docker stop $CID
+#docker rm $CID
+fi
+
+
+#通过Dockerfile重新构建镜像
+docker build -t ${containerName} ${webDir}/${JOB_NAME}/.
+#docker run容器并绑定到端口
+#docker run -d -p ${port}:80 --name ${containerName} ${containerName}
+docker run --name ${containerName} --restart=always -d -p ${port}:${port} -v /etc/localtime:/etc/localtime:ro ${containerName}
+echo "success!"
+
+```
+
+> 就这样自动化部署就好了。  测试服的Jenkins将源码拉下来，Publish，Docker Build，Docker Run。
+
+> 这里想要发布的时候，每次都需要手动去点击“构建”才会执行。也可以做成当分支合并成功后自动运行。反正Jenkins装好之后，你想要什么都能玩起来。比如指定分支提交后自动“构建”、比如构建成功后合并到Master等等
+
+
+## 29.1.4 Jenkins的自动化远程部署
+
+### 29.1.4.1 安装插件
+
+> Publish Over SSH
+
+### 29.1.4.2 配置
+
+> 系统管理=>Publish over SSH
+
+### 29.1.4.3 写脚本
+
+```bash
+# Jenkins 构建  正式服
+
+echo '============查看打包环境================'
+pwd
+ls
+echo $PATH
+
+image_version=`date +%Y%m%d%H%M`;
+echo $image_version;
+
+dotnet --info
+dotnet --version
+
+# 获取短版本号
+GITHASH=`git rev-parse --short HEAD`
+
+echo '============================begin restore======================================='
+dotnet restore
+echo '============================end restore======================================='
+
+#要构建的解决方案名称
+solutionName=MUSaas.SCM.BulkOrder
+#docker run的容器名称
+containerName=jenkinsscmbulk
+#制定run的端口
+port=9986
+#.csproj文件全路径
+csprojDir=/${solutionName}/${solutionName}.csproj
+
+#项目发布的目录
+webDir=/mudata/webroot/jenkins/publish/webapp
+
+#归档目录
+archivesDir=/mudata/webroot/jenkins/publish/archives
+
+#清空文件夹
+rm -rf ${webDir}/${JOB_NAME}/*
+
+#发布网站到webDir
+dotnet publish ${JENKINS_HOME}/workspace/${JOB_NAME}/${csprojDir} -c Release -o ${webDir}/${JOB_NAME} /p:Version=1.0.${BUILD_NUMBER}
+#复制配置文件
+#cp -rf /vdb1/jenkins/DotNetCoreWebPublishToDockerCommonConfigs/* ${webDir}/${JOB_NAME}/
+
+
+#构建远程包
+
+rm -rf ${JENKINS_HOME}/workspace/${JOB_NAME}/publish
+mkdir ${JENKINS_HOME}/workspace/${JOB_NAME}/publish
+
+tar -czvf ${JENKINS_HOME}/workspace/${JOB_NAME}/publish/${JOB_NAME}.${BUILD_NUMBER}.tar.gz -C ${webDir}/${JOB_NAME} .
+
+echo "success!"
+```
+
+> 大概逻辑就是发布后，打个包。然后丢给远程，远程再执行shell
+
+> 注意这里一定要发布到自己的workspace下，防止下一步死活找不到位置。如果找不到位置，只能慢慢用ls命令，一级一级去测，很麻烦
+
+### 29.1.4.4 构建后操作（关键）
+
+选择Send Build artifacts over SSH
+
+``` bash
+Source files: publish/
+Remove prefix(不填)
+Remote directory:/mudata/webroot/publish/
+Exec command:bash /mudata/shell/publish.sh  ${JOB_NAME} jenkinsscmbase ${JOB_NAME}.${BUILD_NUMBER}  9994
+```
+
+- 选择自己的SSH服务器
+- Source files：一定是workspace下的地址
+- Remote directory：远程地址，从更目录开始
+- Exec command：要执行的shell。这里所有的Jenkins环境变量都可以用
+
+
+### 29.1.4.5 远程执行
+
+publish.sh
+```bash
+# Jenkins Prod服 调用脚本
+solutionName=$1
+containerName=$2
+filename=$3
+port=$4
+#.publis
+echo ${solutionName}
+echo ${containerName}
+echo ${filename}
+baseDir=/mudata/webroot/publish
+
+webDir=${baseDir}/publish/${filename}
+
+rm -rf ${webDir}
+mkdir ${webDir}
+
+tar -zxvf ${baseDir}/publish/${filename}.tar.gz -C ${webDir}/
+rm -f  ${webDir}/appsettings.json && mv  ${webDir}/appsettings.Prod.json  ${webDir}/appsettings.json 
+
+#判斷是否存在
+CID=$(docker ps | grep "${containerName}" | awk '{print $1}')
+echo $CID
+if [ "$CID" != "" ];then
+    docker stop ${containerName}
+    docker rm ${containerName}
+    docker rmi ${containerName}
+#docker stop $CID
+#docker rm $CID
+fi
+
+cd  ${webDir}/ && docker build -t ${containerName} . 
+docker run --name ${containerName} --restart=always -d -p ${port}:${port} --link myredis:myredis  -v /etc/localtime:/etc/localtime:ro ${containerName}
+```
+> 这里的逻辑就是解压，然后Docker相关。每次构建都是带着版本号来的
+
+
+
+## 29.1.5 反馈与建议
+
+:::note 与我们交流
+
+给 Furion 提 [Issue](https://gitee.com/dotnetchina/Furion/issues/new?issue)。
+
+:::
-- 
Gitee


From b5d0428e7e279263910a3f1420de08b4d8a83901 Mon Sep 17 00:00:00 2001
From: Herbert <7375946+mxj_3306@user.noreply.gitee.com>
Date: Mon, 15 Mar 2021 11:36:55 +0800
Subject: [PATCH 2/2] =?UTF-8?q?update=20handbook/sidebars.js.=20=E5=A2=9E?=
 =?UTF-8?q?=E5=8A=A029.1=20=E5=85=A8=20Docker=20=E7=8E=AF=E5=A2=83?=
 =?UTF-8?q?=E6=8C=81=E7=BB=AD=E9=83=A8=E7=BD=B2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 handbook/sidebars.js | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/handbook/sidebars.js b/handbook/sidebars.js
index b45c186f2d..9a2b2e439f 100644
--- a/handbook/sidebars.js
+++ b/handbook/sidebars.js
@@ -156,8 +156,9 @@ module.exports = {
       items: ["deploy-iis", "deploy-docker", "deploy-nginx", "virtual-deploy"],
     },
     {
-      type: "doc",
-      id: "devops",
+      type: "category",
+      label:"29.持续部署集成",
+      items: ["deploy-docker-auto","devops"],
     },
     {
       type: "category",
-- 
Gitee