Set up npm to use your internal registry

Set up npm so that Node.js workspaces can install packages from your internal npm registry. .Prerequisites

About this task

You are not running any npm workspace.
Warning:

Applying a ConfigMap that sets environment variables might cause a workspace boot loop.

If you encounter this behavior, remove the ConfigMap and edit the devfile directly.

Procedure

Create a Secret to store the TLS certificate:

kind: Secret
apiVersion: v1
metadata:
  name: tls-cer
  annotations:
    controller.devfile.io/mount-path: /public-certs
    controller.devfile.io/mount-as: file
  labels:
    controller.devfile.io/mount-to-devworkspace: 'true'
    controller.devfile.io/watch-secret: 'true'
data:
  nexus.cer: >-
    <Base64_encoded_content_of_public_cert>

where:

<Base64_encoded_content_of_public_cert>: The Base64-encoded content of your npm artifact repository’s public TLS certificate, with line wrapping disabled.

Apply the Secret to your project:
```
$ oc apply -f tls-cer.yaml -n <your_namespace>
```

Create a ConfigMap to set the NPM_CONFIG_REGISTRY environment variable:

kind: ConfigMap
apiVersion: v1
metadata:
  name: disconnected-env
  annotations:
    controller.devfile.io/mount-as: env
  labels:
    controller.devfile.io/mount-to-devworkspace: 'true'
    controller.devfile.io/watch-configmap: 'true'
data:
  NPM_CONFIG_REGISTRY: >-
    https://<npm_artifact_repository_route>/repository/npm-all/

where:

<npm_artifact_repository_route>: The hostname and path of your internal npm artifact repository.

Apply the ConfigMap to your project:
```
$ oc apply -f disconnected-env.yaml -n <your_namespace>
```
Start a npm workspace.
Configure the workspace to trust the self-signed certificate by using one of the following options:
1. Set the NODE_EXTRA_CA_CERTS environment variable to the path of the TLS certificate:
```
$ export NODE_EXTRA_CA_CERTS=/public-certs/nexus.cer
$ npm install
```
2. Alternatively, disable self-signed certificate validation:
```
$ npm config set strict-ssl false
```
  Warning:
  
  Disabling SSL/TLS bypasses the validation of your self-signed certificates. For a more secure solution, use NODE_EXTRA_CA_CERTS (sub-step a).

Results

Open a terminal in your workspace.
Verify the npm registry configuration:
```
$ npm config get registry
```
The output shows the artifact repository URL from your ConfigMap.
Install a package to verify artifact resolution from the mirror:
```
$ npm install express
```