設定和使用 npm - Amazon CodeCatalyst
使用 設定 npm CodeCatalyst從套件儲存庫安裝 npm CodeCatalyst 套件從 npmjs 到 安裝 npm 套件 CodeCatalyst將 npm 套件發佈至 CodeCatalyst 套件儲存庫npm 命令支援

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

設定和使用 npm

若要npm與 搭配使用 CodeCatalyst，您必須npm連線至套件儲存庫並提供個人存取權杖 （PAT） 以進行身分驗證。您可以在 CodeCatalyst 主控台中檢視npm連線至套件儲存庫的指示。

使用 設定 npm CodeCatalyst

下列指示說明如何驗證和npm連線至 CodeCatalyst 套件儲存庫。如需 npm 的詳細資訊，請參閱官方 npm 文件。

若要npm連線至 CodeCatalyst 套件儲存庫

  1. 在 https：//https://codecatalyst.aws/ 開啟 CodeCatalyst 主控台。

  2. 導覽至您的專案。

  3. 在導覽窗格中，選擇 Packages (套件)。

  4. 從清單中選擇套件儲存庫。

  5. 選擇連線至儲存庫 。

  6. 在組態詳細資訊 的套件管理員用戶端 中，選擇 npm 用戶端 。

  7. 選擇您的作業系統以檢視對應的組態步驟。

  8. 需要個人存取權杖 （PAT） 才能透過 來驗證 npm CodeCatalyst。如果您已經有權杖，則可以使用它。如果沒有，您可以使用下列步驟建立一個。

    1. （選用）：更新PAT名稱 和 過期日期 。

    2. 選擇建立權杖 。

    3. 將 複製並存放在PAT安全的位置。

      警告

      關閉對話方塊後，您將無法PAT再次查看或複製您的 。憑證應該短暫運作，以盡量減少攻擊者在盜用憑證之後可以使用憑證的時間長度。

  9. 從專案的根目錄執行下列命令，以使用套件儲存庫設定 npm。這些命令將執行下列動作：

    • 如果您的專案沒有專案層級.npmrc檔案，請建立專案層級檔案。

    • 將套件儲存庫端點資訊新增至專案層級.npmrc檔案。

    • 將憑證 （PAT） 新增至使用者層級.npmrc檔案。

    取代下列值。

    注意

    如果您從主控台指示複製 ，則下列命令中的值會為您更新，不需要變更。

    • Replace (取代) username 您的 CodeCatalyst 使用者名稱。

    • Replace (取代) PAT 您的 CodeCatalyst PAT。

    • Replace (取代) space_name 您的 CodeCatalyst 空間名稱。

    • Replace (取代) proj_name 您的 CodeCatalyst 專案名稱。

    • Replace (取代) repo_name 使用 CodeCatalyst 套件儲存庫名稱。

    npm set registry=https://packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/ --location project
npm set //packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/:_authToken=username:PAT

    對於 npm 6 或更低：若要讓 npm 一律將驗證權杖傳遞至 CodeCatalyst，即使對於GET請求，也請依照下列npm config set方式使用 設定永遠驗證組態變數。

    npm set //packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/:always-auth=true --location project

從套件儲存庫安裝 npm CodeCatalyst 套件

依照 中的步驟將 npm 連接至儲存庫後使用 設定 npm CodeCatalyst，您可以在儲存庫上執行npm命令。

您可以使用 npm install命令，在套件儲存庫或其上游儲存庫中安裝 npm CodeCatalyst 套件。

npm install lodash

從 npmjs 到 安裝 npm 套件 CodeCatalyst

您可以透過儲存 CodeCatalyst 庫從 npmjs.com 安裝 npm 套件，方法是使用上游連線設定儲存庫，以連接至 npmjs.com、 的閘道儲存庫npm-public-registry-gateway。從 npmjs 安裝的套件會擷取並儲存在閘道儲存庫，以及最遠的下游套件儲存庫中。

從 npmjs 安裝套件

  1. 如果您尚未這麼做，請依照 中的步驟npm，使用 CodeCatalyst套件儲存庫進行設定使用 設定 npm CodeCatalyst。

  2. 檢查您的儲存庫是否已新增閘道儲存庫 npm-public-registry-gateway作為上游連線。您可以依照 中的說明新增上游儲存庫並選擇npm-public-registry-gateway儲存庫，來檢查要新增哪些上游來源，或新增哪些上游來源npm-public-registry-gateway做為上游來源。

  3. 使用 npm install命令安裝套件。

    npm install package_name

如需從上游儲存庫請求套件的詳細資訊，請參閱 使用上游儲存庫請求套件版本。

將 npm 套件發佈至 CodeCatalyst 套件儲存庫

完成 後使用 設定 npm CodeCatalyst，您可以執行npm命令。

您可以使用 npm publish命令將 npm 套件發佈至 CodeCatalyst 套件儲存庫。

npm publish

如需如何建立 npm 套件的資訊，請參閱在 npm 文件上建立 Node.js 模組。

npm 命令支援

除了列出不支援的特定npm命令 CodeCatalyst之外，以下各節還摘要了套件儲存庫支援的命令。

與套件儲存庫互動的支援命令

本節列出npm命令，其中npm用戶端會向設定其登錄檔提出一或多個請求 （例如 npm config set registry）。已驗證這些命令在調用 CodeCatalyst 套件儲存庫時可正常運作。

Command 描述

錯誤

猜測套件的錯誤追蹤器 的位置URL，然後嘗試開啟它。

ci

安裝具有乾淨板塊的專案。

棄用

取代套件的版本。

dist-tag

修改套件分發標籤。

文件

猜測套件文件 的位置URL，然後使用--browser組態參數嘗試開啟。

醫生

執行一組檢查，以驗證您的 npm 安裝是否可以管理 JavaScript 套件。

安裝

安裝套件。

install-ci-test

安裝具有乾淨板塊的專案並執行測試。別名：npm cit。此命令會執行 npm ci，然後立即執行 npm test。

安裝測試

安裝套件並執行測試。執行 npm install，然後立即執行 npm test。

過時

檢查設定的登錄檔，以確定任何已安裝的套件是否已過時。

ping

Ping 已設定或指定的 npm 登錄檔，並驗證身分驗證。

發佈

將套件版本發佈至登錄檔。

update

猜測套件儲存庫 的位置URL，然後使用--browser組態參數嘗試開啟。

檢視

顯示套件中繼資料。也可用於列印中繼資料屬性。

支援的用戶端命令

這些命令不需要與套件儲存庫進行任何直接互動，因此 CodeCatalyst不需要任何東西來支援它們。

Command 描述

bin （舊版）

顯示 npm bin目錄。

建置

建置套件。

快取

操作套件快取。

完成

在所有 npm 命令中啟用索引標籤完成。

組態

更新使用者和全域npmrc檔案的內容。

去重複資料

搜尋本機套件樹狀結構，並嘗試透過將相依性進一步移至樹狀結構來簡化結構，讓多個相依套件更有效地共用這些屬性。

編輯

編輯已安裝的套件。選取目前工作目錄中的相依性，並在預設編輯器中開啟套件目錄。

探索

瀏覽已安裝的套件。在指定已安裝套件的目錄中插入子殼。如果指定命令，則會在子殼中執行，然後立即關閉。

help

取得 npm 的說明。

help-search

搜尋 npm 說明文件。

初始化

建立package.json檔案。

連結

Symlink 套件目錄。

ls

列出已安裝的套件。

套件

從套件建立 tarball。

prefix

顯示字首。除非-g另有指定，否則這是包含package.json檔案的最接近的父目錄。

黑棗

移除未列在父套件相依性清單上的套件。

重建

在相符的資料夾上執行 npm build命令。

重新啟動

執行套件的停止、重新啟動和啟動指令碼，以及相關聯的前綴和後綴。

根

列印要標準化的有效node_modules目錄。

run-script

執行任意套件指令碼。

收縮包裝

鎖定用於發佈的相依性版本。

解除安裝

解除安裝套件。

不支援的命令

CodeCatalyst 套件儲存庫不支援這些npm命令。

Command 描述 備註

存取

設定已發佈套件的存取層級。

CodeCatalyst 使用與公有 npmjs 儲存庫不同的許可模型。

adduser

新增登錄使用者帳戶

CodeCatalyst 使用與公有 npmjs 儲存庫不同的使用者模型。

稽核

執行安全稽核。

CodeCatalyst 目前不會發佈安全漏洞資料。

掛鉤

管理 npm 掛鉤，包括新增、移除、列出和更新。

CodeCatalyst 目前不支援任何變更通知機制。

登入

驗證使用者。這是 npm adduser 的別名。

CodeCatalyst 使用與公有 npmjs 儲存庫不同的身分驗證模型。如需相關資訊，請參閱 使用 設定 npm CodeCatalyst。

登出

登出登錄檔。

CodeCatalyst 使用與公有 npmjs 儲存庫不同的身分驗證模型。無法從 CodeCatalyst 儲存庫登出，但身分驗證權杖會在其可設定的過期時間後過期。預設權杖持續時間為 12 小時。

擁有者

管理套件擁有者。

CodeCatalyst 使用與公有 npmjs 儲存庫不同的許可模型。

profile

變更登錄檔設定檔上的設定。

CodeCatalyst 使用與公有 npmjs 儲存庫不同的使用者模型。

search

搜尋登錄檔，尋找符合搜尋詞彙的套件。

CodeCatalyst 不支援 search命令。

星狀

標記您最愛的套件。

CodeCatalyst 目前不支援任何我的最愛機制。

星數

檢視標記為我的最愛之套件。

CodeCatalyst 目前不支援任何我的最愛機制。

團隊

管理團隊和團隊成員資格。

CodeCatalyst 使用與公有 npmjs 儲存庫不同的使用者和群組成員資格模型。

token

管理您的身分驗證字符。

CodeCatalyst 使用不同的模型來取得身分驗證權杖。如需相關資訊，請參閱 使用 設定 npm CodeCatalyst。

取消發佈

從登錄檔中移除套件。

CodeCatalyst 不支援使用 npm 用戶端從儲存庫移除套件版本。您可以在主控台中刪除套件。

whoami

顯示 npm 使用者名稱。

CodeCatalyst 使用與公有 npmjs 儲存庫不同的使用者模型。