十分钟完成Springboot 生产环境搭建、代码仓库安装、自动打包部署(证书登录)

置顶 已于 2022-06-05 21:30:29 修改
阅读量2.7k 收藏 11
点赞数 6
分类专栏： 环境搭建 文章标签： java
于 2022-04-24 16:39:42 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hjue/article/details/124386222
版权

文章以 Springboot 官方的 HelloWorld 项目为例，教你掌握Springboot项目生产环境搭建、持续集成环境搭建。

如果你是新手，对 Linux 操作不熟悉，可以参考密码登录完成持续部署 进行实践，整个过程在网页中完成，不需要使用终端登录。在使用密码方式完成持续部署后，可以再改为证书登录。

通过此教程，你将获得：

  • Gitlab 代码托管环境

  • Gitlab CI/CD 环境

  • Springboot 生产环境

  • Springboot 项目自动打包部署环境

GitLab 自动打包部署流程如下图，开发者提交代码到GitLab后，会触发编译、构建，然后部署到服务器上。

image-20220426150029370

整个过程采用 CSDN 开发云 搭建，如果你仅仅想学习体验Springboot 生产环境搭建、代码仓库安装、自动打包部署，可以选择按小时计费，体验完毕后释放相关资源，花费只有几元钱。

如果部署过程中遇到问题，可以私信我或者评论文章

前期准备

SSH密钥对是一种安全便捷的登录认证方式，密钥用于登录 Linux 主机和 GitLab 自动打包部署。

创建密钥在自己的电脑上进行，可根据自己电脑的操作系统类型选择创建密钥的方式

创建密钥

Windows 创建密钥

PuTTY 是一个 SSH 和 telnet 客户端，可使用它登录 Linux 主机。 PuTTY 是开源软件，提供源代码，由一群志愿者开发和支持。

PuTTYGen 用来创建密钥对。

浏览到下面开发者页面，下载 PuTTY 的安装程序

https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

下载的文件，按照安装向导完成安装。

也可以从以下链接中下载 PuTTY 的64 位绿色版。绿色版下载后可直接运行，免去安装过程。

PuTTY

PuTTYGen

运行 puttygen.exe ，在 PuTTY 密钥生成器窗口中，单击 【Generate】。在灰色框中移动光标以填充绿色条。

Generating an SSH key pair in Putty.

点击【Save public key】按钮 保存公钥

点击【Save private key】按钮 保存公钥

Linux/MacOS 创建密钥

使用ssh-keygen 生成 SSH 密钥，密钥用来登录 Linux 主机。

ssh-keygen

image-20220421134040207

一路回车就可以完成 创建SSH 密钥，可以看到 ~/.ssh目录下生成了 id_rsa 和 id_rsa.pub 两个文件

image-20220421134123430

密钥使用场景
  • 创建主机时，创建密钥密钥内容填写id_rsa.pub 文件的内容
  • GitLab CI/CD SSH_PRIVATE_KEY 变量使用 id_rsa文件的内容

Linux/MacOS 使用cat命令查看密钥文件内容，windows 下使用type命令或写字板查看密钥文件内容

image-20220421134233886

准备两台主机

购买gitlab 主机

gitlab 主机用于托管项目代码，打包部署项目

访问云主机创建页面，在【镜像市场】选择【Gitlab】

image-20220420173659292

【主机规格】选择4GB/2CPU的以上配置。配置越高，支持的并发用户越多，打包构建的速度越快。gitlab 官方推荐配置是 4GB/4CPU。

注意：2GB 的主机可能安装完就卡死，访问页面一直是 502，根本无法使用。

image-20220421095339435

【登录凭证】选择您的SSH 密钥。若没有密钥，可以点击创建密钥，创建密钥时密钥内容粘贴 id_rsa.pub 文件的 内容。

image-20220420173908366

【弹性公网】选择固定带宽。带宽选择越大，打包构建的速度越快。

image-20220420174454347

如果你仅仅想体验部署过程，可以选择【按小时计费】，整个花费只有几元钱

image-20220422094739576

配置完成后，点击页面底部的【立即购买】

完成购买后，在主机列表可以看到主机的 IP 地址。这个 IP是 gitlab 主机的 ip 地址，下面的配置中会用到。

image-20220420174803254

购买Web 主机

Web 主机用于运行 Springboot 项目

访问云主机创建页面，在【镜像市场】选择【Springboot】，主机规格可选最低规格，其他配置同 gitlab 主机。

image-20220420173525974

配置 hosts 文件

配置本机的 hosts，文本中的ip 地址用你的主机 ip 替换。

此步骤可以跳过，以下步骤中直接使用主机的 ip 地址。

116.196.115.19 gitlab
116.198.43.123 web

配置 gitlab

修改密码

在浏览器地址栏输入 http://gitlab ，访问 上一步购买的gitlab 主机。若访问 gitlab 页面上出现502错误，说明 gitlab 服务正在初始化服务，请稍后再试。

image-20220420150739878

输入用户名 root ，密码 H9ZjJo8jmb1p+2FAEJiA1Mv/ODHyj7JmGpe7joeGiJU=，点击 【Sign in】

成功登录系统后，为了系统安全。请访问 http://gitlab/-/profile/password/edit 修改密码。

修改GitLab的服务地址

image-20220421151244321

如上图，刚购买 gitlab 镜像主机后，GitLab 服务地址不正确，需要修改后才能正常 clone 代码。

此步骤必须进行，否则不能正常 clone 代码和构建项目。

不设置服务地址构建时会出现如下错误

image-20220421152451050

登录gitlab服务器，参照文档登录 Linux 主机

1、编辑GitLab配置文件：/etc/gitlab/gitlab.rb，运行以下命令

sudo docker exec -it gitlab editor /etc/gitlab/gitlab.rb

在文件末尾添加以下内容，注意用你gitlab 主机的 ip 替换<gitlab 主机的 ip>。也可以使用自己的域名，注意域名需要备案。

external_url 'http://<gitlab 主机的 ip>'

2、进行所需的更改后，您需要重新启动GitLab以重新配置 ：

sudo docker restart gitlab

GitLab重新配置需要大概 3-5 分钟，请耐心等待

HelloWorld 项目代码托管

本次演示的 Springboot HelloWorld 项目，来自 spring 官网教程，是最简单的 Springboot Web 项目，适合初学者入门 Springboot。查看教程地址点击这里。

代码仓库托管在 github 上，由于有些时候访问 github 速度比较慢，我们将项目 clone 到了 gitcode。

代码仓库的地址是

https://gitcode.net/hjue/gs-spring-boot.git

新建项目gs-spring-boot

点击页面顶部的➕，选择 【新建项目/仓库】

image-20220420152216735

选择【导入项目】

image-20220420152315015

选择 【从 URL 导入仓库】

image-20220420152401985

Git 仓库URL 中输入 https://gitcode.net/hjue/gs-spring-boot.git ，拖动到页面底部，点击【新建项目】

image-20220420152650704

等待不足 1 分钟的时间，即可看到项目主页。

项目代码打包部署

配置部署变量

接下来我们进行项目的配置

image-20220420152937793

点击左侧边栏菜单的【设置】-> 【CI/CD】

image-20220420153137426

点击【变量】->【添加变量】

image-20220420153251700

键输入 SSH_PRIVATE_KEY ，值 粘贴访问服务器的私钥，点击【添加变量】。私钥是文件 id_rsa 的内容。

image-20220420153416290

按照上面的步骤添加APP_HOST变量。键输入APP_HOST，值输入你 Web 服务器的 IP 地址

image-20220420153846704

完成变量添加后，页面显示如下

image-20220420153945016

添加部署脚本

点击左上角项目名称跳转到项目首页

image-20220420154147626

创建web部署服务配置

点击➕，选择【新建文件】

image-20220420154351797

文件名 .gitlab-ci/hello-world.service ，内容粘贴以下内容。注意检查文件名末尾不要有空格。

[Unit]
Description=hello-world
After=syslog.target

[Service]
User=root
ExecStart=/usr/local/apps/hello-world/run.sh
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

image-20220420154732824

滚动到页面底部，点击【Commit changes】。可以看到文件创建成功。

image-20220420154922649

创建运行 springboot 项目脚本

重新回到项目首页，再次添加文件.gitlab-ci/run.sh。

文件内容如下：

#!/bin/bash
cd /usr/local/apps/hello-world
java -jar hello-world.jar

image-20220420155211810

添加持续集成配置

添加文件 .gitlab-ci.yml，文件内容如下：

stages:
  - build
  - deploy
  
maven-build:
  image: maven:3-jdk-8
  stage: build
  script: 
    - cd complete
    - mvn clean package -B -Dmaven.test.skip=true
  artifacts:
    paths:
      - complete/target/*.jar

production:
  image: maven:3-jdk-8
  stage: deploy
  before_script:
    - 'command -v ssh-agent >/dev/null || ( apt-get update -y && apt-get install openssh-client -y )'
    - eval $(ssh-agent -s)
    - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add -
    - mkdir -p ~/.ssh
    - chmod 700 ~/.ssh
    - '[[ -f /.dockerenv ]] && echo -e "Host *\n\tStrictHostKeyChecking no\n\n" >> ~/.ssh/config'  
  script:
    # 在 web 服务器上创建应用目录
    - ssh root@$APP_HOST "[[ -d /usr/local/apps/hello-world ]] || { mkdir -p /usr/local/apps/hello-world; }"
    # 将应用部署启动脚本到 web 服务器上
    - cat .gitlab-ci/run.sh | ssh root@$APP_HOST "cat > /usr/local/apps/hello-world/run.sh; chmod +x /usr/local/apps/hello-world/run.sh"
    # 复制 jar 文件到服务器
    - scp complete/target/spring-boot-complete-0.0.1-SNAPSHOT.jar root@$APP_HOST:/usr/local/apps/hello-world/hello-world.jar
    # 部署应用为系统服务
    - cat .gitlab-ci/hello-world.service | ssh root@$APP_HOST "cat > ./hello-world.service "
    - ssh root@$APP_HOST "[[ -f /etc/systemd/system/hello-world.service ]] || { mv ./hello-world.service /etc/systemd/system/hello-world.service && systemctl daemon-reload && systemctl enable hello-world.service; }"
    - ssh root@$APP_HOST "[[ -f ./hello-world.service ]] && { rm ./hello-world.service; }"
    # 重启应用服务
    - ssh root@$APP_HOST "systemctl restart hello-world"
    # 查看服务状态
    - ssh root@$APP_HOST "systemctl status hello-world"
  only:
  - main

文件创建成功后，回到项目首页。可以看到项目正在构建。

第一次构建比较慢，大概需要 20 分钟左右，构建的速度和你 gitlab 主机的配置及带宽相关。

点击这个【流水线状态按钮】查看项目构建的进度和构建的日志。

image-20220420160248100

在流水线页面，点击【运行中】按钮，查看流水线的工作情况

image-20220420162809047

点击 构建的作业，可查看构建的日志。从图中可以看到 maven-build 已经成功运行完成。production 任务正在运行中。

image-20220420163101751

最后，在流水线页面，可看到项目部署成功。此次构建用时 8 分钟。

image-20220420170758651

查看部署结果

项目构建成功后，打开浏览器，访问 http://web，页面显示如下内容，表示项目部署成功

image-20220421164832019

至此，完成了代码仓库建立、Springboot 运行环境搭建、项目打包部署的这个过程。

你可以通过 Gitlab 的 WebIDE 修改代码，提交后项目会自动打包部署。

修改代码体验自动部署

编辑项目代码文件HelloController.java，修改 index方法返回的字符串

image-20220421164645192

我将字符串"Greetings from Spring Boot and GitLab!"改为 "Greetings from Spring Boot and GitLab!"，提交修改后，gitlab 会自动开发打包并重新部署应用。

流水线运行完毕后，访问 web 服务器，可以看到首页内容已经变为"Greetings from Spring Boot and GitLab!"

image-20220421165420229

同样，在本地修改代码，push到 gitlab 代码仓库，也会触发 gitlab 流水线。

至此，我们已经完成了 SpringBoot 生产环境搭建、代码仓库安装、自动打包部署。

若你的项目是前端后分离的项目，可以参考【若依管理系统(前后端分离版)部署】。

CSDN 开发云，致力于帮助开发者让开发、代码发布、部署更简单。

FAQ

密钥配置错误

image-20220420160844264

出现上面错误，表示 CI/CD 变量 SSH_PRIVATE_KEY 设置错误。请参考文档重新设置私钥

git clone https://github.com/spring-guides/gs-spring-boot.git

cd gs-spring-boot/complete/

mvn clean package -Dmaven.test.skip=true

如何手动进行项目构建

点击左侧菜单【CI/CD】-> 【流水线】，进入流水线页面后，点击页面右侧的【运行流水线】按钮，进入运行流水线页面，点击【运行流水线】

image-20220420161200778

多鱼的夏天
关注
专栏目录
搭建GitLab服务器
云博
03-23 511
GitLab 是一个非常优秀的开源git管理项目，小型企业可使用该软件 安装之前准备环境： ssh rpm -qa|grep -E “openssh” 防火墙 rpm -qa|grep -E “firewalld” wget rpm -qa|grep -E “wget” 1.安装SMTP服务 安装 GitLab 之前，需要配置 SMTP 电子邮件服务器，以便 GitLab 可以在需要时随时推送电子邮件。官方推荐使用 Postfix。先在你的服务器上安装 Postfix yum install postf
Spring Boot 五种热部署方式，极速开发就是生产力！
weixin_45431247的博客
12-18 381
模板热部署 在 Spring Boot 中，模板引擎的页面默认是开启缓存的，如果修改了页面的内容，则刷新页面是得不到修改后的页面的，因此我们可以在application.properties中关闭模版引擎的缓存，如下：Thymeleaf的配置： spring.thymeleaf.cache=false FreeMarker的配置： spring.freemarker.cache=false G...
十分钟完成Springboot 生产环境搭建、代码仓库安装、自动打包部署（密码登录）
漫漫人生路
04-28 1359
GitLab 自动打包部署流程如下图，开发者提交代码到GitLab后，会触发编译、构建，然后部署到服务器上。
在云服务器上自动化部署项目，jenkins和gitee
最新发布
qq_63230990的博客
08-01 956
在编写项目时，很头大的事情就是需要自己手动的上传jar包到服务器上启动。如果出现一点bug，就要重头上传和启动。这是一件很烦的事情，所以，可以使用jenkins和gitee实现项目的自动部署
配置 GitLab 服务器
csdn_dev_cloud的博客
05-23 718
本教程以主要讲述如何配置GitLab以便正常托管代码和运行流水线。同时也提供了一键部署环境的方案
SpringBoot生产环境部署和常见注意事项
小哇
04-04 1571
1、去除相关生产环境没用的jar 比如热部署dev-tool 2、本地maven打包成jar包 ，或用idea工具 mvn clean package -Dmaven.test.skip=true 跳过测试 3、以守护进程nohup的方式来运行 nohup java -jar xxxx.jar & 大型网络公司通常采用如下方式发布 本地提交生...
十分钟搭建微服务框架（SpringBoot +Dubbo+Docker+Jenkins源码）
Moonxiyue的博客
06-19 1787
这套系统搭建完之后，那可就厉害了：微服务架构 你的整个应用程序将会被拆分成一个个功能独立的子系统，独立运行，系统与系统之间通过RPC接口通信。这样这些系统之间的耦合度大大降低，你的系统将非常容易扩展，团队协作效率提升了N个档次。这种架构通过眼下流行的SpringBoot和阿里巴巴吊炸天的Dubbo框架来实现。容器化部署 你的各个微服务将采用目前处于浪潮之巅的Docker来实现容器化部署，避免一切因环境引起的各种问题，让你们团队的全部精力集中在业务开发上。自动化构建 项目被微服务化后，各个服务之间的关系错中复
十分钟搞定Windows10 Docker环境
技术点滴
03-22 4975
目录 Docker简介 没有虚拟化的原始时代 虚拟化部署过度时代 容器部署时代 DockerDesktopforWindows的安装 Docker核心概念 用IDEA编写SpringBoot测试项目 配置Docker设置 IDEA配置Docker测试连接 编写Docker文件 在IDEA中运行Dockerfile Docker简介 最近几年来，容器算是时下非常火的...
狂神说——SpringBoot学习
weixin_44543307的博客
12-06 5215
Springboot 学习笔记Springboot简介什么是微服务？ThymeleafDuridSpringboot整合mybatisSpringSecurity安全Shiroswagger定时任务springboot 整合分布式 dubbo+ zookeeper+ springbootDubboRPC（两大核心：通讯，序列化）Zookeeper总结 学习源码 spring官网 springboot官网 spring-security版本下载 狂神官网学习 也可以搜索B站 （狂神说） Springboot简
DevOps、CI/CD流水线、Jenkins_Docker案例
zhongzhh8的博客
01-14 1640
微服务（Orchestration）架构 - 开发流水线与 DevOps 工具集 课程地址：18微服务orchestration架构—开发流水线与-devops-工具集 ppt给的要求三选一，我看来看去也就只有第一条能做而且是最简单的了：介绍 CI/CD Pipeline 原理、使用工具与案例。 一、DevOps（开发与运维 – Development and Operations） 参考DevO...
Spring+SpringMVC+Mybatis分布式敏捷开发系统架构
weixin_70730532的博客
06-07 1303
项目不仅仅是一个开发架构，而是努力打造一套从 前端模板 - 基础框架 - 分布式架构 - 开源项目 - 持续集成 - 自动化部署 - 系统监测 - 无缝升级 的全方位J2EE企业级开发解决方案。基于Spring+SpringMVC+Mybatis分布式敏捷开发系统架构，提供整套公共微服务服务模块：内容管理、支付中心、用户管理（包括第三方）、微信平台、存储系统、配置中心、日志分析、任务和通知等，支持服务治理、监控和追踪，努力为中小型企业打造全方位J2EE企业级开发解决方案。 技术选型 后端技术:前端技术
SpringBoot项目部署
qq_53317005的博客
10-23 4521
在真实开发中，在不同环境下运行项目往往会进行不同的配置，比如开发环境使用的是开发数据库，测试环境使用的是测试数据库，生产环境使用的是生产数据库。看到上诉内容就可以知道已经运行成功了，接下来我们访问ip地址:8081/printLog查看是否启动成功这里的ip地址是我的虚拟机ip地址，5. 查看所有的镜像，出现springbootdocker代表镜像构建成功。可以看到该目录少了BOOT-INF，打包是不完整的，也无法运行jar包。查看所有的镜像，出现springbootlogback代表镜像构建成功。
gitlab服务器配置
听雨阁
04-08 2648
gitlab服务器配置 1、安装 sudo apt-get install curl openssh-server ca-certificates postfix curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash sudo apt-get ins...
Springboot项目部署及多环境开发
m0_56308072的博客
11-13 684
我们之前写的代码都是部署在本地的tomcat上，别人是无法访问我们写的程序的。在实际开发中，我们都要将开发完毕的项目部署到公司的服务器上。我们的代码需要经过编译打包生成一个jar包，这个过程需要借助一个插件来实现。我们将一个maven项目打包，需要执行的命令是package，双击package。找到项目所在的文件目录下，打开cmd输入指令 java -jar 即可运行。假设我们现在是一个服务器电脑，我们收到了这个jar包，怎么运行使用呢？创建springboot的时候已经自动添加上了，如果没有就自己加上。
【springboot开发】项目打包、发布和部署
idiotyi的博客
06-25 3579
Docker是一个开源的应用容器引擎，可以让开发者打包应用及依赖包到一个可移植的容器中，然后发布到任何Linux机器上，还可以实现虚拟化。Docker是C/S架构，包括Docker Daemon和Docker Client。镜像（Image）只读的，包含需要运行的组件。用来创建容器，一个镜像可以运行多个容器容器（Container）Docker的运行组件。容器是一个隔离环境，互不影响。仓库（Registry）负责管理和共享Docker镜像。
GitLab服务器的搭建
weixin_44866492的博客
05-02 1479
通过rpm软件包部署GitLab，创建用户，创建组，创建项目
GitLab服务器搭建
05-24 5810
GitLab服务器搭建
SpringBoot：概述，注解，搭建，部署
燕双嘤
06-16 1791
1，SpringBoot简介 1.1，SpringBoot概述 Spring框架非常优秀，然而它最大的问题在于“配置过多”。基于Spring的企业级开发项目，需要大量的配置文件，SpringBoot的出现就是为了解决Spring框架存在的问题。 本质上讲：Spring只是一个“组件”容器，它负责创建并管理容器中的组件（Bean），并管理组件之间的依赖关系。正是由于Spring将容器功能用到了极致，JavaEE应用所涉及的各种组件（控制器、安全组件、逻辑层、消息、DAO、连接数据库组件），都处于Sp.
第十八章:SpringBoot的部署与发布
程序员光剑
01-23 343
1.背景介绍 1. 背景介绍 Spring Boot是一个用于构建新Spring应用的优秀框架。它的目标是简化开发人员的工作，让他们更多地关注业务逻辑，而不是冗长的配置。Spring Boot提供了一种“开箱即用”的方式来搭建Spring应用，使开发者能够快速地构建可扩展的、可维护的应用。 在开发过程中，部署和发布是非常重要的环节。这篇文章将涵盖Spring Boot的部署与发布相关的核心概...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

多鱼的夏天

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值