在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详细图文教程https://blog.csdn.net/weixin_41805734/article/details/120698714

 

2、安装docker

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

Ubuntu上安装docker的详细教程、docker常用命令介绍https://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安装portainerhttps://blog.csdn.net/heyl163_/article/details/131758217

第二步：部署运行环境

1、部署redis

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

Ubuntu上通过源码方式安装Redishttps://blog.csdn.net/heyl163_/article/details/133126763

方案二：通过portainer快速部署

docker pull redis:6.2.13

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

version: "3"
 
services:
  redis:
    container_name: redis
    image: redis:6.2.13
    ports:
      - 6379:6379

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

2、部署nacos

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

安装nacos

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

docker pull nacos/nacos-server:1.4.2

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

version: "3"
​
services:
  nacos:
    container_name: nacos
    image: nacos/nacos-server:1.4.2
    ports:
      - 8848:8848
    environment:
      - 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用户的密码。

version: "3"
​
services:
  mariadb:
    container_name: mariadb
    image: mariadb:10.6.5
    ports:
      - 3306:3306
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - TZ=Asia/Shanghai
    volumes:
      - /usr/local/docker/mariadb:/var/lib/mysql

一键部署

version: "3"
 
services:
  redis:
    container_name: redis
    image: redis:6.2.13
    ports:
      - 6379:6379
  nacos:
    container_name: nacos
    image: nacos/nacos-server:1.4.2
    ports:
      - 8848:8848
    environment:
      - MODE=standalone
  mariadb:
    container_name: mariadb
    image: mariadb:10.6.5
    ports:
      - 3306:3306
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - TZ=Asia/Shanghai
    volumes:
      - /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，添加以下配置

<project>
    <--其他配置-->    
 
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.bootgroupId>
                <artifactId>spring-boot-maven-pluginartifactId>
            plugin>
        plugins>
    build>
project>

例如

"1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0modelVersion>
 
    <parent>
        <groupId>org.springframework.bootgroupId>
        <artifactId>spring-boot-starter-parentartifactId>
        <version>2.3.4.RELEASEversion>
        <relativePath/>
    parent>
 
    <groupId>cn.edu.sgu.wwwgroupId>
    <artifactId>authorityartifactId>
    <version>0.0.1-SNAPSHOTversion>
 
    <properties>
        <java.version>1.8java.version>
        <mysql.version>8.0.28mysql.version>
        <druid.version>1.1.21druid.version>
        <lombok.version>1.18.22lombok.version>
        <mybatis.version>2.2.2mybatis.version>
        <mybatis-plus.version>3.5.1mybatis-plus.version>
        <knife4j.version>2.0.9knife4j.version>
        <shiro.version>1.3.2shiro.version>
        <flyway.version>5.2.1flyway.version>
        <admin.version>2.3.1admin.version>
        <nacos.version>2.2.0.RELEASEnacos.version>
    properties>
 
    <dependencies>
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-webartifactId>
        dependency>
 
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-testartifactId>
            <scope>testscope>
        dependency>
 
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-aopartifactId>
        dependency>
 
        
        <dependency>
            <groupId>org.projectlombokgroupId>
            <artifactId>lombokartifactId>
            <version>${lombok.version}version>
        dependency>
 
        
        <dependency>
            <groupId>mysqlgroupId>
            <artifactId>mysql-connector-javaartifactId>
            <version>${mysql.version}version>
        dependency>
 
        
        <dependency>
            <groupId>org.mybatis.spring.bootgroupId>
            <artifactId>mybatis-spring-boot-starterartifactId>
            <version>${mybatis.version}version>
        dependency>
 
        
        <dependency>
            <groupId>com.alibabagroupId>
            <artifactId>druidartifactId>
            <version>${druid.version}version>
        dependency>
 
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-validationartifactId>
        dependency>
 
        
        <dependency>
            <groupId>com.baomidougroupId>
            <artifactId>mybatis-plus-boot-starterartifactId>
            <version>${mybatis-plus.version}version>
        dependency>
 
        
        <dependency>
            <groupId>org.flywaydbgroupId>
            <artifactId>flyway-coreartifactId>
            <version>${flyway.version}version>
        dependency>
 
        
        <dependency>
            <groupId>org.apache.shirogroupId>
            <artifactId>shiro-springartifactId>
            <version>${shiro.version}version>
        dependency>
 
        
        <dependency>
            <groupId>com.github.xiaoymingroupId>
            <artifactId>knife4j-spring-boot-starterartifactId>
            <version>${knife4j.version}version>
        dependency>
 
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-data-redisartifactId>
        dependency>
 
        
        <dependency>
            <groupId>com.alibaba.cloudgroupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discoveryartifactId>
            <version>${nacos.version}version>
        dependency>
 
        
        <dependency>
            <groupId>com.alibaba.cloudgroupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-configartifactId>
            <version>${nacos.version}version>
        dependency>
 
        
        <dependency>
            <groupId>de.codecentricgroupId>
            <artifactId>spring-boot-admin-starter-clientartifactId>
            <version>${admin.version}version>
        dependency>
    dependencies>
 
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.bootgroupId>
                <artifactId>spring-boot-maven-pluginartifactId>
            plugin>
        plugins>
    build>
project>

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

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

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

打包mhxysy

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

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

第四步：构建镜像

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

构建authority的镜像

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

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

FROM java:8
Add authority-0.0.1-SNAPSHOT.jar /authority.jar
EXPOSE 8099
CMD java -jar /authority.jar

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

docker build -t authority:20231024hyl .

构建mhxysy的镜像

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

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

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

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

docker build -t mhxysy:20231024hyl .

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

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

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

1、部署authority

version: "3"
 
services:
  authority:
    container_name: authority
    image: authority:20231024hyl
    ports:
      - 8099:8099

2、部署mhxysy

version: "3"
 
services:
  mhxysy:
    container_name: mhxysy
    image: mhxysy:20231024hyl
    ports:
      - 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就是额外的静态资源目录。

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

SpringMVC的配置类代码

package cn.edu.sgu.www.mhxysy.config;
 
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.web.servlet.ServletContextInitializer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.CorsRegistry;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 
import javax.servlet.ServletContext;
 
/**
 * springmvc配置类
 * @author heyunlin
 * @version 1.0
 */
@Configuration
public class SpringMvcConfig implements WebMvcConfigurer {
 
    @Value("${uploads.path}")
    private String uploadPath;
 
    /**
     * 解决跨域问题
     */
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedOrigins("*")
                .allowedMethods("*")
                .allowedHeaders("*")
                .allowCredentials(true)
                .maxAge(5000);
    }
 
    /**
     * 添加静态资源路径
     */
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 配置静态资源路径
        registry.addResourceHandler("/**")
                .addResourceLocations("classpath:static/")
                .addResourceLocations("file:" + uploadPath + "/");
        // 解决knife4j访问失败问题
        registry.addResourceHandler("doc.html")
                .addResourceLocations("classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**")
                .addResourceLocations("classpath:/META-INF/resources/webjars/");
    }
 
    /**
     * 设置SESSION_ID
     * @return ServletContextInitializer
     */
    @Bean
    public ServletContextInitializer servletContextInitializer() {
        return new ServletContextInitializer() {
            @Override
            public void onStartup(ServletContext servletContext) {
                servletContext.getSessionCookieConfig().setName("MHXYSY_JSESSIONID");
            }
        };
    }
 
}

然后在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

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

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

docker rmi -f mhxysy:20231024hyl 
 
docker build -t mhxysy:20231024hyl .

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

docker run mhxysy:20231024hyl

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

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

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

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

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

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

什么是挂载？

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

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

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

最终解决方案：

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

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

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

version: "3"
 
services:
  mhxysy:
    container_name: mhxysy
    image: mhxysy:20231024hyl
    ports:
      - 8080:8080
    volumes:
      - /usr/local/uploads/mhxysy:/usr/local/uploads/mhxysy

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

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