{"id":68,"date":"2017-03-29T16:52:34","date_gmt":"2017-03-29T08:52:34","guid":{"rendered":"http:\/\/www.jsjs.org\/?p=68"},"modified":"2017-03-29T16:52:34","modified_gmt":"2017-03-29T08:52:34","slug":"using-nexus-3-as-your-repository-part-1-maven-artifacts","status":"publish","type":"post","link":"https:\/\/blog.jsjs.org\/?p=68","title":{"rendered":"Using Nexus 3 as Your Repository \u2013 Part 1: Maven Artifacts"},"content":{"rendered":"

This article is the first in a three part series by one of our community advocates, Rafael Eyng. You can follow his work at CodeHeaven.io<\/a><\/em><\/p>\n

Installation<\/h1>\n

Install it with docker:<\/p>\n

\n
docker run -d -p 8081:8081 -p 8082:8082 -p 8083:8083 --name my-nexus sonatype\/nexus3:3.0.0\n<\/code><\/pre>\n<\/div>\n
We are mapping all of those ports (8081-8083) because of the next posts in the series. For this post, we\u2019ll actually only need port 8081.<\/small><\/p>\n
Nexus 3 will go up on port 8081. Default credentials are admin\/admin123.<\/p>\n
You might want to create a volume to map the Nexus data folder to your host, adding the option -v \/opt\/my-nexus-data:\/nexus-data<\/code>.<\/p>\n
Configuring Nexus as a Maven repo<\/h1>\n
What we will do:
\n\u2013 create a private (hosted) repository for our snapshots
\n\u2013 create a private (hosted) repository for our releases
\n\u2013 create a proxy repository pointing to Maven Central
\n\u2013 create a group repository to provide all of these repos under a single URL<\/p>\n
I suggest you to create a new blob store for each new repo you want to create. That way, the data for every repo will be in a different folder in \/nexus-data<\/code> (inside the Docker container). But this is not mandatory for it to work.<\/p>\n
snapshots repo<\/h2>\n
A repository for Maven artifacts that you deploy with<\/strong> -SNAPSHOT<\/code> in the end of the version tag of your pom.xml:<\/p>\n
\n
<version>1.0.0-SNAPSHOT<\/version>\n<\/code><\/pre>\n<\/div>\n
Create a new maven (hosted) repository and configure it like:<\/p>\n
\"using<\/a><\/p>\n
releases repo<\/h2>\n
A repository for Maven artifact that you deploy without<\/strong> -SNAPSHOT<\/code> in the end of the version tag of your pom.xml:<\/p>\n
\n
<version>1.0.0<\/version>\n<\/code><\/pre>\n<\/div>\n
Create a new maven (hosted) repository and configure it like:<\/p>\n
\"using<\/p>\n
proxy to Maven Central repo<\/h2>\n
A repository that proxies everything you download from Maven Central. Next time you download the same dependency, it will be cached in your Nexus.<\/p>\n
Create a new maven (proxy) repository and configure it like:<\/p>\n
\"using<\/p>\n
\"using<\/p>\n
group repo<\/h2>\n
This will group all the above repos and provide you a single URL to configure your clients to download from\/deploy to.<\/p>\n
Create a new maven (group) repository and configure it like:<\/p>\n
\"using<\/p>\n
You can create as many repos as you need (like proxies to other public repos) and group them all in the group repo.<\/p>\n
Configuring your clients and projects to use your Nexus repos<\/h1>\n
Put this in your ~\/.m2\/settings.xml<\/code> file. This will configure the credentials to publish to your hosted repos, and will tell your mvn<\/code> to use your repo as a mirror of central:<\/p>\n
\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?><\/span>\n<settings<\/span> xmlns=<\/span>\"http:\/\/maven.apache.org\/SETTINGS\/1.1.0\"<\/span>\n  xmlns:xsi=<\/span>\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"<\/span>\n  xsi:schemaLocation=<\/span>\"http:\/\/maven.apache.org\/SETTINGS\/1.1.0 http:\/\/maven.apache.org\/xsd\/settings-1.1.0.xsd\"<\/span>><\/span>\n\n  <servers><\/span>\n    <server><\/span>\n      <id><\/span>nexus-snapshots<\/id><\/span>\n      <username><\/span>admin<\/username><\/span>\n      <password><\/span>admin123<\/password><\/span>\n    <\/server><\/span>\n    <server><\/span>\n      <id><\/span>nexus-releases<\/id><\/span>\n      <username><\/span>admin<\/username><\/span>\n      <password><\/span>admin123<\/password><\/span>\n    <\/server><\/span>\n  <\/servers><\/span>\n\n  <mirrors><\/span>\n    <mirror><\/span>\n      <id><\/span>central<\/id><\/span>\n      <name><\/span>central<\/name><\/span>\n      <url><\/span>http:\/\/your-host:8081\/repository\/maven-group\/<\/url><\/span>\n      <mirrorOf><\/span>*<\/mirrorOf><\/span>\n    <\/mirror><\/span>\n  <\/mirrors><\/span>\n\n<\/settings><\/span>\n<\/code><\/pre>\n<\/div>\n
And now configure your projects.<\/p>\n
If you want only to download dependencies from Nexus, put this in the pom.xml<\/code>:<\/p>\n
\n
<project ...>\n\n  ...\n\n  <repositories>\n    <repository>\n      <id>maven-group<\/id>\n      <url>http:\/\/your-host:8081\/repository\/maven-group\/<\/url>\n    <\/repository>\n  <\/repositories>\n<\/project>\n<\/code><\/pre>\n<\/div>\n
And if you want also to publish your project, add:<\/p>\n
\n
<project ...>\n\n  ...\n\n  <distributionManagement>\n    <snapshotRepository>\n      <id>nexus-snapshots<\/id>\n      <url>http:\/\/your-host:8081\/repository\/maven-snapshots\/<\/url>\n    <\/snapshotRepository>\n    <repository>\n      <id>nexus-releases<\/id>\n      <url>http:\/\/your-host:8081\/repository\/maven-releases\/<\/url>\n    <\/repository>\n  <\/distributionManagement>\n<\/project>\n<\/code><\/pre>\n<\/div>\n
Now if you run in your projects:<\/p>\n
\n
mvn install\n# or\nmvn deploy\n<\/code><\/pre>\n<\/div>\n
your mvn<\/code> will point to your Nexus instance.<\/p>\n","protected":false},"excerpt":{"rendered":"
This article is the first in a three part series by one of our community advocates, Rafael Eyng. You can […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[1],"tags":[],"class_list":["post-68","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=\/wp\/v2\/posts\/68","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=68"}],"version-history":[{"count":0,"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=\/wp\/v2\/posts\/68\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=68"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=68"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=68"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}