Commit fb9c1c99 authored by Nick Gaskill's avatar Nick Gaskill

Merge branch 'docs-kg-update-npm-registry-page' into 'master'

Update npm registy doc with a few changes

See merge request gitlab-org/gitlab!57032
parents 73f6ae7c 9de5cb5d
...@@ -263,6 +263,16 @@ npm publish ...@@ -263,6 +263,16 @@ npm publish
To view the package, go to your project's **Packages & Registries**. To view the package, go to your project's **Packages & Registries**.
You can also define `"publishConfig"` for your project in `package.json`. For example:
```json
{
"publishConfig": { "@foo:registry":" https://gitlab.example.com/api/v4/projects/<your_project_id>/packages/npm/" }
}
```
This forces the package to publish only to the specified registry.
If you try to publish a package [with a name that already exists](#publishing-packages-with-the-same-name-or-version) within If you try to publish a package [with a name that already exists](#publishing-packages-with-the-same-name-or-version) within
a given scope, you get a `403 Forbidden!` error. a given scope, you get a `403 Forbidden!` error.
...@@ -402,6 +412,9 @@ Due to a bug in npm 6.9.0, deleting distribution tags fails. Make sure your npm ...@@ -402,6 +412,9 @@ Due to a bug in npm 6.9.0, deleting distribution tags fails. Make sure your npm
## Troubleshooting ## Troubleshooting
When troubleshooting npm issues, first run the same command with the `--verbose` flag to confirm
what registry you are hitting.
### Error running Yarn with the Package Registry for npm registry ### Error running Yarn with the Package Registry for npm registry
If you are using [Yarn](https://classic.yarnpkg.com/en/) with the npm registry, you may get If you are using [Yarn](https://classic.yarnpkg.com/en/) with the npm registry, you may get
...@@ -471,6 +484,8 @@ If you get this error, ensure that: ...@@ -471,6 +484,8 @@ If you get this error, ensure that:
- Your token is not expired and has appropriate permissions. - Your token is not expired and has appropriate permissions.
- [Your token does not begin with `-`](https://gitlab.com/gitlab-org/gitlab/-/issues/235473). - [Your token does not begin with `-`](https://gitlab.com/gitlab-org/gitlab/-/issues/235473).
- A package with the same name or version doesn't already exist within the given scope. - A package with the same name or version doesn't already exist within the given scope.
- Your NPM package name does not contain a dot `.`. This is a [known issue](https://gitlab.com/gitlab-org/gitlab-ee/issues/10248)
in GitLab 11.9 and earlier.
- The scoped packages URL includes a trailing slash: - The scoped packages URL includes a trailing slash:
- Correct: `//gitlab.example.com/api/v4/packages/npm/` - Correct: `//gitlab.example.com/api/v4/packages/npm/`
- Incorrect: `//gitlab.example.com/api/v4/packages/npm` - Incorrect: `//gitlab.example.com/api/v4/packages/npm`
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment