Skip to content

CONFIGURATION.md

Latest commit

 

History

History
142 lines (116 loc) · 3.37 KB

CONFIGURATION.md

File metadata and controls

142 lines (116 loc) · 3.37 KB
Raw

Configuration

You can use vsr as a private local registry, a proxy registry, or both. If you want to publish into or consume from the local registry you can use http://localhost:<port>.

To proxy requests to npm you can just add npm to the pathname (ex. http://localhost:<port>/npm will proxy all requests to npmjs.org)

CLI Configuration

VSR supports both development and deployment commands with various configuration options:

Development Server (vsr dev)

# Start with defaults
vsr dev

# Custom configuration
vsr dev --port 3000 --debug --config ./vlt.json

Deployment (vsr deploy)

# Deploy to default environment (dev)
vsr deploy

# Deploy to specific environment
vsr deploy --env=prod

# Override resource names
vsr deploy --env=staging --db-name=custom-db --bucket-name=custom-bucket

# Preview deployment
vsr deploy --dry-run --env=prod

Configuration File (vlt.json)

VSR can be configured using a vlt.json file that supports both development and deployment settings:

Development Configuration

{
  "registry": {
    "port": 4000,
    "debug": true,
    "telemetry": false
  }
}

Deployment Configuration

{
  "registry": {
    "deploy": {
      "sentry": {
        "dsn": "https://your-default-sentry-dsn@sentry.io/project-id",
        "sampleRate": 1.0,
        "tracesSampleRate": 0.1
      },
      "environments": {
        "dev": {
          "databaseName": "vsr-dev-database",
          "bucketName": "vsr-dev-bucket",
          "queueName": "vsr-dev-cache-refresh-queue",
          "sentry": {
            "environment": "development"
          },
          "vars": {
            "CUSTOM_VAR": "dev-value"
          }
        },
        "staging": {
          "databaseName": "vsr-staging-database",
          "bucketName": "vsr-staging-bucket",
          "queueName": "vsr-staging-cache-refresh-queue",
          "sentry": {
            "environment": "staging"
          }
        },
        "prod": {
          "databaseName": "vsr-prod-database",
          "bucketName": "vsr-prod-bucket",
          "queueName": "vsr-prod-cache-refresh-queue",
          "sentry": {
            "environment": "production",
            "dsn": "https://your-prod-sentry-dsn@sentry.io/project-id",
            "sampleRate": 0.1,
            "tracesSampleRate": 0.01
          },
          "vars": {
            "API_BASE_URL": "https://api.example.com"
          }
        }
      }
    }
  }
}

See the Deployment Guide for complete deployment configuration documentation.

Package Manager Integration

For vlt:

In your project or user-level vlt.json file add the relevant configuration.

{
  "registries": {
    "npm": "http://localhost:1337/npm",
    "local": "http://localhost:1337"
  }
}
For npm, pnpm, yarn & bun:

To use vsr as your registry you must either pass a registry config through a client-specific flag (ex. --registry=... for npm) or define client-specific configuration which stores the reference to your registry (ex. .npmrc for npm). Access to the registry & packages is private by default although an "admin" user is created during setup locally (for development purposes) with a default auth token of "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

; .npmrc
registry=http://localhost:1337
//localhost:1337/:_authToken=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx