From 625f529fe9d6ce2364b811ffca904fe9876a0050 Mon Sep 17 00:00:00 2001 From: Juan Picado Date: Sun, 11 Jul 2021 18:39:26 +0200 Subject: [PATCH] New Crowdin updates (#2325) * docs(website): new translation for puppet.md in Filipino * docs(website): new translation for puppet.md in Serbian (Latin) * docs(website): new translation for puppet.md in Tajik * docs(website): new translation for puppet.md in Yoruba * docs(website): new translation for repositories.md in Romanian * docs(website): new translation for repositories.md in Spanish * docs(website): new translation for repositories.md in Chinese Traditional * docs(website): new translation for repositories.md in Arabic * docs(website): new translation for repositories.md in Czech * docs(website): new translation for repositories.md in German * docs(website): new translation for repositories.md in Italian * docs(website): new translation for repositories.md in Japanese * docs(website): new translation for repositories.md in Korean * docs(website): new translation for repositories.md in Polish * docs(website): new translation for repositories.md in Portuguese * docs(website): new translation for repositories.md in Russian * docs(website): new translation for repositories.md in Serbian (Cyrillic) * docs(website): new translation for repositories.md in Chinese Simplified * docs(website): new translation for reverse-proxy.md in Hindi * docs(website): new translation for reverse-proxy.md in Serbian (Latin) * docs(website): new translation for puppet.md in Russian * docs(website): new translation for server.md in Chinese Traditional * docs(website): new translation for server.md in Czech * docs(website): new translation for server.md in German * docs(website): new translation for server.md in Italian * docs(website): new translation for server.md in Japanese * docs(website): new translation for server.md in Korean * docs(website): new translation for server.md in Polish * docs(website): new translation for server.md in Portuguese * docs(website): new translation for server.md in Russian * docs(website): new translation for server.md in Serbian (Cyrillic) * docs(website): new translation for server.md in Chinese Simplified * docs(website): new translation for server.md in Vietnamese * docs(website): new translation for server.md in Spanish * docs(website): new translation for server.md in Galician * docs(website): new translation for server.md in Portuguese, Brazilian * docs(website): new translation for server.md in Hindi * docs(website): new translation for server.md in Filipino * docs(website): new translation for server.md in Serbian (Latin) * docs(website): new translation for server.md in Tajik * docs(website): new translation for server.md in Yoruba * docs(website): new translation for ssl.md in Romanian * docs(website): new translation for ssl.md in French * docs(website): new translation for ssl.md in Spanish * docs(website): new translation for ssl.md in Arabic * docs(website): new translation for server.md in Arabic * docs(website): new translation for server.md in French * docs(website): new translation for reverse-proxy.md in Tajik * docs(website): new translation for reverse-proxy.md in Yoruba * docs(website): new translation for server.md in Romanian * docs(website): new translation for puppet.md in Serbian (Cyrillic) * docs(website): new translation for puppet.md in Portuguese * docs(website): new translation for plugins.md in French * docs(website): new translation for plugins.md in Romanian * docs(website): new translation for plugins.md in Spanish * docs(website): new translation for puppet.md in Polish * docs(website): new translation for protect-your-dependencies.md in Filipino * docs(website): new translation for protect-your-dependencies.md in Polish * docs(website): new translation for protect-your-dependencies.md in Portuguese * docs(website): new translation for protect-your-dependencies.md in Russian * docs(website): new translation for protect-your-dependencies.md in Serbian (Cyrillic) * docs(website): new translation for protect-your-dependencies.md in Chinese Simplified * docs(website): new translation for protect-your-dependencies.md in Chinese Traditional * docs(website): new translation for protect-your-dependencies.md in Vietnamese * docs(website): new translation for protect-your-dependencies.md in Galician * docs(website): new translation for protect-your-dependencies.md in Portuguese, Brazilian * docs(website): new translation for protect-your-dependencies.md in Hindi * docs(website): new translation for protect-your-dependencies.md in Serbian (Latin) * docs(website): new translation for protect-your-dependencies.md in Japanese * docs(website): new translation for protect-your-dependencies.md in Tajik * docs(website): new translation for protect-your-dependencies.md in Yoruba * docs(website): new translation for puppet.md in Romanian * docs(website): new translation for puppet.md in French * docs(website): new translation for puppet.md in Spanish * docs(website): new translation for puppet.md in Arabic * docs(website): new translation for puppet.md in Czech * docs(website): new translation for puppet.md in German * docs(website): new translation for puppet.md in Italian * docs(website): new translation for puppet.md in Japanese * docs(website): new translation for puppet.md in Korean * docs(website): new translation for protect-your-dependencies.md in Korean * docs(website): new translation for protect-your-dependencies.md in Italian * docs(website): new translation for plugins.md in Arabic * docs(website): new translation for plugins.md in Vietnamese * docs(website): new translation for plugins.md in Czech * docs(website): new translation for plugins.md in German * docs(website): new translation for plugins.md in Italian * docs(website): new translation for plugins.md in Japanese * docs(website): new translation for plugins.md in Korean * docs(website): new translation for plugins.md in Polish * docs(website): new translation for plugins.md in Portuguese * docs(website): new translation for plugins.md in Russian * docs(website): new translation for plugins.md in Serbian (Cyrillic) * docs(website): new translation for plugins.md in Chinese Simplified * docs(website): new translation for plugins.md in Chinese Traditional * docs(website): new translation for plugins.md in Galician * docs(website): new translation for protect-your-dependencies.md in German * docs(website): new translation for plugins.md in Portuguese, Brazilian * docs(website): new translation for plugins.md in Hindi * docs(website): new translation for plugins.md in Filipino * docs(website): new translation for plugins.md in Serbian (Latin) * docs(website): new translation for plugins.md in Tajik * docs(website): new translation for plugins.md in Yoruba * docs(website): new translation for protect-your-dependencies.md in Romanian * docs(website): new translation for protect-your-dependencies.md in French * docs(website): new translation for protect-your-dependencies.md in Spanish * docs(website): new translation for protect-your-dependencies.md in Arabic * docs(website): new translation for protect-your-dependencies.md in Czech * docs(website): new translation for install.md in Czech * docs(website): new translation for linking.md in Portuguese, Brazilian * docs(website): new translation for install.md in Spanish * docs(website): new translation for caching.md in Serbian (Cyrillic) * docs(website): new translation for caching.md in Spanish * docs(website): new translation for caching.md in Arabic * docs(website): new translation for caching.md in Czech * docs(website): new translation for caching.md in German * docs(website): new translation for caching.md in Italian * docs(website): new translation for caching.md in Japanese * docs(website): new translation for caching.md in Korean * docs(website): new translation for caching.md in Polish * docs(website): new translation for caching.md in Portuguese * docs(website): new translation for caching.md in Russian * docs(website): new translation for caching.md in Chinese Simplified * docs(website): new translation for caching.md in Romanian * docs(website): new translation for caching.md in Chinese Traditional * docs(website): new translation for caching.md in Vietnamese * docs(website): new translation for caching.md in Galician * docs(website): new translation for caching.md in Portuguese, Brazilian * docs(website): new translation for caching.md in Hindi * docs(website): new translation for caching.md in Filipino * docs(website): new translation for caching.md in Serbian (Latin) * docs(website): new translation for install.md in French * docs(website): new translation for caching.md in Yoruba * docs(website): new translation for chef.md in Romanian * docs(website): new translation for chef.md in French * docs(website): new translation for caching.md in French * docs(website): new translation for best-practices.md in Yoruba * docs(website): new translation for chef.md in Arabic * docs(website): new translation for best-practices.md in Korean * docs(website): new translation for best-practices.md in Romanian * docs(website): new translation for who-is-using.md in Russian * docs(website): new translation for windows.md in Serbian (Latin) * docs(website): new translation for windows.md in Tajik * docs(website): new translation for windows.md in Yoruba * docs(website): new translation for windows.md in Hindi * docs(website): new translation for en.json in Chinese Simplified * docs(website): new translation for windows.md in Filipino * docs(website): new translation for windows.md in Portuguese, Brazilian * docs(website): new translation for who-is-using.md in Serbian (Cyrillic) * docs(website): new translation for windows.md in Spanish * docs(website): new translation for who-is-using.md in Chinese Simplified * docs(website): new translation for who-is-using.md in Chinese Traditional * docs(website): new translation for who-is-using.md in Vietnamese * docs(website): new translation for who-is-using.md in Galician * docs(website): new translation for who-is-using.md in Portuguese, Brazilian * docs(website): new translation for who-is-using.md in Hindi * docs(website): new translation for who-is-using.md in Filipino * docs(website): new translation for who-is-using.md in Serbian (Latin) * docs(website): new translation for who-is-using.md in Tajik * docs(website): new translation for who-is-using.md in Yoruba * docs(website): new translation for windows.md in Romanian * docs(website): new translation for windows.md in French * docs(website): new translation for windows.md in Arabic * docs(website): new translation for windows.md in Galician * docs(website): new translation for windows.md in Czech * docs(website): new translation for windows.md in German * docs(website): new translation for windows.md in Italian * docs(website): new translation for windows.md in Japanese * docs(website): new translation for windows.md in Korean * docs(website): new translation for windows.md in Polish * docs(website): new translation for windows.md in Portuguese * docs(website): new translation for windows.md in Russian * docs(website): new translation for windows.md in Serbian (Cyrillic) * docs(website): new translation for windows.md in Chinese Simplified * docs(website): new translation for windows.md in Chinese Traditional * docs(website): new translation for windows.md in Vietnamese * docs(website): new translation for best-practices.md in French * docs(website): new translation for amazon.md in Spanish * docs(website): new translation for iis-server.md in Vietnamese * docs(website): new translation for install.md in Romanian * docs(website): new translation for iis-server.md in Yoruba * docs(website): new translation for iis-server.md in Tajik * docs(website): new translation for iis-server.md in Serbian (Latin) * docs(website): new translation for iis-server.md in Filipino * docs(website): new translation for iis-server.md in Hindi * docs(website): new translation for iis-server.md in Portuguese, Brazilian * docs(website): new translation for iis-server.md in Galician * docs(website): new translation for iis-server.md in Chinese Traditional * docs(website): new translation for iis-server.md in Chinese Simplified * docs(website): new translation for iis-server.md in Serbian (Cyrillic) * docs(website): new translation for iis-server.md in Russian * docs(website): new translation for iis-server.md in Portuguese * docs(website): new translation for iis-server.md in Polish * docs(website): new translation for iis-server.md in Korean * docs(website): new translation for iis-server.md in Japanese * docs(website): new translation for iis-server.md in Italian * docs(website): new translation for iis-server.md in German * docs(website): new translation for iis-server.md in Czech * docs(website): new translation for iis-server.md in Arabic * docs(website): new translation for iis-server.md in Spanish * docs(website): new translation for iis-server.md in French * docs(website): new translation for iis-server.md in Romanian * docs(website): new translation for e2e.md in Czech * docs(website): new translation for e2e.md in Hindi * docs(website): new translation for e2e.md in Portuguese, Brazilian * docs(website): new translation for e2e.md in Galician * docs(website): new translation for e2e.md in Vietnamese * docs(website): new translation for e2e.md in Chinese Traditional * docs(website): new translation for e2e.md in Chinese Simplified * docs(website): new translation for e2e.md in Serbian (Cyrillic) * docs(website): new translation for e2e.md in Russian * docs(website): new translation for e2e.md in Portuguese * docs(website): new translation for e2e.md in Polish * docs(website): new translation for e2e.md in Korean * docs(website): new translation for e2e.md in Japanese * docs(website): new translation for e2e.md in Italian * docs(website): new translation for e2e.md in German * docs(website): new translation for e2e.md in Arabic * docs(website): new translation for e2e.md in Serbian (Latin) * docs(website): new translation for e2e.md in Spanish * docs(website): new translation for e2e.md in French * docs(website): new translation for e2e.md in Romanian * docs(website): new translation for docker.md in Yoruba * docs(website): new translation for docker.md in Tajik * docs(website): new translation for docker.md in Serbian (Latin) * docs(website): new translation for docker.md in Filipino * docs(website): new translation for docker.md in Hindi * docs(website): new translation for docker.md in Portuguese, Brazilian * docs(website): new translation for docker.md in Galician * docs(website): new translation for docker.md in Vietnamese * docs(website): new translation for docker.md in Chinese Traditional * docs(website): new translation for docker.md in Chinese Simplified * docs(website): new translation for docker.md in Serbian (Cyrillic) * docs(website): new translation for e2e.md in Filipino * docs(website): new translation for e2e.md in Tajik * docs(website): new translation for github-actions.md in Galician * docs(website): new translation for github-actions.md in Yoruba * docs(website): new translation for github-actions.md in Tajik * docs(website): new translation for github-actions.md in Serbian (Latin) * docs(website): new translation for github-actions.md in Filipino * docs(website): new translation for github-actions.md in Hindi * docs(website): new translation for github-actions.md in Portuguese, Brazilian * docs(website): new translation for github-actions.md in Vietnamese * docs(website): new translation for e2e.md in Yoruba * docs(website): new translation for github-actions.md in Italian * docs(website): new translation for github-actions.md in Romanian * docs(website): new translation for github-actions.md in French * docs(website): new translation for github-actions.md in Spanish * docs(website): new translation for github-actions.md in Arabic * docs(website): new translation for github-actions.md in Czech --- website/translated_docs/ar/e2e.md | 10 ++- website/translated_docs/ar/github-actions.md | 2 +- website/translated_docs/ar/iis-server.md | 54 +++++++------ website/translated_docs/cs/e2e.md | 10 ++- website/translated_docs/cs/github-actions.md | 2 +- website/translated_docs/cs/iis-server.md | 54 +++++++------ website/translated_docs/de/e2e.md | 10 ++- website/translated_docs/de/iis-server.md | 54 +++++++------ website/translated_docs/es-ES/amazon.md | 48 ++++++----- website/translated_docs/es-ES/e2e.md | 10 ++- .../translated_docs/es-ES/github-actions.md | 2 +- website/translated_docs/es-ES/iis-server.md | 54 +++++++------ website/translated_docs/fil-PH/docker.md | 25 +++--- website/translated_docs/fil-PH/e2e.md | 10 ++- .../translated_docs/fil-PH/github-actions.md | 2 +- website/translated_docs/fil-PH/iis-server.md | 54 +++++++------ .../translated_docs/fr-FR/best-practices.md | 34 ++++---- website/translated_docs/fr-FR/e2e.md | 10 ++- .../translated_docs/fr-FR/github-actions.md | 2 +- website/translated_docs/fr-FR/iis-server.md | 54 +++++++------ website/translated_docs/gl-ES/docker.md | 25 +++--- website/translated_docs/gl-ES/e2e.md | 10 ++- .../translated_docs/gl-ES/github-actions.md | 2 +- website/translated_docs/gl-ES/iis-server.md | 54 +++++++------ website/translated_docs/hi-IN/docker.md | 25 +++--- website/translated_docs/hi-IN/e2e.md | 10 ++- .../translated_docs/hi-IN/github-actions.md | 2 +- website/translated_docs/hi-IN/iis-server.md | 54 +++++++------ website/translated_docs/it-IT/e2e.md | 16 ++-- .../translated_docs/it-IT/github-actions.md | 2 +- website/translated_docs/it-IT/iis-server.md | 54 +++++++------ website/translated_docs/ja/e2e.md | 10 ++- website/translated_docs/ja/iis-server.md | 54 +++++++------ website/translated_docs/ko/e2e.md | 10 ++- website/translated_docs/ko/iis-server.md | 54 +++++++------ website/translated_docs/pl-PL/e2e.md | 10 ++- website/translated_docs/pl-PL/iis-server.md | 54 +++++++------ website/translated_docs/pt-BR/docker.md | 25 +++--- website/translated_docs/pt-BR/e2e.md | 14 +++- .../translated_docs/pt-BR/github-actions.md | 2 +- website/translated_docs/pt-BR/iis-server.md | 54 +++++++------ website/translated_docs/pt-PT/e2e.md | 10 ++- website/translated_docs/pt-PT/iis-server.md | 54 +++++++------ website/translated_docs/ro/e2e.md | 10 ++- website/translated_docs/ro/github-actions.md | 2 +- website/translated_docs/ro/iis-server.md | 54 +++++++------ website/translated_docs/ro/install.md | 8 +- website/translated_docs/ru-RU/e2e.md | 14 +++- website/translated_docs/ru-RU/iis-server.md | 54 +++++++------ website/translated_docs/sr-CS/docker.md | 25 +++--- website/translated_docs/sr-CS/e2e.md | 10 ++- .../translated_docs/sr-CS/github-actions.md | 2 +- website/translated_docs/sr-CS/iis-server.md | 54 +++++++------ website/translated_docs/sr-SP/docker.md | 25 +++--- website/translated_docs/sr-SP/e2e.md | 10 ++- website/translated_docs/sr-SP/iis-server.md | 54 +++++++------ website/translated_docs/tg-TJ/docker.md | 25 +++--- website/translated_docs/tg-TJ/e2e.md | 10 ++- .../translated_docs/tg-TJ/github-actions.md | 2 +- website/translated_docs/tg-TJ/iis-server.md | 54 +++++++------ website/translated_docs/vi-VN/docker.md | 25 +++--- website/translated_docs/vi-VN/e2e.md | 10 ++- .../translated_docs/vi-VN/github-actions.md | 2 +- website/translated_docs/vi-VN/iis-server.md | 54 +++++++------ website/translated_docs/yo-NG/docker.md | 29 +++---- website/translated_docs/yo-NG/e2e.md | 16 ++-- .../translated_docs/yo-NG/github-actions.md | 2 +- website/translated_docs/yo-NG/iis-server.md | 54 +++++++------ website/translated_docs/zh-CN/docker.md | 33 ++++---- website/translated_docs/zh-CN/e2e.md | 12 ++- website/translated_docs/zh-CN/iis-server.md | 80 ++++++++++++------- website/translated_docs/zh-TW/docker.md | 33 ++++---- website/translated_docs/zh-TW/e2e.md | 12 ++- website/translated_docs/zh-TW/iis-server.md | 80 ++++++++++++------- 74 files changed, 1108 insertions(+), 853 deletions(-) diff --git a/website/translated_docs/ar/e2e.md b/website/translated_docs/ar/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/ar/e2e.md +++ b/website/translated_docs/ar/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**.

Solution: a local npm registry. https://t.co/kvcyVANVSK

— Dan Abramov (@dan_abramov) 11 de enero de 2018
- Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/ar/github-actions.md b/website/translated_docs/ar/github-actions.md index ec819493429c..e93a32a5e91b 100644 --- a/website/translated_docs/ar/github-actions.md +++ b/website/translated_docs/ar/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Within the image uses `verdaccio-auth-memory` and `verdaccio-memory` plugins to handle authentification and storage to speed up the process. -If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. \ No newline at end of file +If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. diff --git a/website/translated_docs/ar/iis-server.md b/website/translated_docs/ar/iis-server.md index 9f9a4f50cdcd..639b65b14048 100644 --- a/website/translated_docs/ar/iis-server.md +++ b/website/translated_docs/ar/iis-server.md @@ -5,23 +5,24 @@ title: "Installing on IIS server" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. -- Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. -- Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) -- Start a command prompt and execute the commands below to download verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. +* Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. +* Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) +* Start a command prompt and execute the commands below to download verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall -- Thats it! Now you can navigate to the host and port that you specified +* Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified I wanted the `verdaccio` site to be the default site in IIS so I did the following: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts These instructions are based on [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Troubleshooting - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/cs/e2e.md b/website/translated_docs/cs/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/cs/e2e.md +++ b/website/translated_docs/cs/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**.

Solution: a local npm registry. https://t.co/kvcyVANVSK

— Dan Abramov (@dan_abramov) 11 de enero de 2018
- Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/cs/github-actions.md b/website/translated_docs/cs/github-actions.md index ec819493429c..e93a32a5e91b 100644 --- a/website/translated_docs/cs/github-actions.md +++ b/website/translated_docs/cs/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Within the image uses `verdaccio-auth-memory` and `verdaccio-memory` plugins to handle authentification and storage to speed up the process. -If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. \ No newline at end of file +If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. diff --git a/website/translated_docs/cs/iis-server.md b/website/translated_docs/cs/iis-server.md index 349fb5cda20f..791c5ee38921 100644 --- a/website/translated_docs/cs/iis-server.md +++ b/website/translated_docs/cs/iis-server.md @@ -5,23 +5,24 @@ title: "Instalace na IIS serveru" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. -- Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. -- Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) -- Start a command prompt and execute the commands below to download verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. +* Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. +* Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) +* Start a command prompt and execute the commands below to download verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall -- Thats it! Now you can navigate to the host and port that you specified +* Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified I wanted the `verdaccio` site to be the default site in IIS so I did the following: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts These instructions are based on [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Troubleshooting - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/de/e2e.md b/website/translated_docs/de/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/de/e2e.md +++ b/website/translated_docs/de/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**.

Solution: a local npm registry. https://t.co/kvcyVANVSK

— Dan Abramov (@dan_abramov) 11 de enero de 2018
- Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/de/iis-server.md b/website/translated_docs/de/iis-server.md index c16dc8f2c112..536ba3279f9a 100644 --- a/website/translated_docs/de/iis-server.md +++ b/website/translated_docs/de/iis-server.md @@ -5,23 +5,24 @@ title: "Auf IIS-Server installieren" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. -- Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. -- Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) -- Start a command prompt and execute the commands below to download verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. +* Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. +* Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) +* Start a command prompt and execute the commands below to download verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall -- Thats it! Now you can navigate to the host and port that you specified +* Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified I wanted the `verdaccio` site to be the default site in IIS so I did the following: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts These instructions are based on [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Troubleshooting - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/es-ES/amazon.md b/website/translated_docs/es-ES/amazon.md index eaba475bee68..aea58edcefec 100644 --- a/website/translated_docs/es-ES/amazon.md +++ b/website/translated_docs/es-ES/amazon.md @@ -11,25 +11,37 @@ Este documento describe varios enfoques para implementar Verdaccio en la nube de Arquitectura: - Clients - | - | (HTTPS) - v - Application Load Balancer - | - | (HTTP) - v - EC2 Auto Scaling Group (Amazon Linux 2) - Docker image (Verdaccio) - | - | (NFS) - v - Elastic File System - - -Notas de Arquitectura: * Despliegue este stack en la región más cercana a sus usuarios para obtener el máximo desempeño. * Usamos un grupo de auto escalamiento principalmente para autorecuperación. Los requerimientos de sistema de Verdaccio son bastante bajos, por tanto es poco probable que necesites multiples instancias para manejar la carga de tráfico. Dado que Amazon Linux 2 no soporta Node, corremos Verdaccio como una imagen de Docker en lugar de correrlo de forma nativa en la instancia. Esto es más rápido y más seguro que confiar en librerías de paquetes de terceros para Node. * Elastic File System is cheap and stateful, and works across AZs. An alternative would be the [third-party S3 storage plugin](https://github.com/remitly/verdaccio-s3-storage). * For backup, use AWS Backup +``` +Clients + | + | (HTTPS) + v +Application Load Balancer + | + | (HTTP) + v +EC2 Auto Scaling Group (Amazon Linux 2) +Docker image (Verdaccio) + | + | (NFS) + v +Elastic File System +``` + +Architecture notes: +* Deploy this stack into the region closest to your users for maximum performance. +* * Usamos un grupo de auto escalamiento principalmente para autorecuperación. Los requerimientos de sistema de Verdaccio son bastante bajos, por tanto es poco probable que necesites multiples instancias para manejar la carga de tráfico. +* Dado que Amazon Linux 2 no soporta Node, corremos Verdaccio como una imagen de Docker en lugar de correrlo de forma nativa en la instancia. Esto es más rápido y más seguro que confiar en librerías de paquetes de terceros para Node. +* * Elastic File System is cheap and stateful, and works across AZs. An alternative would be the [third-party S3 storage plugin](https://github.com/remitly/verdaccio-s3-storage). + * * For backup, use AWS Backup Estimated monthly cost for a small installation (in us-east-1): * ALB (1 LCU average): $22.265/mo * EC2 (t3.nano): $3.796/mo * EBS (8gb): $0.80/mo * EFS (5gb): $1.5/mo * Data transfer: (10gb): $0.9/mo * **TOTAL:** Under $30/mo +* ALB (1 LCU average): $22.265/mo +* EC2 (t3.nano): $3.796/mo +* EBS (8gb): $0.80/mo +* EFS (5gb): $1.5/mo +* Data transfer: (10gb): $0.9/mo +* **TOTAL:** Under $30/mo ## ECS @@ -39,4 +51,4 @@ Note: Fargate doesn't support persistent volumes, so you have to use the S3 stor ## EKS -See the documentation pages on [Kubernetes](kubernetes) and [Docker](docker). \ No newline at end of file +See the documentation pages on [Kubernetes](kubernetes) and [Docker](docker). diff --git a/website/translated_docs/es-ES/e2e.md b/website/translated_docs/es-ES/e2e.md index 9cb6421d4dbf..32032eeb1ba5 100644 --- a/website/translated_docs/es-ES/e2e.md +++ b/website/translated_docs/es-ES/e2e.md @@ -6,7 +6,6 @@ title: "Pruebas End to End" Algunos projectos organizan paquetes en multi repositorios o [mono repositorios](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). Pruebas E2E es un tema que usualmente es solo relevante para Interfaces de Usuario, pero desde el punto de vista de Node.js, **los paquetes que publicamos tambien debe ser probados**.

Solution: a local npm registry. https://t.co/kvcyVANVSK

— Dan Abramov (@dan_abramov) 11 de enero de 2018
- Tal enfoque ha sido realmente difícil de lograr considerando: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/es-ES/github-actions.md b/website/translated_docs/es-ES/github-actions.md index ec819493429c..e93a32a5e91b 100644 --- a/website/translated_docs/es-ES/github-actions.md +++ b/website/translated_docs/es-ES/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Within the image uses `verdaccio-auth-memory` and `verdaccio-memory` plugins to handle authentification and storage to speed up the process. -If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. \ No newline at end of file +If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. diff --git a/website/translated_docs/es-ES/iis-server.md b/website/translated_docs/es-ES/iis-server.md index c46ae8b6a9ac..bc048566c3d4 100644 --- a/website/translated_docs/es-ES/iis-server.md +++ b/website/translated_docs/es-ES/iis-server.md @@ -5,23 +5,24 @@ title: "Instalación en servidor IIS" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Crea una nueva carpeta en Explorer en donde deseas alojar a Verdaccio. Por ejemplo `C:\verdaccio`. Guardar [package.json](#packagejson), [start.js](#startjs) y [web.config](#webconfig) en esta carpeta. -- Crea un nuevo sitio en Administrador de Servicios de Información de Internet. Puedes ponerle el nombre que quieras. Lo llamaré Verdaccio en estas [instrucciones](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Especifica la ruta en donde guardaste todos los archivos y un número de puerto. -- Regresa a Explorer y otorgale al usuario que ejecuta el grupo de aplicaciones derechos para modificar la carpeta que acabas de crear. Si has nombrado el nuevo sitio verdaccio y no cambiaste el grupo de aplicaciones, está funcionado gracias a un ApplicationPoolIdentity y deberías otorgarle al usuario derechos para modificar IIS AppPool\verdaccio mira las instrucciones si necesitas ayuda. (Puede restringir el acceso más adelante si lo deseas para que así solo tenga derechos para modificar en el iisnode y verdaccio\storage) -- Empieza una línea de comando y ejecuta los comandos que aparecen debajo para descargar verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Crea una nueva carpeta en Explorer en donde deseas alojar a Verdaccio. Por ejemplo `C:\verdaccio`. Guardar [package.json](#packagejson), [start.js](#startjs) y [web.config](#webconfig) en esta carpeta. +* Crea un nuevo sitio en Administrador de Servicios de Información de Internet. Puedes ponerle el nombre que quieras. Lo llamaré Verdaccio en estas [instrucciones](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Especifica la ruta en donde guardaste todos los archivos y un número de puerto. +* Regresa a Explorer y otorgale al usuario que ejecuta el grupo de aplicaciones derechos para modificar la carpeta que acabas de crear. Si has nombrado el nuevo sitio verdaccio y no cambiaste el grupo de aplicaciones, está funcionado gracias a un ApplicationPoolIdentity y deberías otorgarle al usuario derechos para modificar IIS AppPool\verdaccio mira las instrucciones si necesitas ayuda. (Puede restringir el acceso más adelante si lo deseas para que así solo tenga derechos para modificar en el iisnode y verdaccio\storage) +* Empieza una línea de comando y ejecuta los comandos que aparecen debajo para descargar verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Asegúrate de tener una regla de entrada que acepte Tráfico de TCP al puerto en Windows Firewall -- ¡Y listo! Ahora puedes navegar al host y al puerto que especificaste +* Asegúrate de tener una regla de entrada que acepte Tráfico de TCP al puerto en Windows Firewall +* ¡Y listo! Ahora puedes navegar al host y al puerto que especificaste Quería que la página `verdaccio` fuese la página predeterminada en IIS así que hice lo siguiente: -- Detuve el "Sitio Web Predeterminado" y solo empiezo el sitio "verdaccio" en IIS -- Establecí los enlaces a "http", dirección de ip "All Unassigned" en el puerto 80, ok cualquier advertencia o carácter de comando +* Detuve el "Sitio Web Predeterminado" y solo empiezo el sitio "verdaccio" en IIS +* Establecí los enlaces a "http", dirección de ip "All Unassigned" en el puerto 80, ok cualquier advertencia o carácter de comando Estas instrucciones se basan en [Anfitrión Sinopia en IIS en Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). Tuve que hacer pequeños ajustes a mi configuración web como se puede ver debajo pero puedes encontrar el original del enlace mencionado el cual funciona mejor @@ -29,7 +30,7 @@ Un archivo de configuración predeterminado será creado `c:\verdaccio\verdaccio ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ Un archivo de configuración predeterminado será creado `c:\verdaccio\verdaccio "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Solución de problemas - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/fil-PH/docker.md b/website/translated_docs/fil-PH/docker.md index 9f29f8db39fa..a0bc392a316f 100644 --- a/website/translated_docs/fil-PH/docker.md +++ b/website/translated_docs/fil-PH/docker.md @@ -5,6 +5,7 @@ title: Docker ![alt Docker Pulls Count](https://dockeri.co/image/verdaccio/verdaccio "Docker Pulls Count") + To pull the latest pre-built [docker image](https://hub.docker.com/r/verdaccio/verdaccio/): ```bash @@ -22,7 +23,6 @@ For a major version: ```bash docker pull verdaccio/verdaccio:4 ``` - For a minor version: ```bash @@ -49,6 +49,7 @@ The last argument defines which image to use. The above line will pull the lates If you have [build an image locally](#build-your-own-docker-image) use `verdaccio` as the last argument. + You can use `-v` to bind mount `conf`, `storage` and `plugins` to the hosts filesystem: ```bash @@ -59,9 +60,7 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ -v $V_PATH/plugins:/verdaccio/plugins \ verdaccio/verdaccio ``` - > if you are running in a server, you might want to add -d to run it in the background -> > Note: Verdaccio runs as a non-root user (uid=10001) inside the container, if you use bind mount to override default, you need to make sure the mount directory is assigned to the right user. In above example, you need to run `sudo chown -R 10001:65533 /path/for/verdaccio` otherwise you will get permission errors at runtime. [Use docker volume](https://docs.docker.com/storage/volumes/) is recommended over using bind mount. Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list: @@ -74,17 +73,21 @@ Verdaccio 4 provides a new set of environment variables to modify either permiss | VERDACCIO_PORT | `4873` | the verdaccio port | | VERDACCIO_PROTOCOL | `http` | the default http protocol | + + ### SELinux If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. - fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file - +``` + fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file +``` If verdaccio can't read files on a bind-mounted directory and you are unsure, please check `/var/log/audit/audit.log` to confirm that it's a SELinux issue. In this example, the error above produced the following AVC denial. - type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 - +``` +type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 +``` `chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. @@ -97,7 +100,6 @@ If you want to make the directory accessible only to a specific container, use ` An alternative solution is to use [z and Z flags](https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label). To add the `z` flag to the mountpoint `./conf:/verdaccio/conf` simply change it to `./conf:/verdaccio/conf:z`. The `z` flag relabels the directory and makes it accessible by every container while the `Z` flags relables the directory and makes it accessible only to that specific container. However using these flags is dangerous. A small configuration mistake, like mounting `/home/user` or `/var` can mess up the labels on those directories and make the system unbootable. ### Plugins - Plugins can be installed in a separate directory and mounted using Docker or Kubernetes, however make sure you build plugins with native dependencies using the same base image as the Verdaccio Dockerfile. ```docker @@ -113,7 +115,6 @@ USER verdaccio ``` ### Docker and custom port configuration - Any `host:port` configured in `conf/config.yaml` under `listen` **is currently ignored when using docker**. If you want to reach Verdaccio docker instance under different port, lets say `5000` in your `docker run` command add the environment variable `VERDACCIO_PORT=5000` and then expose the port `-p 5000:5000`. @@ -127,7 +128,6 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ Of course the numbers you give to `-p` paremeter need to match. ### Using HTTPS with Docker - You can configure the protocol verdaccio is going to listen on, similarly to the port configuration. You have to overwrite the default value("http") of the `PROTOCOL` environment variable to "https", after you specified the certificates in the config.yaml. ```bash @@ -147,6 +147,7 @@ $ docker-compose up --build You can set the port to use (for both container and host) by prefixing the above command with `VERDACCIO_PORT=5000`. + ```yaml version: '3.1' @@ -205,7 +206,7 @@ Please note that for any of the above docker commands you need to have docker in There is a separate repository that hosts multiple configurations to compose Docker images with `verdaccio`, for instance, as reverse proxy: - +[https://github.com/verdaccio/docker-examples](https://github.com/verdaccio/docker-examples) ## Docker Custom Builds @@ -221,4 +222,4 @@ There is a separate repository that hosts multiple configurations to compose Doc * [docker-verdaccio](https://github.com/Global-Solutions/docker-verdaccio) * [verdaccio-docker](https://github.com/idahobean/verdaccio-docker) * [verdaccio-server](https://github.com/andru255/verdaccio-server) -* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. \ No newline at end of file +* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. diff --git a/website/translated_docs/fil-PH/e2e.md b/website/translated_docs/fil-PH/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/fil-PH/e2e.md +++ b/website/translated_docs/fil-PH/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/fil-PH/github-actions.md b/website/translated_docs/fil-PH/github-actions.md index ec819493429c..e93a32a5e91b 100644 --- a/website/translated_docs/fil-PH/github-actions.md +++ b/website/translated_docs/fil-PH/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Within the image uses `verdaccio-auth-memory` and `verdaccio-memory` plugins to handle authentification and storage to speed up the process. -If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. \ No newline at end of file +If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. diff --git a/website/translated_docs/fil-PH/iis-server.md b/website/translated_docs/fil-PH/iis-server.md index 9f9a4f50cdcd..639b65b14048 100644 --- a/website/translated_docs/fil-PH/iis-server.md +++ b/website/translated_docs/fil-PH/iis-server.md @@ -5,23 +5,24 @@ title: "Installing on IIS server" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. -- Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. -- Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) -- Start a command prompt and execute the commands below to download verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. +* Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. +* Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) +* Start a command prompt and execute the commands below to download verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall -- Thats it! Now you can navigate to the host and port that you specified +* Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified I wanted the `verdaccio` site to be the default site in IIS so I did the following: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts These instructions are based on [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Troubleshooting - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/fr-FR/best-practices.md b/website/translated_docs/fr-FR/best-practices.md index 212af3b4ceff..b429ababa431 100644 --- a/website/translated_docs/fr-FR/best-practices.md +++ b/website/translated_docs/fr-FR/best-practices.md @@ -46,34 +46,34 @@ If you want to use a modified version of some public package `foo`, you can just There's two options here: 1. You want to create a separate **fork** and stop synchronizing with public version. - - If you want to do that, you should modify your configuration file so Verdaccio won't make requests regarding this package to npmjs anymore. Add a separate entry for this package to `config.yaml` and remove `npmjs` from `proxy` list and restart the server. - - ```yaml - packages: + + If you want to do that, you should modify your configuration file so Verdaccio won't make requests regarding this package to npmjs anymore. Add a separate entry for this package to `config.yaml` and remove `npmjs` from `proxy` list and restart the server. + + ```yaml + packages: "@my-company/*": access: $all publish: $authenticated # comment it out or leave it empty # proxy: - ``` - - When you publish your package locally, **you should probably start with a version string higher than the existing package** so it won't conflict with that package in the cache. + ``` + + When you publish your package locally, **you should probably start with a version string higher than the existing package** so it won't conflict with that package in the cache. 2. You want to temporarily use your version, but return to the public one as soon as it's updated. - - In order to avoid version conflicts, **you should use a custom pre-release suffix of the next patch version**. For example, if a public package has version 0.1.2, you can upload `0.1.3-my-temp-fix`. - - ```bash + + In order to avoid version conflicts, **you should use a custom pre-release suffix of the next patch version**. For example, if a public package has version 0.1.2, you can upload `0.1.3-my-temp-fix`. + + ```bash npm version 0.1.3-my-temp-fix npm publish --tag fix --registry http://localhost:4873 - ``` - - This way your package will be used until its original maintainer updates his public package to `0.1.3`. + ``` + + This way your package will be used until its original maintainer updates his public package to `0.1.3`. ## Security -> Security starts in your environment. +> Security starts in your environment. Additonal reading: @@ -163,4 +163,4 @@ security: Using JWT also improves the performance with authentication plugins. The old system will perform an unpackage and validate the credentials on every request, while JWT will rely on the token signature instead, avoiding the overhead for the plugin. -As a side note, be aware at **npmjs** and the **legacy** verdaccio token never expires** unless you invalidate manually. \ No newline at end of file +As a side note, be aware at **npmjs** and the **legacy** verdaccio token never expires** unless you invalidate manually. diff --git a/website/translated_docs/fr-FR/e2e.md b/website/translated_docs/fr-FR/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/fr-FR/e2e.md +++ b/website/translated_docs/fr-FR/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/fr-FR/github-actions.md b/website/translated_docs/fr-FR/github-actions.md index ec819493429c..e93a32a5e91b 100644 --- a/website/translated_docs/fr-FR/github-actions.md +++ b/website/translated_docs/fr-FR/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Within the image uses `verdaccio-auth-memory` and `verdaccio-memory` plugins to handle authentification and storage to speed up the process. -If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. \ No newline at end of file +If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. diff --git a/website/translated_docs/fr-FR/iis-server.md b/website/translated_docs/fr-FR/iis-server.md index 8a899fb09b24..d97c0b3f30d2 100644 --- a/website/translated_docs/fr-FR/iis-server.md +++ b/website/translated_docs/fr-FR/iis-server.md @@ -5,23 +5,24 @@ title: "Installation sur le serveur IIS" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Créez un nouveau dossier dans Explorer où vous souhaitez héberger Verdaccio. Par exemple `C:\verdaccio`. Sauvgarder [package.json](#packagejson), [start.js](#startjs) et [web.config](#webconfig) dans ce fichier. -- Créez un nouveau site sur Internet Information Services Manager. Vous pouvez l’appeler comme vous voulez. Je l’appellerai verdaccio dans ces [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Spécifiez le chemin vers où vous avez enregistré les fichiers et un numéro de port. -- Retournez vers Explorer et autorisez l'utilisateur exécutant le groupe d'applications à pouvoir modifier le dossier nouvellement créé. Si vous avez nommé le nouveau site verdaccio et que vous n'avez pas modifié le groupe d'applications, cela fonctionne à l'arrière plan d'une ApplicationPoolIdentity et vous devez autoriser l'utilisateur à modifier IIS AppPool\verdaccio. Voir les instructions si vous avez besoin d'aide. (Si vous le souhaitez, vous pouvez restreindre l'accès ultérieurement, de sorte que vous ne disposiez que des autorisations de modification sur iisnode et verdaccio/storage) -- Lancez une invite de commande et lancez celles ci-dessous pour télécharger verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Créez un nouveau dossier dans Explorer où vous souhaitez héberger Verdaccio. Par exemple `C:\verdaccio`. Sauvgarder [package.json](#packagejson), [start.js](#startjs) et [web.config](#webconfig) dans ce fichier. +* Créez un nouveau site sur Internet Information Services Manager. Vous pouvez l’appeler comme vous voulez. Je l’appellerai verdaccio dans ces [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Spécifiez le chemin vers où vous avez enregistré les fichiers et un numéro de port. +* Retournez vers Explorer et autorisez l'utilisateur exécutant le groupe d'applications à pouvoir modifier le dossier nouvellement créé. Si vous avez nommé le nouveau site verdaccio et que vous n'avez pas modifié le groupe d'applications, cela fonctionne à l'arrière plan d'une ApplicationPoolIdentity et vous devez autoriser l'utilisateur à modifier IIS AppPool\verdaccio. Voir les instructions si vous avez besoin d'aide. (Si vous le souhaitez, vous pouvez restreindre l'accès ultérieurement, de sorte que vous ne disposiez que des autorisations de modification sur iisnode et verdaccio/storage) +* Lancez une invite de commande et lancez celles ci-dessous pour télécharger verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Assurez-vous de disposer d'une règle entrante acceptant le trafic TCP sur le port du pare-feu Windows -- C'est ça! Maintenant, vous pouvez parcourir l'hôte et le port que vous avez spécifiés +* Assurez-vous de disposer d'une règle entrante acceptant le trafic TCP sur le port du pare-feu Windows +* C'est ça! Maintenant, vous pouvez parcourir l'hôte et le port que vous avez spécifiés Je voulais que `verdaccio` soit le site par défaut sur IIS, j'ai donc pris les mesures suivantes: -- J'ai arrêté le "site Web par défaut" et n'ai démarré que le site "verdaccio" sur IIS -- J'ai établi des connexions avec "http", l'adresse Ip "All Unassigned" sur le port 80, permettre tout avertissement ou invite +* J'ai arrêté le "site Web par défaut" et n'ai démarré que le site "verdaccio" sur IIS +* J'ai établi des connexions avec "http", l'adresse Ip "All Unassigned" sur le port 80, permettre tout avertissement ou invite Ces instructions sont basées sur [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). J'ai dû faire un petit ajustement de la configuration Web, comme vous pouvez le voir ci-dessous, mais vous pouvez trouver l'original à partir du lien mentionné qui fonctionne le mieux @@ -29,7 +30,7 @@ Un fichier de configuration par défaut sera créé `c:\verdaccio\verdaccio\conf ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ Un fichier de configuration par défaut sera créé `c:\verdaccio\verdaccio\conf "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Dépannage - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/gl-ES/docker.md b/website/translated_docs/gl-ES/docker.md index 9f29f8db39fa..a0bc392a316f 100644 --- a/website/translated_docs/gl-ES/docker.md +++ b/website/translated_docs/gl-ES/docker.md @@ -5,6 +5,7 @@ title: Docker ![alt Docker Pulls Count](https://dockeri.co/image/verdaccio/verdaccio "Docker Pulls Count") + To pull the latest pre-built [docker image](https://hub.docker.com/r/verdaccio/verdaccio/): ```bash @@ -22,7 +23,6 @@ For a major version: ```bash docker pull verdaccio/verdaccio:4 ``` - For a minor version: ```bash @@ -49,6 +49,7 @@ The last argument defines which image to use. The above line will pull the lates If you have [build an image locally](#build-your-own-docker-image) use `verdaccio` as the last argument. + You can use `-v` to bind mount `conf`, `storage` and `plugins` to the hosts filesystem: ```bash @@ -59,9 +60,7 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ -v $V_PATH/plugins:/verdaccio/plugins \ verdaccio/verdaccio ``` - > if you are running in a server, you might want to add -d to run it in the background -> > Note: Verdaccio runs as a non-root user (uid=10001) inside the container, if you use bind mount to override default, you need to make sure the mount directory is assigned to the right user. In above example, you need to run `sudo chown -R 10001:65533 /path/for/verdaccio` otherwise you will get permission errors at runtime. [Use docker volume](https://docs.docker.com/storage/volumes/) is recommended over using bind mount. Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list: @@ -74,17 +73,21 @@ Verdaccio 4 provides a new set of environment variables to modify either permiss | VERDACCIO_PORT | `4873` | the verdaccio port | | VERDACCIO_PROTOCOL | `http` | the default http protocol | + + ### SELinux If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. - fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file - +``` + fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file +``` If verdaccio can't read files on a bind-mounted directory and you are unsure, please check `/var/log/audit/audit.log` to confirm that it's a SELinux issue. In this example, the error above produced the following AVC denial. - type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 - +``` +type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 +``` `chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. @@ -97,7 +100,6 @@ If you want to make the directory accessible only to a specific container, use ` An alternative solution is to use [z and Z flags](https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label). To add the `z` flag to the mountpoint `./conf:/verdaccio/conf` simply change it to `./conf:/verdaccio/conf:z`. The `z` flag relabels the directory and makes it accessible by every container while the `Z` flags relables the directory and makes it accessible only to that specific container. However using these flags is dangerous. A small configuration mistake, like mounting `/home/user` or `/var` can mess up the labels on those directories and make the system unbootable. ### Plugins - Plugins can be installed in a separate directory and mounted using Docker or Kubernetes, however make sure you build plugins with native dependencies using the same base image as the Verdaccio Dockerfile. ```docker @@ -113,7 +115,6 @@ USER verdaccio ``` ### Docker and custom port configuration - Any `host:port` configured in `conf/config.yaml` under `listen` **is currently ignored when using docker**. If you want to reach Verdaccio docker instance under different port, lets say `5000` in your `docker run` command add the environment variable `VERDACCIO_PORT=5000` and then expose the port `-p 5000:5000`. @@ -127,7 +128,6 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ Of course the numbers you give to `-p` paremeter need to match. ### Using HTTPS with Docker - You can configure the protocol verdaccio is going to listen on, similarly to the port configuration. You have to overwrite the default value("http") of the `PROTOCOL` environment variable to "https", after you specified the certificates in the config.yaml. ```bash @@ -147,6 +147,7 @@ $ docker-compose up --build You can set the port to use (for both container and host) by prefixing the above command with `VERDACCIO_PORT=5000`. + ```yaml version: '3.1' @@ -205,7 +206,7 @@ Please note that for any of the above docker commands you need to have docker in There is a separate repository that hosts multiple configurations to compose Docker images with `verdaccio`, for instance, as reverse proxy: - +[https://github.com/verdaccio/docker-examples](https://github.com/verdaccio/docker-examples) ## Docker Custom Builds @@ -221,4 +222,4 @@ There is a separate repository that hosts multiple configurations to compose Doc * [docker-verdaccio](https://github.com/Global-Solutions/docker-verdaccio) * [verdaccio-docker](https://github.com/idahobean/verdaccio-docker) * [verdaccio-server](https://github.com/andru255/verdaccio-server) -* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. \ No newline at end of file +* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. diff --git a/website/translated_docs/gl-ES/e2e.md b/website/translated_docs/gl-ES/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/gl-ES/e2e.md +++ b/website/translated_docs/gl-ES/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/gl-ES/github-actions.md b/website/translated_docs/gl-ES/github-actions.md index ec819493429c..e93a32a5e91b 100644 --- a/website/translated_docs/gl-ES/github-actions.md +++ b/website/translated_docs/gl-ES/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Within the image uses `verdaccio-auth-memory` and `verdaccio-memory` plugins to handle authentification and storage to speed up the process. -If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. \ No newline at end of file +If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. diff --git a/website/translated_docs/gl-ES/iis-server.md b/website/translated_docs/gl-ES/iis-server.md index 9f9a4f50cdcd..639b65b14048 100644 --- a/website/translated_docs/gl-ES/iis-server.md +++ b/website/translated_docs/gl-ES/iis-server.md @@ -5,23 +5,24 @@ title: "Installing on IIS server" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. -- Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. -- Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) -- Start a command prompt and execute the commands below to download verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. +* Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. +* Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) +* Start a command prompt and execute the commands below to download verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall -- Thats it! Now you can navigate to the host and port that you specified +* Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified I wanted the `verdaccio` site to be the default site in IIS so I did the following: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts These instructions are based on [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Troubleshooting - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/hi-IN/docker.md b/website/translated_docs/hi-IN/docker.md index 9f29f8db39fa..a0bc392a316f 100644 --- a/website/translated_docs/hi-IN/docker.md +++ b/website/translated_docs/hi-IN/docker.md @@ -5,6 +5,7 @@ title: Docker ![alt Docker Pulls Count](https://dockeri.co/image/verdaccio/verdaccio "Docker Pulls Count") + To pull the latest pre-built [docker image](https://hub.docker.com/r/verdaccio/verdaccio/): ```bash @@ -22,7 +23,6 @@ For a major version: ```bash docker pull verdaccio/verdaccio:4 ``` - For a minor version: ```bash @@ -49,6 +49,7 @@ The last argument defines which image to use. The above line will pull the lates If you have [build an image locally](#build-your-own-docker-image) use `verdaccio` as the last argument. + You can use `-v` to bind mount `conf`, `storage` and `plugins` to the hosts filesystem: ```bash @@ -59,9 +60,7 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ -v $V_PATH/plugins:/verdaccio/plugins \ verdaccio/verdaccio ``` - > if you are running in a server, you might want to add -d to run it in the background -> > Note: Verdaccio runs as a non-root user (uid=10001) inside the container, if you use bind mount to override default, you need to make sure the mount directory is assigned to the right user. In above example, you need to run `sudo chown -R 10001:65533 /path/for/verdaccio` otherwise you will get permission errors at runtime. [Use docker volume](https://docs.docker.com/storage/volumes/) is recommended over using bind mount. Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list: @@ -74,17 +73,21 @@ Verdaccio 4 provides a new set of environment variables to modify either permiss | VERDACCIO_PORT | `4873` | the verdaccio port | | VERDACCIO_PROTOCOL | `http` | the default http protocol | + + ### SELinux If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. - fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file - +``` + fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file +``` If verdaccio can't read files on a bind-mounted directory and you are unsure, please check `/var/log/audit/audit.log` to confirm that it's a SELinux issue. In this example, the error above produced the following AVC denial. - type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 - +``` +type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 +``` `chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. @@ -97,7 +100,6 @@ If you want to make the directory accessible only to a specific container, use ` An alternative solution is to use [z and Z flags](https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label). To add the `z` flag to the mountpoint `./conf:/verdaccio/conf` simply change it to `./conf:/verdaccio/conf:z`. The `z` flag relabels the directory and makes it accessible by every container while the `Z` flags relables the directory and makes it accessible only to that specific container. However using these flags is dangerous. A small configuration mistake, like mounting `/home/user` or `/var` can mess up the labels on those directories and make the system unbootable. ### Plugins - Plugins can be installed in a separate directory and mounted using Docker or Kubernetes, however make sure you build plugins with native dependencies using the same base image as the Verdaccio Dockerfile. ```docker @@ -113,7 +115,6 @@ USER verdaccio ``` ### Docker and custom port configuration - Any `host:port` configured in `conf/config.yaml` under `listen` **is currently ignored when using docker**. If you want to reach Verdaccio docker instance under different port, lets say `5000` in your `docker run` command add the environment variable `VERDACCIO_PORT=5000` and then expose the port `-p 5000:5000`. @@ -127,7 +128,6 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ Of course the numbers you give to `-p` paremeter need to match. ### Using HTTPS with Docker - You can configure the protocol verdaccio is going to listen on, similarly to the port configuration. You have to overwrite the default value("http") of the `PROTOCOL` environment variable to "https", after you specified the certificates in the config.yaml. ```bash @@ -147,6 +147,7 @@ $ docker-compose up --build You can set the port to use (for both container and host) by prefixing the above command with `VERDACCIO_PORT=5000`. + ```yaml version: '3.1' @@ -205,7 +206,7 @@ Please note that for any of the above docker commands you need to have docker in There is a separate repository that hosts multiple configurations to compose Docker images with `verdaccio`, for instance, as reverse proxy: - +[https://github.com/verdaccio/docker-examples](https://github.com/verdaccio/docker-examples) ## Docker Custom Builds @@ -221,4 +222,4 @@ There is a separate repository that hosts multiple configurations to compose Doc * [docker-verdaccio](https://github.com/Global-Solutions/docker-verdaccio) * [verdaccio-docker](https://github.com/idahobean/verdaccio-docker) * [verdaccio-server](https://github.com/andru255/verdaccio-server) -* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. \ No newline at end of file +* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. diff --git a/website/translated_docs/hi-IN/e2e.md b/website/translated_docs/hi-IN/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/hi-IN/e2e.md +++ b/website/translated_docs/hi-IN/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/hi-IN/github-actions.md b/website/translated_docs/hi-IN/github-actions.md index ec819493429c..e93a32a5e91b 100644 --- a/website/translated_docs/hi-IN/github-actions.md +++ b/website/translated_docs/hi-IN/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Within the image uses `verdaccio-auth-memory` and `verdaccio-memory` plugins to handle authentification and storage to speed up the process. -If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. \ No newline at end of file +If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. diff --git a/website/translated_docs/hi-IN/iis-server.md b/website/translated_docs/hi-IN/iis-server.md index 9f9a4f50cdcd..639b65b14048 100644 --- a/website/translated_docs/hi-IN/iis-server.md +++ b/website/translated_docs/hi-IN/iis-server.md @@ -5,23 +5,24 @@ title: "Installing on IIS server" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. -- Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. -- Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) -- Start a command prompt and execute the commands below to download verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. +* Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. +* Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) +* Start a command prompt and execute the commands below to download verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall -- Thats it! Now you can navigate to the host and port that you specified +* Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified I wanted the `verdaccio` site to be the default site in IIS so I did the following: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts These instructions are based on [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Troubleshooting - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/it-IT/e2e.md b/website/translated_docs/it-IT/e2e.md index 6c15517ce427..cd47af66c6f1 100644 --- a/website/translated_docs/it-IT/e2e.md +++ b/website/translated_docs/it-IT/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Alcuni progetti organizzano pacchetti in repository multi pacchetti o [monorepo](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). Il test E2E è un argomento che è rilevante solitamente solo per le Interfacce Utente, tuttavia secondo Node.js, **è necessario testare anche i pacchetti in pubblicazione**. - Tale approccio è stato molto difficile da raggiungere considerando che: @@ -15,7 +14,7 @@ Tale approccio è stato molto difficile da raggiungere considerando che: * Alcuni registri OSS self-hosted sono troppo pesanti * Ambienti offline (reti private) -**Verdaccio** è un registro leggero senza configurazione che **si adatta perfettamente a qualsiasi E2E + CI workflow**. +Non è ancora disponibile la soluzione perfetta, ogni implementazione sembra essere specifica per ciascun progetto; è possibile consultarne alcune nel thread seguente [cliccando qui](https://stackoverflow.com/a/50222427/308341). ## Implementazione @@ -23,7 +22,7 @@ Non è ancora disponibile la soluzione perfetta, ogni implementazione sembra ess ### Esempio di utilizzo di Bash -Questo è l'esempio più semplice dell'utilizzo di Verdaccio in un bash script (estratto da *create-react-app*). +This is the most simple example using Verdaccio in a bash script (extracted from *create-react-app*). ```bash #!/bin/sh @@ -45,7 +44,8 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` -## Who is using it for E2E? + +## Chi lo sta usando per E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* * [Storybook](https://github.com/storybooks/storybook) *(+44k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/it-IT/github-actions.md b/website/translated_docs/it-IT/github-actions.md index e4c57e14b3ba..07f8c41ace74 100644 --- a/website/translated_docs/it-IT/github-actions.md +++ b/website/translated_docs/it-IT/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu All'interno dell'immagine utilizza i plugin `verdaccio-auth-memory` e `verdaccio-memory` per gestire l'autenticazione e l'archiviazione per velocizzare il processo. -Se si desidera sapere di più sull'azione, [visitare il nostro repository](https://github.com/verdaccio/github-actions) dedicato alle GitHub Action. \ No newline at end of file +Se si desidera sapere di più sull'azione, [visitare il nostro repository](https://github.com/verdaccio/github-actions) dedicato alle GitHub Action. diff --git a/website/translated_docs/it-IT/iis-server.md b/website/translated_docs/it-IT/iis-server.md index 8b3d899dc010..70f08215770a 100644 --- a/website/translated_docs/it-IT/iis-server.md +++ b/website/translated_docs/it-IT/iis-server.md @@ -5,23 +5,24 @@ title: "Installazione sul server IIS" Queste istruzioni sono state scritte per Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) e [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Installare IIS e [iisnode](https://github.com/Azure/iisnode). Assicurarsi di installare i prerequisiti (Url Rewrite Module & node) come spiegato nelle istruzioni per iisnode. -- Creare una nuova cartella in Explorer in cui si desidera ospitare verdaccio. Per esempio `C:\verdaccio`. Salvare in questa cartella [package.json](#packagejson), [start.js](#startjs) e [web.config](#webconfig). -- Creare un nuovo sito su Internet Information Services Manager. È possibile nominarlo come si preferisce. In queste [istruzioni](http://www.iis.net/learn/manage/configuring-security/application-pool-identities) verrà chiamato verdaccio. Specificare il percorso in cui sono stati salvati i file ed il numero della porta. -- Tornare indietro a Explorer e autorizzare l'utente che esegue il gruppo di applicazioni a poter modificare la cartella appena creata. Se si è nominato il nuovo sito verdaccio e non si è modificato il gruppo di applicazioni, allora questo sta funzionando grazie ad un'ApplicationPoolIdentity e si dovrebbe dare all'utente le autorizzazioni di poter modificare IIS AppPool\verdaccio, vedere le istruzioni in caso di aiuto. (Se si desidera è possibile restringere l'accesso successivamente, così che si abbiano solo le autorizzazioni per modificare su iisnode e verdaccio/storage) -- Iniziare un prompt dei comandi ed eseguire quelli sottostanti per scaricare verdaccio: +* Installare IIS e [iisnode](https://github.com/Azure/iisnode). Assicurarsi di installare i prerequisiti (Url Rewrite Module & node) come spiegato nelle istruzioni per iisnode. +* Creare una nuova cartella in Explorer in cui si desidera ospitare verdaccio. Per esempio `C:\verdaccio`. Salvare in questa cartella [package.json](#packagejson), [start.js](#startjs) e [web.config](#webconfig). +* Creare un nuovo sito su Internet Information Services Manager. È possibile nominarlo come si preferisce. In queste [istruzioni](http://www.iis.net/learn/manage/configuring-security/application-pool-identities) verrà chiamato verdaccio. Specificare il percorso in cui sono stati salvati i file ed il numero della porta. +* Tornare indietro a Explorer e autorizzare l'utente che esegue il gruppo di applicazioni a poter modificare la cartella appena creata. Se si è nominato il nuovo sito verdaccio e non si è modificato il gruppo di applicazioni, allora questo sta funzionando grazie ad un'ApplicationPoolIdentity e si dovrebbe dare all'utente le autorizzazioni di poter modificare IIS AppPool\verdaccio, vedere le istruzioni in caso di aiuto. (Se si desidera è possibile restringere l'accesso successivamente, così che si abbiano solo le autorizzazioni per modificare su iisnode e verdaccio/storage) +* Iniziare un prompt dei comandi ed eseguire quelli sottostanti per scaricare verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Assicurarsi di possedere una regola in entrata che accetti il traffico TCP alla porta in Windows Firewall -- Con questo è tutto! Ora si può navigare nell'host e nella porta che sono stati specificati +* Assicurarsi di possedere una regola in entrata che accetti il traffico TCP alla porta in Windows Firewall +* Con questo è tutto! Ora si può navigare nell'host e nella porta che sono stati specificati Desideravo che `verdaccio` fosse il sito di default su IIS, quindi ho intrapreso le seguenti azioni: -- Ho arrestato il "Sito Web predefinito" e ho avviato esclusivamente il sito "verdaccio" su IIS -- Ho stabilito le connessioni a "http", indirizzo ip "All Unassigned" sulla porta 80, ok qualsiasi avvertenza o prompt +* Ho arrestato il "Sito Web predefinito" e ho avviato esclusivamente il sito "verdaccio" su IIS +* Ho stabilito le connessioni a "http", indirizzo ip "All Unassigned" sulla porta 80, ok qualsiasi avvertenza o prompt Queste istruzioni sono basate su [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). Ho dovuto fare un piccolo aggiustamento alla configurazione web come si può notare qui sotto, ma è possibile trovare l'originale dal link menzionato che funziona meglio @@ -29,7 +30,7 @@ Verrà creato un file di configurazione predefinito `c:\verdaccio\verdaccio\conf ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ Verrà creato un file di configurazione predefinito `c:\verdaccio\verdaccio\conf "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### start.js sostitutivo per versioni di Verdaccio < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Risoluzione dei problemi - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/ja/e2e.md b/website/translated_docs/ja/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/ja/e2e.md +++ b/website/translated_docs/ja/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/ja/iis-server.md b/website/translated_docs/ja/iis-server.md index 9f9a4f50cdcd..639b65b14048 100644 --- a/website/translated_docs/ja/iis-server.md +++ b/website/translated_docs/ja/iis-server.md @@ -5,23 +5,24 @@ title: "Installing on IIS server" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. -- Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. -- Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) -- Start a command prompt and execute the commands below to download verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. +* Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. +* Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) +* Start a command prompt and execute the commands below to download verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall -- Thats it! Now you can navigate to the host and port that you specified +* Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified I wanted the `verdaccio` site to be the default site in IIS so I did the following: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts These instructions are based on [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Troubleshooting - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/ko/e2e.md b/website/translated_docs/ko/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/ko/e2e.md +++ b/website/translated_docs/ko/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/ko/iis-server.md b/website/translated_docs/ko/iis-server.md index 330ef5d4a684..21fa9d291159 100644 --- a/website/translated_docs/ko/iis-server.md +++ b/website/translated_docs/ko/iis-server.md @@ -5,23 +5,24 @@ title: "IIS 서버에 설치하기" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. -- Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. -- Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) -- Start a command prompt and execute the commands below to download verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. +* Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. +* Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) +* Start a command prompt and execute the commands below to download verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall -- Thats it! Now you can navigate to the host and port that you specified +* Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified I wanted the `verdaccio` site to be the default site in IIS so I did the following: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts These instructions are based on [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Troubleshooting - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/pl-PL/e2e.md b/website/translated_docs/pl-PL/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/pl-PL/e2e.md +++ b/website/translated_docs/pl-PL/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/pl-PL/iis-server.md b/website/translated_docs/pl-PL/iis-server.md index 1b780a5465ab..9d437e36f252 100644 --- a/website/translated_docs/pl-PL/iis-server.md +++ b/website/translated_docs/pl-PL/iis-server.md @@ -5,23 +5,24 @@ title: "Installing on IIS server" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Utwórz nowy folder w Eksploratorze, gdzie chcesz, aby znajdowało się verdaccio. Na przykład `C:\verdaccio`. Zapisz[package.json](#packagejson), [start.js](#startjs) oraz [web.config](#webconfig) w tym folderze. -- Utwórz nową witrynę w Menedżerze Internetowych Usług Informacyjnych. Możesz ją nazwać jakkolwiek chcesz. Ja nazwę ją verdaccio w tych [instrukcjach](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Określ ścieżkę do lokalizacji, w której zapisałeś wszystkie pliki i numer portu. -- Wróć do Eksploratora i daj użytkownikowi, który uruchamia pulę aplikacji, prawa do modyfikacji folderu, który został właśnie utworzony. Jeśli nazwałeś nową witrynę verdaccio i nie zmieniłeś puli aplikacji, działa ona pod ApplicationPoolIdentity i powinieneś dać użytkownikowi IIS AppPool\verdaccio uprawnienia modyfikacji, jeśli potrzebujesz pomocy, sprawdź instrukcje. (Możesz ograniczyć dostęp później, jeśli chcesz, aby miał on tylko uprawnienia modyfikacyjne do plików iisnode i verdaccio\magazyn) -- Uruchom wiersz polecenia i wykonaj poniższe polecenia, aby pobrać verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Utwórz nowy folder w Eksploratorze, gdzie chcesz, aby znajdowało się verdaccio. Na przykład `C:\verdaccio`. Zapisz[package.json](#packagejson), [start.js](#startjs) oraz [web.config](#webconfig) w tym folderze. +* Utwórz nową witrynę w Menedżerze Internetowych Usług Informacyjnych. Możesz ją nazwać jakkolwiek chcesz. Ja nazwę ją verdaccio w tych [instrukcjach](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Określ ścieżkę do lokalizacji, w której zapisałeś wszystkie pliki i numer portu. +* Wróć do Eksploratora i daj użytkownikowi, który uruchamia pulę aplikacji, prawa do modyfikacji folderu, który został właśnie utworzony. Jeśli nazwałeś nową witrynę verdaccio i nie zmieniłeś puli aplikacji, działa ona pod ApplicationPoolIdentity i powinieneś dać użytkownikowi IIS AppPool\verdaccio uprawnienia modyfikacji, jeśli potrzebujesz pomocy, sprawdź instrukcje. (Możesz ograniczyć dostęp później, jeśli chcesz, aby miał on tylko uprawnienia modyfikacyjne do plików iisnode i verdaccio\magazyn) +* Uruchom wiersz polecenia i wykonaj poniższe polecenia, aby pobrać verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Upewnij się, że w Zaporze systemu Windows masz regułę ruchu przychodzącego akceptującą ruch TCP przez dany port -- To wszystko! Teraz można przejść do hosta i portu, który został określony +* Upewnij się, że w Zaporze systemu Windows masz regułę ruchu przychodzącego akceptującą ruch TCP przez dany port +* To wszystko! Teraz można przejść do hosta i portu, który został określony Chciałem, aby strona `verdaccio` była domyślną stroną w IIS, więc wykonałem następujące czynności: -- Zatrzymałem "Domyślną witrynę sieci Web" i uruchomiłem tylko witrynę "verdaccio" w IIS -- Ustawiłem powiązania na "http", adres ip na "Wszystkie nieprzypisane" na porcie 80 i obyło się bez żadnych ostrzeżeń lub monitów +* Zatrzymałem "Domyślną witrynę sieci Web" i uruchomiłem tylko witrynę "verdaccio" w IIS +* Ustawiłem powiązania na "http", adres ip na "Wszystkie nieprzypisane" na porcie 80 i obyło się bez żadnych ostrzeżeń lub monitów Te instrukcje są oparte na [Host Sinopia w IISw systemie Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ Domyślny plik konfiguracji zostanie utworzony `c:\verdaccio\verdaccio\config.ya ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ Domyślny plik konfiguracji zostanie utworzony `c:\verdaccio\verdaccio\config.ya "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Rozwiązywanie problemów - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/pt-BR/docker.md b/website/translated_docs/pt-BR/docker.md index 087431e42010..4344eddd8cfb 100644 --- a/website/translated_docs/pt-BR/docker.md +++ b/website/translated_docs/pt-BR/docker.md @@ -5,6 +5,7 @@ title: Docker ![alt Docker Pulls Count](https://dockeri.co/image/verdaccio/verdaccio "Docker Pulls Count") + Para fazer o pull do último pré-build[docker image](https://hub.docker.com/r/verdaccio/verdaccio/): ```bash @@ -22,7 +23,6 @@ Para uma versão principal: ```bash docker pull verdaccio/verdaccio:4 ``` - Para uma versão secundária: ```bash @@ -49,6 +49,7 @@ O último argumento define qual imagem usar. A linha acima irá puxar a imagem p Se você tiver [uma imagem construída localmente](#build-your-own-docker-image) use `verdaccio` como o último argumento. + You can use `-v` to bind mount `conf`, `storage` and `plugins` to the hosts filesystem: ```bash @@ -59,9 +60,7 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ -v $V_PATH/plugins:/verdaccio/plugins \ verdaccio/verdaccio ``` - > if you are running in a server, you might want to add -d to run it in the background -> > Note: Verdaccio runs as a non-root user (uid=10001) inside the container, if you use bind mount to override default, you need to make sure the mount directory is assigned to the right user. In above example, you need to run `sudo chown -R 10001:65533 /path/for/verdaccio` otherwise you will get permission errors at runtime. [Use docker volume](https://docs.docker.com/storage/volumes/) is recommended over using bind mount. O Verdaccio 4 fornece um novo conjunto de variáveis de ambiente para modificar permissões, porta ou protocolo http. Abaixo a lista completa: @@ -74,17 +73,21 @@ O Verdaccio 4 fornece um novo conjunto de variáveis de ambiente para modificar | VERDACCIO_PORT | `4873` | a porta do verdaccio | | VERDACCIO_PROTOCOL | `http` | o protocolo http padrão | + + ### SELinux If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. - fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file - +``` + fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file +``` If verdaccio can't read files on a bind-mounted directory and you are unsure, please check `/var/log/audit/audit.log` to confirm that it's a SELinux issue. In this example, the error above produced the following AVC denial. - type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 - +``` +type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 +``` `chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. @@ -97,7 +100,6 @@ If you want to make the directory accessible only to a specific container, use ` An alternative solution is to use [z and Z flags](https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label). To add the `z` flag to the mountpoint `./conf:/verdaccio/conf` simply change it to `./conf:/verdaccio/conf:z`. The `z` flag relabels the directory and makes it accessible by every container while the `Z` flags relables the directory and makes it accessible only to that specific container. However using these flags is dangerous. A small configuration mistake, like mounting `/home/user` or `/var` can mess up the labels on those directories and make the system unbootable. ### Plugins - Plugins can be installed in a separate directory and mounted using Docker or Kubernetes, however make sure you build plugins with native dependencies using the same base image as the Verdaccio Dockerfile. ```docker @@ -113,7 +115,6 @@ USER verdaccio ``` ### Docker and custom port configuration - Any `host:port` configured in `conf/config.yaml` under `listen` **is currently ignored when using docker**. If you want to reach Verdaccio docker instance under different port, lets say `5000` in your `docker run` command add the environment variable `VERDACCIO_PORT=5000` and then expose the port `-p 5000:5000`. @@ -127,7 +128,6 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ Of course the numbers you give to `-p` paremeter need to match. ### Using HTTPS with Docker - You can configure the protocol verdaccio is going to listen on, similarly to the port configuration. You have to overwrite the default value("http") of the `PROTOCOL` environment variable to "https", after you specified the certificates in the config.yaml. ```bash @@ -147,6 +147,7 @@ $ docker-compose up --build You can set the port to use (for both container and host) by prefixing the above command with `VERDACCIO_PORT=5000`. + ```yaml version: '3.1' @@ -205,7 +206,7 @@ Please note that for any of the above docker commands you need to have docker in There is a separate repository that hosts multiple configurations to compose Docker images with `verdaccio`, for instance, as reverse proxy: - +[https://github.com/verdaccio/docker-examples](https://github.com/verdaccio/docker-examples) ## Construções de Docker Personalizadas @@ -221,4 +222,4 @@ There is a separate repository that hosts multiple configurations to compose Doc * [docker-verdaccio](https://github.com/Global-Solutions/docker-verdaccio) * [verdaccio-docker](https://github.com/idahobean/verdaccio-docker) * [verdaccio-server](https://github.com/andru255/verdaccio-server) -* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. \ No newline at end of file +* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. diff --git a/website/translated_docs/pt-BR/e2e.md b/website/translated_docs/pt-BR/e2e.md index 0d7f3fd02898..50f8e611f318 100644 --- a/website/translated_docs/pt-BR/e2e.md +++ b/website/translated_docs/pt-BR/e2e.md @@ -6,7 +6,6 @@ title: "Teste End-to-End" Alguns projetos organizam pacotes em repositórios multi-pacotes ou [mono repositórios](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). O teste E2E é um tópico que geralmente só é relevante para as Interfaces de usuário, porém do ponto de vista do Node.js, **a publicação de pacotes também requerem testes**. - Tal abordagem tem sido realmente difícil de alcançar, considerando: @@ -15,7 +14,7 @@ Tal abordagem tem sido realmente difícil de alcançar, considerando: * Alguns registros de OSS auto-hospedados são muito pesados * Ambientes offline (redes privadas) -O **Verdaccio** é um registro leve com zero configurações que **se encaixa perfeitamente em qualquer fluxo de trabalho E2E + CI**. +Ainda não há uma solução única, cada implementação parece ser específica de cada projeto, você pode verificar algumas delas [clicando neste tópico](https://stackoverflow.com/a/50222427/308341). ## Implementação @@ -23,7 +22,7 @@ Ainda não há uma solução única, cada implementação parece ser específica ### Exemplos usando Bash -Este é o exemplo mais simples usando o Verdaccio em um script bash (extraído do *create-react-app *). +This is the most simple example using Verdaccio in a bash script (extracted from *create-react-app*). ```bash #!/bin/sh @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/pt-BR/github-actions.md b/website/translated_docs/pt-BR/github-actions.md index 09af5a7f19c3..a8a3a1be6e9f 100644 --- a/website/translated_docs/pt-BR/github-actions.md +++ b/website/translated_docs/pt-BR/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Dentro da imagem usa-se os plugins `verdaccio-auth-memory` e `verdaccio-memory` para gerenciar autenticação e armazenamento para acelerar o processo. -Se você quiser saber mais sobre a ação, [visite nosso repositório ](https://github.com/verdaccio/github-actions) dedicado ao GitHub Actions. \ No newline at end of file +Se você quiser saber mais sobre a ação, [visite nosso repositório ](https://github.com/verdaccio/github-actions) dedicado ao GitHub Actions. diff --git a/website/translated_docs/pt-BR/iis-server.md b/website/translated_docs/pt-BR/iis-server.md index 702003991c77..58668c874a2d 100644 --- a/website/translated_docs/pt-BR/iis-server.md +++ b/website/translated_docs/pt-BR/iis-server.md @@ -5,23 +5,24 @@ title: "Instalando em um Servidor ISS" Estas instruções foram escritas para o Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) e [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Instale o IIS Install [iisnode](https://github.com/Azure/iisnode). Certifique-se de instalar os pré-requisitos (Url Rewrite Module & node), conforme explicado nas instruções do iisnode. -- Crie uma nova pasta no Explorer onde você deseja hospedar o verdaccio. Por exemplo `C:\verdaccio`. Salve o [package.json](#packagejson), [start.js](#startjs) e [web.config](#webconfig) nesta pasta. -- Crie um novo site no Gerenciador de Serviços de Informações da Internet. Você pode nomea-lo como quiser. Chamarei de verdaccio nestas [instruções](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Especifique o caminho onde você salvou todos os arquivos e um número de porta. -- Volte para o Explorer e forneça, ao usuário que executa a pool de aplicações, direitos de modificação para a pasta recém criada. Se você nomeou o novo site como verdaccio e não alterou a pool de aplicações, ele está sendo executado sob uma ApplicationPoolIdentity e você deve conceder ao usuário direitos de modificação de IIS AppPool\verdaccio, veja as instruções se precisar de ajuda. (Você pode restringir o acesso mais tarde caso o queira, para que ele tenha apenas direitos de modificação no iisnode e no verdaccio\storage) -- Inicie um prompt de comando e execute os comandos abaixo para fazer o download do verdaccio: +* Instale o IIS Install [iisnode](https://github.com/Azure/iisnode). Certifique-se de instalar os pré-requisitos (Url Rewrite Module & node), conforme explicado nas instruções do iisnode. +* Crie uma nova pasta no Explorer onde você deseja hospedar o verdaccio. Por exemplo `C:\verdaccio`. Salve o [package.json](#packagejson), [start.js](#startjs) e [web.config](#webconfig) nesta pasta. +* Crie um novo site no Gerenciador de Serviços de Informações da Internet. Você pode nomea-lo como quiser. Chamarei de verdaccio nestas [instruções](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Especifique o caminho onde você salvou todos os arquivos e um número de porta. +* Volte para o Explorer e forneça, ao usuário que executa a pool de aplicações, direitos de modificação para a pasta recém criada. Se você nomeou o novo site como verdaccio e não alterou a pool de aplicações, ele está sendo executado sob uma ApplicationPoolIdentity e você deve conceder ao usuário direitos de modificação de IIS AppPool\verdaccio, veja as instruções se precisar de ajuda. (Você pode restringir o acesso mais tarde caso o queira, para que ele tenha apenas direitos de modificação no iisnode e no verdaccio\storage) +* Inicie um prompt de comando e execute os comandos abaixo para fazer o download do verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Verifique se você tem uma regra de entrada aceitando o tráfego TCP na porta do Firewall do Windows -- E é isto! Agora você pode navegar para o host e a porta que você especificou +* Verifique se você tem uma regra de entrada aceitando o tráfego TCP na porta do Firewall do Windows +* E é isto! Agora você pode navegar para o host e a porta que você especificou Eu queria que o site do `verdaccio` fosse o site padrão no IIS, então fiz o seguinte: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts Estas instruções são baseadas em [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). Eu tive que fazer pequenos ajustes na minha configuração web, como você pode ver abaixo, mas você pode encontrar o original do link mencionado que funciona melhor @@ -29,7 +30,7 @@ Um arquivo de configuração padrão será criado `c:\verdaccio\verdaccio\config ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ Um arquivo de configuração padrão será criado `c:\verdaccio\verdaccio\config "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Start.js alternativos para versões do Verdaccio < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Troubleshooting - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/pt-PT/e2e.md b/website/translated_docs/pt-PT/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/pt-PT/e2e.md +++ b/website/translated_docs/pt-PT/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/pt-PT/iis-server.md b/website/translated_docs/pt-PT/iis-server.md index 9f9a4f50cdcd..639b65b14048 100644 --- a/website/translated_docs/pt-PT/iis-server.md +++ b/website/translated_docs/pt-PT/iis-server.md @@ -5,23 +5,24 @@ title: "Installing on IIS server" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. -- Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. -- Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) -- Start a command prompt and execute the commands below to download verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. +* Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. +* Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) +* Start a command prompt and execute the commands below to download verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall -- Thats it! Now you can navigate to the host and port that you specified +* Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified I wanted the `verdaccio` site to be the default site in IIS so I did the following: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts These instructions are based on [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Troubleshooting - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/ro/e2e.md b/website/translated_docs/ro/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/ro/e2e.md +++ b/website/translated_docs/ro/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/ro/github-actions.md b/website/translated_docs/ro/github-actions.md index ec819493429c..e93a32a5e91b 100644 --- a/website/translated_docs/ro/github-actions.md +++ b/website/translated_docs/ro/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Within the image uses `verdaccio-auth-memory` and `verdaccio-memory` plugins to handle authentification and storage to speed up the process. -If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. \ No newline at end of file +If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. diff --git a/website/translated_docs/ro/iis-server.md b/website/translated_docs/ro/iis-server.md index 9f9a4f50cdcd..639b65b14048 100644 --- a/website/translated_docs/ro/iis-server.md +++ b/website/translated_docs/ro/iis-server.md @@ -5,23 +5,24 @@ title: "Installing on IIS server" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. -- Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. -- Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) -- Start a command prompt and execute the commands below to download verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. +* Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. +* Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) +* Start a command prompt and execute the commands below to download verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall -- Thats it! Now you can navigate to the host and port that you specified +* Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified I wanted the `verdaccio` site to be the default site in IIS so I did the following: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts These instructions are based on [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Troubleshooting - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/ro/install.md b/website/translated_docs/ro/install.md index 46b35f61a3bc..3f897208d7f3 100644 --- a/website/translated_docs/ro/install.md +++ b/website/translated_docs/ro/install.md @@ -13,7 +13,7 @@ Verdaccio is a multiplatform web application. To install it, you need a few basi > We highly recommend to use the latest versions of Node Package Manager clients `> npm@6.x | yarn@1.x | | yarn@2.x | pnpm@6.x`. Don't support `npm@5.x` or older. -1. A modern web browser to run the web interface. We actually support `Chrome, Firefox, Edge`. +3. A modern web browser to run the web interface. We actually support `Chrome, Firefox, Edge`. > Verdaccio will support latest Node.js version according the [Node.js Release Working Group](https://github.com/nodejs/Release) recomendations. @@ -21,7 +21,7 @@ Are you still using **Verdaccio 4**?. Check the [migration guide](https://verdac ### Quick Introduction -Learn the basics before getting started, how to install, where is the location of the configuration file and more. +Learn the basics before getting started, how to install, where is the location of the configuration file and more. ## Installing the CLI @@ -92,7 +92,7 @@ Or a `publishConfig` in your `package.json` ## Create Your Own Private NPM Package Tutorial -If you'd like a broader explanation, don't miss the tutorial created by [thedevlife](https://mybiolink.co/thedevlife) on how to Create Your Own Private NPM Package using Verdaccio. +If you'd like a broader explanation, don't miss the tutorial created by [thedevlife](https://mybiolink.co/thedevlife) on how to Create Your Own Private NPM Package using Verdaccio. ## Docker Image @@ -106,4 +106,4 @@ docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio `Verdaccio` is also available as a 1-click install on [Cloudron](https://cloudron.io) -[![Install](https://cloudron.io/img/button.svg)](https://cloudron.io/button.html?app=org.eggertsson.verdaccio) \ No newline at end of file +[![Install](https://cloudron.io/img/button.svg)](https://cloudron.io/button.html?app=org.eggertsson.verdaccio) diff --git a/website/translated_docs/ru-RU/e2e.md b/website/translated_docs/ru-RU/e2e.md index 884fbb9a7acc..fe77fb0d9728 100644 --- a/website/translated_docs/ru-RU/e2e.md +++ b/website/translated_docs/ru-RU/e2e.md @@ -6,7 +6,6 @@ title: "End to End тестирование" Некоторые проекты организуют свой код, разделяя его на много пакетов, другие используют [монорепо](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E-тестирование используется обычно только для тестировани пользовательских интерфейсов, но, с точки зрения Node.js, **публикацию пакетов тоже нужно тестировать**. - Используя этот подход, вы можете столкнуться со следующими трудностями: @@ -15,7 +14,7 @@ title: "End to End тестирование" * Некоторые локальные OSS репозитории - "тяжелые" * Оффлайн-окружение (в приватных сетях) -**Verdaccio** - это "легкий" репозиторий, который аже не нужно конфигурировать, который **прекрасно подходит для E2E + CI**. +"Серебрянной пули" нет, и, похоже, реализация для каждого проекта - особенная; вы можете посмотреть на примеры в [этом обсуждении](https://stackoverflow.com/a/50222427/308341). ## Реализация @@ -23,7 +22,7 @@ title: "End to End тестирование" ### Примеры, использующие Bash -Это наиболее простой пример использования Verdaccio в bash-скрипте (взято из *create-react-app*). +This is the most simple example using Verdaccio in a bash script (extracted from *create-react-app*). ```bash #!/bin/sh @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/ru-RU/iis-server.md b/website/translated_docs/ru-RU/iis-server.md index 09fca0e4fe6f..7e13e1d43dfa 100644 --- a/website/translated_docs/ru-RU/iis-server.md +++ b/website/translated_docs/ru-RU/iis-server.md @@ -5,23 +5,24 @@ title: "Установка на IIS сервер" Эти инструкции были написаны для Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) и [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Установите IIS - установите [iisnode](https://github.com/Azure/iisnode). Убедитесь, что вы так выполнили все предусловния (установили Url Rewrite Module & node), как указано в инструкции для iisnode. -- Создайте новую директорию в Explorer, в которой вы хотите расположить verdaccio. Например `C:\verdaccio`. Сохраните [package.json](#packagejson), [start.js](#startjs) и [web.config](#webconfig) в эту директорию. -- Создайте новый сайт c помощью Internet Information Services Manager. Можете назвать его как хотите. Я буду называть его verdaccio в этих [инструкциях](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Укажите путь к сохранённым файлам и номер порта. -- Вернитесь в Explorer и дайте пользователю, который будет запускать приложение, права на изменение созданной вами ранее директории. Если вы назвали новый сайт verdaccio и не меняли пул приложения, он запустится под ApplicationPoolIdentity и вы должны дать пользователю IIS AppPool\verdaccio права на изменение, смотрите инструкцию, если вам требуется помощь. (Вы можете ограничить доступ позже, если вы хотите, чтобы права распространялись только на iisnode и verdaccio\storage) -- Запустите команду строку и выполните эти команды для загрузки verdaccio: +* Установите IIS - установите [iisnode](https://github.com/Azure/iisnode). Убедитесь, что вы так выполнили все предусловния (установили Url Rewrite Module & node), как указано в инструкции для iisnode. +* Создайте новую директорию в Explorer, в которой вы хотите расположить verdaccio. Например `C:\verdaccio`. Сохраните [package.json](#packagejson), [start.js](#startjs) и [web.config](#webconfig) в эту директорию. +* Создайте новый сайт c помощью Internet Information Services Manager. Можете назвать его как хотите. Я буду называть его verdaccio в этих [инструкциях](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Укажите путь к сохранённым файлам и номер порта. +* Вернитесь в Explorer и дайте пользователю, который будет запускать приложение, права на изменение созданной вами ранее директории. Если вы назвали новый сайт verdaccio и не меняли пул приложения, он запустится под ApplicationPoolIdentity и вы должны дать пользователю IIS AppPool\verdaccio права на изменение, смотрите инструкцию, если вам требуется помощь. (Вы можете ограничить доступ позже, если вы хотите, чтобы права распространялись только на iisnode и verdaccio\storage) +* Запустите команду строку и выполните эти команды для загрузки verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Убедитесь, что у вас есть правила приёма входящего TCP подключения на порт в Windows Firewall -- Вот и всё! Теперь вы можете перейти на хост и порт, который вы указывали +* Убедитесь, что у вас есть правила приёма входящего TCP подключения на порт в Windows Firewall +* Вот и всё! Теперь вы можете перейти на хост и порт, который вы указывали Я хотел чтобы сайт `verdaccio` был сайтом по умолчанию в IIS, по этому я сделал так: -- Я остановил "Default Web Site" и просто запустил сайт "verdaccio" в IIS -- Я установил привязку ip адреса "Всех неназначенных" к "http" на 80ый порт, чтобы избежать предупреждений или запросов +* Я остановил "Default Web Site" и просто запустил сайт "verdaccio" в IIS +* Я установил привязку ip адреса "Всех неназначенных" к "http" на 80ый порт, чтобы избежать предупреждений или запросов Эта инструкция основана на [Host Sinopia в IIS под Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). Мне пришлось настроить мою конфигурацию, так как показано ниже. Но вы можете обратиться к оригиналу по приведённой выше ссылке @@ -29,7 +30,7 @@ title: "Установка на IIS сервер" ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ title: "Установка на IIS сервер" "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Альтернативный start.js для Verdaccio версии < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Устранение проблем - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/sr-CS/docker.md b/website/translated_docs/sr-CS/docker.md index c9bc6a426f40..68567b4f1967 100644 --- a/website/translated_docs/sr-CS/docker.md +++ b/website/translated_docs/sr-CS/docker.md @@ -5,6 +5,7 @@ title: Docker ![alt Docker Pulls Count](https://dockeri.co/image/verdaccio/verdaccio "Docker Pulls Count") + Kako biste povukli (pull) najnoviji pre-built [docker image](https://hub.docker.com/r/verdaccio/verdaccio/): ```bash @@ -22,7 +23,6 @@ Za glavne verzije: ```bash docker pull verdaccio/verdaccio:4 ``` - Za podverzije: ```bash @@ -49,6 +49,7 @@ The last argument defines which image to use. The above line will pull the lates Ako imate [build an image locally](#build-your-own-docker-image) koristite `verdaccio` kao poslednji argument. + Možete koristiti `-v` kako biste vezali (bind) mount `conf`, `storage` i `plugins` za hosts filesystem: ```bash @@ -59,9 +60,7 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ -v $V_PATH/plugins:/verdaccio/plugins \ verdaccio/verdaccio ``` - > if you are running in a server, you might want to add -d to run it in the background -> > Note: Verdaccio runs as a non-root user (uid=10001) inside the container, if you use bind mount to override default, you need to make sure the mount directory is assigned to the right user. In above example, you need to run `sudo chown -R 10001:65533 /path/for/verdaccio` otherwise you will get permission errors at runtime. [Use docker volume](https://docs.docker.com/storage/volumes/) is recommended over using bind mount. Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list: @@ -74,17 +73,21 @@ Verdaccio 4 provides a new set of environment variables to modify either permiss | VERDACCIO_PORT | `4873` | the verdaccio port | | VERDACCIO_PROTOCOL | `http` | the default http protocol | + + ### SELinux If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. - fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file - +``` + fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file +``` If verdaccio can't read files on a bind-mounted directory and you are unsure, please check `/var/log/audit/audit.log` to confirm that it's a SELinux issue. In this example, the error above produced the following AVC denial. - type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 - +``` +type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 +``` `chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. @@ -97,7 +100,6 @@ If you want to make the directory accessible only to a specific container, use ` An alternative solution is to use [z and Z flags](https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label). To add the `z` flag to the mountpoint `./conf:/verdaccio/conf` simply change it to `./conf:/verdaccio/conf:z`. The `z` flag relabels the directory and makes it accessible by every container while the `Z` flags relables the directory and makes it accessible only to that specific container. However using these flags is dangerous. A small configuration mistake, like mounting `/home/user` or `/var` can mess up the labels on those directories and make the system unbootable. ### Plugins - Plugins can be installed in a separate directory and mounted using Docker or Kubernetes, however make sure you build plugins with native dependencies using the same base image as the Verdaccio Dockerfile. ```docker @@ -113,7 +115,6 @@ USER verdaccio ``` ### Docker and custom port configuration - Any `host:port` configured in `conf/config.yaml` under `listen` **is currently ignored when using docker**. If you want to reach Verdaccio docker instance under different port, lets say `5000` in your `docker run` command add the environment variable `VERDACCIO_PORT=5000` and then expose the port `-p 5000:5000`. @@ -127,7 +128,6 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ Of course the numbers you give to `-p` paremeter need to match. ### Using HTTPS with Docker - You can configure the protocol verdaccio is going to listen on, similarly to the port configuration. You have to overwrite the default value("http") of the `PROTOCOL` environment variable to "https", after you specified the certificates in the config.yaml. ```bash @@ -147,6 +147,7 @@ $ docker-compose up --build You can set the port to use (for both container and host) by prefixing the above command with `VERDACCIO_PORT=5000`. + ```yaml version: '3.1' @@ -205,7 +206,7 @@ Please note that for any of the above docker commands you need to have docker in There is a separate repository that hosts multiple configurations to compose Docker images with `verdaccio`, for instance, as reverse proxy: - +[https://github.com/verdaccio/docker-examples](https://github.com/verdaccio/docker-examples) ## Docker Custom Builds @@ -221,4 +222,4 @@ There is a separate repository that hosts multiple configurations to compose Doc * [docker-verdaccio](https://github.com/Global-Solutions/docker-verdaccio) * [verdaccio-docker](https://github.com/idahobean/verdaccio-docker) * [verdaccio-server](https://github.com/andru255/verdaccio-server) -* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. \ No newline at end of file +* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. diff --git a/website/translated_docs/sr-CS/e2e.md b/website/translated_docs/sr-CS/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/sr-CS/e2e.md +++ b/website/translated_docs/sr-CS/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/sr-CS/github-actions.md b/website/translated_docs/sr-CS/github-actions.md index ec819493429c..e93a32a5e91b 100644 --- a/website/translated_docs/sr-CS/github-actions.md +++ b/website/translated_docs/sr-CS/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Within the image uses `verdaccio-auth-memory` and `verdaccio-memory` plugins to handle authentification and storage to speed up the process. -If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. \ No newline at end of file +If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. diff --git a/website/translated_docs/sr-CS/iis-server.md b/website/translated_docs/sr-CS/iis-server.md index f1a7de40fadc..df721fb4d603 100644 --- a/website/translated_docs/sr-CS/iis-server.md +++ b/website/translated_docs/sr-CS/iis-server.md @@ -5,23 +5,24 @@ title: "Instaliranje na IIS server" Navedene instrukcije su pisane za Windows Server 2016, IIS 10, Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) i [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode).. Postarajte se da instalirate sve što je potrebno (Url Rewrite Module & node), kao što je objašnjeno u uputstvima za iisnode. -- Napravite novi folder u Explorer-u, koji će biti host za verdaccio. Na primer `C:\verdaccio`. Usnimite [package.json](#packagejson), [start.js](#startjs) i [web.config](#webconfig) u ovaj folder. -- Napravite novi sajt u Internet Information Services Manager. Možete ga nazvati kako Vam je volja. Zvaćemo ga verdaccio u ovim [instrukcijama](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Odredite path gde ćete snimiti sve fajlove i broj porta. -- Vratite se u Explorer i u okviru foldera koji ste upravo kreirali dodelite prava korisniku koji pokreće application pool. Ako ste imenovali novi sajt kao verdaccio i niste promenili app pool, on radi pod ApplicationPoolIdentity i trebalo bi da dodelite prava korisniku, IIS AppPool\verdaccio modify rights, pogledajte instrukcije ako Vam je potrebna pomoć. (Kasnije ako poželite, možete ograničiti pristup, tako da prava ostaju promenjena samo za iisnode i verdaccio\storage) -- Pokrenite command prompt i izvršite komande navedene ispod kako biste preuzeli verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Napravite novi folder u Explorer-u, koji će biti host za verdaccio. Na primer `C:\verdaccio`. Usnimite [package.json](#packagejson), [start.js](#startjs) i [web.config](#webconfig) u ovaj folder. +* Napravite novi sajt u Internet Information Services Manager. Možete ga nazvati kako Vam je volja. Zvaćemo ga verdaccio u ovim [instrukcijama](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Odredite path gde ćete snimiti sve fajlove i broj porta. +* Vratite se u Explorer i u okviru foldera koji ste upravo kreirali dodelite prava korisniku koji pokreće application pool. Ako ste imenovali novi sajt kao verdaccio i niste promenili app pool, on radi pod ApplicationPoolIdentity i trebalo bi da dodelite prava korisniku, IIS AppPool\verdaccio modify rights, pogledajte instrukcije ako Vam je potrebna pomoć. (Kasnije ako poželite, možete ograničiti pristup, tako da prava ostaju promenjena samo za iisnode i verdaccio\storage) +* Pokrenite command prompt i izvršite komande navedene ispod kako biste preuzeli verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Postarajte se da imate dobro podešeno pravilo za prihvatanje TCP saobraćaja na port, u Windows Firewall -- I to je to! Sada možete da navigate do host-a i porta koje ste odredili +* Postarajte se da imate dobro podešeno pravilo za prihvatanje TCP saobraćaja na port, u Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified Želeo sam da `verdaccio` sajt bude podrazumevani sajt u IIS i zato sam uradio sledeće: -- Stopirao sam "Default Web Site" i pokrenuo jedino "verdaccio" sajt u IIS -- Podesio sam bindings na "http", ip address "All Unassigned" na port 80, ok any warning or prompts +* Stopirao sam "Default Web Site" i pokrenuo jedino "verdaccio" sajt u IIS +* Podesio sam bindings na "http", ip address "All Unassigned" na port 80, ok any warning or prompts Date instrukcije se baziraju na [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). Treba još da čačnem my web config kao što je navedeno ispod, ali može se desiti da navedeni link zapravo radi bolje @@ -29,7 +30,7 @@ Kreiraće se podrazumevana konfiguracija `c:\verdaccio\verdaccio\config.yaml` ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ Kreiraće se podrazumevana konfiguracija `c:\verdaccio\verdaccio\config.yaml` "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Promenite start.js za verzije Verdaccio-a < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Problemi (Troubleshooting) - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/sr-SP/docker.md b/website/translated_docs/sr-SP/docker.md index db31c63c810c..b348bb393d36 100644 --- a/website/translated_docs/sr-SP/docker.md +++ b/website/translated_docs/sr-SP/docker.md @@ -5,6 +5,7 @@ title: Docker ![alt Docker Pulls Count](https://dockeri.co/image/verdaccio/verdaccio "Docker Pulls Count") + Како бисте привукли (pull) најновији pre-built [docker image](https://hub.docker.com/r/verdaccio/verdaccio/): ```bash @@ -22,7 +23,6 @@ docker pull verdaccio/verdaccio ```bash docker pull verdaccio/verdaccio:4 ``` - За подверзије: ```bash @@ -49,6 +49,7 @@ The last argument defines which image to use. The above line will pull the lates Ако употребљавате опцију [build an image locally](#build-your-own-docker-image) користите `verdaccio` као последњи аргумент. + Можете користити `-v` како бисте везали (bind) mount `conf`, `storage` и `plugins` за hosts filesystem: ```bash @@ -59,9 +60,7 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ -v $V_PATH/plugins:/verdaccio/plugins \ verdaccio/verdaccio ``` - > if you are running in a server, you might want to add -d to run it in the background -> > Note: Verdaccio runs as a non-root user (uid=10001) inside the container, if you use bind mount to override default, you need to make sure the mount directory is assigned to the right user. In above example, you need to run `sudo chown -R 10001:65533 /path/for/verdaccio` otherwise you will get permission errors at runtime. [Use docker volume](https://docs.docker.com/storage/volumes/) is recommended over using bind mount. Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list: @@ -74,17 +73,21 @@ Verdaccio 4 provides a new set of environment variables to modify either permiss | VERDACCIO_PORT | `4873` | the verdaccio port | | VERDACCIO_PROTOCOL | `http` | the default http protocol | + + ### SELinux If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. - fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file - +``` + fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file +``` If verdaccio can't read files on a bind-mounted directory and you are unsure, please check `/var/log/audit/audit.log` to confirm that it's a SELinux issue. In this example, the error above produced the following AVC denial. - type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 - +``` +type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 +``` `chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. @@ -97,7 +100,6 @@ If you want to make the directory accessible only to a specific container, use ` An alternative solution is to use [z and Z flags](https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label). To add the `z` flag to the mountpoint `./conf:/verdaccio/conf` simply change it to `./conf:/verdaccio/conf:z`. The `z` flag relabels the directory and makes it accessible by every container while the `Z` flags relables the directory and makes it accessible only to that specific container. However using these flags is dangerous. A small configuration mistake, like mounting `/home/user` or `/var` can mess up the labels on those directories and make the system unbootable. ### Plugins - Plugins can be installed in a separate directory and mounted using Docker or Kubernetes, however make sure you build plugins with native dependencies using the same base image as the Verdaccio Dockerfile. ```docker @@ -113,7 +115,6 @@ USER verdaccio ``` ### Docker and custom port configuration - Any `host:port` configured in `conf/config.yaml` under `listen` **is currently ignored when using docker**. If you want to reach Verdaccio docker instance under different port, lets say `5000` in your `docker run` command add the environment variable `VERDACCIO_PORT=5000` and then expose the port `-p 5000:5000`. @@ -127,7 +128,6 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ Of course the numbers you give to `-p` paremeter need to match. ### Using HTTPS with Docker - You can configure the protocol verdaccio is going to listen on, similarly to the port configuration. You have to overwrite the default value("http") of the `PROTOCOL` environment variable to "https", after you specified the certificates in the config.yaml. ```bash @@ -147,6 +147,7 @@ $ docker-compose up --build You can set the port to use (for both container and host) by prefixing the above command with `VERDACCIO_PORT=5000`. + ```yaml version: '3.1' @@ -205,7 +206,7 @@ Please note that for any of the above docker commands you need to have docker in There is a separate repository that hosts multiple configurations to compose Docker images with `verdaccio`, for instance, as reverse proxy: - +[https://github.com/verdaccio/docker-examples](https://github.com/verdaccio/docker-examples) ## Docker Custom Builds @@ -221,4 +222,4 @@ There is a separate repository that hosts multiple configurations to compose Doc * [docker-verdaccio](https://github.com/Global-Solutions/docker-verdaccio) * [verdaccio-docker](https://github.com/idahobean/verdaccio-docker) * [verdaccio-server](https://github.com/andru255/verdaccio-server) -* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. \ No newline at end of file +* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. diff --git a/website/translated_docs/sr-SP/e2e.md b/website/translated_docs/sr-SP/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/sr-SP/e2e.md +++ b/website/translated_docs/sr-SP/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/sr-SP/iis-server.md b/website/translated_docs/sr-SP/iis-server.md index ae9cc7ea67c5..a591748708ed 100644 --- a/website/translated_docs/sr-SP/iis-server.md +++ b/website/translated_docs/sr-SP/iis-server.md @@ -5,23 +5,24 @@ title: "Инсталирање на IIS server" Наведене инструкције су писане за Windows Server 2016, IIS 10, Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) и [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode).. Постарајте се да сте инсталирали све што је потребно (Url Rewrite Module & node), као што је објашњено у упутствима за iisnode. -- Направите нови фолдер у Explorer-у, који ће бити host за verdaccio. На пример `C:\verdaccio`. Уснимите [package.json](#packagejson), [start.js](#startjs) и [web.config](#webconfig) у овај фолдер. -- Направите нови сајт у Internet Information Services Manager. Можете га назвати како Вам је воља. Зваћемо га verdaccio у овим [инструкцијама](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Одаберите path где ћете снимити све фајлове и број порта. -- Вратите се у Explorer и у оквиру фолдера који сте управо креирали доделите права кориснику који покреће application pool. Ако сте именовали нови сајт као verdaccio и нисте променили app pool, он ради под ApplicationPoolIdentity и требало би да доделите права кориснику, IIS AppPool\verdaccio modify rights, погледајте инструкције ако Вам је потребна помоћ. (Касније ако пожелите, можете ограничити приступ, тако да права остају промењена само за iisnode и verdaccio\storage) -- Покрените command prompt и извршите команде наведене испод како бисте преузели verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Направите нови фолдер у Explorer-у, који ће бити host за verdaccio. На пример `C:\verdaccio`. Уснимите [package.json](#packagejson), [start.js](#startjs) и [web.config](#webconfig) у овај фолдер. +* Направите нови сајт у Internet Information Services Manager. Можете га назвати како Вам је воља. Зваћемо га verdaccio у овим [инструкцијама](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Одаберите path где ћете снимити све фајлове и број порта. +* Вратите се у Explorer и у оквиру фолдера који сте управо креирали доделите права кориснику који покреће application pool. Ако сте именовали нови сајт као verdaccio и нисте променили app pool, он ради под ApplicationPoolIdentity и требало би да доделите права кориснику, IIS AppPool\verdaccio modify rights, погледајте инструкције ако Вам је потребна помоћ. (Касније ако пожелите, можете ограничити приступ, тако да права остају промењена само за iisnode и verdaccio\storage) +* Покрените command prompt и извршите команде наведене испод како бисте преузели verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Постарајте се да имате добро подешено правило за прихватање TCP саобраћаја на порт, у Windows Firewall -- И то је то! Сада можете да навигате до host-a и порта које сте одредили +* Постарајте се да имате добро подешено правило за прихватање TCP саобраћаја на порт, у Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified Желео сам да `verdaccio` сајт буде подразумевани сајт у IIS и зато сам урадио следеће: -- Стопирао сам "Default Web Site" и покренуо јединo "verdaccio" сајт у IIS -- Подесио сам bindings на "http", ip address "All Unassigned" на port 80, ok any warning or prompts +* Стопирао сам "Default Web Site" и покренуо јединo "verdaccio" сајт у IIS +* Подесио сам bindings на "http", ip address "All Unassigned" на port 80, ok any warning or prompts Дате инструкције се базирају на [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). Треба још да чачнем my web config као што је наведено испод, али може се десити да наведени линк заправо ради боље @@ -29,7 +30,7 @@ title: "Инсталирање на IIS server" ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ title: "Инсталирање на IIS server" "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Промените start.js за верзије Verdaccio-а < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Проблеми (Troubleshooting) - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/tg-TJ/docker.md b/website/translated_docs/tg-TJ/docker.md index 9f29f8db39fa..a0bc392a316f 100644 --- a/website/translated_docs/tg-TJ/docker.md +++ b/website/translated_docs/tg-TJ/docker.md @@ -5,6 +5,7 @@ title: Docker ![alt Docker Pulls Count](https://dockeri.co/image/verdaccio/verdaccio "Docker Pulls Count") + To pull the latest pre-built [docker image](https://hub.docker.com/r/verdaccio/verdaccio/): ```bash @@ -22,7 +23,6 @@ For a major version: ```bash docker pull verdaccio/verdaccio:4 ``` - For a minor version: ```bash @@ -49,6 +49,7 @@ The last argument defines which image to use. The above line will pull the lates If you have [build an image locally](#build-your-own-docker-image) use `verdaccio` as the last argument. + You can use `-v` to bind mount `conf`, `storage` and `plugins` to the hosts filesystem: ```bash @@ -59,9 +60,7 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ -v $V_PATH/plugins:/verdaccio/plugins \ verdaccio/verdaccio ``` - > if you are running in a server, you might want to add -d to run it in the background -> > Note: Verdaccio runs as a non-root user (uid=10001) inside the container, if you use bind mount to override default, you need to make sure the mount directory is assigned to the right user. In above example, you need to run `sudo chown -R 10001:65533 /path/for/verdaccio` otherwise you will get permission errors at runtime. [Use docker volume](https://docs.docker.com/storage/volumes/) is recommended over using bind mount. Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list: @@ -74,17 +73,21 @@ Verdaccio 4 provides a new set of environment variables to modify either permiss | VERDACCIO_PORT | `4873` | the verdaccio port | | VERDACCIO_PROTOCOL | `http` | the default http protocol | + + ### SELinux If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. - fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file - +``` + fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file +``` If verdaccio can't read files on a bind-mounted directory and you are unsure, please check `/var/log/audit/audit.log` to confirm that it's a SELinux issue. In this example, the error above produced the following AVC denial. - type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 - +``` +type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 +``` `chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. @@ -97,7 +100,6 @@ If you want to make the directory accessible only to a specific container, use ` An alternative solution is to use [z and Z flags](https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label). To add the `z` flag to the mountpoint `./conf:/verdaccio/conf` simply change it to `./conf:/verdaccio/conf:z`. The `z` flag relabels the directory and makes it accessible by every container while the `Z` flags relables the directory and makes it accessible only to that specific container. However using these flags is dangerous. A small configuration mistake, like mounting `/home/user` or `/var` can mess up the labels on those directories and make the system unbootable. ### Plugins - Plugins can be installed in a separate directory and mounted using Docker or Kubernetes, however make sure you build plugins with native dependencies using the same base image as the Verdaccio Dockerfile. ```docker @@ -113,7 +115,6 @@ USER verdaccio ``` ### Docker and custom port configuration - Any `host:port` configured in `conf/config.yaml` under `listen` **is currently ignored when using docker**. If you want to reach Verdaccio docker instance under different port, lets say `5000` in your `docker run` command add the environment variable `VERDACCIO_PORT=5000` and then expose the port `-p 5000:5000`. @@ -127,7 +128,6 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ Of course the numbers you give to `-p` paremeter need to match. ### Using HTTPS with Docker - You can configure the protocol verdaccio is going to listen on, similarly to the port configuration. You have to overwrite the default value("http") of the `PROTOCOL` environment variable to "https", after you specified the certificates in the config.yaml. ```bash @@ -147,6 +147,7 @@ $ docker-compose up --build You can set the port to use (for both container and host) by prefixing the above command with `VERDACCIO_PORT=5000`. + ```yaml version: '3.1' @@ -205,7 +206,7 @@ Please note that for any of the above docker commands you need to have docker in There is a separate repository that hosts multiple configurations to compose Docker images with `verdaccio`, for instance, as reverse proxy: - +[https://github.com/verdaccio/docker-examples](https://github.com/verdaccio/docker-examples) ## Docker Custom Builds @@ -221,4 +222,4 @@ There is a separate repository that hosts multiple configurations to compose Doc * [docker-verdaccio](https://github.com/Global-Solutions/docker-verdaccio) * [verdaccio-docker](https://github.com/idahobean/verdaccio-docker) * [verdaccio-server](https://github.com/andru255/verdaccio-server) -* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. \ No newline at end of file +* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. diff --git a/website/translated_docs/tg-TJ/e2e.md b/website/translated_docs/tg-TJ/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/tg-TJ/e2e.md +++ b/website/translated_docs/tg-TJ/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/tg-TJ/github-actions.md b/website/translated_docs/tg-TJ/github-actions.md index ec819493429c..e93a32a5e91b 100644 --- a/website/translated_docs/tg-TJ/github-actions.md +++ b/website/translated_docs/tg-TJ/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Within the image uses `verdaccio-auth-memory` and `verdaccio-memory` plugins to handle authentification and storage to speed up the process. -If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. \ No newline at end of file +If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. diff --git a/website/translated_docs/tg-TJ/iis-server.md b/website/translated_docs/tg-TJ/iis-server.md index 9f9a4f50cdcd..639b65b14048 100644 --- a/website/translated_docs/tg-TJ/iis-server.md +++ b/website/translated_docs/tg-TJ/iis-server.md @@ -5,23 +5,24 @@ title: "Installing on IIS server" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. -- Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. -- Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) -- Start a command prompt and execute the commands below to download verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. +* Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. +* Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) +* Start a command prompt and execute the commands below to download verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall -- Thats it! Now you can navigate to the host and port that you specified +* Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall +* Thats it! Now you can navigate to the host and port that you specified I wanted the `verdaccio` site to be the default site in IIS so I did the following: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts These instructions are based on [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Troubleshooting - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/vi-VN/docker.md b/website/translated_docs/vi-VN/docker.md index eafdc7072c4e..9a93e4032892 100644 --- a/website/translated_docs/vi-VN/docker.md +++ b/website/translated_docs/vi-VN/docker.md @@ -5,6 +5,7 @@ title: Docker ![alt Docker Pulls Count](https://dockeri.co/image/verdaccio/verdaccio "Docker Pulls Count") + Để tải [hình ảnh docker mới nhất](https://hub.docker.com/r/verdaccio/verdaccio/): ```bash @@ -22,7 +23,6 @@ Bắt đầu với phiên bản `v2.x`, bạn có thể tải những hình ản ```bash docker pull verdaccio/verdaccio:4 ``` - Đối với phiên bản phụ: ```bash @@ -49,6 +49,7 @@ The last argument defines which image to use. The above line will pull the lates Khi bạn muốn tạo [một bản sao cục bộ](#build-your-own-docker-image) hãy dùng `verdaccio` làm tham số cuối cùng. + Bạn có thể sử dụng `-v` để liên kết với `conf`, `storage` và `plugins` với hệ thống tệp host: ```bash @@ -59,9 +60,7 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ -v $V_PATH/plugins:/verdaccio/plugins \ verdaccio/verdaccio ``` - > if you are running in a server, you might want to add -d to run it in the background -> > Note: Verdaccio runs as a non-root user (uid=10001) inside the container, if you use bind mount to override default, you need to make sure the mount directory is assigned to the right user. In above example, you need to run `sudo chown -R 10001:65533 /path/for/verdaccio` otherwise you will get permission errors at runtime. [Use docker volume](https://docs.docker.com/storage/volumes/) is recommended over using bind mount. Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list: @@ -74,17 +73,21 @@ Verdaccio 4 provides a new set of environment variables to modify either permiss | VERDACCIO_PORT | `4873` | the verdaccio port | | VERDACCIO_PROTOCOL | `http` | the default http protocol | + + ### SELinux If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. - fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file - +``` + fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file +``` If verdaccio can't read files on a bind-mounted directory and you are unsure, please check `/var/log/audit/audit.log` to confirm that it's a SELinux issue. In this example, the error above produced the following AVC denial. - type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 - +``` +type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 +``` `chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. @@ -97,7 +100,6 @@ If you want to make the directory accessible only to a specific container, use ` An alternative solution is to use [z and Z flags](https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label). To add the `z` flag to the mountpoint `./conf:/verdaccio/conf` simply change it to `./conf:/verdaccio/conf:z`. The `z` flag relabels the directory and makes it accessible by every container while the `Z` flags relables the directory and makes it accessible only to that specific container. However using these flags is dangerous. A small configuration mistake, like mounting `/home/user` or `/var` can mess up the labels on those directories and make the system unbootable. ### Plugins - Plugins can be installed in a separate directory and mounted using Docker or Kubernetes, however make sure you build plugins with native dependencies using the same base image as the Verdaccio Dockerfile. ```docker @@ -113,7 +115,6 @@ USER verdaccio ``` ### Docker and custom port configuration - Any `host:port` configured in `conf/config.yaml` under `listen` **is currently ignored when using docker**. If you want to reach Verdaccio docker instance under different port, lets say `5000` in your `docker run` command add the environment variable `VERDACCIO_PORT=5000` and then expose the port `-p 5000:5000`. @@ -127,7 +128,6 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ Of course the numbers you give to `-p` paremeter need to match. ### Using HTTPS with Docker - You can configure the protocol verdaccio is going to listen on, similarly to the port configuration. You have to overwrite the default value("http") of the `PROTOCOL` environment variable to "https", after you specified the certificates in the config.yaml. ```bash @@ -147,6 +147,7 @@ $ docker-compose up --build You can set the port to use (for both container and host) by prefixing the above command with `VERDACCIO_PORT=5000`. + ```yaml version: '3.1' @@ -205,7 +206,7 @@ Please note that for any of the above docker commands you need to have docker in There is a separate repository that hosts multiple configurations to compose Docker images with `verdaccio`, for instance, as reverse proxy: - +[https://github.com/verdaccio/docker-examples](https://github.com/verdaccio/docker-examples) ## Tạo tùy chỉnh Docker @@ -221,4 +222,4 @@ There is a separate repository that hosts multiple configurations to compose Doc * [docker-verdaccio](https://github.com/Global-Solutions/docker-verdaccio) * [verdaccio-docker](https://github.com/idahobean/verdaccio-docker) * [verdaccio-server](https://github.com/andru255/verdaccio-server) -* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. \ No newline at end of file +* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. diff --git a/website/translated_docs/vi-VN/e2e.md b/website/translated_docs/vi-VN/e2e.md index 67e5545c45ef..0a4f17ba85d2 100644 --- a/website/translated_docs/vi-VN/e2e.md +++ b/website/translated_docs/vi-VN/e2e.md @@ -6,7 +6,6 @@ title: "End to End testing" Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/vi-VN/github-actions.md b/website/translated_docs/vi-VN/github-actions.md index ec819493429c..e93a32a5e91b 100644 --- a/website/translated_docs/vi-VN/github-actions.md +++ b/website/translated_docs/vi-VN/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Within the image uses `verdaccio-auth-memory` and `verdaccio-memory` plugins to handle authentification and storage to speed up the process. -If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. \ No newline at end of file +If you want to know more about the action, [visit our repository](https://github.com/verdaccio/github-actions) dedicated for GitHub Actions. diff --git a/website/translated_docs/vi-VN/iis-server.md b/website/translated_docs/vi-VN/iis-server.md index 387f9cb0a4ef..910343594d1f 100644 --- a/website/translated_docs/vi-VN/iis-server.md +++ b/website/translated_docs/vi-VN/iis-server.md @@ -5,23 +5,24 @@ title: "Cài đặt trên máy chủ IIS" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Bạn hãy tạo một thư mục mới trong Explorer để lưu trữ verdaccio. Ví dụ: `C:\verdaccio`. Lưu [package.json](#packagejson), [start.js](#startjs) và [web.config](#webconfig) vào thư mục này. -- Tạo một trang mới trong Trình quản lý dịch vụ thông tin Internet. Hãy đặt tên cho thư mục theo ý thích của bạn. Tôi sẽ gọi là verdaccio như trong [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities) này. Xác định đường dẫn để lưu tất cả các tệp và số cổng. -- Trở lại Explorer và cấp quyền cho người dùng sử dụng nhóm ứng dụng trong thư mục bạn vừa tạo. Trong trường hợp bạn đã đặt tên trang này là verdaccio và chưa sửa đổi nhóm ứng dụng, đồng thời trang đang chạy ứng dụng ApplicationPoolIdentity, bạn nên cấp cho người dùng quyền sửa đổi IIS AppPool\verdaccio. Nếu bạn cần trợ giúp, vui lòng tham khảo hướng dẫn. (Nếu cần, bạn có thể hạn chế quyền truy cập trong tương lai, chỉ cho phép quyền sửa đổi trong iisnode và verdaccio\storage) -- Bắt đầu dòng lệnh và thực hiện lệnh sau để tải verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Bạn hãy tạo một thư mục mới trong Explorer để lưu trữ verdaccio. Ví dụ: `C:\verdaccio`. Lưu [package.json](#packagejson), [start.js](#startjs) và [web.config](#webconfig) vào thư mục này. +* Tạo một trang mới trong Trình quản lý dịch vụ thông tin Internet. Hãy đặt tên cho thư mục theo ý thích của bạn. Tôi sẽ gọi là verdaccio như trong [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities) này. Xác định đường dẫn để lưu tất cả các tệp và số cổng. +* Trở lại Explorer và cấp quyền cho người dùng sử dụng nhóm ứng dụng trong thư mục bạn vừa tạo. Trong trường hợp bạn đã đặt tên trang này là verdaccio và chưa sửa đổi nhóm ứng dụng, đồng thời trang đang chạy ứng dụng ApplicationPoolIdentity, bạn nên cấp cho người dùng quyền sửa đổi IIS AppPool\verdaccio. Nếu bạn cần trợ giúp, vui lòng tham khảo hướng dẫn. (Nếu cần, bạn có thể hạn chế quyền truy cập trong tương lai, chỉ cho phép quyền sửa đổi trong iisnode và verdaccio\storage) +* Bắt đầu dòng lệnh và thực hiện lệnh sau để tải verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Hãy chắc chắn bạn có yêu cầu gửi đến rằng chấp nhận lưu lượng truy cập TCP vào cổng tường lửa của Windows -- Sau đấy bạn có thể điều hướng đến máy chủ và cổng mà bạn chỉ định +* Hãy chắc chắn bạn có yêu cầu gửi đến rằng chấp nhận lưu lượng truy cập TCP vào cổng tường lửa của Windows +* Thats it! Now you can navigate to the host and port that you specified Tôi muốn trang web `verdaccio` trở thành trang mặc định trong IIS, vì vậy tôi đã làm như sau: -- Tôi đã hủy bỏ "trang web mặc định" và chỉ bắt đầu trang "verdaccio" trong IIS -- Tôi cài đặt các binding thành "http" và địa chỉ Ip là "All Unassigned" ở cổng 80, nhấp vào ok cho bất kỳ cảnh báo hoặc lời nhắc nào +* Tôi đã hủy bỏ "trang web mặc định" và chỉ bắt đầu trang "verdaccio" trong IIS +* Tôi cài đặt các binding thành "http" và địa chỉ Ip là "All Unassigned" ở cổng 80, nhấp vào ok cho bất kỳ cảnh báo hoặc lời nhắc nào Những nguyên tắc này dựa trên [ Host Sinopia trong IIS trên Windows ](https://gist.github.com/HCanber/4dd8409f79991a09ac75). Tôi phải điều chỉnh cấu hình trang web của mình như sau, tuy nhiên bạn có thể nhận thấy cấu hình ban đầu trong liên kết được đề cập ở trên hoạt động tốt hơn @@ -29,7 +30,7 @@ Tệp tin cấu hình mặc định `c:\verdaccio\verdaccio\config.yaml` sẽ đ ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ Tệp tin cấu hình mặc định `c:\verdaccio\verdaccio\config.yaml` sẽ đ "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Khắc phục sự cố - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/yo-NG/docker.md b/website/translated_docs/yo-NG/docker.md index c312e2bc8d34..9beb2d8e7e0f 100644 --- a/website/translated_docs/yo-NG/docker.md +++ b/website/translated_docs/yo-NG/docker.md @@ -5,6 +5,7 @@ title: Docker ![alt Docker Pulls Count](https://dockeri.co/image/verdaccio/verdaccio "Docker Pulls Count") + Lati fa [aworan docker](https://hub.docker.com/r/verdaccio/verdaccio/) tuntun to ti jẹ kikọ siwaju: ```bash @@ -22,7 +23,6 @@ Fun ẹya pataki kan: ```bash docker pull verdaccio/verdaccio:4 ``` - Fun ẹya kekere kan: ```bash @@ -45,10 +45,11 @@ Lati mu apoti docker ṣiṣẹ: docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio ``` -Ariyanjiyan ikẹhin n sọ iru aworan to ma jẹ lilo. Ila to wa loke yoo fa aworan tuntun ti o ti wa ni kikọ tẹlẹ lati dockerhub, ti o ko ba ti ṣe bẹ tẹlẹ. +The last argument defines which image to use. The above line will pull the latest prebuilt image from dockerhub, if you haven't done that already. Ti o ba ti [kọ aworan kan ni ilana ibilẹ](#build-your-own-docker-image) lo `verdaccio` gẹgẹbi ariyanjiyan ikẹhin. + O le lo `-v` lati de atopọ `conf`, `storage` ati `plugins` mọ eto faili ti olugbalejo naa: ```bash @@ -59,12 +60,10 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ -v $V_PATH/plugins:/verdaccio/plugins \ verdaccio/verdaccio ``` - > if you are running in a server, you might want to add -d to run it in the background -> > Note: Verdaccio runs as a non-root user (uid=10001) inside the container, if you use bind mount to override default, you need to make sure the mount directory is assigned to the right user. In above example, you need to run `sudo chown -R 10001:65533 /path/for/verdaccio` otherwise you will get permission errors at runtime. [Use docker volume](https://docs.docker.com/storage/volumes/) is recommended over using bind mount. -Verdaccio 4 n pese awọn iyipada ayika tuntun lati ṣayipada si boya awọn igbanilaaye, ibudo tabi Ilana Http. Eyi ni akojọ pipe: +Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list: | Ohun ini | atilẹwa | Apejuwe | | --------------------- | ---------------- | ----------------------------------------------------------------------- | @@ -74,17 +73,21 @@ Verdaccio 4 n pese awọn iyipada ayika tuntun lati ṣayipada si boya awọn ig | VERDACCIO_PORT | `4873` | ibudo verdaccio naa | | VERDACCIO_PROTOCOL | `http` | ilana http atilẹwa naa | + + ### SELinux If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. - fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file - +``` + fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file +``` If verdaccio can't read files on a bind-mounted directory and you are unsure, please check `/var/log/audit/audit.log` to confirm that it's a SELinux issue. In this example, the error above produced the following AVC denial. - type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 - +``` +type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 +``` `chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. @@ -97,7 +100,6 @@ If you want to make the directory accessible only to a specific container, use ` An alternative solution is to use [z and Z flags](https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label). To add the `z` flag to the mountpoint `./conf:/verdaccio/conf` simply change it to `./conf:/verdaccio/conf:z`. The `z` flag relabels the directory and makes it accessible by every container while the `Z` flags relables the directory and makes it accessible only to that specific container. However using these flags is dangerous. A small configuration mistake, like mounting `/home/user` or `/var` can mess up the labels on those directories and make the system unbootable. ### Awọn ohun elo - Plugins can be installed in a separate directory and mounted using Docker or Kubernetes, however make sure you build plugins with native dependencies using the same base image as the Verdaccio Dockerfile. ```docker @@ -113,7 +115,6 @@ USER verdaccio ``` ### Docker and custom port configuration - Any `host:port` configured in `conf/config.yaml` under `listen` **is currently ignored when using docker**. If you want to reach Verdaccio docker instance under different port, lets say `5000` in your `docker run` command add the environment variable `VERDACCIO_PORT=5000` and then expose the port `-p 5000:5000`. @@ -127,7 +128,6 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ Of course the numbers you give to `-p` paremeter need to match. ### Using HTTPS with Docker - You can configure the protocol verdaccio is going to listen on, similarly to the port configuration. You have to overwrite the default value("http") of the `PROTOCOL` environment variable to "https", after you specified the certificates in the config.yaml. ```bash @@ -147,6 +147,7 @@ $ docker-compose up --build You can set the port to use (for both container and host) by prefixing the above command with `VERDACCIO_PORT=5000`. + ```yaml version: '3.1' @@ -205,7 +206,7 @@ Please note that for any of the above docker commands you need to have docker in There is a separate repository that hosts multiple configurations to compose Docker images with `verdaccio`, for instance, as reverse proxy: - +[https://github.com/verdaccio/docker-examples](https://github.com/verdaccio/docker-examples) ## Awọn agbedide Akanṣe ti Docker @@ -221,4 +222,4 @@ There is a separate repository that hosts multiple configurations to compose Doc * [docker-verdaccio](https://github.com/Global-Solutions/docker-verdaccio) * [verdaccio-docker](https://github.com/idahobean/verdaccio-docker) * [verdaccio-server](https://github.com/andru255/verdaccio-server) -* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. \ No newline at end of file +* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. diff --git a/website/translated_docs/yo-NG/e2e.md b/website/translated_docs/yo-NG/e2e.md index 183351bf1740..bdba6f7cd645 100644 --- a/website/translated_docs/yo-NG/e2e.md +++ b/website/translated_docs/yo-NG/e2e.md @@ -3,10 +3,9 @@ id: e2e title: "Idanwo Opin si Opin" --- -Awọn iṣẹ akanṣe kan ma n ṣeto awọn akojọ ni awọn ibi ipamọ ti ọlọpọlọpọ-akojọ tabi [onibi ipamọ kan](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). Idanwo E2E jẹ akọle ti o ma n saba yẹ fun Awọn Intafeesi Olumulo nikan, ṣugbọn lati oju iwoye ti Node.js, **sise atẹjade awọn akojọ naa tun nilo lati ni idanwo**. +Awọn iṣẹ akanṣe kan ma n ṣeto awọn akojọ ni awọn ibi ipamọ ti ọlọpọlọpọ-akojọ tabi [onibi ipamọ kan](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Iru ọna yẹn ti jẹ eyi to soro gidi gan lati ni aṣeyọri pẹlu riro iwọnyi: @@ -15,7 +14,7 @@ Iru ọna yẹn ti jẹ eyi to soro gidi gan lati ni aṣeyọri pẹlu riro iw * Awọn ibi iforukọsilẹ OSS agbalejo-alara ẹni kan ti wuwo ju * Awọn awujọ alaisilorila (awọn nẹtiwọki aladani) -**Verdaccio** jẹ ibi iforukọsilẹ fifuyẹ pẹlu iṣeto-odo ti **o ni ibamu didanmọran pẹlu eyikeyi E2E + CI ilana iṣẹ**. +Ko ti si ọta fadaka kankan, imuṣiṣẹ kọọkan dabi pe o jẹ pato fun iṣẹ akanṣe kọọkan, o le ṣayẹwo diẹ ninu wọn ni okun atẹle yii [tẹ ibi](https://stackoverflow.com/a/50222427/308341). ## Imuṣiṣẹ @@ -23,7 +22,7 @@ Ko ti si ọta fadaka kankan, imuṣiṣẹ kọọkan dabi pe o jẹ pato fun i ### Apẹẹrẹ nipa lilo Bash -Eyi ni apẹẹrẹ to rọrun julọ nipa lilo Verdaccio ninu iwe afọwọkọ bash kan (ti o jẹ fifajade lati *create-react-app*). +This is the most simple example using Verdaccio in a bash script (extracted from *create-react-app*). ```bash #!/bin/sh @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/yo-NG/github-actions.md b/website/translated_docs/yo-NG/github-actions.md index cff4b1eec7b6..ae6eceb14fe2 100644 --- a/website/translated_docs/yo-NG/github-actions.md +++ b/website/translated_docs/yo-NG/github-actions.md @@ -20,4 +20,4 @@ The action will perform a `npm publish` and if the publishing finishes successfu Laarin aworan `verdaccio-auth-memory` ati `verdaccio-memory` lo awọn ohun elo lati sakoso sise ifasẹsi ati ipamọ lati mu ki ilana na yara si. -Ti o ba fẹ mọ sii nipa igbesẹ naa, [lọ si ibi ipamọ wa](https://github.com/verdaccio/github-actions) ti a gbekalẹ fun Awọn igbesẹ GitHub. \ No newline at end of file +Ti o ba fẹ mọ sii nipa igbesẹ naa, [lọ si ibi ipamọ wa](https://github.com/verdaccio/github-actions) ti a gbekalẹ fun Awọn igbesẹ GitHub. diff --git a/website/translated_docs/yo-NG/iis-server.md b/website/translated_docs/yo-NG/iis-server.md index dc909e3ad4a1..961f4728fadb 100644 --- a/website/translated_docs/yo-NG/iis-server.md +++ b/website/translated_docs/yo-NG/iis-server.md @@ -5,23 +5,24 @@ title: "Fifi sori olupese IIS" Awọn ilana wọnyi ni a kọ fun Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Fi IIS sori ẹ̀rọ [iisnode](https://github.com/Azure/iisnode). Ri daju pe o fi awọn ohun inilo ti o ṣe pataki sori ẹrọ (Url Rewrite Module & node) bi a ti ṣe salaye ninu ilana fun iisnode. -- Ṣẹda foda tuntun ni Explorer ni ibi ti o fẹ gbalejo verdaccio. Fun apẹẹrẹ `C:\verdaccio`. Fi [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) pamọ sinu foda yii. -- Ṣẹda aaye ayelujara tuntun kan ni Alakoso Awọn Iṣẹ Alaye Ayelujara. O le fun lorukọ eyikeyi ti o fẹ. Mo ma pe ni verdaccio ninu [awọn alaye yii](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Yan pato ọna ibi ti o ti fi gbogbo awọn faili ati nọmba ibudo kan pamọ si. -- Pada lọ si Explorer ki o si fun olumulo ti o n lo awọn ẹtọ atunṣe adagun ohun elo si foda ti o sẹsẹ ṣẹda. Ti o ba ti fun aaye ayelujara tuntun naa ni orukọ verdaccio ati ti o ko yi adagun ohun elo naa pada, o n ṣiṣẹ labẹ ApplicationPoolIdentity kan atipe o yẹ ki o fun olumulo naa ni awọn ẹtọ atunṣe IIS AppPool\verdaccio wo awọn ilana ti o ba nilo iranlọwọ. (O le se idena wiwọle to ba ya ti o ba fẹ to fi ma jẹ wipe awọn ẹtọ atunṣe nikan ni o ma ni lori iisnode ati verdaccio\storage) -- Bẹrẹ aṣẹ kan tọ ati ki o si ṣe abayọri awọn aṣẹ isalẹ yii lati gba verdaccio sori ẹrọ: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Ṣẹda foda tuntun ni Explorer ni ibi ti o fẹ gbalejo verdaccio. Fun apẹẹrẹ `C:\verdaccio`. Fi [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) pamọ sinu foda yii. +* Ṣẹda aaye ayelujara tuntun kan ni Alakoso Awọn Iṣẹ Alaye Ayelujara. O le fun lorukọ eyikeyi ti o fẹ. Mo ma pe ni verdaccio ninu [awọn alaye yii](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Yan pato ọna ibi ti o ti fi gbogbo awọn faili ati nọmba ibudo kan pamọ si. +* Pada lọ si Explorer ki o si fun olumulo ti o n lo awọn ẹtọ atunṣe adagun ohun elo si foda ti o sẹsẹ ṣẹda. Ti o ba ti fun aaye ayelujara tuntun naa ni orukọ verdaccio ati ti o ko yi adagun ohun elo naa pada, o n ṣiṣẹ labẹ ApplicationPoolIdentity kan atipe o yẹ ki o fun olumulo naa ni awọn ẹtọ atunṣe IIS AppPool\verdaccio wo awọn ilana ti o ba nilo iranlọwọ. (O le se idena wiwọle to ba ya ti o ba fẹ to fi ma jẹ wipe awọn ẹtọ atunṣe nikan ni o ma ni lori iisnode ati verdaccio\storage) +* Bẹrẹ aṣẹ kan tọ ati ki o si ṣe abayọri awọn aṣẹ isalẹ yii lati gba verdaccio sori ẹrọ: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Ri daju pe o ni ofin to n wọle bọ to tẹwọgba abẹwo TCP si ibudo naa ni Awọn aabo ayelujara ti Windows -- Ohun niyẹn! Bayi o le ṣe ilọ kiri si agbalejo naa ati ibudo ti o yan ni pato +* Ri daju pe o ni ofin to n wọle bọ to tẹwọgba abẹwo TCP si ibudo naa ni Awọn aabo ayelujara ti Windows +* Thats it! Now you can navigate to the host and port that you specified Mo fẹ jẹ ki aaye ayelujara `verdaccio` jẹ aaye ayelujara atilẹwa ni IIS fun idi eyi mo se awọn ohun wọnyii: -- Mo da "Aaye Ayelujara Atilẹwa" duro atipe mo kan bẹrẹ aaye ayelujara "verdaccio" nikan ni IIS -- Mo seto awọn isopọ naa si "http", adirẹsi ip "Gbogbo eyi ti ko jẹ Pinpin" lori ibudo 80, fọwọsi eyikeyi ikilọ tabi awọn ibeere +* Mo da "Aaye Ayelujara Atilẹwa" duro atipe mo kan bẹrẹ aaye ayelujara "verdaccio" nikan ni IIS +* Mo seto awọn isopọ naa si "http", adirẹsi ip "Gbogbo eyi ti ko jẹ Pinpin" lori ibudo 80, fọwọsi eyikeyi ikilọ tabi awọn ibeere Awọn itọsọna wọnyi da lori [Host Sinopia ni IIS lori Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). Mo ni lati ṣe ayipada iṣeto wẹẹbu mi gẹgẹbi isalẹ yii ṣugbọn o le ri ojulowo naa lati ọdọ itọkasi asopọ to n ṣiṣẹ daradara @@ -29,7 +30,7 @@ Faili iṣeto atilẹwa kan maa jẹ ṣiṣẹda `c:\verdaccio\verdaccio\config ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ Faili iṣeto atilẹwa kan maa jẹ ṣiṣẹda `c:\verdaccio\verdaccio\config "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Ọna start.js miran fun awọn ẹya Verdaccio < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -104,14 +105,15 @@ require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### Titu laasigbo sita - - **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` + + + + + +```` - - - - - \ No newline at end of file diff --git a/website/translated_docs/zh-CN/docker.md b/website/translated_docs/zh-CN/docker.md index 98af4c651bad..2e924c362487 100644 --- a/website/translated_docs/zh-CN/docker.md +++ b/website/translated_docs/zh-CN/docker.md @@ -5,6 +5,7 @@ title: Docker ![alt Docker Pulls Count](https://dockeri.co/image/verdaccio/verdaccio "Docker Pulls Count") + 要下载(pull)最新的预先-创建的[docker镜像](https://hub.docker.com/r/verdaccio/verdaccio/): ```bash @@ -22,7 +23,6 @@ docker pull verdaccio/verdaccio ```bash docker pull verdaccio/verdaccio:4 ``` - 对于次版本: ```bash @@ -45,10 +45,11 @@ docker pull verdaccio/verdaccio:4.0.0 docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio ``` -The last argument defines which image to use. The above line will pull the latest prebuilt image from dockerhub, if you haven't done that already. +The last argument defines which image to use. The last argument defines which image to use. The above line will pull the latest prebuilt image from dockerhub, if you haven't done that already. 如果您已经用 `verdaccio`作为最后参数[在本地创建一个镜像](#build-your-own-docker-image)。 + 您可以用 `-v`来绑定安装 `conf`, `storage` 和`plugins`到主机文件系统中: ```bash @@ -59,12 +60,10 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ -v $V_PATH/plugins:/verdaccio/plugins \ verdaccio/verdaccio ``` - > if you are running in a server, you might want to add -d to run it in the background -> > Note: Verdaccio runs as a non-root user (uid=10001) inside the container, if you use bind mount to override default, you need to make sure the mount directory is assigned to the right user. In above example, you need to run `sudo chown -R 10001:65533 /path/for/verdaccio` otherwise you will get permission errors at runtime. [Use docker volume](https://docs.docker.com/storage/volumes/) is recommended over using bind mount. -Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list: +Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list: Here the complete list: | 属性 | default | 描述 | | --------------------- | ---------------- | -------------------------------------------------- | @@ -74,19 +73,23 @@ Verdaccio 4 provides a new set of environment variables to modify either permiss | VERDACCIO_PORT | `4873` | the verdaccio port | | VERDACCIO_PROTOCOL | `http` | the default http protocol | + + ### SELinux -If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. +If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. Otherwise verdaccio will be forbidden from reading those files. - fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file - +``` + fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file +``` If verdaccio can't read files on a bind-mounted directory and you are unsure, please check `/var/log/audit/audit.log` to confirm that it's a SELinux issue. In this example, the error above produced the following AVC denial. - type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 - +``` +type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 +``` -`chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. +`chcon` can change the labels of shared files and directories. `chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. ```sh $ chcon -Rt container_file_t ./conf @@ -97,7 +100,6 @@ If you want to make the directory accessible only to a specific container, use ` An alternative solution is to use [z and Z flags](https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label). To add the `z` flag to the mountpoint `./conf:/verdaccio/conf` simply change it to `./conf:/verdaccio/conf:z`. The `z` flag relabels the directory and makes it accessible by every container while the `Z` flags relables the directory and makes it accessible only to that specific container. However using these flags is dangerous. A small configuration mistake, like mounting `/home/user` or `/var` can mess up the labels on those directories and make the system unbootable. ### 插件 - Plugins can be installed in a separate directory and mounted using Docker or Kubernetes, however make sure you build plugins with native dependencies using the same base image as the Verdaccio Dockerfile. ```docker @@ -113,7 +115,6 @@ USER verdaccio ``` ### Docker and custom port configuration - Any `host:port` configured in `conf/config.yaml` under `listen` **is currently ignored when using docker**. If you want to reach Verdaccio docker instance under different port, lets say `5000` in your `docker run` command add the environment variable `VERDACCIO_PORT=5000` and then expose the port `-p 5000:5000`. @@ -127,7 +128,6 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ Of course the numbers you give to `-p` paremeter need to match. ### Using HTTPS with Docker - You can configure the protocol verdaccio is going to listen on, similarly to the port configuration. You have to overwrite the default value("http") of the `PROTOCOL` environment variable to "https", after you specified the certificates in the config.yaml. ```bash @@ -147,6 +147,7 @@ $ docker-compose up --build You can set the port to use (for both container and host) by prefixing the above command with `VERDACCIO_PORT=5000`. + ```yaml version: '3.1' @@ -205,7 +206,7 @@ Please note that for any of the above docker commands you need to have docker in There is a separate repository that hosts multiple configurations to compose Docker images with `verdaccio`, for instance, as reverse proxy: - +[https://github.com/verdaccio/docker-examples](https://github.com/verdaccio/docker-examples) ## Docker 自定义创建 @@ -221,4 +222,4 @@ There is a separate repository that hosts multiple configurations to compose Doc * [docker-verdaccio](https://github.com/Global-Solutions/docker-verdaccio) * [verdaccio-docker](https://github.com/idahobean/verdaccio-docker) * [verdaccio-server](https://github.com/andru255/verdaccio-server) -* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. \ No newline at end of file +* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. diff --git a/website/translated_docs/zh-CN/e2e.md b/website/translated_docs/zh-CN/e2e.md index 67e5545c45ef..e98df5f74496 100644 --- a/website/translated_docs/zh-CN/e2e.md +++ b/website/translated_docs/zh-CN/e2e.md @@ -3,10 +3,9 @@ id: e2e title: "End to End testing" --- -Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. +Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/zh-CN/iis-server.md b/website/translated_docs/zh-CN/iis-server.md index 52d5fa8b6b65..40f8977ebfbd 100644 --- a/website/translated_docs/zh-CN/iis-server.md +++ b/website/translated_docs/zh-CN/iis-server.md @@ -5,23 +5,24 @@ title: "IIS server上进行安装" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- 在要承载verdaccio的资源管理器中创建一个新文件夹。 例如 `C:\verdaccio`。 在此文件夹里保存 [package.json](#packagejson), [start.js](#startjs) 和 [web.config](#webconfig) 。 -- 在因特网信息服务管理器中创建一个新站点。 您可以随意给它命名。 我将在这些[用法说明](http://www.iis.net/learn/manage/configuring-security/application-pool-identities)中称它为verdaccio。 指定保存所有文件和端口号的路径。 -- 返回到资源管理器中,把对您刚创建的文件夹的修改权限赋予给运行此应用程序池的用户。 如果您已命名此站点为verdaccio,并没有修改该应用程序池,它正在ApplicationPoolIdentity下运行,您就应该给用户 IIS AppPool\verdaccio修改权限。如果您需要帮助的话,请参照用法说明。 (如果需要,可以在日后限制访问,这样它只有 iisnode 和verdaccio\storage的修改权限) -- 启动命令行并执行以下命令来下载verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* 在要承载verdaccio的资源管理器中创建一个新文件夹。 例如 `C:\verdaccio`。 在此文件夹里保存 [package.json](#packagejson), [start.js](#startjs) 和 [web.config](#webconfig) 。 +* 在因特网信息服务管理器中创建一个新站点。 您可以随意给它命名。 我将在这些[用法说明](http://www.iis.net/learn/manage/configuring-security/application-pool-identities)中称它为verdaccio。 指定保存所有文件和端口号的路径。 +* 返回到资源管理器中,把对您刚创建的文件夹的修改权限赋予给运行此应用程序池的用户。 如果您已命名此站点为verdaccio,并没有修改该应用程序池,它正在ApplicationPoolIdentity下运行,您就应该给用户 IIS AppPool\verdaccio修改权限。如果您需要帮助的话,请参照用法说明。 (如果需要,可以在日后限制访问,这样它只有 iisnode 和verdaccio\storage的修改权限) +* 启动命令行并执行以下命令来下载verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- 请确保您有入站规则来接受TCP流量到Windows防火墙的端口 -- 就这样!现在您可以导航到您指定的主机和端口 +* 请确保您有入站规则来接受TCP流量到Windows防火墙的端口 +* 就这样! 现在您可以导航到您指定的主机和端口 我希望 `verdaccio`站点成为IIS中默认的站点,因此我执行了以下操作: -- 我中止“默认网站”,并且只在IIS 里启动"verdaccio"站点 -- 我将端口80绑定设置为"http", ip 地址为"全部未定义",ok 任何警告或提示。 +* 我中止“默认网站”,并且只在IIS 里启动"verdaccio"站点 +* 我将端口80绑定设置为"http", ip 地址为"全部未定义",ok 任何警告或提示。 这些指南是基于[Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75)。 我不得不依照以下调整我的网页配置,但是您可能发现上述提到链接里的原始配置可以更好作业 @@ -29,7 +30,7 @@ These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15. ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15. "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -102,16 +103,41 @@ require('./node_modules/verdaccio/src/lib/cli.js'); + + These should + never be rewritten --> + + + + + + + + + + + + + + + + + + + + + + + + -``` +```` ### 故障排除 +- **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` +Install IIS Install iisnode. Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +```` -- **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). - - - - - - \ No newline at end of file diff --git a/website/translated_docs/zh-TW/docker.md b/website/translated_docs/zh-TW/docker.md index 9f29f8db39fa..cb329796a3b3 100644 --- a/website/translated_docs/zh-TW/docker.md +++ b/website/translated_docs/zh-TW/docker.md @@ -5,6 +5,7 @@ title: Docker ![alt Docker Pulls Count](https://dockeri.co/image/verdaccio/verdaccio "Docker Pulls Count") + To pull the latest pre-built [docker image](https://hub.docker.com/r/verdaccio/verdaccio/): ```bash @@ -22,7 +23,6 @@ For a major version: ```bash docker pull verdaccio/verdaccio:4 ``` - For a minor version: ```bash @@ -45,10 +45,11 @@ To run the docker container: docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio ``` -The last argument defines which image to use. The above line will pull the latest prebuilt image from dockerhub, if you haven't done that already. +The last argument defines which image to use. The last argument defines which image to use. The above line will pull the latest prebuilt image from dockerhub, if you haven't done that already. If you have [build an image locally](#build-your-own-docker-image) use `verdaccio` as the last argument. + You can use `-v` to bind mount `conf`, `storage` and `plugins` to the hosts filesystem: ```bash @@ -59,12 +60,10 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ -v $V_PATH/plugins:/verdaccio/plugins \ verdaccio/verdaccio ``` - > if you are running in a server, you might want to add -d to run it in the background -> > Note: Verdaccio runs as a non-root user (uid=10001) inside the container, if you use bind mount to override default, you need to make sure the mount directory is assigned to the right user. In above example, you need to run `sudo chown -R 10001:65533 /path/for/verdaccio` otherwise you will get permission errors at runtime. [Use docker volume](https://docs.docker.com/storage/volumes/) is recommended over using bind mount. -Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list: +Verdaccio 4 provides a new set of environment variables to modify either permissions, port or http protocol. Here the complete list: Here the complete list: | Property | default | Description | | --------------------- | ---------------- | -------------------------------------------------- | @@ -74,19 +73,23 @@ Verdaccio 4 provides a new set of environment variables to modify either permiss | VERDACCIO_PORT | `4873` | the verdaccio port | | VERDACCIO_PROTOCOL | `http` | the default http protocol | + + ### SELinux -If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. +If SELinux is enforced in your system, the directories to be bind-mounted in the container need to be relabeled. Otherwise verdaccio will be forbidden from reading those files. Otherwise verdaccio will be forbidden from reading those files. - fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file - +``` + fatal--- cannot open config file /verdaccio/conf/config.yaml: Error: CONFIG: it does not look like a valid config file +``` If verdaccio can't read files on a bind-mounted directory and you are unsure, please check `/var/log/audit/audit.log` to confirm that it's a SELinux issue. In this example, the error above produced the following AVC denial. - type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 - +``` +type=AVC msg=audit(1606833420.789:9331): avc: denied { read } for pid=1251782 comm="node" name="config.yaml" dev="dm-2" ino=8178250 scontext=system_u:system_r:container_t:s0:c32,c258 tcontext=unconfined_u:object_r:user_home_t:s0 tclass=file permissive=0 +``` -`chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. +`chcon` can change the labels of shared files and directories. `chcon` can change the labels of shared files and directories. To make a directory accessible to containers, change the directory type to `container_file_t`. ```sh $ chcon -Rt container_file_t ./conf @@ -97,7 +100,6 @@ If you want to make the directory accessible only to a specific container, use ` An alternative solution is to use [z and Z flags](https://docs.docker.com/storage/bind-mounts/#configure-the-selinux-label). To add the `z` flag to the mountpoint `./conf:/verdaccio/conf` simply change it to `./conf:/verdaccio/conf:z`. The `z` flag relabels the directory and makes it accessible by every container while the `Z` flags relables the directory and makes it accessible only to that specific container. However using these flags is dangerous. A small configuration mistake, like mounting `/home/user` or `/var` can mess up the labels on those directories and make the system unbootable. ### Plugins - Plugins can be installed in a separate directory and mounted using Docker or Kubernetes, however make sure you build plugins with native dependencies using the same base image as the Verdaccio Dockerfile. ```docker @@ -113,7 +115,6 @@ USER verdaccio ``` ### Docker and custom port configuration - Any `host:port` configured in `conf/config.yaml` under `listen` **is currently ignored when using docker**. If you want to reach Verdaccio docker instance under different port, lets say `5000` in your `docker run` command add the environment variable `VERDACCIO_PORT=5000` and then expose the port `-p 5000:5000`. @@ -127,7 +128,6 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio \ Of course the numbers you give to `-p` paremeter need to match. ### Using HTTPS with Docker - You can configure the protocol verdaccio is going to listen on, similarly to the port configuration. You have to overwrite the default value("http") of the `PROTOCOL` environment variable to "https", after you specified the certificates in the config.yaml. ```bash @@ -147,6 +147,7 @@ $ docker-compose up --build You can set the port to use (for both container and host) by prefixing the above command with `VERDACCIO_PORT=5000`. + ```yaml version: '3.1' @@ -205,7 +206,7 @@ Please note that for any of the above docker commands you need to have docker in There is a separate repository that hosts multiple configurations to compose Docker images with `verdaccio`, for instance, as reverse proxy: - +[https://github.com/verdaccio/docker-examples](https://github.com/verdaccio/docker-examples) ## Docker Custom Builds @@ -221,4 +222,4 @@ There is a separate repository that hosts multiple configurations to compose Doc * [docker-verdaccio](https://github.com/Global-Solutions/docker-verdaccio) * [verdaccio-docker](https://github.com/idahobean/verdaccio-docker) * [verdaccio-server](https://github.com/andru255/verdaccio-server) -* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. \ No newline at end of file +* [coldrye-debian-verdaccio](https://github.com/coldrye-docker/coldrye-debian-verdaccio) docker image providing verdaccio from coldrye-debian-nodejs. diff --git a/website/translated_docs/zh-TW/e2e.md b/website/translated_docs/zh-TW/e2e.md index 67e5545c45ef..e98df5f74496 100644 --- a/website/translated_docs/zh-TW/e2e.md +++ b/website/translated_docs/zh-TW/e2e.md @@ -3,10 +3,9 @@ id: e2e title: "End to End testing" --- -Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. +Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). Some projects organize packages in multi-packages repositories or [monorepos](https://github.com/babel/babel/blob/master/doc/design/monorepo.md). E2E testing is a topic that usually is only relevant for User Interfaces, but from a Node.js perspective, **publishing packages also need to be tested**. - Such approach has been really hard to achieve considering: @@ -45,6 +44,7 @@ sh -c "npm-auth-to-token -u test -p test -e test@test.com -r $local_registry" sh -c "npm --registry $local_registry publish" ``` + ## Who is using it for E2E? * [create-react-app](https://github.com/facebook/create-react-app/blob/master/CONTRIBUTING.md#contributing-to-e2e-end-to-end-tests) *(+73.5k ⭐️)* @@ -59,4 +59,10 @@ sh -c "npm --registry $local_registry publish" * [Mozilla Neutrino](https://github.com/neutrinojs/neutrino) *(+3k ⭐️)* * [Embark](https://embark.status.im/) *(+3k ⭐️)* * [Hyperledger Composer](https://github.com/hyperledger/composer) *(+1.6k ⭐️)* -* [Wix Yoshi](https://github.com/wix/yoshi) \ No newline at end of file +* [Wix Yoshi](https://github.com/wix/yoshi) + + + + + + diff --git a/website/translated_docs/zh-TW/iis-server.md b/website/translated_docs/zh-TW/iis-server.md index 9f9a4f50cdcd..89831bda7d26 100644 --- a/website/translated_docs/zh-TW/iis-server.md +++ b/website/translated_docs/zh-TW/iis-server.md @@ -5,23 +5,24 @@ title: "Installing on IIS server" These instructions were written for Windows Server 2016, IIS 10, [Node.js 10.15.0](https://nodejs.org/), [iisnode 0.2.26](https://github.com/Azure/iisnode) and [verdaccio 3.11.0](https://github.com/verdaccio/verdaccio). -- Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. -- Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. -- Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. -- Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) -- Start a command prompt and execute the commands below to download verdaccio: +* Install IIS Install [iisnode](https://github.com/Azure/iisnode). Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +* Create a new folder in Explorer where you want to host verdaccio. For example `C:\verdaccio`. Save [package.json](#packagejson), [start.js](#startjs) and [web.config](#webconfig) in this folder. +* Create a new site in Internet Information Services Manager. You can name it whatever you want. I'll call it verdaccio in these [instructions](http://www.iis.net/learn/manage/configuring-security/application-pool-identities). Specify the path to where you saved all files and a port number. +* Go back to Explorer and give the user that runs the application pool modify rights to the folder you just created. If you've named the new site verdaccio and did not change the app pool, it's running under an ApplicationPoolIdentity and you should give the user IIS AppPool\verdaccio modify rights see instructions if you need help. (You can restrict access later if you want so that it only has modify rights on the iisnode and verdaccio\storage) +* Start a command prompt and execute the commands below to download verdaccio: - cd c:\verdaccio - npm install - +```` +cd c:\verdaccio +npm install +```` -- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall -- Thats it! Now you can navigate to the host and port that you specified +* Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall +* Thats it! Thats it! Now you can navigate to the host and port that you specified I wanted the `verdaccio` site to be the default site in IIS so I did the following: -- I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS -- I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts +* I stopped the "Default Web Site" and only start the site "verdaccio" site in IIS +* I set the bindings to "http", ip address "All Unassigned" on port 80, ok any warning or prompts These instructions are based on [Host Sinopia in IIS on Windows](https://gist.github.com/HCanber/4dd8409f79991a09ac75). I had to tweak my web config as per below but you may find the original from the for mentioned link works better @@ -29,7 +30,7 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml ### package.json -```json +````json { "name": "iisnode-verdaccio", "version": "1.0.0", @@ -39,25 +40,25 @@ A default configuration file will be created `c:\verdaccio\verdaccio\config.yaml "verdaccio": "^3.11.0" } } -``` +```` ### start.js -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT, '-c', './config.yaml'); require('./node_modules/verdaccio/build/lib/cli.js'); -``` +```` ### Alternate start.js for Verdaccio versions < v3.0 -```bash +````bash process.argv.push('-l', 'unix:' + process.env.PORT); require('./node_modules/verdaccio/src/lib/cli.js'); -``` +```` ### web.config -```xml +````xml @@ -102,16 +103,41 @@ require('./node_modules/verdaccio/src/lib/cli.js'); + + These should + never be rewritten --> + + + + + + + + + + + + + + + + + + + + + + + + -``` +```` ### Troubleshooting +- **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). +```` +Install IIS Install iisnode. Make sure you install prerequisites (Url Rewrite Module & node) as explained in the instructions for iisnode. +```` -- **The web interface does not load when hosted with https as it tries to download scripts over http.** Make sure that you have enabled `X-Forwarded-Proto` in IISNode using `enableXFF`. See [the related issue](https://github.com/verdaccio/verdaccio/issues/2003). - - - - - - \ No newline at end of file