zongkx

Appearance

切换jdk ​

maven-toolchains-plugin

xml

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-toolchains-plugin</artifactId>
    <version>3.2.0</version>
    <executions>
        <execution>
            <goals>
                <goal>toolchain</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <toolchains>
            <jdk>
                <version>14</version>
                <vendor>oracle</vendor>
            </jdk>
        </toolchains>
    </configuration>
</plugin>

classifier ​

一个项目打两个jar包

xml

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-jar-plugin</artifactId>
    <executions>
        <execution>
            <id>thin-jar</id>
            <phase>package</phase>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
                <includes>
                    <include>**/com/demo/entity/**</include>
                </includes>
                <classifier>base</classifier>
            </configuration>
        </execution>
    </executions>
</plugin>
xml

<dependency>
    <groupId>com.zkx</groupId>
    <artifactId>demo</artifactId>
    <version>1.0.1-SNAPSHOT</version>
    <classifier>base</classifier>
</dependency>

mirror ​

xml

<mirrors>
    <mirror>
        <id>central</id>
        <mirrorOf>external:http:*</mirrorOf>
        <url>http://127.0.0.1:8081/nexus/repository/maven-public/</url>
        <blocked>true</blocked>
    </mirror>
    <mirror>
        <id>huaweicloud</id>
        <name>mirror from maven huaweicloud</name>
        <mirrorOf>central</mirrorOf>
        <url>https://repo.huaweicloud.com/repository/maven/</url>
    </mirror>
</mirrors>

指令 ​

mvn clean compile deploy -DskipTests

Profile ​

profile也可以指定 ·distributionManagement·

mvn package -P all all in one fat jar mvn package -P plat thin jar

xml

<project>
    <profile>
        <id>all</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-shade-plugin</artifactId>
                    <version>3.2.3</version>
                    <configuration>
                        <filters>
                            <filter>
                                <artifact>*:*</artifact>
                                <excludes>
                                    <exclude>META-INF/*.SF</exclude>
                                    <exclude>META-INF/*.DSA</exclude>
                                    <exclude>META-INF/*.RSA</exclude>
                                </excludes>
                            </filter>
                        </filters>
                        <createDependencyReducedPom>true</createDependencyReducedPom>
                        <relocations>
                            <relocation>
                                <pattern>com.fasterxml</pattern>
                                <shadedPattern>demo.com.fasterxml</shadedPattern>
                            </relocation>
                        </relocations>
                    </configuration>
                    <executions>
                        <execution>
                            <phase>package</phase>
                            <goals>
                                <goal>shade</goal>
                            </goals>
                        </execution>
                    </executions>
                </plugin>
            </plugins>
        </build>
    </profile>

    <profile>
        <id>plat</id>
    </profile>
</project>

deploy 上次至私服 ​

一般多模块项目,把distributionManagement标签放在 package为 pom的父级模块, 比如

  • common( common-a,common-b)
  • boot

需要deploy common-a和common-b 两个模块,此时将distributionManagement放在 common中即可,在项目根目录或者在其目录下执行 mvn deploy 即可.

xml

<servers>
    <server>
        <id>nexus-releases</id>
        <username>admin</username>
        <password>admin</password>
    </server>
    <server>
        <id>nexus-snapshots</id>
        <username>admin</username>
        <password>admin</password>
    </server>
</servers>
xml

<distributionManagement>
    <!-- 两个ID必须与 setting.xml中的<server><id>nexus-releases</id></server>保持一致 -->
    <repository>
        <id>nexus-releases</id>
        <name>Nexus Release Repository</name>
        <url>http://maven.demo.com/nexus/content/repositories/demo-Release/</url>
    </repository>
    <snapshotRepository>
        <id>nexus-snapshots</id>
        <name>Nexus Snapshot Repository</name>
        <url>http://maven.demo.com/nexus/content/repositories/demo-Snapshot/</url>
    </snapshotRepository>

</distributionManagement>

resource ​

该插件将会把指定目录下的配置文件中的占位符替换为 profile中的配置信息dev的activeByDefault为true,默认mvn package 将执行dev环境(也可以指定 -Ppro 来执行 pro环境.)

比如下文配置将会启用 dev,且dev中的${name}会被替换为dev-name

yaml
spring:
profiles:
  active: ${profile-name}
yaml
name: ${name}
xml

<profiles>
    <profile>
        <id>dev</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <properties>
            <profile-name>dev</profile-name>
            <name>dev-name</name>
        </properties>
    </profile>
    <profile>
        <id>pro</id>
        <activation>
            <activeByDefault>false</activeByDefault>
        </activation>
        <properties>
            <profile-name>pro</profile-name>
            <name>pro-name</name>
        </properties>
    </profile>
</profiles>
xml

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <encoding>utf-8</encoding>
                <useDefaultDelimiters>true</useDefaultDelimiters>
                <resources>
                    <resource>
                        <directory>src/main/resources</directory>
                        <filtering>true</filtering>
                    </resource>
                    <resource>
                        <directory>src/main/k8s</directory>
                        <filtering>true</filtering>
                    </resource>
                </resources>
            </configuration>
        </plugin>
    </plugins>
</build>

java-doc ​

上传至mvn私服

xml

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
</plugin>

java-source ​

xml

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-source-plugin</artifactId>
    <executions>
        <execution>
            <id>attach-sources</id>
            <goals>
                <goal>jar</goal>
            </goals>
        </execution>
    </executions>
</plugin>

fat-jar打包(all in one) ​

打包后的jar包含所有依赖,且路径被重写.

xml

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.2.3</version>
    <configuration>
        <filters>
            <filter>
                <artifact>*:*</artifact>
                <excludes>
                    <exclude>META-INF/*.SF</exclude>
                    <exclude>META-INF/*.DSA</exclude>
                    <exclude>META-INF/*.RSA</exclude>
                </excludes>
            </filter>
        </filters>
        <createDependencyReducedPom>true</createDependencyReducedPom>
        <relocations>
            <relocation>
                <pattern>com.fasterxml</pattern>
                <shadedPattern>demo.com.fasterxml</shadedPattern>
            </relocation>
        </relocations>
    </configuration>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
        </execution>
    </executions>
</plugin>

springboot插件 ​

springboot 插件,用于启动springboot

  • spring-boot:repackage，默认goal。在mvn package之后，再次打包可执行的jar/war，同时保留mvn package生成的jar/war为.origin
  • spring-boot:run，运行Spring Boot应用
  • spring-boot:start，在mvn integration-test阶段，进行Spring Boot应用生命周期的管理
  • spring-boot:stop，在mvn integration-test阶段，进行Spring Boot应用生命周期的管理
  • spring-boot:build-info，生成Actuator使用的构建信息文件build-info.properties
xml

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>${springboot.version}</version>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>

docker插件(new)/分层构建 ​

io.fabric8

xml

<properties>
    <java.version>17</java.version>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <!--上传的Docker镜像前缀，此前缀一定要和Harbor中的项目名称一致，和阿里云仓库的命名空间一致-->
    <docker.registry.name>demo</docker.registry.name>
    <docker.registry.username>demo@aliyun.com</docker.registry.username>
    <docker.registry.password>password</docker.registry.password>
    <docker.registry.url>registry.cn-shenzhen.aliyuncs.com</docker.registry.url>
    <docker.tag>latest</docker.tag>
</properties>
xml

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>${spring-boot.version}</version>
    <configuration>
        <excludes>
            <exclude>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
            </exclude>
        </excludes>
        <layers>
            <enabled>true</enabled>
            <configuration>${project.basedir}/layers.xml</configuration>
        </layers>
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>
xml

<plugin>
    <groupId>io.fabric8</groupId>
    <artifactId>docker-maven-plugin</artifactId>
    <version>0.37.0</version>
    <configuration>
        <pushRegistry>${docker.registry.url}</pushRegistry>
        <authConfig>
            <username>${docker.registry.username}</username>
            <password>${docker.registry.password}</password>
        </authConfig>
        <images>
            <image>
                <name>${docker.registry.url}/${docker.registry.name}/${project.artifactId}:${docker.tag}
                </name>
                <build>
                    <dockerFileDir>${project.basedir}</dockerFileDir><!--指定 dockerFile 目录-->
                </build>
            </image>
        </images>
    </configuration>
</plugin>

layers.xml

xml

<layers xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns="http://www.springframework.org/schema/boot/layers"
        xsi:schemaLocation="http://www.springframework.org/schema/boot/layers
                          https://www.springframework.org/schema/boot/layers/layers-3.0.xsd">
    <application>
        <into layer="spring-boot-loader">
            <include>org/springframework/boot/loader/**</include>
        </into>
        <into layer="application"/>
    </application>
    <dependencies>
        <into layer="application">
            <includeModuleDependencies/>
        </into>
        <into layer="snapshot-dependencies">
            <include>*:*:*SNAPSHOT</include>
        </into>
        <into layer="dependencies"/>
    </dependencies>
    <layerOrder>
        <layer>dependencies</layer>
        <layer>spring-boot-loader</layer>
        <layer>snapshot-dependencies</layer>
        <layer>application</layer>
    </layerOrder>
</layers>
Dockerfile
# 分层构建
FROM bellsoft/liberica-openjdk-debian:17-cds as builder
# 执行工作目录
WORKDIR application
# 将编译构建得到的jar文件复制到镜像空间中
ADD target/demo-2.0.0-SNAPSHOT.jar .
# 通过工具spring-boot-jarmode-layertools从application.jar中提取拆分后的构建结果
RUN java -Djarmode=layertools -jar demo-2.0.0-SNAPSHOT.jar extract

# 正式构建镜像
FROM bellsoft/liberica-openjdk-debian:17-cds
WORKDIR application
EXPOSE 6311
# 前一阶段从jar中提取除了多个文件，这里分别执行COPY命令复制到镜像空间中，每次COPY都是一个layer
COPY --from=builder application/dependencies/ ./
COPY --from=builder application/spring-boot-loader/ ./
COPY --from=builder application/snapshot-dependencies/ ./
COPY --from=builder application/application/ ./
ENTRYPOINT ["java", "org.springframework.boot.loader.JarLauncher"]

build&push

shell
@echo off
for /f "tokens=2 delims==" %%I in ('wmic os get localdatetime /value') do set mydatetime=%%I
set mydatetime=%mydatetime:~0,8%%mydatetime:~8,4%
echo %mydatetime%
 mvn   docker:build docker:push -DskipTests=true -Ddocker.tag=%mydatetime%

docker插件 ​

该插件需要配合mvn setting.xml中配置使用,mvn 编译的时候会自动 构建上传镜像

xml

<servers>
    <server>
        <id>docker-image</id>
        <username>admin</username>
        <password>admin</password>
        <configuration>
            <email>123@qq.com</email>
        </configuration>
    </server>
</servers>
xml

<plugin>
    <groupId>com.spotify</groupId>
    <artifactId>docker-maven-plugin</artifactId>
    <version>0.4.11</version>
    <configuration>
        <imageName>dockerimage.demo.com/${project.artifactId}-${profile-name}</imageName>
        <!--suppress UnresolvedMavenProperty -->
        <imageTags>${project.version}-${timestamp}</imageTags>
        <dockerDirectory>src/main/docker</dockerDirectory>
        <serverId>docker-image</serverId>
        <useConfigFile>true</useConfigFile>
        <resources>
            <resource>
                <targetPath>/</targetPath>
                <directory>${project.build.directory}</directory>
                <include>${project.build.finalName}.jar</include>
            </resource>
        </resources>
    </configuration>
</plugin>

maven deploy ​

可以配置忽略某个模块是否上传,配合distributionManagement 使用 在maven的setting 文件中添加server配置

xml

<servers>
    <server>
        <id>maven-releases</id>
        <username>admin</username>
        <password>password</password>
    </server>
    <server>
        <id>maven-snapshots</id>
        <username>admin</username>
        <password>password</password>
    </server>
</servers>
xml

<distributionManagement>
    <repository>
        <id>maven-releases</id>
        <url>http://192.168.8.92:28081/nexus/repository/maven-releases/</url>
        <uniqueVersion>true</uniqueVersion>
    </repository>
    <snapshotRepository>
        <id>maven-snapshots</id>
        <url>http://192.168.8.92:28081/nexus/repository/maven-snapshots/</url>
    </snapshotRepository>
</distributionManagement>
xml

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-deploy-plugin</artifactId>
    <version>2.8.2</version>
    <configuration>
        <skip>true</skip>
    </configuration>
</plugin>