mirror of
https://github.com/verdaccio/verdaccio.git
synced 2025-02-21 07:29:37 +01:00
New Crowdin translations (#774)
* New translations windows.md (Spanish) docs(website): new translations * New translations use-cases.md (Spanish) docs(website): new translations * New translations windows.md (Spanish) docs(website): new translations * New translations puppet.md (Spanish) docs(website): new translations * New translations puppet.md (Spanish) docs(website): new translations * New translations packages.md (Spanish) docs(website): new translations * New translations test.md (Spanish) docs(website): new translations * New translations use-cases.md (Spanish) docs(website): new translations * New translations server.md (Spanish) docs(website): new translations * New translations use-cases.md (Spanish) docs(website): new translations * New translations server.md (Spanish) docs(website): new translations * New translations server.md (Spanish) docs(website): new translations * New translations server.md (Spanish) docs(website): new translations * New translations puppet.md (Spanish) docs(website): new translations * New translations server.md (Spanish) docs(website): new translations * New translations puppet.md (Spanish) docs(website): new translations * New translations server.md (Spanish) docs(website): new translations
This commit is contained in:
verdacciobot
Juan Picado @jotadeveloper
parent
e2ffa0b6e7
commit
ac5036b172
@ -53,7 +53,7 @@ Todos los usuarios reciben todos estos conjuntos de permisos, independientemente
|
||||
'$all', '$anonymous', '@all', '@anonymous', 'all', 'undefined', 'anonymous', 'npmUser'
|
||||
```
|
||||
|
||||
Si deseas proteger paquetes establecidos específicos bajo tu grupo, debes realizar algo similara a esto. Vamos a usar un `Regex` que cubre los todos los páquetes prefijos con`npmuser-`. Recomendamos usar un prefijo para tus paquetes, de esta forma será más sencillo protegerlos.
|
||||
Si deseas proteger un grupo de paquetes específicos dentro de tu grupo, debes realizar algo similar a esto. Vamos a usar un `Regex` que cubre los todos los páquetes prefijos con`npmuser-`. Recomendamos usar un prefijo para tus paquetes, de esta forma será más sencillo protegerlos.
|
||||
|
||||
```yaml
|
||||
packages:
|
||||
|
||||
@ -2,19 +2,19 @@
|
||||
id: puppet
|
||||
title: "Puppet"
|
||||
---
|
||||
Install verdaccio for Debian, Ubuntu, Fedora, and RedHat.
|
||||
Instalar verdaccio para Debian, Ubuntu, Fedora y RedHat.
|
||||
|
||||
# Usage
|
||||
# Uso
|
||||
|
||||
There are two variants to install verdaccio using this Puppet module:
|
||||
Hay dos variantes para instalar verdaccio utilizando este módulo Puppet:
|
||||
|
||||
* Apply-mode (with puppet-apply and no puppetmaster setup needed)
|
||||
* Master-Agent-mode (with puppet-agent accessing your configuration through the puppetmaster).
|
||||
* Modo Aplicación (con aplicación de Puppet y sin necesidad de configurar el puppetmaster)
|
||||
* Modo Agente Maestro (con acceso del agente Puppet a su configuración a través del puppetmaster).
|
||||
|
||||
In both variants you have to explicitely 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. Scroll down for details about Master-Agent-mode variant.
|
||||
En ambas variantes tiene que llamar explícitamente a "class nodejs {}" en su script de marioneta porque el módulo de marioneta de verdaccio solo define esto como un requisito, por lo que tiene toda la flexibilidad que quiera cuando instale nodejs. Desplácese hacia abajo para detalles sobre la variante del Modo Agente Maestro.
|
||||
|
||||
For further information:
|
||||
Para más información:
|
||||
|
||||
<https://github.com/verdaccio/puppet-verdaccio>
|
||||
|
||||
> We are looking for active contributors for this integration, if you are interested [refers to this ticket](https://github.com/verdaccio/puppet-verdaccio/issues/11).
|
||||
> Estamos buscando colaboradores para esta integración, si está interesado [ refiérase a esta entrada](https://github.com/verdaccio/puppet-verdaccio/issues/11).
|
||||
@ -1,71 +1,71 @@
|
||||
---
|
||||
id: server-configuration
|
||||
title: "Server Configuration"
|
||||
title: "Configuración del Servidor"
|
||||
---
|
||||
This is mostly basic linux server configuration stuff but I felt it important to document and share the steps I took to get verdaccio running permanently on my server. You will need root (or sudo) permissions for the following.
|
||||
Esta materia es principalmente la configuración básica del servidor de linux pero me pareció importante documentar y compartir los pasos que tomé para obtener la ejecución de verdaccio permanentemente en mi servidor. Necesitará permisos de root (o sudo) para lo siguiente.
|
||||
|
||||
## Running as a separate user
|
||||
## Ejecutar como un usuario separado
|
||||
|
||||
First create the verdaccio user:
|
||||
Crear primero el usuario de verdaccio:
|
||||
|
||||
```bash
|
||||
$ sudo adduser --disabled-login --gecos 'Verdaccio NPM mirror' verdaccio
|
||||
```
|
||||
|
||||
You create a shell as the verdaccio user using the following command:
|
||||
Crear una capa como el usuario de verdaccio utilizando el siguiente comando:
|
||||
|
||||
```bash
|
||||
$ sudo su verdaccio
|
||||
$ cd ~
|
||||
```
|
||||
|
||||
The 'cd ~' command send you to the home directory of the verdaccio user. Make sure you run verdaccio at least once to generate the config file. Edit it according to your needs.
|
||||
El comando 'cd ~' lo envía al directorio principal del usuario de verdaccio. Asegúrese de ejecutar verdaccio al menos una vez para generar el archivo de configuración. Edítelo acorde a sus necesidades.
|
||||
|
||||
## Listening on all addresses
|
||||
## Atender todas las direcciones
|
||||
|
||||
If you want to listen to every external address set the listen directive in the config to:
|
||||
Si quiere atender cada dirección externa establezca la directiva a atender en la configuración para:
|
||||
|
||||
```yaml
|
||||
# you can specify listen address (or simply a port)
|
||||
listen: 0.0.0.0:4873
|
||||
```
|
||||
|
||||
If you are running `verdaccio` in a Amazon EC2 Instance, [you will need set the listen in change your config file](https://github.com/verdaccio/verdaccio/issues/314#issuecomment-327852203) as is described above.
|
||||
Si está ejecutando `verdaccio` en una instancia de Amazon EC2, [necesitará establecer la escucha en cambiar su archivo de configuración](https://github.com/verdaccio/verdaccio/issues/314#issuecomment-327852203) como se describió anteriormente.
|
||||
|
||||
> Apache configure? Please check out the [Reverse Proxy Setup](reverse-proxy.md)
|
||||
> ¿Configurar Apache? Por favor verifique la [Configuración Inversa de Proxy](reverse-proxy.md)
|
||||
|
||||
## Keeping verdaccio running forever
|
||||
## Mantener verdaccio ejecutándose para siempre
|
||||
|
||||
We can use the node package called 'forever' to keep verdaccio running all the time. https://github.com/nodejitsu/forever
|
||||
Podemos utilizar el paquete de nodo llamado 'forever' para mantener verdaccio ejecutándose todo el tiempo. https://github.com/nodejitsu/forever
|
||||
|
||||
First install forever globally:
|
||||
Primero instales forever globalmente:
|
||||
|
||||
```bash
|
||||
$ sudo npm install -g forever
|
||||
```
|
||||
|
||||
Make sure you've started verdaccio at least once to generate the config file and write down the created admin user. You can then use the following command to start verdaccio:
|
||||
Asegúrese que ha iniciado verdaccio al menos una vez para general el archivo de configuración y escriba el usuario admin creado. Puede entonces utilizar el siguiente comando para iniciar verdaccio:
|
||||
|
||||
```bash
|
||||
$ forever start `which verdaccio`
|
||||
```
|
||||
|
||||
You can check the documentation for more information on how to use forever.
|
||||
Puede verificar la documentación para más información sobre como utilizar forever.
|
||||
|
||||
## Surviving server restarts
|
||||
## Sobrevivir a los reinicios del servidor
|
||||
|
||||
We can use crontab and forever together to restart verdaccio after a server reboot. When you're logged in as the verdaccio user do the following:
|
||||
Podemos utilizar crontab y forever juntos para reiniciar verdaccio después de un reinicio del servidor. Cuando inicie sesión como usuario de verdaccio haga lo siguiente:
|
||||
|
||||
```bash
|
||||
$ crontab -e
|
||||
```
|
||||
|
||||
This might ask you to choose an editor. Pick your favorite and proceed. Add the following entry to the file:
|
||||
Esto podría pedirle que escoja un editor. Elija su favorito y continúe. Agregue la siguiente entrada al archivo:
|
||||
|
||||
@reboot /usr/bin/forever start /usr/lib/node_modules/verdaccio/bin/verdaccio
|
||||
|
||||
|
||||
The locations may vary depending on your server setup. If you want to know where your files are you can use the 'which' command:
|
||||
Las ubicaciones pueden variar dependiendo de su configuración del servidor. Si quiere saber donde están sus archivos puede utilizar el comando 'which':
|
||||
|
||||
```bash
|
||||
$ which forever
|
||||
|
||||
@ -8,7 +8,7 @@ Todos los tests están divididos entre tres carpetas:
|
||||
- `test/functional` - Tests que ejecutan una instancia de verdaccio y realizan una serie de peticiones a esta sobre http. Son de mayor lentitud en comparación a los tests unitarios.
|
||||
- `test/integration` - Tests que ejecutan una instancia de verdaccio y realizan peticiones a esta usando npm. Son considerablemente lentas y pueden incidir sobre un registro real de npm. **test sin mantenimiento**
|
||||
|
||||
Los tests de tipo unit y functional son ejecutados automáticamente al correr `npm test` desde el directorio raiz del proyecto. Los tests de tipo integration se suponen deben ser ejecutados de forma manual ocasionalmente.
|
||||
Los tests de tipo unit y functional son ejecutados automáticamente al correr `npm test` desde el directorio raíz del proyecto. Los tests de tipo integration se suponen deben ser ejecutados de forma manual ocasionalmente.
|
||||
|
||||
Utilizamos `jest` para todos los tests.
|
||||
|
||||
@ -23,7 +23,7 @@ Esto accionará solo los primeros dos grupos de tests, unit y funtional.
|
||||
|
||||
### Usando test/unit
|
||||
|
||||
El siguiente es simplemente un ejemplo de cómo se debe ver un test unitario. Básicamente, sigue el estandar `jest`.
|
||||
El siguiente es simplemente un ejemplo de cómo se debe ver un test unitario. Básicamente, sigue el estándar `jest`.
|
||||
|
||||
Intenta describir exactamente qué hace el test unitario en una sola frase en el encabezado de la sección `test`.
|
||||
|
||||
@ -50,9 +50,9 @@ const config = require('./partials/config');
|
||||
|
||||
### Usando test/functional
|
||||
|
||||
Los tests functionales en verdaccio acarrean un mayor nivel de complejidad que amerita una explicación profunda para asegurar el éxito de tu experiencia.
|
||||
Los tests funcionales en verdaccio acarrean un mayor nivel de complejidad que amerita una explicación profunda para asegurar el éxito de tu experiencia.
|
||||
|
||||
Todo inicia en el archivo `index.js`. Adentrémosnos en este.
|
||||
Todo inicia en el archivo `index.js`. Adentrémonos en este.
|
||||
|
||||
```javascript
|
||||
// creamos tres instancias de servidores
|
||||
@ -109,7 +109,7 @@ Todo inicia en el archivo `index.js`. Adentrémosnos en este.
|
||||
|
||||
### Uso
|
||||
|
||||
Aquí describiremos cómo se ve un test funcional típico, revise en línea para información más detallada.
|
||||
Aquí describiremos cómo se ve un test funcional típico.
|
||||
|
||||
#### El lib/server.js
|
||||
|
||||
@ -131,4 +131,4 @@ Usando dichas referencias serás capaz de enviar peticiones a cualquiera de las
|
||||
|
||||
### Test/integration
|
||||
|
||||
Esta sección no ha sido usada jamás, pero estamos buscando ayuda con la intención de poder ejecutarla apropiadamente. **Toda idea nueva es bastante bienvenida.**
|
||||
Esta sección no ha sido usada jamás, pero estamos buscando ayuda con la intención de poder ejecutarla apropiadamente. **Toda idea nueva es bien recibida.**
|
||||
@ -4,13 +4,13 @@ title: "Casos de Usos"
|
||||
---
|
||||
## Uso de paquetes privados
|
||||
|
||||
Puede agregar usuarios y administrar qué usuarios pueden acceder a cuál paquete.
|
||||
Puede agregar usuarios y administrar qué usuarios pueden acceder a cuáles paquetes.
|
||||
|
||||
Se recomienda que defina un prefijo para sus paquetes privados, por ejemplo "local", así que todos sus elementos privados se verán así: `local-foo`. De esta manera puede separar claramente los paquetes públicos de los privados.
|
||||
|
||||
## Uso de paquetes públicos desde npmjs.org
|
||||
|
||||
Si algún paquete no existe en el almacenamiento, el servidor intentará recuperarlo desde npmjs.org. Si npmjs.org está fuera de línea, proporciona paquetes desde el caché que simulan que no existen otros paquetes. Verdaccio descargará solo los que necesita (los solicitados por los clientes), y esta información se almacenará en caché, entonces si un cliente pregunta lo mismo por segunda vez, puede ser atendido sin preguntar a npmjs.org por eso.
|
||||
Si algún paquete no existe en el almacenamiento, el servidor intentará recuperarlo desde npmjs.org. Si npmjs.org está fuera de línea, este proporciona paquetes desde el caché que simulan que no existen otros paquetes. Verdaccio descargará solo los que necesita (los solicitados por los clientes), y esta información se almacenará en caché, entonces si un cliente pregunta lo mismo por segunda vez, puede ser atendido sin preguntar a npmjs.org por eso.
|
||||
|
||||
Ejemplo: si solicita exitosamente express@3.0.1 desde este servidor una vez, podrá hacerlo nuevamente (con todas sus dependencias) en cualquier momento incluso si npmjs.org está fuera de línea. Pero digamos que express@3.0.0 no se descargará hasta que realmente alguien lo necesite. Y si npmjs.org no está conectado, este servidor diría que solo express@3.0.1 (únicamente lo que está en caché) se publicará, pero nada más.
|
||||
|
||||
@ -18,14 +18,14 @@ Ejemplo: si solicita exitosamente express@3.0.1 desde este servidor una vez, pod
|
||||
|
||||
Si quiere utilizar una versión modificada de algún paquete público `foo`, puede sólo publicarlo en su servidor local, así que cuando escriba `npm install foo`, lo considerará instalando su versión.
|
||||
|
||||
There's two options here:
|
||||
Hay dos opciones aquí:
|
||||
|
||||
1. You want to create a separate fork and stop synchronizing with public version.
|
||||
1. Quiere crear una bifurcación separada y detener la sincronización con la versión pública.
|
||||
|
||||
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.
|
||||
Si quiere hacer eso, debe modificar su archivo de configuración para que verdaccio nunca más realice solicitudes en cuanto a este paquete en npmjs. Agregue una entrada separada para este paquete a *config.yaml* y elimine `npmjs` desde la lista `proxy` y reinicie el servidor.
|
||||
|
||||
When you publish your package locally, you should probably start with version string higher than existing one, so it won't conflict with existing package in the cache.
|
||||
Cuando publique su paquete localmente, probablemente deberá iniciar con la cadena de versión superior a la existente, para que no entre en conflicto con el paquete existente en caché.
|
||||
|
||||
2. You want to temporarily use your version, but return to public one as soon as it's updated.
|
||||
2. Quiere utilizar temporalmente su versión, pero regresar a la pública tan pronto como se actualice.
|
||||
|
||||
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. This way your package will be used until its original maintainer updates his public package to 0.1.3.
|
||||
A fin de evitar conflictos de versiones, debería utilizar un sufijo personalizado previo al lanzamiento de la siguiente versión del parche. Por ejemplo, si un paquete público tiene la versión 0.1.2, puede cargar 0.1.3-my-temp-fix. De esta manera su paquete se utilizará hasta que el desarrollador original cargue su paquete público al 0.1.3.
|
||||
@ -2,7 +2,7 @@
|
||||
id: windows
|
||||
title: "Instalación como un Servicio de Windows"
|
||||
---
|
||||
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:
|
||||
Basándome 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. Crear un directorio para Verdaccio
|
||||
* mkdir `c:\verdaccio`
|
||||
@ -24,7 +24,7 @@ MÉTODO ALTERNATIVO: (el paquete WinSW faltaba cuando intenté descargarlo)
|
||||
|
||||
* Ejecutar la instalación nssm de verdaccio. Como mínimo debe completar en la Aplicación las pestañas de Ruta, el directorio de Inicio y los campos de Argumentos. Suponiendo una instalación con nodo en la ruta del sistema y una ubicación de c:\verdaccio los siguientes valores funcionarán:
|
||||
|
||||
* Ruta:`nodo`
|
||||
* Ruta: `node`
|
||||
* Directorio de Inicio: `c:\verdaccio`
|
||||
* Argumentos: `c:\verdaccio\node_modules\verdaccio\build\lib\cli.js -c c:\verdaccio\config.yaml`
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user