{"id":70,"date":"2017-03-29T16:53:12","date_gmt":"2017-03-29T08:53:12","guid":{"rendered":"http:\/\/www.jsjs.org\/?p=70"},"modified":"2017-03-29T16:53:12","modified_gmt":"2017-03-29T08:53:12","slug":"using-nexus-3-as-your-repository-part-2-npm-packages","status":"publish","type":"post","link":"https:\/\/blog.jsjs.org\/?p=70","title":{"rendered":"Using Nexus 3 as Your Repository \u2013 Part 2: Npm Packages"},"content":{"rendered":"

\"NPM\"<\/p>\n

This is the second part of a series of posts on Nexus 3 and how to use it as repository for several technologies. Also available is \u201cPart 1, Maven Artifacts\u201d<\/a> by Rafael Eyng.<\/em><\/p>\n

npm install<\/code> can take too long sometimes, so it might be a good idea to have a proxy in your own network. And if you can\u2019t just pay the 7 dollars\/month to host your packages in the official npm private registry, then you\u2019ll probably benefit from this post.<\/p>\n

Installation<\/h2>\n

Check out the first part<\/a> of this series to see how we installed and ran Nexus 3 using a single docker command. Just do that and the installation is done.<\/p>\n

Configuring Nexus as a npm repo<\/h2>\n

What we will do:
\n\u2013 create a private (hosted) repository for our own packages
\n\u2013 create a proxy repository pointing to the official registry
\n\u2013 create a group repository to provide all the above 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

private repo<\/h3>\n

A repository for npm packages that your team develops.<\/p>\n

Create a new npm (hosted) repository and configure it like:<\/p>\n

\"using<\/p>\n

The deployment policy \u201cAllow redeploy\u201d above might look somewhat polemic, so you might want to set it to \u201cDisable redeploy\u201d. In my use case, it makes sense to use \u201cAllow redeploy\u201d, since we keep a latest<\/code> version on Nexus always updated with the status of the master branch, that is redeployed in our CI flow.<\/p>\n

proxy repo<\/h3>\n

A repository that proxies everything you download from the official npm registry. Next time you download the same dependency, it will be cached in your Nexus.<\/p>\n

Create a new npm (proxy) repository and configure it like:<\/p>\n

\"using<\/p>\n

\"using<\/p>\n

group repo<\/h3>\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 npm (group) repository and configure it like:<\/p>\n

\"using<\/p>\n

You can create as many repos as you need and group them all in the group repo, but for npm I don\u2019t think that you will need more than 1 proxy and 1 private repos.<\/p>\n

Configuring your clients and projects to use your Nexus repos<\/h2>\n

For npm, we will configure the repository per project (unlike Maven, that have some global configs, for instance). I believe that you can configure the authentication globally in your machine, with npm addUser<\/code>, but I didn\u2019t went that way for simplicity.<\/p>\n

If you have a project where you only want to download<\/strong> dependencies from Nexus, create a .npmrc<\/code> file at your project\u2019s root with:<\/p>\n

\n
registry=http:\/\/your-host:8081\/repository\/npm-group\/\n_auth=YWRtaW46YWRtaW4xMjM=\n<\/code><\/pre>\n<\/div>\n
_auth=YWRtaW46YWRtaW4xMjM=<\/code> is the base64 hash for the credentials (admin\/admin123). If you use a different set of credentials, you should compute your own hash with:<\/p>\n
\n
echo -n 'myuser:mypassword' | openssl base64\n<\/code><\/pre>\n<\/div>\n
You have to set a user so you can publish packages. If you do this from your local machine, npm publish<\/code> will use your user configured in ~\/.npmrc<\/code> (in your home, not in your project). If you don\u2019t have this configuration, or if you want to publish from CI, you can set an email=any@email.com<\/code> configuration in your project\u2019s .npmrc<\/code>. Really, any email.<\/p>\n
If you have a project that you want to publish<\/strong> to your Nexus, put this in package.json<\/code>:<\/p>\n
\n
{<\/span>\n  ...<\/span>\n\n  \"publishConfig\"<\/span>:<\/span> {<\/span>\n    \"registry\"<\/span>:<\/span> \"http:\/\/your-host:8081\/repository\/npm-private\/\"<\/span>\n  }<\/span>\n}<\/span>\n<\/code><\/pre>\n<\/div>\n
Note that you publish to your private repo, but when you download, you can point to your group repo, so both your own packages and the packages from the official repo will be available from a single URL.<\/p>\n
Now if you run in your projects:<\/p>\n
\n
npm install\n# or\nnpm publish\n<\/code><\/pre>\n<\/div>\n
your npm<\/code> will point to your Nexus instance.<\/p>\n
Installing npm packages globally<\/h2>\n
Run:<\/p>\n
\n
npm --registry http:\/\/your-host:8081\/repository\/npm-group\/ install -g your-pac<\/code><\/pre>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
This is the second part of a series of posts on Nexus 3 and how to use it as repository […]<\/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-70","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=\/wp\/v2\/posts\/70","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=70"}],"version-history":[{"count":0,"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=\/wp\/v2\/posts\/70\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=70"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=70"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jsjs.org\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=70"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}