Axe DevTools Linter Connector を npm パッケージとしてインストールする方法
Agora をセットアップして Axe DevTools Linter Connector を npm パッケージとして簡単にダウンロードしインストールするためのガイド
この記事では、Axe DevTools ConnectorをnpmパッケージレジストリとしてAgoraを使用してダウンロードおよびインストールする方法について説明します。これにより、Node.jsやnpmの提供するインフラストラクチャを利用して、Axe DevTools Linter Connectorのバイナリをダウンロード、バージョン管理、更新することができ、ダウンロードページから直接Connectorをダウンロードする際に必要な手動操作を避けることができます。
Agora とは？
AgoraはDequeのリポジトリであり（JFrogによってホスティングされているアーティファクトファクトリーまたはアーティファクトリ）で、バイナリアーティファクト（パッケージ、ライブラリ、実行可能ファイル）を安全に保存し、アクセスにはアカウントが必要です。AgoraにはAxe Linter Connector（npmパッケージおよび手動でダウンロード可能な実行ファイルの両方）がホスティングされています。
この記事の手順を実行するにはAgoraアカウントが必要です。作成するには、直接Dequeの担当者に連絡するか、わたしたちのサポートデスクを通じて問い合わせるか、helpdesk@deque.comへメールを送ってください。よろこんでお手伝いいたします。
Agora アイデンティティ トークンを作成する
最初のステップは、npm があなたの Agora セッションを認証するために使用するアイデンティティ トークンを作成することです。Agora のアイデンティティ トークンは1年で期限切れになるため、毎年再作成する必要があります。
- アイデンティティトークンを取得するためにAgoraのプロフィールページを訪れてください。（Agoraにログインしていない場合、ログイン後にプロフィールページではなく別のランディングページにリダイレクトされることがあります。ログイン後に同じリンクをもう一度クリックするとプロフィールページにアクセスできます。または右上隅のヘルプボタンの右側のボタンをクリックし、プロフィールを編集をクリックしてください。）
- アイデンティティ トークンを生成をクリックします。
- 今後トークンを特定するのに役立つ説明を追加してください。（オプション）
- コピーアイコンをクリックしてアイデンティティ トークンをクリップボードにコピーします。（アイデンティティ トークンは再取得できないため、パスワード管理アプリに保存することをお勧めします。）
.npmrcの設定
Agoraアイデンティティトークンを取得したので、Connectorのインストールにnpmインフラストラクチャを使用するために.npmrcファイルを設定できます。
- Agora パッケージへのアクセス設定サイトを訪れて、
.npmrcファイルに貼り付けるための設定を作成します。このページの情報は保存されないし、送信もされませんので、注意してください。 - 登録されているメールアドレスを入力してください（Agora サイトで登録されているものである必要があります）。
- アイデンティティ トークンを対応するテキストボックスに貼り付けます。
- 設定を作成するために設定を生成をクリックし、コピーアイコンをクリックします。
- コピーした行を
.npmrcファイルに貼り付けます。ファイルへのパスはLinux、macOS、およびWindowsのサイト上で指定されています。
これらの手順を完了した後、Axe DevTools Linter Connector の npm パッケージを使用できます。
.npmrcの例
次の例は、あなたの.npmrc設定に追加する必要がある行です。
@axe-devtools:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth="am9obmRvZUBleGFtcGxlLmNvbTpUaGlzIGlzbid0IGEgdmFsaWQgaWRlbnRpdHkgdG9rZW4K"
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=johndoe@example.com
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true_authに含まれる値は、<email>:<identity-token>のBase64エンコードです。
email:identity-tokenのBase64エンコードされた値を使用する必要がある_authの代わりに、あなたのアイデンティティトークンと共に_authTokenを使用できます。例えば：
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_authToken="VGhpcyBpc24ndCBhIHZhbGlkIGlkZW50aXR5IHRva2VuCg=="インストールと使用
最新バージョンのAxe DevTools Connectorは、次のコマンドでインストールできます:
npm install @axe-devtools/axe-linter-connector -gこのコマンドはConnectorをグローバルにインストールします。--versionオプションを使用してインストールをチェックします：
axe-linter-connector --version次のステップ
- Axe Linter Connectorのドキュメントを参照してください。
- (外部JFrogドキュメント) npmクライアントをArtifactoryに接続するで
.npmrcを手動で設定する方法について詳細に説明しています。