Azure Artifactsのアクセス設定

Azure DevOpsでホストされているプライベートnpmパッケージにアクセスするための設定手順です。

概要

プロジェクトで使用しているプライベートパッケージ（例：nemesis-core）にアクセスするため、ローカルにアクセストークンを設定します。

設定手順

1. アクセストークンの作成

1. Azure DevOps Personal Access Tokensにアクセス
2. 「New Token」をクリック
3. 以下の設定でトークンを作成：
   • Name: 任意の名前（例：npm-access）
   • Expiration: 必要な期間を設定
   • Scopes: 「Packaging」の「Read & write」を選択
4. トークンをコピー（この画面を閉じると二度と表示されません）

2. トークンのBase64エンコード

# トークンをBase64エンコード
echo -n "your-access-token" | base64

3. npmrc設定ファイルの作成

.npmrcファイルを編集：

code ~/.npmrc

以下の内容を追加（組織名やBase64エンコードしたトークンは適宜置き換え）：

; begin auth token
//pkgs.dev.azure.com/[organization]/[project]/_packaging/[feed]/npm/registry/:username=[organization]
//pkgs.dev.azure.com/[organization]/[project]/_packaging/[feed]/npm/registry/:_password=[BASE64_ENCODED_TOKEN]
//pkgs.dev.azure.com/[organization]/[project]/_packaging/[feed]/npm/registry/:email=your.email@example.com
//pkgs.dev.azure.com/[organization]/[project]/_packaging/[feed]/npm/:username=[organization]
//pkgs.dev.azure.com/[organization]/[project]/_packaging/[feed]/npm/:_password=[BASE64_ENCODED_TOKEN]
//pkgs.dev.azure.com/[organization]/[project]/_packaging/[feed]/npm/:email=your.email@example.com

4. 設定の確認

対象プロジェクトで以下のコマンドを実行：

# npm の場合
npm install

# yarn の場合
yarn install

プロジェクト固有の設定

特定のプロジェクトのみで使用する場合は、プロジェクトルートの.npmrcに設定を記載します。

@[scope]:registry=https://pkgs.dev.azure.com/[organization]/[project]/_packaging/[feed]/npm/registry/
always-auth=true

セキュリティ上の注意

1. アクセストークンは機密情報です

   • Gitリポジトリにコミットしない
   • 必要最小限の権限のみ付与
   • 定期的に更新

2. より安全な管理方法

   • 環境変数を使用
   • CI/CDのシークレット機能を活用
   • Azure DevOpsのService Connectionを使用

トラブルシューティング

401 Unauthorized エラー

1. トークンの有効期限を確認
2. Base64エンコードが正しいか確認
3. スコープに必要な権限があるか確認

パッケージが見つからない

1. フィードのURLが正しいか確認
2. スコープ名が正しいか確認
3. パッケージが実際にフィードに存在するか確認

参考リンク

• Azure Artifacts Documentation
• npm Registry Authentication