Maven倉庫的搭建
1. 倉庫選型
這里經過了解,好像沒有什么其他的選擇,Nexus
就是一個不二之選,網上的帖子區別也就是在于是nexus2還是nexus3,這里鑒于nexus3的顏值較好,就選擇了nexus3。
兩者一個有趣的區別在于,文件的存儲方式不同,nexus2對上傳的文件直接存放的是源文件,而nexus3則是存放的blob文件,以一種二進制的大對象將數據存儲了起來。這就導致,在2上可以直接將maven倉庫C&V過去,但是在3上沒法這么干。
首先下載nexus安裝包:
tar -zxvf nexus-3.*.tar.gz
## 之后進入nexus-3.28.0-01/bin??
./nexus start
## 啟動后默認端口為8081
## 用戶admin,密碼需要在sonatype-work中獲取
## 當然,啟動端口可以進行修改,在sonatype-work/nexus3/etc中找到相應的配置文件進行修改,之后重啟
2. 進行倉庫配置
首先,nexus倉庫中有三種類型,為hosted,proxy和group,下面對三種分別描述:
- hosted :主機模式,相當于使用本地的maven倉庫
- proxy :代理模式,可以設定一個在線倉庫進行Jar包的下載更新,更新之后的Jar包會存儲在本地Maven倉庫,hosted倉庫中可以檢索到
- group :組合模式,可以把設定的倉庫repositories進行組合,統一提供服務。
這里可以將maven-central設置如下:
查看maven-public提供服務的路徑
之后就可以像使用阿里的maven鏡像一樣設置好settings.xml中的mirrors,或者修改repository的設置:
<repositories>
<repository>
<id>nexus</id>
<layout>default</layout>
<url>http://localhost:30203/repository/maven-public/</url>
<releases>
<enabled>true</enabled>
</releases>
</repository>
</repositories>
settings.xml文件的完整描述
詳見: Setting.xml文件詳解
上面有一個概念比較有意思,一個是mirror,一個是repository,一個叫鏡像,一個叫倉庫,都是為用戶下載jar包而指定的,兩者有什么差別呢?
簡言之[1],mirror就是repository的一個鏡像,相當于在用戶和倉庫之間做了個轉發,將用戶對A倉庫的請求,轉發到對B鏡像倉庫的請求上。
POM文件的完整描述
詳見:POM文件詳述
目前可以關注一下distributionManagement,因為后面向nexus倉庫中上傳當前項目的Jar包時,需要指定該屬性
3. Maven中的幾種命令的意義[2]
其中涉及到了Maven的生命周期和一個常用的插件maven-dependency-plugin。
3.1 Maven的生命周期【TODO】
3.2 上傳項目生成的Jar包
這里主要用到了mvn deploy的命令,需要預先設定好POM中的distributionManagement
,其中的id應該與setting文件中的<server/>
節點做好對應,方便進行用戶&密碼的讀取。
<distributionManagement>
<!-- 部署項目產生的構件到遠程倉庫需要的信息 -->
<repository>
<!-- 是分配給快照一個唯一的版本號(由時間戳和構建流水號)?還是每次都使用相同的版本號?參見
repositories/repository元素 -->
<uniqueVersion />
<id> banseon-maven2 </id>
<name> banseon maven2 </name>
<url> file://${basedir}/target/deploy
</url>
<layout></layout>
</repository>
<!-- 構件的快照部署到哪里?如果沒有配置該元素,默認部署到repository元素配置的倉庫,參見
distributionManagement/repository元素 -->
<snapshotRepository>
<uniqueVersion />
<id> banseon-maven2 </id>
<name> Banseon-maven2 Snapshot Repository
</name>
<url> scp://svn.baidu.com/banseon:/usr/local/maven-snapshot
</url>
<layout></layout>
</snapshotRepository>
</distributionManagement>
之后運行mvn deploy即可
idea中出現如下日志,即為上傳成功
之后查看nexus,成功在snasnapshot庫中加入該jar包
2. docker倉庫的搭建
1. 倉庫的選型
倉庫無外乎就是docker中官方推薦的registry和Harbor,Nexus。網上有人沉迷于Harbor方便的給鏡像分包歸置的功能,但是又希望融合在線鏡像,所以選擇了Nexus代理在線鏡像。比較冗余了,個人認為直接選Nexus就可以滿足一般的需求,這里還是選擇Nexus。
2. 倉庫的配置
與maven倉庫類似,創建proxy類型的docker倉庫代理阿里上的docker鏡像,同時創建hosted類型的docker倉庫用于存儲下載或者上傳的docker鏡像,之后創建group類型,用于統一管理proxy和hosted兩種倉庫。
這里設置releases的端口和pulic的端口,分別作為上傳和下載的端口。
之后需要進行安全設置
【另可參見】:docker下的nexus搭建[3]
3. 上傳本地docker中的images
以上傳java:8的鏡像為例,步驟如下:
graph LR
id1(修改images的Tag)-->id2(docker push)
id2-->id3{是否上傳成功}
id3--成功-->id4[end]
id3-.失敗.->id5((圓形))
id5-->id6(進行登錄后上傳)
之后可以在Nexus中看到該鏡像
為了驗證pulic可以為外部提供鏡像下載的功能,這里將鏡像倉庫地址配置到docker的daemon.json中。
docker pull 127.0.0.1:30205/java:8
# 可以正常下載
4. 制作項目的docker鏡像
這里有兩種方式:
graph LR
已有項目-->id1(打包package)
subgraph 打包
id1-->打成jar包-->制作基于jre的Dockerfile-->id2
id1-->打成war包-->制作基于tomcat的Dockerfile-->id2
id2(手動生成鏡像)
end
subgraph 通過插件
id1-->借助docker-maven-plugin-->在package之后自動封裝鏡像
end
這里采用插件
的方案:
1.在pom中定義image
首先在父pom中引入該插件, 之后在其中進行配置,主要需要配置docker的連接和相關的證書,以及dockerhub的連接和相關用戶密碼。
<profiles>
<profile>
<id>build-jar-docker</id>
<activation>
<!-- 這里默認構建-->
<!-- <activeByDefault>true</activeByDefault>-->
<!-- 當pom中包含這個鍵值對時啟用該配置-->
<property>
<name>build.method</name>
<value>jar-docker</value>
</property>
</activation>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>2.4.1</version>
</plugin>
<plugin>
<groupId>com.spotify</groupId>
<artifactId>docker-maven-plugin</artifactId>
<version>1.1.0</version>
<!--相關的配置-->
<configuration>
<!--構建的鏡像的名字-->
<imageName>${project.artifactId}</imageName>
<imageTags>
<!--構建的鏡像的tag,可以設置多個, 但是push的時候,會有一些報錯,建議設置一個-->
<imageTag>${project.version}</imageTag>
</imageTags>
<!--使用的基礎鏡像,類似于FROM ...-->
<baseImage>java:8-jre-alpine</baseImage>
<!--docker的地址和相關證書-->
<dockerHost>${docker.host}</dockerHost>
<dockerCertPath>E:\\Docker\\Docker\\ca</dockerCertPath>
<resources>
<resource>
<!--放在容器的位置-->
<targetPath>/</targetPath>
<!--需要移動的資源的位置-->
<directory>${project.build.directory}</directory>
<include>${project.build.finalName}.jar</include>
</resource>
</resources>
<!--運行容器時,啟動jar包-->
<entryPoint>["java","-jar","/${project.build.finalName}.jar"]</entryPoint>
<!--是否強制覆蓋tag-->
<forceTags>true</forceTags>
<!--調用setting中設定好的server中的用戶密碼-->
<serverId>nexus</serverId>
<!--dockerHub的位置,注意不要帶http://,否則push會報錯-->
<registryUrl>${dockerhub.host}</registryUrl>
</configuration>
<executions>
<execution>
<id>build-image</id>
<!--對應maven中的一個生命階段-->
<phase>package</phase>
<!--對應docker中的操作-->
<goals>
<goal>build</goal>
</goals>
</execution>
<execution>
<id>tag-image</id>
<phase>package</phase>
<goals>
<goal>tag</goal>
</goals>
<configuration>
<image>${project.artifactId}:${project.version}</image>
<newName>${dockerhub.host}/${project.artifactId}:${project.version}</newName>
</configuration>
</execution>
<execution>
<id>push-image</id>
<phase>deploy</phase>
<goals>
<goal>push</goal>
</goals>
<configuration>
<imageName>${dockerhub.host}/${project.artifactId}:${project.version}</imageName>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</profile>
</profiles>
在子pom中通過屬性進行啟用
<properties>
<build.method>jar-docker</build.method>
</properties>
2. 在Dockerfile中定義image??
其實還可以通過在目錄下定義Dockerfile來個性化的定制。
<profile>
<id>build-jar-dockerfile</id>
<activation>
<!-- 這里默認構建-->
<!-- <activeByDefault>true</activeByDefault>-->
<!-- 當pom中包含這個鍵值對時啟用該配置-->
<!-- <property>-->
<!-- <name>build.method</name>-->
<!-- <value>jdk-dockerfile</value>-->
<!-- </property>-->
<!--這里通過判斷是否存在這個文件來決定是否啟用-->
<file>
<exists>Dockerfile</exists>
</file>
</activation>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>2.4.1</version>
</plugin>
<plugin>
<groupId>com.spotify</groupId>
<artifactId>docker-maven-plugin</artifactId>
<version>1.1.0</version>
<!--相關的配置-->
<configuration>
<!--構建的鏡像的名字-->
<imageName>${project.artifactId}</imageName>
<imageTags>
<!--構建的鏡像的tag,可以設置多個, 但是push的時候,會有一些報錯,建議設置一個-->
<imageTag>${project.version}</imageTag>
</imageTags>
<!--Dockerfile-->
<dockerDirectory>${project.basedir}</dockerDirectory>
<!--用于將構造的jar的文件名傳入Dockerfile-->
<buildArgs>
<Jar_File>${project.build.finalName}.jar</Jar_File>
</buildArgs>
<!--docker的地址和相關證書-->
<dockerHost>${docker.host}</dockerHost>
<dockerCertPath>E:\\Docker\\Docker\\ca</dockerCertPath>
<resources>
<resource>
<!--放在容器的位置-->
<targetPath>/</targetPath>
<!--需要移動的資源的位置-->
<directory>${project.build.directory}</directory>
<include>${project.build.finalName}.jar</include>
</resource>
</resources>
<!--調用setting中設定好的server中的用戶密碼-->
<serverId>nexus</serverId>
<!--dockerHub的位置,注意不要帶http://,否則push會報錯-->
<registryUrl>${dockerhub.host}</registryUrl>
</configuration>
<executions>
<execution>
<id>build-image</id>
<!--對應maven中的一個生命階段-->
<phase>package</phase>
<!--對應docker中的操作-->
<goals>
<goal>build</goal>
</goals>
</execution>
<execution>
<id>tag-image</id>
<phase>package</phase>
<goals>
<goal>tag</goal>
</goals>
<configuration>
<image>${project.artifactId}:${project.version}</image>
<newName>${dockerhub.host}/${project.artifactId}:${project.version}</newName>
</configuration>
</execution>
<execution>
<id>push-image</id>
<phase>deploy</phase>
<goals>
<goal>push</goal>
</goals>
<configuration>
<imageName>${dockerhub.host}/${project.artifactId}:${project.version}</imageName>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</profile>
對應的Dockerfile定義為:
FROM java:8-jre-alpine
ARG Jar_File
ADD ${Jar_File} /app.jar
ENTRYPOINT ["java","-jar","-Dserver.port=8080","/app.jar"]
EXPOSE 8080
至于構造war包的鏡像配置,這里留個坑??
5. 上傳項目的docker鏡像
配置同樣在上面,已經將push方法綁定到了deploy方法上了,在上傳jar包的時候,同時也會上傳image鏡像。
-
詳見:mirror和repository的區別 https://www.cnblogs.com/bollen/p/7143551.html ?
-
基于docker 安裝 nexus: http://www.lxweimin.com/p/86e573f18df3?from=singlemessage ?