_remote.repositories文件的作用/Maven修改setting文件后本地仓库缓存了jar或pom但还是去远程仓库获取
Maven仓库中 _remote.repositories文件介绍
结论: 通过删除仓库中的_remote.repositories文件,解决由于更换仓库带来的jar包不兼容/重新下载问题
1. 结构构成:
举个栗子
#Thu Jan 24 11:42:29 CST 2019
logback-parent-1.1.1.pom>nexus-aliyun=
logback-parent-1.1.1.pom>nexus-xx=
logback-parent-1.1.1.pom>mirror-all=
这里的nexus-aliyun表示setting.xml中配置的私服id
其中
这个文件存储的是每次从私服或者中央仓库下载的jar包的信息。
该logback-parent只有pom管理,所以没有jar
第3行:表示该pom第一次从nexus-aliyun(阿里云镜像)来的
第4行:表示更换远程仓库nexus-xx(xx私服)且该私服存在该pom,那么就将该私服地址写入到_remote.repositories.
第5行:表示镜像服务器mirror-all存在该pom
只有存在该资源的镜像或私服才会将私服或镜像的id写入到_remote.repositories中
参考资料:https://www.cnblogs.com/mySummer/p/9453777.html
假设我们更换了私服地址为nexus-abc,并且该私服不存在该资源,那么就会生成logback-parent-1.1.1.pom.lastUpdated文件;
也就是说,_remote.repositories文件,标示该资源的来源,如果你有这个_remote.repositories,那就会在访问本地的同时,必须确保远程上有才行(这里的远程是setting文件中配置的镜像或远程仓库,用id来进行关联,详情见标题2._remote…),否则就会报错;
参考资料:https://blog.csdn.net/zzb5682119/article/details/89217780
错误信息大体如下:
Could not resolve dependencies for project com-hallo-mybatis:generator:jar:1.0-SNAPSHOT:
The following artifacts could not be resolved: com.tencent.tsf:spring-cloud-tsf-dependencies:pom:1.1.1-
RELEASE, com.tencent.tsf:spring-cloud-tsf-sleuth:jar:1.1.1-RELEASE, com.tencent.tsf:spring-cloud-tsf-
auth:jar:1.1.1-RELEASE: Failure to find com.tencent.tsf:spring-cloud-tsf-dependencies:pom:1.1.1-RELEASE in
<span style="color:#ab4642">http://***:8081/repository/public/ was cached in the local repository, resolution
will not be reattempted until the update interval of public has elapsed or updates are forced</span>
2._remote.*和setting文件的py关系
<mirrors>
<mirror>
<!-- * 表示我这个镜像服务器要代替所有的仓库 -->
<mirrorOf>*</mirrorOf>
<name>mirror-all</name>
<url>http://mirrors.cloud.tencent.com/nexus/repository/maven-public/</url>
<id>custom</id>
</mirror>
<repositories>
<repository>
<id>central</id>
<url>http://repo1.maven.org/maven2</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
_remote.repositories中>符号后的字符为setting文件中配置的<mirror>标签下的id,也就是镜像服务器的id(自己定义),
也可以是<repository>标签下的id,表示远程仓库的id(自己定义);具体看本地仓库的构件是从哪里下载的;
3.maven setting配置文件 tips ★
3.1 setting不配置镜像或仓库时,会自动请求apache的maven仓库
3.2 标签解读
<localRepository>
本地仓库的路径
<!-- 默认值为${user.home}/.m2/repository。 -->
windows用户请注意,默认是在C盘
<pluginGroups>
第三方插件的groupId(不常用)
例如:以下为springBoot的地址,但是为什么在idea中却不用指定该groupId也可以使用,
是因为boot的maven中指定了<goalPrefix>spring-boot</goalPrefix>命令前缀
<pluginGroups>
<pluginGroup>org.springframework.boot</pluginGroup>
</pluginGroups>
<proxies>
给maven配置代理(不常用)
<!--用来配置不同的代理,多代理profiles 可以应对笔记本或移动设备的工作环境:通过简单的设置profile id就可以很容易的更换整个代理配置。 -->
<proxies>
<!--代理元素包含配置代理时需要的信息-->
<proxy>
<!--代理的唯一定义符,用来区分不同的代理元素。-->
<id>myproxy</id>
<!--该代理是否是激活的那个。true则激活代理。当我们声明了一组代理,而某个时候只需要激活一个代理的时候,该元素就可以派上用处。 -->
<active>true</active>
<!--代理的协议。 协议://主机名:端口,分隔成离散的元素以方便配置。-->
<protocol>http</protocol>
<!--代理的主机名。协议://主机名:端口,分隔成离散的元素以方便配置。 -->
<host>proxy.somewhere.com</host>
<!--代理的端口。协议://主机名:端口,分隔成离散的元素以方便配置。 -->
<port>8080</port>
<!--代理的用户名,用户名和密码表示代理服务器认证的登录名和密码。 -->
<username>proxyuser</username>
<!--代理的密码,用户名和密码表示代理服务器认证的登录名和密码。 -->
<password>somepassword</password>
<!--不该被代理的主机名列表。该列表的分隔符由代理服务器指定;例子中使用了竖线分隔符,使用逗号分隔也很常见。-->
<nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts>
</proxy>
</proxies>
<servers>
远程仓库的配置文件(deploy构件时常用,需要配置私服的账号及密码)
<!--配置服务端的一些设置。一些设置如安全证书不应该和pom.xml一起分发。这种类型的信息应该存在于构建服务器上的settings.xml文件中。-->
<servers>
<!--服务器元素包含配置服务器时需要的信息 -->
<server>
<!--这是server的id(注意不是用户登陆的id),该id与distributionManagement中repository元素的id相匹配。-->
<id>server001</id>
<!--鉴权用户名。鉴权用户名和鉴权密码表示服务器认证所需要的登录名和密码。 -->
<username>my_login</username>
<!--鉴权密码 。鉴权用户名和鉴权密码表示服务器认证所需要的登录名和密码。密码加密功能已被添加到2.1.0 +。详情请访问密码加密页面-->
<password>my_password</password>
<!--鉴权时使用的私钥位置。和前两个元素类似,私钥位置和私钥密码指定了一个私钥的路径(默认是${user.home}/.ssh/id_dsa)以及如果需要的话,一个密语。将来passphrase和password元素可能会被提取到外部,但目前它们必须在settings.xml文件以纯文本的形式声明。 -->
<privateKey>${usr.home}/.ssh/id_dsa</privateKey>
<!--鉴权时使用的私钥密码。-->
<passphrase>some_passphrase</passphrase>
<!--文件被创建时的权限。如果在部署的时候会创建一个仓库文件或者目录,这时候就可以使用权限(permission)。这两个元素合法的值是一个三位数字,其对应了unix文件系统的权限,如664,或者775。 -->
<filePermissions>664</filePermissions>
<!--目录被创建时的权限。 -->
<directoryPermissions>775</directoryPermissions>
</server>
</servers>
<mirrors>
镜像服务器地址(常用,一般配置aliyun镜像)
可以配置多个镜像
<mirrors>
<mirror>
<!--该镜像的唯一标识符。id用来区分不同的mirror元素。且与_remote.repositories有关系 -->
<id>alimaven</id>
<!--被镜像的仓库的id。例如,要设置为<repository>中id为def的仓库的景象,就需要将该元素设置成def。表示为仓库def的镜像,注意给该仓库设置镜像后,所有的构建请求将不再请求def仓库,所以,建议不要给私服设置镜像。-->
<!-- 还有'*'表示镜像所有的仓库,'*,!def'表示镜像除def仓库外的其他所有仓库(适合def为私服时设置) -->
<mirrorOf>def</mirrorOf>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
</mirror>
...
</mirrors>
<repositories>
仓库配置(常用,id与标签mirrorOf和_remote.repositories有关,repositories标签常配置在下)
<!--远程仓库列表,它是Maven用来填充构建系统本地仓库所使用的一组远程项目。 -->
<repositories>
<!--包含需要连接到远程仓库的信息 -->
<repository>
<!--远程仓库唯一标识-->
<id>codehausSnapshots</id>
<!--远程仓库名称 -->
<name>Codehaus Snapshots</name>
<!--如何处理远程仓库里发布版本的下载-->
<releases>
<!--true或者false表示该仓库是否为下载某种类型构件(发布版,快照版)开启。 -->
<enabled>false</enabled>
<!--该元素指定更新发生的频率。Maven会比较本地POM和远程POM的时间戳。这里的选项是:always(一直),daily(默认,每日),interval:X(这里X是以分钟为单位的时间间隔),或者never(从不)。 -->
<updatePolicy>always</updatePolicy>
<!--当Maven验证构件校验文件失败时该怎么做-ignore(忽略),fail(失败),或者warn(警告)。-->
<checksumPolicy>warn</checksumPolicy>
</releases>
<!--如何处理远程仓库里快照版本的下载。有了releases和snapshots这两组配置,POM就可以在每个单独的仓库中,为每种类型的构件采取不同的策略。例如,可能有人会决定只为开发目的开启对快照版本下载的支持。参见repositories/repository/releases元素-->
<snapshots>
<enabled/><updatePolicy/><checksumPolicy/>
</snapshots>
<!--远程仓库URL,按protocol://hostname/path形式 -->
<url>http://snapshots.maven.codehaus.org/maven2</url>
<!--用于定位和排序构件的仓库布局类型-可以是default(默认)或者legacy(遗留)。Maven 2为其仓库提供了一个默认的布局;然而,Maven 1.x有一种不同的布局。我们可以使用该元素指定布局是default(默认)还是legacy(遗留)。 -->
<layout>default</layout>
</repository>
</repositories>
<!--发现插件的远程仓库列表。仓库是两种主要构件的家。第一种构件被用作其它构件的依赖。这是中央仓库中存储的大部分构件类型。另外一种构件类型是插件。Maven插件是一种特殊类型的构件。由于这个原因,插件仓库独立于其它仓库。pluginRepositories元素的结构和repositories元素的结构类似。每个pluginRepository元素指定一个Maven可以用来寻找新插件的远程地址。-->
<pluginRepositories>
<!--包含需要连接到远程插件仓库的信息.参见profiles/profile/repositories/repository元素的说明-->
<pluginRepository>
<releases>
<enabled/><updatePolicy/><checksumPolicy/>
</releases>
<snapshots>
<enabled/><updatePolicy/><checksumPolicy/>
</snapshots>
<id/><name/><url/><layout/>
\</pluginRepository>
</pluginRepositories>
<profiles>
配置不同的profiles,使setting.xml配置和pom.xml进行联动
(在idea mavenProjects边栏中的profiles会出现这里设置的profiles的id,如下面的test,当被选中时它的值会覆盖任何其它定义在POM中或者profile.xml中的带有相同id的profile,通常配置在标签下)
<!--根据环境参数来调整构建配置的列表。settings.xml中的profile元素是pom.xml中profile元素的裁剪版本。它包含了id,activation, repositories, pluginRepositories和 properties元素。这里的profile元素只包含这五个子元素是因为这里只关心构建系统这个整体(这正是settings.xml文件的角色定位),而非单独的项目对象模型设置。如果一个settings中的profile被激活,它的值会覆盖任何其它定义在POM中或者profile.xml中的带有相同id的profile。 -->
<profiles>
<!--根据环境参数来调整的构件的配置-->
<profile>
<!--该配置的唯一标识符。 -->
<id>test</id>
<activeProfiles>
使配置的profiles手动生效(注意,如果这里不启用某一个profile的话,profile下的repositories将不会生效,默认仓库还是apache的默认仓库;另:这里设置的activeProfile会与pom.xml设置的profile产生联动,相同的id会被激活)
<activeProfiles>
<activeProfile>nexus</activeProfile>
<activeProfile>qcloud-repo</activeProfile>
<activeProfile>prd</activeProfile> <!-- prd的profile在项目的pom.xml中定义 -->
</activeProfiles>
<!--手动激活profiles的列表,按照profile被应用的顺序定义activeProfile。 该元素包含了一组activeProfile元素,每个activeProfile都含有一个profile id。任何在activeProfile中定义的profile id,不论环境设置如何,其对应的
profile都会被激活。如果没有匹配的profile,则什么都不会发生。例如,env-test是一个activeProfile,则在pom.xml(或者profile.xml)中对应id的profile会被激活。如果运行过程中找不到这样一个profile,Maven则会像往常一样运行。 -->
<activeProfiles>
<activeProfile>env-test</activeProfile>
<activeProfile>test</activeProfile>
</activeProfiles>
</settings>
pom.xml配置构件发布
使用<distributionManagement>
配置发布的私服地址及id
例:
*pom.xml*
<distributionManagement>
<!-- 正式版发布仓库 -->
<repository>
<!-- 这里的id要求配置用户名及密码,在setting.xml中进行配置,通过id进行关联 -->
<id>nexus-server@public</id>
<url>http://ip:8081/repository/maven-releases</url>
</repository>
<!-- 快照版发布仓库 -->
<snapshotRepository>
<id>nexus-server@public-snapshots</id>
<url>http://ip:8081/repository/maven-snapshots</url>
</snapshotRepository>
</distributionManagement>
*setting.xml*
<servers>
<server>
<id>nexus-server@public</id>
<username>admin</username>
<password>admin</password>
</server>
<server>
<id>nexus-server@public-snapshots</id>
<username>admin</username>
<password>admin</password>
</server>
更多关于标签的知识详见Maven系列二setting.xml 配置详解
本文只是对maven使用过程中的一点记录
耳鸣了一天,脑袋瓜子嗡嗡的
更多推荐
所有评论(0)