gitlabプライベートリポジトリからnpmモジュールをインストールする

私たちはプライベートプロジェクトにGitLabを使用しています。npmモジュールとしてインストールしたい、githubからのフォークされたライブラリーがいくつかあります。npmからそのモジュールを直接インストールしても問題ありません。たとえば、次のようにします。

npm install git://github.com/FredyC/grunt-stylus-sprite.git

...正しく動作しますが、GitLabでも同じことを行います。ドメインを変更するだけでこのエラーが発生します。

npm WARN `git config --get remote.origin.url` returned wrong result (git://git.domain.com/library/grunt-stylus-sprite.git)
npm ERR! git clone git://git.domain.com/library/grunt-stylus-sprite.git Cloning into bare repository 'D:\users\Fredy\AppData\Roaming\npm-cache\_git-remotes\git-git-domain-com-library-grunt-stylus-sprite-git-6f33bc59'...
npm ERR! git clone git://git.domain.com/library/grunt-stylus-sprite.git fatal:unable to connect to git.domain.com:
npm ERR! git clone git://git.domain.com/library/grunt-stylus-sprite.git git.domain.com[0: 77.93.195.214]: errno=No error
npm ERR! Error: Command failed: Cloning into bare repository 'D:\users\Fredy\App
Data\Roaming\npm-cache\_git-remotes\git-git-domain-com-library-grunt-stylus-spr
ite-git-6f33bc59'...
npm ERR! fatal: unable to connect to git.domain.com:
npm ERR! git.domain.com[0: xx.xx.xx.xx]: errno=No error

GitLabのウェブインターフェースから、私はこのURLを取得しました git@git.domain.com:library/grunt-stylus-sprite.git。これに対してnpm installこれを実行gitすると、npmレジストリからモジュールをインストールしようとします。

ただし、URLを使用するgit+ssh@git.domain.com:library/grunt-stylus-sprite.gitと、突然パスワードを要求されます。SSHキーにパスフレーズが含まれていないため、そのキーをロードできなかったと思います。たぶん、私が見逃したいくつかの構成がありますか？キーは、私の名前が付いたホームディレクトリの標準の場所にあり"id_rsa"ます。

私はWindows 7 x64を使用しています。

更新

NPM v3以降、GitLabおよびその他のソース（BitBucket、Gist）の組み込みサポートがあり、そこからパッケージをインストールできます。残念ながらそれは公的なものでのみ機能するので、これと正確に関連しているわけではありませんが、いくつかはそれが役に立つと思うかもしれません。

npm install gitlab:<gitlabname>/<gitlabrepo>[#<commit-ish>]

ドキュメントを確認してください：https : //docs.npmjs.com/cli/install

プライベートgitlabリポジトリに接続するには、次の方法があります

SSHを使用

git+ssh://git@git.mydomain.com:Username/Repository#{branch|tag}
git+ssh://git@git.mydomain.com/Username/Repository#{branch|tag}

HTTPSを使用

git+https://git@git.mydomain.com/Username/Repository#{branch|tag}

HTTPSとデプロイトークン

git+https://<token-name>:<token>@gitlab.com/Username/Repository#{branch|tag}

の代わりにgit://、use git+ssh://とnpmが正しく動作するはずです。

更新

コメントで@felixが言及しているように（@felixに感謝）、を使用することdeploy tokenは、のプライベートレジストリの読み取りにはるかに関連していますgitlab。この方法では、トークンが危険にさらされ、攻撃者はそのリポジトリを読み取るだけで変更を加えることができません。

展開トークンの作成

1. GitLabアカウントにログインします。
2. デプロイトークンを作成するプロジェクトに移動します。
3. [設定]> [リポジトリ]に移動します。
4. [ Expandトークンの展開]セクションをクリックします。
5. トークンの名前と、オプションで有効期限を選択します。
6. 目的のスコープを選択します。<=選択read_repository
7. [配置トークンの作成]をクリックします。
8. 安全な場所に展開トークンを保存します。ページを離れるか、ページを更新すると、再びアクセスできなくなります。

古い答え

移動して、許可を得User Settings > Access Tokensて新しいaccess tokenを作成しますread_registry。

生成されたコピー。ファイルにtoken必要package.jsonです。

次のようにpackage.json追加dependencyします：

"my-module": "git+https://Xaqron:token@gitlab.com/Xaqron/my-module"

Xaqronユーザー名とtoken生成されたトークンに置き換えます。branchとtagでURLの最後にを指定できます#{branch|tag}。

注：アクセストークンはpackage.json、このプロジェクトへのアクセス権を持つすべてのユーザーがリポジトリを読み取ることができる場所にあるため、プロジェクト自体は非公開であると思います。

質問はGitlabに関するものですが、この質問はGoogle検索で非常によくランク付けされているため、Githubで得た同様の問題を修正する方法についての詳細を次に示します。

私にとっては、URLを変更しただけでは機能しませんでした。これを修正するために必要な手順は次のとおりです。

• git+ssh://git@github.com:owner/repo.git#master
• デプロイキーを作成してリポジトリに追加する
• git configを編集して（~/.ssh/configファイルが存在しない場合は作成します）、デフォルトのsshキーの代わりにDeployKeyの使用を強制します

その後、npmインストールは単に機能しました。他のすべてのオプションとソリューションは、npmインストールの中断の結果です

ただ、この全体つまずく誰のために、私はそれがすべてでHTTPS経由で作業することができませんでした-それはレポ（例えばへの直接リンクをサポートしていないようですhttps://git.domain.com/user/somerepo.git）、またそれはサポートしていない.tar、.tar.bzまたは.zipアーカイブバージョンを。

.tar.gzアーカイブでのみ機能するようです。

完全な例（タグ付きバージョンあり）：

https://git.domain.com/user/somerepo/repository/archive.tar.gz?ref=v1.2.3

他の回答はいずれも、gitlab.comのプライベートリポジトリではうまくいきませんでした...

ただし、これは機能します。

npm i -S git+ssh://git@gitlab.com:<org>/<project>.git

プロジェクトページの "clone"入力フィールドからのgit ssh clone urlが、git+ssh://その前に追加されています。

あなたが間違っているところを私が知ることができる限り、git://プロトコルです。GitLabはクローンのHTTP（s）とSSHのみをサポートします。したがって、gitプロトコルではなく、これらのメソッドのいずれかを使用する必要があります。

私にとっては、package.jsonを以下のように設定します。

"dependencies": {
    "<module-name>": "git+http://<username>:<token>@url.git",
}

トークンは、「プロファイル設定-アクセストークン」から取得されます。

URLでハードコードされたトークンの代わりにトークンを保持する環境変数を使用したい場合は、非常に複雑でも解決策を考え出しました。GIT_ASKPASS環境変数を使用してbashスクリプトからパスワードを取得します。このスクリプトは環境変数をエコーし​​ます。特定のGIT環境変数のみを渡すnpmを克服するために、仲介者GIT_SSHとして使用します。

したがって、git_pass_env.shcontaining echo $GIT_SSHを指定すると、次のように呼び出すことができます。

GIT_SSH=<TOKEN> GIT_ASKPASS="$(pwd)/git_pass_env.sh" npm install

dockerおよびdocker-composeを使用したサンプルプロジェクトについては、 、こちらの私のリポジトリてください。

環境変数のフロー図：

Gitlabには、npmパッケージのビルド、デプロイ、ホストが可能なパッケージレジストリがあります。プライベートリポジトリを使用すると、リポジトリのコンテンツとパッケージに対するきめ細かなアクセス制御を提供できます。

NPMパッケージは、.npmrcファイルを一緒に追加することにより、プライベートGitlabリポジトリからインストールできますpackage.json。詳細はこちら。同じコードベースの異なるリポジトリに複数のデプロイトークンを使用すると、複雑になります。

Gitlabを使用すると、パッケージ.tgzファイルにHTTPSで直接アクセスしてトークンをデプロイすることができます。次のようにプロジェクトの依存関係を追加するだけです。

"@foo/bar": "https://<username>:<token>@gitlab.com/api/v4/projects/<project-id>/packages/npm/@foo/bar/-/@foo/bar-1.0.0.tgz"

@ foo / barがURLに2回存在します。@fooはプロジェクトスコープ、barはモジュール名、1.0.0はモジュール名です。プロジェクトID（8桁の数値）はGitlabプロジェクトIDで、プロジェクトページの名前の下に表示されます。モジュール名から@fooを省略することも可能です（リンクは不可）。

同じスコープと異なるデプロイトークンで複数のモジュールを使用すると、プライベートリポジトリの管理が安全になります。また、デプロイトークンはアクセス権しか持っていない可能性がありますpackage registry。つまり、エンドユーザーはリポジトリから完全なソースコードにアクセスできません。