mirror of
https://github.com/verdaccio/verdaccio.git
synced 2025-02-21 07:29:37 +01:00
New Crowdin translations (#768)
* New translations iis-server.md (Spanish) docs(website): new translations * New translations install.md (Spanish) docs(website): new translations * New translations en.json (Spanish) docs(website): new translations * New translations config.md (Spanish) docs(website): new translations * New translations config.md (Spanish) docs(website): new translations * New translations auth.md (Spanish) docs(website): new translations * New translations iis-server.md (Spanish) docs(website): new translations * New translations auth.md (Spanish) docs(website): new translations * New translations auth.md (Spanish) docs(website): new translations * New translations ansible.md (Spanish) docs(website): new translations * New translations windows.md (Spanish) docs(website): new translations * New translations logger.md (Spanish) docs(website): new translations * New translations logger.md (Spanish) docs(website): new translations * New translations logger.md (Spanish) docs(website): new translations * New translations ci.md (Spanish) docs(website): new translations * New translations ci.md (Spanish) docs(website): new translations * New translations dev-plugins.md (Spanish) docs(website): new translations * New translations dev-plugins.md (Spanish) docs(website): new translations * New translations dev-plugins.md (Spanish) docs(website): new translations * New translations dev-plugins.md (Spanish) docs(website): new translations * New translations windows.md (Spanish) docs(website): new translations * New translations dev-plugins.md (Spanish) docs(website): new translations * New translations dev-plugins.md (Spanish) docs(website): new translations * New translations config.md (Spanish) docs(website): new translations * New translations dev-plugins.md (Spanish) docs(website): new translations * New translations dev-plugins.md (Spanish) docs(website): new translations * New translations protect-your-dependencies.md (Spanish) docs(website): new translations * New translations uplinks.md (Spanish) docs(website): new translations * New translations dev-plugins.md (Spanish) docs(website): new translations * New translations protect-your-dependencies.md (Spanish) docs(website): new translations * New translations docker.md (Spanish) docs(website): new translations * New translations node-api.md (Spanish) docs(website): new translations * New translations protect-your-dependencies.md (Spanish) docs(website): new translations * New translations docker.md (Spanish) docs(website): new translations * New translations docker.md (Spanish) docs(website): new translations * New translations install.md (Spanish) docs(website): new translations * New translations reverse-proxy.md (Spanish) docs(website): new translations * New translations reverse-proxy.md (Spanish) docs(website): new translations * New translations ssl.md (Spanish) docs(website): new translations * New translations ssl.md (Spanish) docs(website): new translations * New translations ssl.md (Spanish) docs(website): new translations * New translations ssl.md (Spanish) docs(website): new translations * New translations auth.md (Spanish) docs(website): new translations * New translations dev-plugins.md (Spanish) docs(website): new translations * New translations iis-server.md (Spanish) docs(website): new translations * New translations dev-plugins.md (Spanish) docs(website): new translations * New translations config.md (Spanish) docs(website): new translations * New translations ci.md (Spanish) docs(website): new translations * New translations iis-server.md (Spanish) docs(website): new translations * New translations logger.md (Spanish) docs(website): new translations * New translations ci.md (Spanish) docs(website): new translations * New translations dev-plugins.md (Spanish) docs(website): new translations * New translations logger.md (Spanish) docs(website): new translations * New translations iis-server.md (Spanish) docs(website): new translations * New translations iis-server.md (Spanish) docs(website): new translations * New translations windows.md (Spanish) docs(website): new translations
This commit is contained in:
verdacciobot
Juan Picado @jotadeveloper
parent
9a862dd704
commit
825f5a57ea
@ -23,7 +23,7 @@
|
||||
"packages": "Acceso a paquetes",
|
||||
"plugins": "Extensiones",
|
||||
"protect-your-dependencies": "Protegiendo paquetes",
|
||||
"puppet": "Marioneta",
|
||||
"puppet": "Puppet",
|
||||
"source-code": "Código fuente",
|
||||
"reverse-proxy": "Configuración de proxy inverso",
|
||||
"server-configuration": "Configuración del Servidor",
|
||||
|
||||
@ -2,12 +2,12 @@
|
||||
id: ansible
|
||||
title: "Ansible"
|
||||
---
|
||||
We have a customised solution for `verdaccio` in our organization.
|
||||
Tenemos una solución hecha específicamente para `verdaccio` en nuestra organización.
|
||||
|
||||
<https://github.com/verdaccio/ansible-verdaccio>
|
||||
|
||||
#### Otras opciones
|
||||
|
||||
* Ansible role for Gentoo users: [jirutka/ansible-role-sinopia](https://github.com/jirutka/ansible-role-sinopia).
|
||||
* Ansible role for Ubuntu users: [jagregory/sinopia-ansible](https://github.com/jagregory/sinopia-ansible).
|
||||
* ansible-verdaccio-role <https://github.com/refinery29/ansible-verdaccio-role>
|
||||
* Rol de Ansible para los usuarios de Gentoo: [jirutka/ansible-role-sinopia](https://github.com/jirutka/ansible-role-sinopia).
|
||||
* Rol de Ansible para los usuarios de Ubuntu: [jagregory/sinopia-ansible](https://github.com/jagregory/sinopia-ansible).
|
||||
* ansible-verdaccio-rol <https://github.com/refinery29/ansible-verdaccio-role>
|
||||
@ -21,7 +21,7 @@ registry=http://localhost:5555/
|
||||
|
||||
#### Publicar anonimamente
|
||||
|
||||
`verdaccio`allows you to enable anonymous publish, to achieve that you will need to set up correctly your [packages access](packages.md).
|
||||
`verdaccio` te permite habilitar publicar de manera anónima, para poder hacerlo necesitarás configurar correctamente tu [acceso a paquetes](packages.md).
|
||||
|
||||
Por ejemplo:
|
||||
|
||||
@ -36,7 +36,7 @@ Como se describe en [el ticket #212](https://github.com/verdaccio/verdaccio/issu
|
||||
|
||||
## Htpasswd por defecto
|
||||
|
||||
In order to simplify the setup, `verdaccio` use a plugin based on `htpasswd`. As of version v3.0.x an [external plugin](https://github.com/verdaccio/verdaccio-htpasswd) is used by default. The v2.x version of this package still contains the built-in version of this plugin.
|
||||
Para simplificar la instalación, `verdaccio` usa una extensión basada en `htpasswd`. A partir de la versión v3.0.x se usa una [extensión externa](https://github.com/verdaccio/verdaccio-htpasswd) por defecto. La versión v2.x de este paquete mantiene la versión integrada de esta extensión.
|
||||
|
||||
```yaml
|
||||
auth:
|
||||
@ -52,4 +52,4 @@ auth:
|
||||
| file | string | Si | ./htpasswd | all | archivo que aloja las credenciales encriptadas |
|
||||
| max_users | number | No | 1000 | all | limita los usuarios que pueden registrarse |
|
||||
|
||||
En caso que decidas no permiter mas nuevos registros, puedes definir `max_users: -1`.
|
||||
En caso que decidas no permitir más nuevos registros, puedes definir `max_users: -1`.
|
||||
@ -1,9 +1,9 @@
|
||||
---
|
||||
id: ci
|
||||
title: "Continuous Integration"
|
||||
title: "Integración Continua"
|
||||
---
|
||||
You may use verdaccio with continuous integration while login or publish. When using NPM to install a private module in a continuous integration environment for the first time, a brick wall is quickly hit. The NPM login command is designed to be used interactively. This causes an issue in CI, scripts, etc. Here’s how to use NPM login different continuous integration platforms.
|
||||
Puedes usar verdaccio con la integración continua al inicio de sesión o al publicar. Al momento de usar el NPM para instalar un módulo privado en un entorno de integración continua por primera vez, encontrarás un problema rápidamente. El comando de inicio de sesión del NPM está diseñado para ser utilizado interactivamente. Esto causa un problema en IC, scripts, etc. Aquí se explica cómo usar el inicio de sesión NPM en diferentes plataformas de integración continua.
|
||||
|
||||
- [Travis CI](https://remysharp.com/2015/10/26/using-travis-with-private-npm-deps)
|
||||
- [Circle CI 1.0](https://circleci.com/docs/1.0/npm-login/) or [Circle CI 2.0](https://circleci.com/docs/2.0/deployment-integrations/#npm)
|
||||
- [Circle CI 1.0](https://circleci.com/docs/1.0/npm-login/) ó [Circle CI 2.0](https://circleci.com/docs/2.0/deployment-integrations/#npm)
|
||||
- [Gitlab CI](https://www.exclamationlabs.com/blog/continuous-deployment-to-npm-using-gitlab-ci/)
|
||||
@ -108,7 +108,7 @@ Desde: `verdaccio@2.3.6` debido a [#197](https://github.com/verdaccio/verdaccio/
|
||||
|
||||
### Tamaño Máximo del Cuerpo
|
||||
|
||||
By default the maximum body size for a JSON document is `10mb`, if you run in errors as `"request entity too large"` you may increase this value.
|
||||
Por defecto el tamaño máximo de cuerpo para un documento JSON es `10mb`, si encuentras errores tales como `"request entity too large"` puedes incrementar este valor.
|
||||
|
||||
```yaml
|
||||
max_body_size: 10mb
|
||||
@ -175,13 +175,13 @@ notify:
|
||||
|
||||
> Para información detallada sobre configuración, por favor [revise el código fuente](https://github.com/verdaccio/verdaccio/tree/master/conf).
|
||||
|
||||
### Audit
|
||||
### Revisión
|
||||
|
||||
<small>Since: <code>verdaccio@3.0.0</code></small>
|
||||
<small>Desde: <code>verdaccio@3.0.0</code></small>
|
||||
|
||||
`npm audit` is a new command released with [npm 6.x](https://github.com/npm/npm/releases/tag/v6.1.0). Verdaccio includes a built-in middleware plugin to handle this command.
|
||||
`npm audit` es un nuevo comando lanzado con [npm 6.x](https://github.com/npm/npm/releases/tag/v6.1.0). Verdaccio incluye una extensión de middleware integrada para el manejo de este comando.
|
||||
|
||||
> If you have a new installation it comes by default, otherwise you need to add the following props to your config file
|
||||
> Si tienes una nueva instalación va incluida por defecto, de otro modo necesitarás añadir las siguientes propiedades a tu archivo config
|
||||
|
||||
```yaml
|
||||
middlewares:
|
||||
|
||||
@ -1,12 +1,12 @@
|
||||
---
|
||||
id: dev-plugins
|
||||
title: "Developing Plugins"
|
||||
title: "Extensiones en Desarrollo"
|
||||
---
|
||||
There are many ways to extend `verdaccio`, currently we support `authentication plugins`, `middleware plugins` (since `v2.7.0`) and `storage plugins` since (`v3.x`).
|
||||
Hay muchas maneras de extender `verdaccio`, actualmente apoyamos `authentication plugins`, `middleware plugins` (desde `v2.7.0`) y `storage plugins` desde (`v3.x`).
|
||||
|
||||
## Authentication Plugin
|
||||
## Extensión de Autenticación
|
||||
|
||||
This section will describe how it looks like a Verdaccio plugin in a ES5 way. Basically we have to return an object with a single method called `authenticate` that will recieve 3 arguments (`user, password, callback`). Once the authentication has been executed there is 2 options to give a response to `verdaccio`.
|
||||
Esta sección describe cómo se ve una extensión de Verdaccio de manera ES5. Básicamente tenemos que devolver un objeto con un único método llamado `authenticate` que recibirá 3 argumentos (`user, password, callback`). Una vez que la autenticación haya sido ejecutada habrán 2 opciones con las que se podrá dar una respuesta a `verdaccio`.
|
||||
|
||||
### API
|
||||
|
||||
@ -18,21 +18,21 @@ function authenticate (user, password, callback) {
|
||||
|
||||
##### OnError
|
||||
|
||||
Either something bad happened or auth was unsuccessful.
|
||||
Algo malo sucedió o la autenticación no tuvo éxito.
|
||||
|
||||
callback(null, false)
|
||||
|
||||
|
||||
##### OnSuccess
|
||||
|
||||
The auth was successful.
|
||||
La autenticación tuvo éxito.
|
||||
|
||||
`groups` is an array of strings where the user is part of.
|
||||
`groups` es una matriz de cadenas de caracteres donde el usuario participa.
|
||||
|
||||
callback(null, groups);
|
||||
|
||||
|
||||
### Example
|
||||
### Ejemplo
|
||||
|
||||
```javascript
|
||||
function Auth(config, stuff) {
|
||||
@ -65,7 +65,7 @@ Auth.prototype.authenticate = function (user, password, callback) {
|
||||
module.exports = Auth;
|
||||
```
|
||||
|
||||
And the setup
|
||||
Y la configuración
|
||||
|
||||
```yaml
|
||||
auth:
|
||||
@ -73,13 +73,13 @@ auth:
|
||||
file: ./htpasswd
|
||||
```
|
||||
|
||||
Where `htpasswd` is the sufix of the plugin name. eg: `verdaccio-htpasswd` and the rest of the body would be the plugin configuration params.
|
||||
Donde `htpasswd` es el sufijo del nombre de la extensión. Por ejemplo: `verdaccio-htpasswd` y el resto del cuerpo serían los parámetros de configuración de la extensión.
|
||||
|
||||
## Middleware Plugin
|
||||
## Extensión de Middleware
|
||||
|
||||
Middleware plugins have the capability to modify the API layer, either adding new endpoints or intercepting requests.
|
||||
Las extensiones de Middleware tienen la capacidad de modificar la capa de API, ya sea añadiendo extremos o peticiones de interceptación.
|
||||
|
||||
> A pretty good example of middleware plugin is the [sinopia-github-oauth](https://github.com/soundtrackyourbrand/sinopia-github-oauth) and [verdaccio-audit](https://github.com/verdaccio/verdaccio-audit).
|
||||
> Un muy buen ejemplo de la extensión de middleware es [sinopia-github-oauth](https://github.com/soundtrackyourbrand/sinopia-github-oauth) y [verdaccio-audit](https://github.com/verdaccio/verdaccio-audit).
|
||||
|
||||
### API
|
||||
|
||||
@ -89,15 +89,15 @@ function register_middlewares(expressApp, authInstance, storageInstance) {
|
||||
}
|
||||
```
|
||||
|
||||
To register a middleware we need an object with a single method called `register_middlewares` that will recieve 3 arguments (`expressApp, auth, storage`). *Auth* is the authentification instance and *storage* is also the main Storage instance that will give you have access to all to the storage actions.
|
||||
Para registrar un middleware necesitamos un objeto con un único método llamado `register_middlewares` que recibirá 3 argumentos (`expressApp, auth, storage`). *Auth* es la instancia de autentificación y *storage* es de igual manera la instancia de Almacenamiento principal que te dará el acceso a todas las acciones de almacenamiento.
|
||||
|
||||
## Storage Plugin
|
||||
## Extensión de Almacenamiento
|
||||
|
||||
Verdaccio by default uses a file system storage plugin [local-storage](https://github.com/verdaccio/local-storage) but, since `verdaccio@3.x` you can plug in a custom storage.
|
||||
Verdaccio por defecto utiliza una extensión de almacenamientos de sistema de archivos [local-storage](https://github.com/verdaccio/local-storage) pero, desde `verdaccio@3.x` puedes añadir un almacenamiento personalizado.
|
||||
|
||||
### API
|
||||
|
||||
The storage API is a bit more complex, you will need to create a class that return a `ILocalData` implementation. Please see details bellow.
|
||||
El API de almacenamiento es un poco más complejo, necesitarás crear una clase que devuelva una implementación de `ILocalData`. Por favor, mira los detalles que aparecen a continuación.
|
||||
|
||||
```js
|
||||
<br />class LocalDatabase<ILocalData>{
|
||||
@ -139,15 +139,15 @@ interface IReadTarball extends stream$PassThrough {
|
||||
}
|
||||
```
|
||||
|
||||
> The Storage API is still experimental and might change in the next minor versions. For further information about Storage API please follow the [types definitions in our official repository](https://github.com/verdaccio/flow-types).
|
||||
> El API de Almacenamiento todavía es experimental y podría cambiar en las próximas versiones menores. Para más información acerca del API de Almacenamiento por favor sigue los [tipos y definiciones en nuestro repositorio oficial](https://github.com/verdaccio/flow-types).
|
||||
|
||||
### Storage Plugins Examples
|
||||
### Ejemplos de Extensiones de Almacenamiento
|
||||
|
||||
The following list of plugins are implementing the Storage API and might be used them as example.
|
||||
La siguiente lista de extensiones implementan el API de Almacenamiento y pueden ser utilizados como ejemplo.
|
||||
|
||||
* [verdaccio-memory](https://github.com/verdaccio/verdaccio-memory)
|
||||
* [local-storage](https://github.com/verdaccio/local-storage)
|
||||
* [verdaccio-google-cloud](https://github.com/verdaccio/verdaccio-google-cloud)
|
||||
* [verdaccio-s3-storage](https://github.com/Remitly/verdaccio-s3-storage/tree/s3)
|
||||
|
||||
> Are you willing to contribute with new Storage Plugins? [Click here.](https://github.com/verdaccio/verdaccio/issues/103#issuecomment-357478295)
|
||||
> ¿Estás dispuesto a contribuir con nuevas extensiones de almacenamiento? [Haz click aquí.](https://github.com/verdaccio/verdaccio/issues/103#issuecomment-357478295)
|
||||
@ -36,7 +36,7 @@ Para un (parche) especifico:
|
||||
docker pull verdaccio/verdaccio:3.0.1
|
||||
```
|
||||
|
||||
For the next major release using the `beta` (master branch) version.
|
||||
Para el siguiente gran lanzamiento usando la versión `beta` (rama principal).
|
||||
|
||||
```bash
|
||||
docker pull verdaccio/verdaccio:beta
|
||||
@ -54,7 +54,7 @@ docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio
|
||||
|
||||
El último argumento define cual imagen se usa. En la linea de abajo se descargará la ultima imagen desde Docker Hub, si no existía previamente.
|
||||
|
||||
If you have [build an image locally](#build-your-own-docker-image) use `verdaccio` as the last argument.
|
||||
Si has [construido una imagen localmente](#build-your-own-docker-image) usa `verdaccio` como el último argumento.
|
||||
|
||||
You can use `-v` to bind mount `conf` and `storage` to the hosts filesystem:
|
||||
|
||||
@ -69,13 +69,13 @@ V_PATH=/path/for/verdaccio; docker run -it --rm --name verdaccio -p 4873:4873 \
|
||||
|
||||
### Usar un puerto personalizado con Docker
|
||||
|
||||
Any `host:port` configured in `conf/config.yaml` under `listen` is currently ignored when using docker.
|
||||
Cualquier `host:port` configurado en `conf/config.yaml` bajo `listen` está actualmente ignorado al usar docker.
|
||||
|
||||
If you want to reach verdaccio docker instance under different port, lets say `5000` in your `docker run` command replace `-p 4873:4873` with `-p 5000:4873`.
|
||||
|
||||
In case you need to specify which port to listen to **in the docker container**, since version 2.?.? you can do so by providing additional arguments to `docker run`: `--env PORT=5000` This changes which port the docker container exposes and the port verdaccio listens to.
|
||||
En caso de que necesites especificar cuál puerto escuchar **en el contenedor docker**, desde la versión 2.?.? puedes hacerlo al proveer argumentos adicionales a `docker run`: `--env PORT=5000` Esto cambia cual puerto el contenedor docker muestra y el puerto que verdaccio escucha.
|
||||
|
||||
Of course the numbers you give to `-p` paremeter need to match, so assuming you want them to all be the same this is what you could copy, paste and adopt:
|
||||
Por supuesto que los número que le das al parámetro `-p` necesitan coincidir, así que asumiendo que quieres que todos sean iguales, esto es lo que pudieses copiar, pegar y adoptar:
|
||||
|
||||
```bash
|
||||
PORT=5000; docker run -it --rm --name verdaccio \
|
||||
@ -85,7 +85,7 @@ PORT=5000; docker run -it --rm --name verdaccio \
|
||||
|
||||
### Configura Docker con HTTPS
|
||||
|
||||
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.
|
||||
Puedes configurar el protocolo que verdaccio va a escuchar, similar a la configuración de puerto. Tienes que sobre escribir el valor por defecto ("http") de la variable del entorno `PROTOCOL` a "https", luego de haber especificado los certificados en config.yaml.
|
||||
|
||||
```bash
|
||||
PROTOCOL=https; docker run -it --rm --name verdaccio \
|
||||
@ -95,16 +95,16 @@ PROTOCOL=https; docker run -it --rm --name verdaccio \
|
||||
|
||||
### Usando docker-compose
|
||||
|
||||
1. Obtener la última versión de [docker-compose](https://github.com/docker/compose).
|
||||
1. Obtén la última versión de [docker-compose](https://github.com/docker/compose).
|
||||
2. Construye y ejecuta el contenedor:
|
||||
|
||||
```bash
|
||||
$ docker-compose up --build
|
||||
```
|
||||
|
||||
You can set the port to use (for both container and host) by prefixing the above command with `PORT=5000`.
|
||||
Puedes configurar el puerto a usar (tanto para el contenedor como para el cliente) prefijando el comando anterior con `PORT=5000`.
|
||||
|
||||
Docker will generate a named volume in which to store persistent application data. You can use `docker inspect` or `docker volume inspect` to reveal the physical location of the volume and edit the configuration, such as:
|
||||
Docker generará un volumen con nombre en el cual se almacenan datos de aplicación persistente. Puedes usar `docker inspect` ó `docker volume inspect` para revelar la ubicación física del volumen y editar la configuración, tal como:
|
||||
|
||||
$ docker volume inspect verdaccio_verdaccio
|
||||
[
|
||||
@ -131,7 +131,7 @@ There is also an npm script for building the docker image, so you can also do:
|
||||
npm run build:docker
|
||||
```
|
||||
|
||||
Note: The first build takes some minutes to build because it needs to run `npm install`, and it will take that long again whenever you change any file that is not listed in `.dockerignore`.
|
||||
Nota: La primera construcción toma algunos minutos para construir porque necesita ejecutar el `npm install`, y tomará el mismo tiempo cada vez que cambies cualquier archivo que no esté listado en `.dockerignore`.
|
||||
|
||||
If you want to use the docker image on a rpi or a compatible device there is also a dockerfile available. To build the docker image for raspberry pi execute:
|
||||
|
||||
@ -139,11 +139,11 @@ If you want to use the docker image on a rpi or a compatible device there is als
|
||||
npm run build:docker:rpi
|
||||
```
|
||||
|
||||
Please note that for any of the above docker commands you need to have docker installed on your machine and the docker executable should be available on your `$PATH`.
|
||||
Por favor note que para cualquier comando docker de arriba, necesitas tener un docker instalado en tu máquina y el docker ejecutable debe estar disponible en tu `$PATH`.
|
||||
|
||||
## Ejemplos con Docker
|
||||
|
||||
There is a separate repository that hosts multiple configurations to compose Docker images with `verdaccio`, for instance, as reverse proxy:
|
||||
Existe un repositorio separado que aloja múltiples configuraciones para componer imágenes Docker con `verdaccio`, por ejemplo, como proxy inverso:
|
||||
|
||||
<https://github.com/verdaccio/docker-examples>
|
||||
|
||||
|
||||
@ -2,26 +2,26 @@
|
||||
id: iss-servidor
|
||||
title: "Instalación en servidor IIS"
|
||||
---
|
||||
Estas instrucciones fueron escritas para Windows Server 2012, IIS 8, [Node.js 0.12.3](https://nodejs.org/), [iisnode 0.2.16](https://github.com/tjanczuk/iisnode) and [verdaccio 2.1.0](https://github.com/verdaccio/verdaccio).
|
||||
Estas instrucciones fueron escritas para Windows Server 2012, IIS 8, [Node.js 0.12.3](https://nodejs.org/), [iisnode 0.2.16](https://github.com/tjanczuk/iisnode) y [verdaccio 2.1.0](https://github.com/verdaccio/verdaccio).
|
||||
|
||||
- Instala IIS Instala [iisnode](https://github.com/tjanczuk/iisnode). Asegúrate de instalar los requerimientos (Url Rewrite Module & node) como se explicó en las instrucciones para 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). Especifíca la ruta en donde guardaste todos los archivos y un número de puerto.
|
||||
- Regresa a Explorer y entrega al usuario que usa el grupo de aplicaciones derechos para modificar la carpeta que acabas de crear. 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)
|
||||
- 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
|
||||
|
||||
|
||||
- Make sure you have an inbound rule accepting TCP traffic to the port in Windows Firewall
|
||||
- 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:
|
||||
|
||||
- Me aseguré que el archivo .npmrc en `c:\users{yourname}` tuviese el registro configurado a `"registry=http://localhost/"`
|
||||
- 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
|
||||
- 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
|
||||
|
||||
|
||||
@ -8,7 +8,7 @@ Verdaccio es una aplicación web multiplataforma. Para instalarlo, necesitas uno
|
||||
|
||||
1. Node mayor que
|
||||
- En `verdaccio@2.x` Node `v4.6.1` es la versión mínima soportada.
|
||||
- For version `verdaccio@latest` Node `6.12.0` is the minimum supported version.
|
||||
- Para la versión `verdaccio@latest` El Node `6.12.0` es la versión mínima soportada.
|
||||
2. npm `>=3.x` o `yarn`
|
||||
3. La interfaz web soporta los exploradores `Chrome, Firefox, Edge, and IE9`.
|
||||
|
||||
@ -28,11 +28,11 @@ o usando `yarn`
|
||||
yarn global add verdaccio
|
||||
```
|
||||
|
||||
|
||||
|
||||
|
||||
## Uso Básico
|
||||
|
||||
Once it has been installed, you only need to execute the CLI command:
|
||||
Una vez ha sido instalado, solo necesitas ejecutar el commando CLI:
|
||||
|
||||
```bash
|
||||
$> verdaccio
|
||||
@ -42,8 +42,8 @@ warn --- http address - http://localhost:4873/ - verdaccio/3.0.1
|
||||
|
||||
|
||||
|
||||
For more information about the CLI, please [read the cli section](cli.md).
|
||||
Para mas información sobre CLI, por favor[lea la sección cli](cli.md).
|
||||
|
||||
## Imagen de Docker
|
||||
|
||||
`verdaccio` has an official docker image you can use, and in most cases, the default configuration is good enough. For more information about how to install the official image, [read the docker section](docker.md).
|
||||
` verdaccio`ofrece una imagen oficial de docker que puedes usar, y en el mayor de los casos, la configuración por defecto es suficiente. Para mas información sobre como instalar la imagen oficial, [lea la sección de docker](docker.md).
|
||||
@ -1,8 +1,8 @@
|
||||
---
|
||||
id: logger
|
||||
title: "Logger"
|
||||
title: "Registrador"
|
||||
---
|
||||
As any web application, verdaccio has a customisable built-in logger. You can define multiple types of outputs.
|
||||
Como cualquier aplicación web, verdaccio tiene un registrador personalizable integrado. Puedes definir varios tipos de salidas.
|
||||
|
||||
```yaml
|
||||
logs:
|
||||
@ -12,13 +12,13 @@ logs:
|
||||
- {type: file, path: verdaccio.log, level: info}
|
||||
```
|
||||
|
||||
Use `SIGUSR2` to notify the application, the log-file was rotated and it needs to reopen it.
|
||||
Usa `SIGUSR2` para notificar a la aplicación, el archivo de registro fue rotado y necesita reabrirlo.
|
||||
|
||||
### Configuration
|
||||
### Configuración
|
||||
|
||||
| Property | Type | Required | Example | Support | Description |
|
||||
| -------- | ------ | -------- | ---------------------------------------------- | ------- | ------------------------------------------------- |
|
||||
| type | string | No | [stdout, file] | all | define the output |
|
||||
| path | string | No | verdaccio.log | all | if type is file, define the location of that file |
|
||||
| format | string | No | [pretty, pretty-timestamped] | all | output format |
|
||||
| level | string | No | [fatal, error, warn, http, info, debug, trace] | all | verbose level |
|
||||
| Propiedad | Tipo | Requerido | Ejemplo | Soporte | Descripción |
|
||||
| --------- | ------ | --------- | ---------------------------------------------- | ------- | --------------------------------------------------------- |
|
||||
| type | string | No | [stdout, file] | todos | define la salida |
|
||||
| path | string | No | verdaccio.log | todos | si el tipo es archivo, define la ubicación de ese archivo |
|
||||
| format | string | No | [pretty, pretty-timestamped] | todos | formato de salida |
|
||||
| level | string | No | [fatal, error, warn, http, info, debug, trace] | todos | nivel verboso |
|
||||
@ -1,6 +1,6 @@
|
||||
---
|
||||
id: node-api
|
||||
title: "Node API"
|
||||
title: "Nodo API"
|
||||
---
|
||||
Verdaccio puede ser invocado programáticamente. El API de node ha sido introducido despues de la versión `verdaccio@3.0.0-alpha.10`.
|
||||
|
||||
@ -21,7 +21,7 @@ Verdaccio puede ser invocado programáticamente. El API de node ha sido introduc
|
||||
|
||||
## Otras implementaciones
|
||||
|
||||
* [verdaccio-server](https://github.com/boringame/verdaccio-server) local npm registry proxy server
|
||||
* [servidor-verdaccio](https://github.com/boringame/verdaccio-server) servidor proxy de registro de npm local
|
||||
|
||||
```js
|
||||
// js
|
||||
|
||||
@ -1,12 +1,12 @@
|
||||
---
|
||||
id: protect-your-dependencies
|
||||
title: "Protecting packages"
|
||||
id: protege-tus-dependencias
|
||||
title: "Protegiendo paquetes"
|
||||
---
|
||||
`verdaccio` allows you protect publish, to achieve that you will need to set up correctly your [packages acces](packages).
|
||||
|
||||
### Package configuration
|
||||
### Configuración del paquete
|
||||
|
||||
Let's see for instance the following set up. You have a set of dependencies what are prefixed with `my-company-*` and you need to protect them from anonymous or another logged user without right credentials.
|
||||
Veamos por instancia la siguiente configuración. Tienes un conjunto de dependencias con prefijo `my-company-*` y necesitas protegerlas de anónimos o de otro usuario registrado sin credenciales.
|
||||
|
||||
```yaml
|
||||
'my-company-*':
|
||||
@ -15,18 +15,18 @@ Let's see for instance the following set up. You have a set of dependencies what
|
||||
proxy: npmjs
|
||||
```
|
||||
|
||||
With this configuration, basically we allow to groups **admin** and **teamA** to * publish* and **teamA** **teamB** **teamC** *access* to such dependencies.
|
||||
Con esta configuración, básicamente le permitimos agrupar **administradores** y **equipoA** para * publicar* y el **equipoA** **equipoB** **equipoC** *acceder* a dichas dependencias.
|
||||
|
||||
### Use case: teamD try to access the dependency
|
||||
|
||||
So, if I am logged as **teamD**. I shouldn't be able to access all dependencies that match with `my-company-*` pattern.
|
||||
Entonces, si yo estoy conectado como **equipoD**. No debería ser capaz de acceder a todas las dependencias que cumplan con el patrón `my-company-*`.
|
||||
|
||||
```bash
|
||||
➜ npm whoami
|
||||
teamD
|
||||
```
|
||||
|
||||
I won't have access to such dependencies and also won't be visible via web for user **teamD**. If I try to access the following will happen.
|
||||
No tendré acceso a dichas dependencias y tampoco serán visibles vía web para el usuario **equipoD**. Si intentas acceder, ocurrirá lo siguiente.
|
||||
|
||||
```bash
|
||||
➜ npm install my-company-core
|
||||
@ -34,12 +34,12 @@ npm ERR! code E403
|
||||
npm ERR! 403 Forbidden: webpack-1@latest
|
||||
```
|
||||
|
||||
or with `yarn`
|
||||
o con `yarn`
|
||||
|
||||
```bash
|
||||
➜ yarn add my-company-core
|
||||
yarn add v0.24.6
|
||||
info No lockfile found.
|
||||
[1/4]
|
||||
error An unexpected error occurred: "http://localhost:5555/webpack-1: unregistered users are not allowed to access package my-company-core".
|
||||
error Ocurrió un error inesperado: "http://localhost:5555/webpack-1: no se les permite acceder al paquete my-company-core a usuarios no registrados".
|
||||
```
|
||||
@ -4,7 +4,7 @@ title: "Reverse Proxy Setup"
|
||||
---
|
||||
## Apache
|
||||
|
||||
Apache and mod_proxy should not decode/encode slashes and leave them as they are:
|
||||
Apache y mod_proxy no deberían decodificar/codificar barras y dejarlas como son:
|
||||
|
||||
<VirtualHost *:80>
|
||||
AllowEncodedSlashes NoDecode
|
||||
@ -13,7 +13,7 @@ Apache and mod_proxy should not decode/encode slashes and leave them as they are
|
||||
</VirtualHost>
|
||||
|
||||
|
||||
### Configuration with SSL
|
||||
### Configuración con SSL
|
||||
|
||||
config.yaml
|
||||
|
||||
@ -21,7 +21,7 @@ config.yaml
|
||||
url_prefix: https://npm.your.domain.com
|
||||
```
|
||||
|
||||
Apache virtual server configuration
|
||||
Configuración del servidor virtual de Apache
|
||||
|
||||
apacheconfig
|
||||
<IfModule mod_ssl.c>
|
||||
@ -55,7 +55,7 @@ Apache virtual server configuration
|
||||
|
||||
If you run verdaccio behind reverse proxy, you may noticed all resource file served as relaticve path, like `http://127.0.0.1:4873/-/static`
|
||||
|
||||
To resolve this issue, you should send real domain and port to verdaccio with `Host` heade
|
||||
Para resolver este problema, debes enviar el dominio real y el puerto a verdaccio con `Host` heade
|
||||
|
||||
Nginx configure should look like this:
|
||||
|
||||
@ -68,11 +68,11 @@ location / {
|
||||
}
|
||||
```
|
||||
|
||||
For this case, `url_prefix` should NOT set in verdaccio config
|
||||
Para este caso, `url_prefix` NO debe establecerse en la configuración verdaccio
|
||||
|
||||
* * *
|
||||
|
||||
or a sub-directory installation:
|
||||
o a una instalación de sub-directorio:
|
||||
|
||||
```nginx
|
||||
location ~ ^/verdaccio/(.*)$ {
|
||||
@ -83,6 +83,6 @@ location ~ ^/verdaccio/(.*)$ {
|
||||
}
|
||||
```
|
||||
|
||||
For this case, `url_prefix` should set to `/verdaccio/`
|
||||
Para este caso, `url_prefix` debe establecerse a `/verdaccio/`
|
||||
|
||||
> Note: There is a Slash after install path (`https://your-domain:port/vardaccio/`)!
|
||||
@ -1,45 +1,45 @@
|
||||
---
|
||||
id: ssl
|
||||
title: "Set up the SSL Certificates"
|
||||
title: "Configurar los Certificados SSL"
|
||||
---
|
||||
Follow this instructions to configure a SSL certificate to serve NPM registry under HTTPS.
|
||||
Siga estas instrucciones para configurar un certificado SSL que sirva al registro NPM bajo HTTPS.
|
||||
|
||||
* Update the listen property in your `~/.config/verdaccio/config.yaml`:
|
||||
* Actualice la propiedad listen desde `~/.config/verdaccio/config.yaml`:
|
||||
|
||||
listen: 'https://your.domain.com/'
|
||||
|
||||
|
||||
Once you update the listen and try to run verdaccio again will ask for certificates.
|
||||
Una vez haya actualizado la propiedad listen e intente correr verdaccio nuevamente pedirá los certificados.
|
||||
|
||||
* Generate your certificates
|
||||
* Genere sus certificados
|
||||
|
||||
$ openssl genrsa -out /Users/user/.config/verdaccio/verdaccio-key.pem 2048
|
||||
$ openssl req -new -sha256 -key /Users/user/.config/verdaccio/verdaccio-key.pem -out /Users/user/.config/verdaccio/verdaccio-csr.pem
|
||||
$ openssl x509 -req -in /Users/user/.config/verdaccio/verdaccio-csr.pem -signkey /Users/user/.config/verdaccio/verdaccio-key.pem -out /Users/user/.config/verdaccio/verdaccio-cert.pem
|
||||
````
|
||||
|
||||
* Edit your config file `/Users/user/.config/verdaccio/config.yaml` and add the following section
|
||||
* Edite su archivo config `/Users/user/.config/verdaccio/config.yaml`y añada la próxima sección
|
||||
|
||||
|
||||
|
||||
https: key: /Users/user/.config/verdaccio/verdaccio-key.pem cert: /Users/user/.config/verdaccio/verdaccio-cert.pem ca: /Users/user/.config/verdaccio/verdaccio-csr.pem
|
||||
|
||||
<br />Alternatively, if you have a certificate as `server.pfx` format, you can add the following configuration section. The passphrase is optional and only needed, if your certificate is encrypted.
|
||||
<br />Alternativamente, si tiene un certificado de formato `server.pfx`, puede añadir la siguiente sección de configuración. La propiedad passphrase es opcional y solo necesaria en caso de que su certificado esté encriptado.
|
||||
|
||||
|
||||
|
||||
https: pfx: /Users/user/.config/verdaccio/server.pfx passphrase: 'secret' ````
|
||||
|
||||
More info on the `key`, `cert`, `ca`, `pfx` and `passphrase` arguments on the [Node documentation](https://nodejs.org/api/tls.html#tls_tls_createsecurecontext_options)
|
||||
Puede encontrar más información referente a los argumentos `key`, `cert`, `ca`, `pfx` y `passphrase`, en la [Documentación de nodes](https://nodejs.org/api/tls.html#tls_tls_createsecurecontext_options)
|
||||
|
||||
* Run `verdaccio` in your command line.
|
||||
* Corra `verdaccio` en su línea de comandos.
|
||||
|
||||
* Open the browser and load `https://your.domain.com:port/`
|
||||
* Abra el explorador y cargue `https://your.domain.com:port/`
|
||||
|
||||
This instructions are mostly valid under OSX and Linux, on Windows the paths will vary but, the steps are the same.
|
||||
Estas instrucciones son válidas mayormente para OSX y Linux. Para Windows, las rutas serán diferentes, pero los pasos a seguir son iguales.
|
||||
|
||||
## Docker
|
||||
|
||||
If you are using the Docker image, you have to set the `PROTOCOL` environment variable to `https` as the `listen` argument is provided on the [Dockerfile](https://github.com/verdaccio/verdaccio/blob/master/Dockerfile#L43), and thus ignored from your config file.
|
||||
Si está usando la imagen Docker, debe configurar la variable de entorno `PROTOCOL` como `https` ya que el argumento `listen` es proporcionado por [Dockerfile](https://github.com/verdaccio/verdaccio/blob/master/Dockerfile#L43) y, por lo tanto, ignora lo establecido en su archivo config.
|
||||
|
||||
You can also set the `PORT` environment variable if you are using a different port than `4873`.
|
||||
También puede configurar la variable de entorno `PORT` si está usando un puerto diferente a `4873`.
|
||||
@ -25,18 +25,18 @@ uplinks:
|
||||
|
||||
Puedes definir múltiples uplinks y cada uno de ellos debe tener un nombre único (key). Pueden tener las siguientes propiedades:
|
||||
|
||||
| Propiedad | Tipo | Requerido | Ejemplo | Soporte | Descripción | Por Defecto |
|
||||
| ------------ | ------- | --------- | ------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------- | ----------- |
|
||||
| url | string | Yes | https://registry.npmjs.org/ | all | El dominio del registro | npmjs |
|
||||
| ca | string | No | ~./ssl/client.crt' | all | Ubicación del certificado SSL | Desactivado |
|
||||
| timeout | string | No | 100ms | all | timeout por petición | 30s |
|
||||
| maxage | string | No | 10m | all | limite máximo de fallos de cada petición | 2m |
|
||||
| fail_timeout | string | No | 10m | all | define el tiempo máximo cuando una petición falla | 5m |
|
||||
| max_fails | number | No | 2 | all | límite máximo de fallos | 2 |
|
||||
| cache | boolean | No | [true,false] | >= 2.1 | cache all remote tarballs in storage | true |
|
||||
| auth | list | No | [see below](uplinks.md#auth-property) | >= 2.5 | assigns the header 'Authorization' [more info](http://blog.npmjs.org/post/118393368555/deploying-with-npm-private-modules) | desactivado |
|
||||
| headers | list | No | ]] | all | listado de encabezados por uplink | desactivado |
|
||||
| strict_ssl | boolean | No | [true,false] | >= 3.0 | Es verdadero, requiere que el certificado SSL sea válido. | true |
|
||||
| Propiedad | Tipo | Requerido | Ejemplo | Soporte | Descripción | Por Defecto |
|
||||
| ------------ | ------- | --------- | ------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------- | ----------- |
|
||||
| url | string | Yes | https://registry.npmjs.org/ | all | El dominio del registro | npmjs |
|
||||
| ca | string | No | ~./ssl/client.crt' | all | Ubicación del certificado SSL | Desactivado |
|
||||
| timeout | string | No | 100ms | all | timeout por petición | 30s |
|
||||
| maxage | string | No | 10m | all | limite máximo de fallos de cada petición | 2m |
|
||||
| fail_timeout | string | No | 10m | all | define el tiempo máximo cuando una petición falla | 5m |
|
||||
| max_fails | number | No | 2 | all | límite máximo de fallos | 2 |
|
||||
| cache | boolean | No | [true,false] | >= 2.1 | cache all remote tarballs in storage | true |
|
||||
| auth | list | No | [ver abajo](uplinks.md#auth-property) | >= 2.5 | asigna el encabezado 'Autorización' [más información](http://blog.npmjs.org/post/118393368555/deploying-with-npm-private-modules) | desactivado |
|
||||
| headers | list | No | ]] | all | listado de encabezados por uplink | desactivado |
|
||||
| strict_ssl | boolean | No | [true,false] | >= 3.0 | Es verdadero, requiere que el certificado SSL sea válido. | true |
|
||||
|
||||
#### Auth property
|
||||
|
||||
@ -51,7 +51,7 @@ uplinks:
|
||||
token_env: true # defaults to `process.env['NPM_TOKEN']`
|
||||
```
|
||||
|
||||
or via a specified environment variable:
|
||||
o a través de una variable de entorno específica:
|
||||
|
||||
```yaml
|
||||
uplinks:
|
||||
@ -64,7 +64,7 @@ uplinks:
|
||||
|
||||
`token_env: FOO_TOKEN`internally will use `process.env['FOO_TOKEN']`
|
||||
|
||||
or by directly specifying a token:
|
||||
o al especificar directamente un token:
|
||||
|
||||
```yaml
|
||||
uplinks:
|
||||
@ -75,12 +75,12 @@ uplinks:
|
||||
token: "token"
|
||||
```
|
||||
|
||||
> Note: `token` has priority over `token_env`
|
||||
> Nota: `token` tiene prioridad sobre `token_env`
|
||||
|
||||
### Debes saber
|
||||
|
||||
* Verdaccio no usa Basic Authentication desde la versión `v2.3.0`. Todos los tokens generados por verdaccio están basados en JWT ([JSON Web Token](https://jwt.io/))
|
||||
* Uplinks must be registries compatible with the `npm` endpoints. Eg: *verdaccio*, `sinopia@1.4.0`, *npmjs registry*, *yarn registry*, *JFrog*, *Nexus* and more.
|
||||
* Setting `cache` to false will help to save space in your hard drive. This will avoid store `tarballs` but [it will keep metadata in folders](https://github.com/verdaccio/verdaccio/issues/391).
|
||||
* Exceed with multiple uplinks might slow down the lookup of your packages due for each request a npm client does, verdaccio does 1 call for each uplink.
|
||||
* Definiendo el `caché` como falso te ayudará a ahorrar espacio en tu disco duro. This will avoid store `tarballs` but [it will keep metadata in folders](https://github.com/verdaccio/verdaccio/issues/391).
|
||||
* Excederse con múltiples uplinks puede ralentizar la búsqueda de tus paquetes debido a que cada solicitud que un cliente npm realiza, verdaccio hace una llamada por cada uplink.
|
||||
* The (timeout, maxage and fail_timeout) format follow the [NGINX measurement units](http://nginx.org/en/docs/syntax.html)
|
||||
@ -1,10 +1,10 @@
|
||||
---
|
||||
id: windows
|
||||
title: "Installing As a Windows Service"
|
||||
title: "Instalación como un Servicio de Windows"
|
||||
---
|
||||
Loosely based upon the instructions found [here](http://asysadmin.tumblr.com/post/32941224574/running-nginx-on-windows-as-a-service). I crafted the following and it provided me with a fully working verdaccio service installation:
|
||||
Basándose ligeramente en las instrucciones encontradas [aquí](http://asysadmin.tumblr.com/post/32941224574/running-nginx-on-windows-as-a-service). Elaboré lo siguiente y me proporcionó un servicio de instalación de verdaccio totalmente funcional:
|
||||
|
||||
1. Create a directory for verdaccio
|
||||
1. Crear un directorio para Verdaccio
|
||||
* mkdir `c:\verdaccio`
|
||||
* cd `c:\verdaccio`
|
||||
2. Install verdaccio locally (I ran into npm issues with global installs)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user