verdaccio/website/translated_docs/fr/config.md

id	title
configuration	Fichier de configuration

Ce fichier est le pilier de verdaccio où vous pouvez modifier le comportement par défaut, activer les plugins et étendre les fonctionnalités.

Un fichier de configuration par défaut est créé la première fois que vous exécutez verdaccio.

Configuration par défaut

La configuration par défaut a un support pour les packs portée(scoped) et permet à tout utilisateur à accéder à tous les packs, mais seuls les utilisateurs authentifiés qui peuvent publier.

storage: ./storage
auth:
  htpasswd:
    file: ./htpasswd
uplinks:
  npmjs:
    url: https://registry.npmjs.org/
packages:
  '@*/*':
    access: $all
    publish: $authenticated
    proxy: npmjs
  '**':
    proxy: npmjs
logs:
  - {type: stdout, format: pretty, level: http}

Sections

Les sections suivantes expliquent ce que signifie chaque propriété et les différentes options.

Stockage

Is the location of the default storage. Verdaccio is by default based on local file system.

storage: ./storage

Plugins

C'est le chemin du répertoire des plugins. Utile pour les distributions basées sur Docker / Kubernetes.

plugins: ./plugins

Authentification

Le paramètre d'authentification est défini ici, l'authentification par défaut est basée sur htpasswd et est incorporée. Vous pouvez modifier ce comportement via lesplugins. Pour plus d'informations sur cette section, consultez la page d'authentification .

auth:
  htpasswd:
    file: ./htpasswd
    max_users: 1000

Web UI

Cette propriété vous permet de modifier les fonctionnalités de l'interface utilisateur Web. Pour plus d'informations sur cette section, consultez la page de l'interface utilisateur Web .

web:
  enable: true
  title: Verdaccio
  logo: logo.png
  scope:

Uplinks

Uplinks is the ability of the system to fetch packages from remote registries when those packages are not available locally. For more information about this section read the uplinks page.

uplinks:
  npmjs:
    url: https://registry.npmjs.org/

Packages

Packages allow the user to control how the packages are gonna be accessed. For more information about this section read the packages page.

packages:
  '@*/*':
    access: $all
    publish: $authenticated
    proxy: npmjs

Advanced Settings

Offline Publish

Par défaut verdaccio n'autorise pas le client à publier lorsqu'il est hors ligne, ce comportement peut être remplacé en définissant cette option true.

publish:
  allow_offline: false

Since: verdaccio@2.3.6 due #223

Préfixe de l'URL

url_prefix: https://dev.company.local/verdaccio/

Since: verdaccio@2.3.6 due #197

Taille maximale du corps

Par défaut, la taille maximale du corps d'un document JSON est 10mb. Si vous rencontrez des erreurs telles que "entité requise trop grande", vous pouvez augmenter cette valeur.

max_body_size: 10mb

Port d’écoute

verdaccio s’exécute par défaut dans le port 4873. La modification du port peut être faite via cli ou dans le fichier de configuration, les options suivantes sont valides.

listen:
# - localhost:4873            # default value
# - http://localhost:4873     # same thing
# - 0.0.0.0:4873              # listen on all addresses (INADDR_ANY)
# - https://example.org:4873  # if you want to use https
# - "[::1]:4873"                # ipv6
# - unix:/tmp/verdaccio.sock    # unix socket

HTTPS

Pour activer https dans verdaccio il suffit de définir le drapeau Ecoute avec le protocole https://. Pour plus d’informations sur cette section, lisez ssl page.

https:
    key: ./path/verdaccio-key.pem
    cert: ./path/verdaccio-cert.pem
    ca: ./path/verdaccio-csr.pem

Proxy

Les Proxy sont des serveurs HTTP spéciaux conçus pour transférer des données de serveurs distants vers des clients locaux.

http_proxy and https_proxy

Si vous avez un proxy sur le réseau, vous pouvez définir un en-tête X-Forwarded-For à l'aide des propriétés suivantes.

http_proxy: http://something.local/
https_proxy: https://something.local/

no_proxy

Cette variable doit contenir une liste d'extensions de domaine séparées par des virgules pour lesquelles le proxy ne doit pas être utilisé.

no_proxy: localhost,127.0.0.1

Notifications

L'activation des notifications d'outils tiers est assez facile via des points d'ancrage Web. Pour plus d'informations sur cette section, consultez la page de notification .

notify:
  method: POST
  headers: [{'Content-Type': 'application/json'}]
  endpoint: https://usagge.hipchat.com/v2/room/3729485/notification?auth_token=mySecretToken
  content: '{"color":"green","message":"New package published: * {{ name }}*","notify":true,"message_format":"text"}'

Pour plus de détails sur les paramètres de configuration, veuillez vérifier le code source .

Audit

Depuis : verdaccio@3.0.0

npm audit est une nouvelle commande émise avec npm 6.x . Verdaccio inclut un plugin middleware intégré pour gérer cette commande.

Si vous avez une nouvelle installation, elle est fournie par défaut. Sinon, vous devez ajouter les propriétés suivantes au fichier de configuration

middlewares:
  audit:
    enabled: true