mirror of
https://github.com/verdaccio/verdaccio.git
synced 2024-12-24 21:15:51 +01:00
docs: fix typos (#2399)
This commit is contained in:
parent
4b0eaff5f7
commit
2e51c931dd
@ -89,6 +89,6 @@ Below is a list of articles about Verdaccio. If you have written a blog post or
|
|||||||
## Slides {#slides}
|
## Slides {#slides}
|
||||||
|
|
||||||
* [Introduction to Verdaccio VueJS Meetup 2018](https://www.slideshare.net/juancarlospicado/introduction-to-verdaccio)
|
* [Introduction to Verdaccio VueJS Meetup 2018](https://www.slideshare.net/juancarlospicado/introduction-to-verdaccio)
|
||||||
* [Introduccion Verdaccio Vienna JS Meetup 2019](https://docs.google.com/presentation/d/1eam_OtXCQh5IVYyia2GHhxVD8tb37B0yIadVa8wxQSk/edit?usp=sharing)
|
* [Introduction Verdaccio Vienna JS Meetup 2019](https://docs.google.com/presentation/d/1eam_OtXCQh5IVYyia2GHhxVD8tb37B0yIadVa8wxQSk/edit?usp=sharing)
|
||||||
* [Cover Your Apps While Still Using npm](https://www.slideshare.net/TierneyCoren/cover-your-apps-while-still-using-npm)
|
* [Cover Your Apps While Still Using npm](https://www.slideshare.net/TierneyCoren/cover-your-apps-while-still-using-npm)
|
||||||
* [Unity 2018-2019を見据えたDeNAのUnity開発のこれから [DeNA TechCon 2019]](https://www.slideshare.net/dena_tech/unity-20182019denaunity-dena-techcon-2019)
|
* [Unity 2018-2019を見据えたDeNAのUnity開発のこれから [DeNA TechCon 2019]](https://www.slideshare.net/dena_tech/unity-20182019denaunity-dena-techcon-2019)
|
||||||
|
@ -78,7 +78,7 @@ There's two options here:
|
|||||||
|
|
||||||
<iframe width="560" height="315" src="https://www.youtube.com/embed/qTRADSp3Hpo?enablejsapi=1" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
<iframe width="560" height="315" src="https://www.youtube.com/embed/qTRADSp3Hpo?enablejsapi=1" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
|
||||||
|
|
||||||
Additonal reading:
|
Additional reading:
|
||||||
|
|
||||||
- **[10 npm Security Best Practices](https://snyk.io/blog/ten-npm-security-best-practices/)** and following the steps outlined there.
|
- **[10 npm Security Best Practices](https://snyk.io/blog/ten-npm-security-best-practices/)** and following the steps outlined there.
|
||||||
- **[Avoiding npm substitution attacks](https://github.blog/2021-02-12-avoiding-npm-substitution-attacks/)**
|
- **[Avoiding npm substitution attacks](https://github.blog/2021-02-12-avoiding-npm-substitution-attacks/)**
|
||||||
|
@ -8,7 +8,7 @@ a different strategy. Using of plugins you might use the cloud or any sort of da
|
|||||||
|
|
||||||
## Caching scenarios {#caching-scenarios}
|
## Caching scenarios {#caching-scenarios}
|
||||||
|
|
||||||
* Build a Node.js project on **Continous Integration** (Bamboo, GitLab, Jenkins, etc) servers is a task that might take several times at a day, thus, the server will download tons of tarballs from the registry every time takes place. As usual, the CI tools clear the cache after each build and the process start over and over again. That is a waste of bandwidth and reduces the external traffic.
|
* Build a Node.js project on **Continuous Integration** (Bamboo, GitLab, Jenkins, etc) servers is a task that might take several times at a day, thus, the server will download tons of tarballs from the registry every time takes place. As usual, the CI tools clear the cache after each build and the process start over and over again. That is a waste of bandwidth and reduces the external traffic.
|
||||||
**You can use Verdaccio for caching tarballs and metadata in our internal network and give a boost in your build time.**
|
**You can use Verdaccio for caching tarballs and metadata in our internal network and give a boost in your build time.**
|
||||||
* **Latency and Connectivity**, not all countries enjoy a high-speed connection. For such reason cache packages locally in your network
|
* **Latency and Connectivity**, not all countries enjoy a high-speed connection. For such reason cache packages locally in your network
|
||||||
is really handy. Either if you are traveling, or have a weak connection, roaming or countries with strong Firewalls that might affect the user experience (eg: corrupting tarballs).
|
is really handy. Either if you are traveling, or have a weak connection, roaming or countries with strong Firewalls that might affect the user experience (eg: corrupting tarballs).
|
||||||
|
@ -155,7 +155,7 @@ The prefix is intended to be used when the server runs behinds the proxy and won
|
|||||||
url_prefix: /verdaccio/
|
url_prefix: /verdaccio/
|
||||||
```
|
```
|
||||||
|
|
||||||
> Verdaccio 5 has an improved prefix behaviour and the `VERDACCIO_PUBLIC_URL` is avilable for use, learn how to [here](https://verdaccio.org/blog/2021/04/14/verdaccio-5-migration-guide#url_prefix-improved-behavior).
|
> Verdaccio 5 has an improved prefix behaviour and the `VERDACCIO_PUBLIC_URL` is available for use, learn how to [here](https://verdaccio.org/blog/2021/04/14/verdaccio-5-migration-guide#url_prefix-improved-behavior).
|
||||||
|
|
||||||
### Max Body Size {#max-body-size}
|
### Max Body Size {#max-body-size}
|
||||||
|
|
||||||
|
@ -47,7 +47,7 @@ The list internal groups handled by `verdaccio` are:
|
|||||||
'$all', '$anonymous', '@all', '@anonymous', 'all', 'undefined', 'anonymous'
|
'$all', '$anonymous', '@all', '@anonymous', 'all', 'undefined', 'anonymous'
|
||||||
```
|
```
|
||||||
|
|
||||||
All users recieve all those set of permissions independently of is anonymous or not plus the groups provided by the plugin, in case of `htpasswd` return the username as a group. For instance, if you are logged as `npmUser` the list of groups will be.
|
All users receive all those set of permissions independently of is anonymous or not plus the groups provided by the plugin, in case of `htpasswd` return the username as a group. For instance, if you are logged as `npmUser` the list of groups will be.
|
||||||
|
|
||||||
```js
|
```js
|
||||||
// groups without '$' are going to be deprecated eventually
|
// groups without '$' are going to be deprecated eventually
|
||||||
|
@ -36,7 +36,7 @@ auth:
|
|||||||
|
|
||||||
## How do the authentication plugin works? {#how-do-the-authentication-plugin-works}
|
## How do the authentication plugin works? {#how-do-the-authentication-plugin-works}
|
||||||
|
|
||||||
Basically we have to return an object with a single method called `authenticate` that will recieve 3 arguments (`user, password, callback`).
|
Basically we have to return an object with a single method called `authenticate` that will receive 3 arguments (`user, password, callback`).
|
||||||
|
|
||||||
On each request, `authenticate` will be triggered and the plugin should return the credentials, if the `authenticate` fails, it will fallback to the `$anonymous` role by default.
|
On each request, `authenticate` will be triggered and the plugin should return the credentials, if the `authenticate` fails, it will fallback to the `$anonymous` role by default.
|
||||||
|
|
||||||
@ -100,7 +100,7 @@ The authentication service might fails, and you might want to reflect that in th
|
|||||||
callback(getInternalError('something bad message), null);
|
callback(getInternalError('something bad message), null);
|
||||||
```
|
```
|
||||||
|
|
||||||
> A failure on login is not the same as service error, if you want to notify user the credentails are wrong, just return `false` instead string of groups. The behaviour mostly depends of you.
|
> A failure on login is not the same as service error, if you want to notify user the credentials are wrong, just return `false` instead string of groups. The behaviour mostly depends of you.
|
||||||
|
|
||||||
|
|
||||||
### `adduser` callback {#adduser-callback}
|
### `adduser` callback {#adduser-callback}
|
||||||
|
@ -21,7 +21,7 @@ npm i -g generator-verdaccio-plugin
|
|||||||
|
|
||||||
## Using the generator {#using-the-generator}
|
## Using the generator {#using-the-generator}
|
||||||
|
|
||||||
Use `yeoman` is quite straighforward, you can read more infomation about it [here](https://yeoman.io/learning/index.html).
|
Use `yeoman` is quite straighforward, you can read more information about it [here](https://yeoman.io/learning/index.html).
|
||||||
|
|
||||||
After a success install, run `yo verdaccio-plugin` in your terminal and follow the steps.
|
After a success install, run `yo verdaccio-plugin` in your terminal and follow the steps.
|
||||||
|
|
||||||
|
@ -22,7 +22,7 @@ There are 5 types of plugins:
|
|||||||
$> npm install --global verdaccio-activedirectory
|
$> npm install --global verdaccio-activedirectory
|
||||||
```
|
```
|
||||||
|
|
||||||
`verdaccio` as a sinopia fork it has backward compability with plugins that are compatible with `sinopia@1.4.0`. In such case the installation is the same.
|
`verdaccio` as a sinopia fork it has backward compatibility with plugins that are compatible with `sinopia@1.4.0`. In such case the installation is the same.
|
||||||
|
|
||||||
```
|
```
|
||||||
$> npm install --global sinopia-memory
|
$> npm install --global sinopia-memory
|
||||||
|
@ -12,7 +12,7 @@ There are two variants to install verdaccio using this Puppet module:
|
|||||||
* Apply-mode (with puppet-apply and no puppetmaster setup needed)
|
* Apply-mode (with puppet-apply and no puppetmaster setup needed)
|
||||||
* Master-Agent-mode (with puppet-agent accessing your configuration through the puppetmaster).
|
* Master-Agent-mode (with puppet-agent accessing your configuration through the puppetmaster).
|
||||||
|
|
||||||
In both variants you have to explicitely call "class nodejs {}" in your puppet script because
|
In both variants you have to explicitly call "class nodejs {}" in your puppet script because
|
||||||
the puppet-verdaccio module only defines this as a requirement, so you have all the flexibility you want when installing nodejs.
|
the puppet-verdaccio module only defines this as a requirement, so you have all the flexibility you want when installing nodejs.
|
||||||
Scroll down for details about Master-Agent-mode variant.
|
Scroll down for details about Master-Agent-mode variant.
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user