neus资源库使用手册

RepoatDry rargets LDAP Conflfl.rfitiCrijdmln I Los Ou ScfKaM himjiOiMin Ecur-s*/na-： 1 I;Views/Repo&it o-rie 5nexus 资源库使用手册作者：魏玮本文主要描述的是如何在使用 nexus 进行类库的管理，以及权限的管理安装配置在hudson项目持续集成操作指南中有详细描述，这里就不赘述了。 已搭建好的仓库地址：http:/192.168.22.253/nexus/类库查询言 Sonatype再浏览器地址栏输入http:/192.168.22.253/nexus/直接看到的就是类库搜索页面，支持 关键词搜索，任何人都可以通过界面查询。如果知道要查找的类库属于哪个仓库(Repository)，可以点击页面左侧的Kepositori es System Feeds点击Repositories会显示所有可用的仓库，选择某1个仓库进行搜索，浏览3rd partf1hextdma s-n2R-?hBS?In 5ericchttp J/1&2.1Sa.22! SSnexLUicDntenW-q: nsitnr.Apa zh = Snap sb atsproxfF .1 e-n2Snanshain 5er-;iceHHp:l/1ffi.16a.22L25rEXjs/ixint-rlA-epDsa：Dr.Csnlral U1 sbfldow/irtunlna en1RsteascIn Seiwicshtlp V192.1.2? 25$!nexuE/Entent也 h nd ow.C nd chaus- Snapshuisjrmyna cnS戲巾曲h朮In E&iwic; - Rcnolff Aulcmatica EthtlpSnexucontcntfrcf： nsfcnr.Gocgfe Cedeprmy en2In Seiyicshtlp 出尼 1鹽.2? 25眇阴BEntcntbsp eshr.3rd partyBravje Stcsrag eBravse: ndewCanfiqjratinn MrrorsSimanarnfect Unload |空 Refresh Pa:h Lzck.p:P3rd pHfty1Ld Cl! .retflid O aGtivation Qactiveia习，二| Ol a.ctPi5D-aans-lncubfli?rLd O actiYienx:每个仓库有多个个选项卡Browse Storage：浏览、搜索Browse Index：浏览索引（一般不用管） Configuration：对于仓库的基本配置Reositorf rlamePravderFormatR-apositoryPolQDeult Laczl Staraae Locaten这里只能修改name，仓库权限（release发布版本snapshot快照版本）基本不改 其它选项会在添加仓库的步骤中讲到。Mirrors：镜像服务器，用于该仓库正常访问时备份服务器（一般不用管）Summery：该资源仓库的摘要（一般不用管）Artifact Upload：将类库上传到仓库中（重要）类库上传步骤说明Select GAV Deftnitlan MuiirmGAVDefiiccn： Setect.* 尊Sdect ? source For thr G ctfipiitfcjF GW ccin be pedfcd e ther nrrudl cr 斤or o POM file. Tliese settrgs 洵| tcto 別 日咄命匚匕Epe-rfied首先需要选择上传的类库的定义方式，有2 种一般选择From POMGAV Parameters一般情况用 GAV Parameters 上传时填写参数表单，如果自定义了 POM 文件可以用第一种 这里着重说 GAV Parameters 方式选择 “GAV Parameters”GAV Definti口 n:GAV-ut口 Bueee:Grcup:Artrfsct:Vertioii：Pm 匚 kaging:Seleijt.auhts Fec: isecpredGroup：组id,就是要填写这个类库的groupid该groupid自动生成的该类库的pom文件 中，同时也会作为存储这个类库的第1 级目录名称； 一般情况直接使用jar的名称即可（不包含版本号）1）例asm.jar， 那么 groupid 填写 asm 即可1）但是有一些类库是由一组相关的jar功能组成的 例：commons-io.jar commons-lang.jar commons-logging.jar都是apache common组件，因此他们的group需要定义成一致的 比口group都填写成：commonsPs: 不要使用汉语拼音.2 Artifact:上传的类库的标识，一般也直接使用jar文件的名称即可（不包含版本号） 例：ojdbcl4.jar 其 Art fact 就填写 ojdbc14 即可3 Version: 类库版本，需要填写这个类库的准确版本4 Packaging:选择上传的文件类型，照实选择即可，多为jar填写完后，就是选择要上传的文件，没啥可说delect Artifact（）far UploadSEtci ArtfiSctJsJ tn UptdmPlena me:匚:rak 已 DBth ycactusa nt-12 jarCassrer:Evenson:Acd ArtfactArttfacUREHio/e自 C:fakep fl：hc9l-5.2pr G：jarRerrae Al就会把文件插入带上传列表中，可以添加多个文件统一上传，不过考虑到性能消耗，不要一次添加过多文件，一般不要超过 20 个。每选择一个文件后，点击添加完毕后，点击页面下方的的上传按钮即可。类库管理规范1 为了统一标准，最大限度避免重复上传，第3 方类库（公共类裤脚）上传权限统一控 制，nexus原则上由测试部负责控制（admin权限、deploy权限）2 在确定当前所需要的类库在资源仓库中不存在，或者版本缺少的情况下（务必确认） ，可 以提供一份类库清单以及类库文件，发给测试部的接口人，由测试部进行备案，并进行 上传工作（需要发布者权限delopment）,在上传前需要再次确认仓库中并没有存在相同 的类库（测试部负责）。类库清单文件格式： commons commons-io1.2commons commons-utilfinal concurrentconcurrent 1.3.4其中 groupId、artifactId、version 就分别对应了上传时要填写Group, Artifact,Version，该文件的格式与maven的依赖关系一致，在整理依赖关系时就 可以直接得出这个清单，不会造成重复劳动重要事项：对于仓库中不存在的类库，可以按照我们的规则自行指定； 如果仓库中已存在该类库其他版本，则需要上传的类库的 groupId、artifactId 必须与已上 传的资源保持一致；如果要上传类库在仓库中并不存在，但是属于 1 个组件的一部分，并且其他组成部分已经上传 到仓库中，那么上传时，需要保持与仓库中已上传的其他部分保持相同的 groupid总结：除非太离谱的情况，否则务必要保证与已存在的资源保持一致性，哪怕错大家也要起错，对于依赖资源，保持一致性非常重要，出了问题也方便统一处理。对上传类库与已存在的资源一致性检查也需要测试部负责3 类库所有查询，下载权限公开，可以匿名访问4 每个部门都有自己的内部项目，这些内部项目也可以通过nexus进行版本仓库管理，因此如果部门有需求，可以申请开通部门内部项目的仓库，一般包括发布版本(Release) 与快照版本(Snapshot%种版本的仓库(快照版本、发布版本的定义与应用请参看 hudson 项目持续集成操作指南)a) 这个管理权限可以放开给各部门(每个部门开通单个账号)；b) 建立仓库、开通权限的工作需要由测试部统一控制，备案；c) 类库管理方式与第 3 方类库保持一致。建立仓库、开通权限的步骤在下面详细说明添加新的仓库如何添加发布版本、快照版本的仓库呢？首先必须用仓库管理员的身份登录，这时点击右侧氓工时，除了显示仓库列表外, 还会出现操作选项弓R已卄亡曲 Add. Delete Trash.尸 User Managed Repositories Hs网mitory 厶_ypeFormatPo licyRpositor)f StatusPub-lie： Reposito-rie-sgroupiriavn2?rd partyhost&dmavenSRElEaseIn ServiceHpach Sna；3hct3maven?SnapshotIn ServiceCentral M1 shadowvirtualma.e- r 1Rlea seIn SerYiceCodehaus Snapshotsppxymawen2SnapshotIn Ser/ice- 口snnots AutomaticalGttcgle CodsprtSKyReleaseIn Service点击Add即可进入添加仓库的界面Add. r 口亡1已亡 总THosted kepositcry:roxy Repository讪tunl Repository-Repository Group)一般选择第 1 个 Hosted Repository然后填上写仓库的详细信息Repository ID：仓库 ID,发布版本的仓库：部门标示-release快照版本版本的仓库：部门标示-snapshotRepository Name:仓库名称，照实填写即可，与ID 一样也可以Provider： Maven2 即可,暂时不会升级Repository Policy：如果是发布版本就选” Release” 如果是快照版本就选” Snapshot”192.168.22.253 上的目录地址Override Local Storage Location： E:nexus-workstorage（与 Repository ID 相同的目录,会自动 创建目录）添加后的仓库会在Repository列表中显示出来，可以删除，或上传类库，仓库中维护类库的 流程与前面说的一致。我们创建mmt-release、mmt-snapshot2个仓库，为了后面设置权限，以及方便管理，我们还 需要创建一个仓库组包含着2个仓库 Add. r 口亡1已亡 鬥THosted depositoryProxy RepositoryVirtual RepositoryRepository Group还是 Add 这次选择 Repository GroupGroup ID：仓库组ID使用部门标示-repositoryGroup Name:仓库组如实填写，与仓库组ID保持一致也可Provider： maven2 即可Pulish URL： True最后重要的是要把组包含的仓库加入到列表中，我们选择 mmt-release、mmt-snapshot 添加 到组中。管理权限创建各部门内部仓库管理员账号 仓库管理员身份登录点开左侧 SecurityChange FassvordUsersRolesPrivilegesRepository TargetsLDAP C onfigiiration添加该部门仓库管理员的权限组该管理员权限限制只能管理本部门的仓库例：我们建立了 mmt-release、mmt-snapshot 的仓库那么mmt开发部的仓库管理员只能有权限维护管理mmt-release、mmt-snapshot这2个仓库 点击Privilages，出现添加权限页面-Refresh Add.Name T User l-iaragecType-argstNs-.； Repcs itcry_3rg=t PrivilsgsFtepcstory Target3rd part/-view怕辰：R-pository ViewAdministrator privilsgs ALL/falss-ApplicationAll l1 Rsposito riss - : creais-falss-R.epcsitcry TargetAll CM a-, er 1；All l1 Rspo site ri&s - deletefalse-R.epcs.itory TargetAll CMa-.er 1All l1 Rsp o site riss -: rea d;falss-R-positonf Tare stAll rL1asr1点击 AddNew Repos-itory Target PrivilegeName:权限组名称使用 仓库id-privilege 例：刚才我们创建了 mmt-release、mmt-snapshot 因此分别添加这2 个仓库的权限Description：权限描述，如是填写即可（中文支持不太好，最好用英文）Repository :要创建权限的仓库，新建的仓库只需要创建1次,Repository Target： 一般选择 Maven2 即可点击save后会执行创建，创建完成后在权限列表中可以看到Naire *user F/anageuTynelarfetFepositoriwiven cefErai -isiseK&osrtoiy viev/irmt-rglsa ss-p rivilegs - (createirueRsgository TargetAll (Mavert2)nimt-rgfeasgmmt-relea se-c rivitege -(delete)frueRetiositon/TargetAll P-1 aven?)mmt-reteas.emmt-rslsa ss-p rivilegs - (rea d)IrusReosrtory TargetAll(r.1an2)mmt-rsbaseirmt-relsa s&-p rivilegs - (updateirueRepository TargetAll (MavertZ)nimt-r&teasemmt-retease - (view)falseRepository Viewmrnt-snnpsho:-prifiltge- (dimIs)lius艮印 osiEiy TargetAll(r.1an2)mnil-snapEhoiirmt-snapsho:-privilege- (delate：trueRepository TargetAll (Maven2)mmt-snapsholirmt-snapshol-privileQS- fr&ad)irueRsgository TargetAll (Mavert2)nunt-snapshoinnmt-sn3psho:-privilegs- (upcats)trueRepository TargetAll (Mnvert2)mmt-snapshaiPS：列表是按照字母顺序排序的添加仓库管理员角色SecurityChange FassvuordUsersRalesPrivilegesRepository TargetsLDAP Configuration点击Roles出现角色管理页面-RefreshAdd,.,T Delet亡Nexus RoleImDs-scriptionUl; Role AcEwternsl Role MappingusChes acc&25 tc the- Rcle- AdmirIJI: RoLiting AdministrationNexusCiiea access tc tbs- Routing HUh chedulecl Task Administration NexusIJI: SearchN exusUh -Senrer AdministrationNUh System Fee-cisFJexusCSves access tc the Schtdule-dGh ea access tc tbs Search sciChes tc th? Server AdiGkes access tc tbs System Fe点击 Add 选择 Nexus RoleNew Nexus RoleRole Idnniz-deploYnienT-Role0Namenniz-deploYnienT-Rolel|GDes criptionFint仓库笞理员Role Id：角色ID命名为 部门标示-deployment-RoleName:与Role Id保持一致即可Description：如实填写即可（中文支持不太好，最好用英文）选择权限Selected Roles / PrivilegesAvaHable Roles / PrivUeges冒 mnt-n&lE-a-se - (vie-wLug (read.：冒 mnt-nelMSS-trirfcflj- :i rrmc-c ea loongnt-Ralg Pl Nexus Depbynrert cie赋完权限后保存，然后就可以用刚创建的mmt-deployment用户登录。在 maven 中添加仓库配置在nesxus中创建仓库，还需要在maven中配置，这样通过maven构建时才能从这个仓库中 搜索类库