devbox
从前慢现在也慢
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

在Ubuntu上通过Docker/Portainer部署微服务项目_ubuntu portainer

作者：从前慢现在也慢 | 2024-07-19 06:19:46

赞

踩

ubuntu portainer

这篇文章详细介绍一下在ubuntu上部署自己开发的微服务应用的过程，文章中使用的技术包括docker、Dockerfile、docker-compose和portainer，在部署过程中遇到了不少问题，因为博主也是初学docker-compose，通过这次部署实战确实有所收获，在这篇文章一起分享给大家~

目录

第一步：开始前的准备工作

1、安装Ubuntu

2、安装docker

3、拉取java8的镜像

4、通过docker安装portainer

第二步：部署运行环境

1、部署redis

2、部署nacos

安装nacos

创建命名空间

添加配置文件

3、部署maraidb

一键部署

第三步：打包项目

打包authority

打包mhxysy

第四步：构建镜像

构建authority的镜像

构建mhxysy的镜像

第五步：通过portainer部署微服务

1、部署authority

2、部署mhxysy

部署过程中遇到的一些问题

问题1：多个docker容器之间无法通过内部ip相互访问

问题2：docker容器内部无法访问宿主机上的资源

第一步：开始前的准备工作

1、安装Ubuntu

在开始阅读本篇文章之前，需要拥有一台服务器或者在本地安装一台Ubuntu的虚拟机，还没有Ubuntu的童鞋推荐一篇写的非常详细的文章。

VMware虚拟机安装Ubuntu20.04详细图文教程icon-default.png?t=N7T8https://blog.csdn.net/weixin_41805734/article/details/120698714

 

2、安装docker

如果虚拟机上还没有安装docker的，可以参考博主的以下文章完成docker安装

Ubuntu上安装docker的详细教程、docker常用命令介绍icon-default.png?t=N7T8https://blog.csdn.net/heyl163_/article/details/131503469

3、拉取java8的镜像

因为微服务的镜像是基于java构建的，这个镜像在通过Dockerfile把jar包打包生成docker镜像文件的时候要用到，所以把java:8的镜像下载到本地docker仓库，否则每次构建镜像的时候都会下载一遍java:8。

docker pull java:8

4、通过docker安装portainer

下面链接中的文章详细介绍了通过docker安装并启动portainer的步骤

使用docker安装portainericon-default.png?t=N7T8https://blog.csdn.net/heyl163_/article/details/131758217

第二步：部署运行环境

1、部署redis

方案一：可以在ubuntu宿主机上通过源码方式安装redis

Ubuntu上通过源码方式安装Redisicon-default.png?t=N7T8https://blog.csdn.net/heyl163_/article/details/133126763

方案二：通过portainer快速部署

docker pull redis:6.2.13

在portainer上新建一个stack，填写docker-compose.yml

  1. version: "3"
  2.  
  3. services:
  4.   redis:
  5.     container_name: redis
  6.     image: redis:6.2.13
  7.     ports:
  8.       - 6379:6379

然后点击部署按钮，可以参考下一小节《2、安装nacos》

2、部署nacos

本篇文章中，使用nacos作为微服务的注册中心和配置中心。

安装nacos

第一步：通过docker输入以下命令拉取nacos镜像

docker pull nacos/nacos-server:1.4.2

第二步：在portainer中新建一个stack，填写docker-compose.yml

  1. version: "3"
  2. ​
  3. services:
  4.   nacos:
  5.     container_name: nacos
  6.     image: nacos/nacos-server:1.4.2
  7.     ports:
  8.       - 8848:8848
  9.     environment:
  10.       - MODE=standalone

操作的详细步骤：

点击左侧的Stacks菜单，然后点击【Add Stacks】按钮添加一个应用

 按照红框内的文字填写

如图

如上图，填写完成之后，页面往下拉，找到并点击【Deploy the stack】按钮，portainer就会帮我们创建并启动一个docker容器，容器名是docker-compose.yml里配置的container_name。

如图，右上角弹出提示部署成功

部署完成后，点击左侧菜单的Containers在容器列表查看刚刚部署的nacos，状态显示running，表示nacos正在以docker容器的方式运行。

最后，在windows上访问portainer上部署的nacos，通过虚拟机IP:8848/nacos访问nacos控制台首页，虚拟机IP通过在安装的linux虚拟机（本篇文章中安装的是Ubuntu）上使用ifconfig命令获取。

如图，说明nacos可以正常访问，通过用户名、密码都是nacos登录。

创建命名空间

通过nacos用户名和密码登录nacos，点击左侧菜单中的【命名空间】，新建一个命名空间，命名空间ID如下

0df4345c-cf1e-4af4-9501-d4be92ca6fda

添加配置文件

点击左侧的配置管理-配置列表，点击右上角的+新建配置文件

3、部署maraidb

通过docker拉取mariadb镜像，并通过portainer部署启动MariaDB。

拉取mariadb镜像

docker pull mariadb:10.6.5

参照安装nacos的步骤，在portainer中新建一个stack，填写docker-compose.yml。

environment里的MYSQL_ROOT_PASSWORD配置MariaDB的root用户的密码。

  1. version: "3"
  2. ​
  3. services:
  4.   mariadb:
  5.     container_name: mariadb
  6.     image: mariadb:10.6.5
  7.     ports:
  8.       - 3306:3306
  9.     environment:
  10.       - MYSQL_ROOT_PASSWORD=root
  11.       - TZ=Asia/Shanghai
  12.     volumes:
  13.       - /usr/local/docker/mariadb:/var/lib/mysql

一键部署

  1. version: "3"
  2.  
  3. services:
  4.   redis:
  5.     container_name: redis
  6.     image: redis:6.2.13
  7.     ports:
  8.       - 6379:6379
  9.   nacos:
  10.     container_name: nacos
  11.     image: nacos/nacos-server:1.4.2
  12.     ports:
  13.       - 8848:8848
  14.     environment:
  15.       - MODE=standalone
  16.   mariadb:
  17.     container_name: mariadb
  18.     image: mariadb:10.6.5
  19.     ports:
  20.       - 3306:3306
  21.     environment:
  22.       - MYSQL_ROOT_PASSWORD=root
  23.       - TZ=Asia/Shanghai
  24.     volumes:
  25.       - /usr/local/docker/mariadb:/var/lib/mysql

第三步：打包项目

在IntelliJ IDEA上通过maven插件打包自己的微服务项目authority和mhxysy。

打包authority

第一步：修改nacos的服务地址

第二步：修改profile设置

因为博主在本地用的是开发环境dev，在虚拟机上使用测试环境，在阿里云ECS服务器上使用生产环境。修改spring.profile.active=test

第三步：通过IntelliJ IDEA的Maven插件打包项目

需要在项目maven依赖中添加maven插件，修改pom.xml，添加以下配置

  1. <project>
  2.     <--其他配置-->    
  3.  
  4.     <build>
  5.         <plugins>
  6.             <plugin>
  7.                 <groupId>org.springframework.boot</groupId>
  8.                 <artifactId>spring-boot-maven-plugin</artifactId>
  9.             </plugin>
  10.         </plugins>
  11.     </build>
  12. </project>

例如

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  4.     <modelVersion>4.0.0</modelVersion>
  5.  
  6.     <parent>
  7.         <groupId>org.springframework.boot</groupId>
  8.         <artifactId>spring-boot-starter-parent</artifactId>
  9.         <version>2.3.4.RELEASE</version>
  10.         <relativePath/>
  11.     </parent>
  12.  
  13.     <groupId>cn.edu.sgu.www</groupId>
  14.     <artifactId>authority</artifactId>
  15.     <version>0.0.1-SNAPSHOT</version>
  16.  
  17.     <properties>
  18.         <java.version>1.8</java.version>
  19.         <mysql.version>8.0.28</mysql.version>
  20.         <druid.version>1.1.21</druid.version>
  21.         <lombok.version>1.18.22</lombok.version>
  22.         <mybatis.version>2.2.2</mybatis.version>
  23.         <mybatis-plus.version>3.5.1</mybatis-plus.version>
  24.         <knife4j.version>2.0.9</knife4j.version>
  25.         <shiro.version>1.3.2</shiro.version>
  26.         <flyway.version>5.2.1</flyway.version>
  27.         <admin.version>2.3.1</admin.version>
  28.         <nacos.version>2.2.0.RELEASE</nacos.version>
  29.     </properties>
  30.  
  31.     <dependencies>
  32.         <dependency>
  33.             <groupId>org.springframework.boot</groupId>
  34.             <artifactId>spring-boot-starter-web</artifactId>
  35.         </dependency>
  36.  
  37.         <dependency>
  38.             <groupId>org.springframework.boot</groupId>
  39.             <artifactId>spring-boot-starter-test</artifactId>
  40.             <scope>test</scope>
  41.         </dependency>
  42.  
  43.         <!--aop-->
  44.         <dependency>
  45.             <groupId>org.springframework.boot</groupId>
  46.             <artifactId>spring-boot-starter-aop</artifactId>
  47.         </dependency>
  48.  
  49.         <!--lombok-->
  50.         <dependency>
  51.             <groupId>org.projectlombok</groupId>
  52.             <artifactId>lombok</artifactId>
  53.             <version>${lombok.version}</version>
  54.         </dependency>
  55.  
  56.         <!--mysql-->
  57.         <dependency>
  58.             <groupId>mysql</groupId>
  59.             <artifactId>mysql-connector-java</artifactId>
  60.             <version>${mysql.version}</version>
  61.         </dependency>
  62.  
  63.         <!--mybatis-->
  64.         <dependency>
  65.             <groupId>org.mybatis.spring.boot</groupId>
  66.             <artifactId>mybatis-spring-boot-starter</artifactId>
  67.             <version>${mybatis.version}</version>
  68.         </dependency>
  69.  
  70.         <!--druid-->
  71.         <dependency>
  72.             <groupId>com.alibaba</groupId>
  73.             <artifactId>druid</artifactId>
  74.             <version>${druid.version}</version>
  75.         </dependency>
  76.  
  77.         <!--validation-->
  78.         <dependency>
  79.             <groupId>org.springframework.boot</groupId>
  80.             <artifactId>spring-boot-starter-validation</artifactId>
  81.         </dependency>
  82.  
  83.         <!--mybatis-plus-->
  84.         <dependency>
  85.             <groupId>com.baomidou</groupId>
  86.             <artifactId>mybatis-plus-boot-starter</artifactId>
  87.             <version>${mybatis-plus.version}</version>
  88.         </dependency>
  89.  
  90.         <!--flyway-->
  91.         <dependency>
  92.             <groupId>org.flywaydb</groupId>
  93.             <artifactId>flyway-core</artifactId>
  94.             <version>${flyway.version}</version>
  95.         </dependency>
  96.  
  97.         <!--shiro-->
  98.         <dependency>
  99.             <groupId>org.apache.shiro</groupId>
  100.             <artifactId>shiro-spring</artifactId>
  101.             <version>${shiro.version}</version>
  102.         </dependency>
  103.  
  104.         <!--knife4j-->
  105.         <dependency>
  106.             <groupId>com.github.xiaoymin</groupId>
  107.             <artifactId>knife4j-spring-boot-starter</artifactId>
  108.             <version>${knife4j.version}</version>
  109.         </dependency>
  110.  
  111.         <!--redis-->
  112.         <dependency>
  113.             <groupId>org.springframework.boot</groupId>
  114.             <artifactId>spring-boot-starter-data-redis</artifactId>
  115.         </dependency>
  116.  
  117.         <!--nacos注册中心-->
  118.         <dependency>
  119.             <groupId>com.alibaba.cloud</groupId>
  120.             <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
  121.             <version>${nacos.version}</version>
  122.         </dependency>
  123.  
  124.         <!--nacos配置中心-->
  125.         <dependency>
  126.             <groupId>com.alibaba.cloud</groupId>
  127.             <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
  128.             <version>${nacos.version}</version>
  129.         </dependency>
  130.  
  131.         <!--admin client-->
  132.         <dependency>
  133.             <groupId>de.codecentric</groupId>
  134.             <artifactId>spring-boot-admin-starter-client</artifactId>
  135.             <version>${admin.version}</version>
  136.         </dependency>
  137.     </dependencies>
  138.  
  139.     <build>
  140.         <plugins>
  141.             <plugin>
  142.                 <groupId>org.springframework.boot</groupId>
  143.                 <artifactId>spring-boot-maven-plugin</artifactId>
  144.             </plugin>
  145.         </plugins>
  146.     </build>
  147. </project>

最后，点击左侧工具栏的maven，点击package完成项目打包。

如下图所示，就是打包成功了

打包完成后，会生成编译生成的目录，我们只需要红框内的jar包，把他复制出来，在后面需要通过finalshell上传到服务器上。

打包mhxysy

按照打包authority的步骤完成mhxysy的打包。

打包完成后，得到了两个jar包

第四步：构建镜像

在虚拟机/服务器的某个目录下（如/opt目录）创建applications目录，在文件夹下面在创建一级目录，目录名为微服务的应用名。

构建authority的镜像

在虚拟机的/opt/applications目录下面创建authority目录，然后把idea中打包生成的jar包上传到这个目录/opt/applications/authority。

在同目录下创建一个文件，文件名为Dockerfile，文件名没有后缀，在Dockerfile中填写以下内容。

  1. FROM java:8
  2. Add authority-0.0.1-SNAPSHOT.jar /authority.jar
  3. EXPOSE 8099
  4. CMD java -jar /authority.jar

然后在当前目录下运行命令将当前目录下的jar包打包成镜像

docker build -t authority:20231024hyl .

构建mhxysy的镜像

在虚拟机的/opt/applications目录下面创建mhxysy目录，然后把idea中打包生成的jar包上传到这个目录/opt/applications/mhxysy。

在同目录下创建一个文件，文件名为Dockerfile，文件名没有后缀，在Dockerfile中填写以下内容。

  1. FROM java:8
  2. ADD mhxysy-0.0.1-SNAPSHOT.jar mhxysy.jar
  3. EXPOSE 8080
  4. CMD ["java", "-jar", "mhxysy.jar"]

然后在mhxysy目录下运行命令将当前目录下的jar包打包成镜像

docker build -t mhxysy:20231024hyl .

完成以上步骤后，docker仓库中已经有了两个微服务的镜像

第五步：通过portainer部署微服务

通过portainer在Stacks里通过docker-compose.yml使用通过刚刚打包的镜像部署微服务应用。

1、部署authority

  1. version: "3"
  2.  
  3. services:
  4.   authority:
  5.     container_name: authority
  6.     image: authority:20231024hyl
  7.     ports:
  8.       - 8099:8099

2、部署mhxysy

  1. version: "3"
  2.  
  3. services:
  4.   mhxysy:
  5.     container_name: mhxysy
  6.     image: mhxysy:20231024hyl
  7.     ports:
  8.       - 8080:8080

部署过程中遇到的一些问题

问题1：多个docker容器之间无法通过内部ip相互访问

在部署mhxysy服务的过程中遇到了一点问题，因为mhxysy这个服务在启动的时候需要通过feign从authority服务中查询数据，由于authority注册到nacos上的IP地址是容器内部ip，而宿主机是无法直接访问容器内部的ip的，为了能让多个服务之间能够正常通信，需要让服务提供者authority和服务消费者mhxysy加入同一个网络，比如网桥bridge（默认情况下，当前服务会加入xxx_default这个网络，xxx表示服务名）。

加入网络之后需要重启authority

按照相同的方法，把mhxysy也加入到bridge网络

然后重新启动mhxysy这个服务

问题2：docker容器内部无法访问宿主机上的资源

问题是这样的，因为mhxysy项目的图片资源并不是存放在项目的目录下，而是分开存储，在windows上运行时，放在了D:/uploads/mhxysy目录下，然后在SpringMVC的配置类里把这个目录添加为静态资源目录。

在配置文件中配置的uploads.path就是额外的静态资源目录。

  1. uploads:
  2.   path: D:/uploads/mhxysy # 文件上传路径
  3.   file:
  4.     max-size: 1024MB # 最大上传文件大小
  5.     suffix: .webp,.jpeg,.jpg,.png # 上传的文件名

SpringMVC的配置类代码

  1. package cn.edu.sgu.www.mhxysy.config;
  2.  
  3. import org.springframework.beans.factory.annotation.Value;
  4. import org.springframework.boot.web.servlet.ServletContextInitializer;
  5. import org.springframework.context.annotation.Bean;
  6. import org.springframework.context.annotation.Configuration;
  7. import org.springframework.web.servlet.config.annotation.CorsRegistry;
  8. import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
  9. import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
  10.  
  11. import javax.servlet.ServletContext;
  12.  
  13. /**
  14.  * springmvc配置类
  15.  * @author heyunlin
  16.  * @version 1.0
  17.  */
  18. @Configuration
  19. public class SpringMvcConfig implements WebMvcConfigurer {
  20.  
  21.     @Value("${uploads.path}")
  22.     private String uploadPath;
  23.  
  24.     /**
  25.      * 解决跨域问题
  26.      */
  27.     @Override
  28.     public void addCorsMappings(CorsRegistry registry) {
  29.         registry.addMapping("/**")
  30.                 .allowedOrigins("*")
  31.                 .allowedMethods("*")
  32.                 .allowedHeaders("*")
  33.                 .allowCredentials(true)
  34.                 .maxAge(5000);
  35.     }
  36.  
  37.     /**
  38.      * 添加静态资源路径
  39.      */
  40.     @Override
  41.     public void addResourceHandlers(ResourceHandlerRegistry registry) {
  42.         // 配置静态资源路径
  43.         registry.addResourceHandler("/**")
  44.                 .addResourceLocations("classpath:static/")
  45.                 .addResourceLocations("file:" + uploadPath + "/");
  46.         // 解决knife4j访问失败问题
  47.         registry.addResourceHandler("doc.html")
  48.                 .addResourceLocations("classpath:/META-INF/resources/");
  49.         registry.addResourceHandler("/webjars/**")
  50.                 .addResourceLocations("classpath:/META-INF/resources/webjars/");
  51.     }
  52.  
  53.     /**
  54.      * 设置SESSION_ID
  55.      * @return ServletContextInitializer
  56.      */
  57.     @Bean
  58.     public ServletContextInitializer servletContextInitializer() {
  59.         return new ServletContextInitializer() {
  60.             @Override
  61.             public void onStartup(ServletContext servletContext) {
  62.                 servletContext.getSessionCookieConfig().setName("MHXYSY_JSESSIONID");
  63.             }
  64.         };
  65.     }
  66.  
  67. }

然后在ubuntu上部署，毋庸置疑，需要修改这个静态资源目录，本篇文章中，放在了/usr/local/uploads/mhxysy目录下，所以ubuntu虚拟机上的/usr/local/uploads/mhxysy目录作为了项目的静态资源文件夹，和static目录一样。

因此，在ubuntu上通过java -jar命令运行jar包的方式启动是没有问题的，可以正常访问到图片，但是通过docker上运行会有问题，找不到对应的文件。这是因为docker的容器其实就是一个小的操作系统，里面有属于这个容器的类似ubuntu的文件系统，所以里面也有大部分linux虚拟机上有的目录。所以，我们配置的静态资源文件夹，容器会从自己内部的文件系统中查找，如果找不到，就返回404。

问题解决：

既然容器内部没有这些文件夹，能不能创建出来呢，然后把宿主机上的文件复制到容器内部。

既然有了思路，那么该从何下手呢？

突破点：博主在通过官网学习Dockerfile的时候，发现了Dockerfile有很多指令，除了构建微服务应用镜像必须要的几个指令FROM、EXPOSE、ADD、ENTRYPOINT以外，在文档开头就看到了有个RUN指令，很显然这个RUN指令后面跟的是linux的命令。

看完文档介绍也没说清楚这个命令到底是干嘛用的，只知道是执行linux命令，于是，抱着尝试的态度，在Dockerfile里增加了创建文件夹的命令

RUN mkdir /mhxysy
  1. FROM java:8
  2. RUN mkdir /mhxysy
  3. ADD mhxysy-0.0.1-SNAPSHOT.jar mhxysy.jar
  4. EXPOSE 8080
  5. CMD ["java", "-jar", "mhxysy.jar"]

然后把原来的mhxysy镜像mhxysy:20231024hyl删掉，重新生成一次镜像文件

  1. docker rmi -f mhxysy:20231024hyl 
  2.  
  3. docker build -t mhxysy:20231024hyl .

然后运行这个镜像，生成一个容器

docker run mhxysy:20231024hyl

然后看一下ubuntu上有没有创建对应的mhxysy目录，最后发现并没有。看到这个结果，可能会验证自己的猜想：这个RUN指令后面的脚本是在运行镜像的时候，在容器内部执行的。

于是，进入容器内部，看下有没有mhxysy这个目录

  1. docker exec -it 通过mhxysy:20231024hyl镜像运行生成的容器的ID
  2.  
  3. ls

果然，容器里面确实创建了一个mhxysy目录。

到这里，这个问题基本就已经解决了，在容器内部创建和ubuntu宿主机上一样的目录，然后把宿主机上的文件复制到里面去，文件上传的时候新上传的文件会保存在容器内部。

新的问题：当删除容器时，里面的文件就丢失了。为了防止删除容器导致文件丢失，在这里需要接触到docker中的另一个概念：挂载。

什么是挂载？

首先，第一次接触挂载的时候，博主只是将它理解为一个目录的对应关系，宿主机上的目录对应的docker容器内部的目录。

随着对挂载的使用，逐渐有了更加深入的理解：

挂载就是和上面说的一样，建立宿主机docker容器内部的目录的映射关系，挂载是为了防止上面的删除容器导致数据丢失的问题，挂载可以把容器内部的数据在映射的宿主机目录上也备份一份，当删除容器时，容器内的数据自然被删除了，但是重新创建容器，然后指定相同的挂载路径，容器启动的时候就会从宿主机的目录上加载数据，这样的话，只要宿主机的数据没有删，容器在重新创建之后启动完成就加载回了删除容器之前的数据。

最终解决方案：

于是，为了解决mhxysy服务找不到图片的问题，把之前的Dockerfile内容再次修改，在RUN指令里创建和宿主机目录一样的多级目录/usr/local/uploads/mhxysy

  1. FROM java:8
  2. RUN mkdir -p /usr/local/uploads/mhxysy
  3. ADD mhxysy-0.0.1-SNAPSHOT.jar mhxysy.jar
  4. EXPOSE 8080
  5. CMD ["java", "-jar", "mhxysy.jar"]

docker-compose里的挂载通过volumes配置，把之前mhxysy的docker-compose.yml中添加volumes的相关配置

  1. version: "3"
  2.  
  3. services:
  4.   mhxysy:
  5.     container_name: mhxysy
  6.     image: mhxysy:20231024hyl
  7.     ports:
  8.       - 8080:8080
  9.     volumes:
  10.       - /usr/local/uploads/mhxysy:/usr/local/uploads/mhxysy

在portainer中删除之前的mhxysy的容器，重新部署一次，然后通过浏览器访问，图片能正常显示了，至此，问题2也解决了。

好了，文章就分享到这里了，看完不要忘了点赞+收藏哦~

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/从前慢现在也慢/article/detail/849831
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号