🐸 configure-jfrog 🐸

The command-line utility configure-jfrog is used to configure an NPM repository for using a JFrog SaaS Artifactory registry.

Installation

No installation is necessary when using npx, although you may globally install with npm install --global configure-jfrog. This is only recommended if you do not desire the latest version of the utility on each run.

Usage

Run the CLI command configure-jfrog with optional flags and answer any prompts that may appear.

configure-jfrog [--directory -d] [--server-name -n] [--artifactory-key -k] [--registry -r] [--scope -s]

⚠️ WARNING: configure-jfrog will replace any existing .npmrc file at the specified directory.

Flags

| name | alias | description | | ----------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | directory | -d | The relative or absolute path to the directory in which to configure NPM. This should be the root directory where your package.json lives. | | server-name | -n | The JFrog Artifactory server name: https://__<server-name>__.jfrog.io | | artifactory-key | -k | Your Artifactory API key. You must generate one for your user profile. | | registry | -r | The name of the registry on Artifactory you would like to use. | | scope | -s | The NPM @scope that your private packages are published to. It is best practice to always publish private packages under a scope so that there are no conflicts with public packages of the same name. |

Example

npx configure-jfrog -d ~/Sites/example-package -n doximity -k $ARTIFACTORY_API_KEY -r npm-doximity -s dox

Run as npm script

It may be helpful to create an NPM script to automatically configure your repository for new users:

{
  "scripts": {
    "configure-npm":
      "npx configure-jfrog -d . -n doximity -k $ARTIFACTORY_API_KEY -r npm-doximity -s dox"
  }
}

This will allow a new user to set up the private registry using their credentials.