本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
配置和使用 npm
若要npm
搭配使用 CodeCatalyst,您必須連線npm
至套件儲存庫,並提供個人存取權杖 (PAT) 以進行驗證。您可以在 CodeCatalyst 主控台中檢視連線npm
至套裝程式儲存區域的指示。
內容
使用 npm 配置 CodeCatalyst
下列指示說明如何驗證並連線npm
至 CodeCatalyst 套件儲存庫。有關 npm 的更多信息,請參閱官方的 npm 文檔
連線npm
至您的 CodeCatalyst 套裝程式儲存區域
-
開啟主 CodeCatalyst 控台,網址為 https://codecatalyst.aws/
。 -
導航到您的項目。
-
在導覽窗格中,選擇 Packages (套件)。
-
從清單中選擇您的套裝程式儲存區域。
-
選擇「Connect 至儲存庫」。
-
在配置詳細信息的 P ackage 管理器客戶端中,選擇 npm 客戶端。
選擇您的作業系統以檢視對應的組態步驟。
-
需要個人訪問令牌(PAT)來驗證 npm CodeCatalyst。如果您已經有令牌,則可以使用它。如果沒有,您可以使用以下步驟創建一個。
(可選):更新名PAT稱和到期日。
-
選擇 [建立權杖]。
-
複製並存儲PAT在安全的位置。
警告
關閉對話方塊後,您將無法PAT再次看到或複製您的。認證應該很短,以盡量減少攻擊者盜用憑證後可以使用憑證的時間長度。
-
從項目的根目錄運行以下命令,以使用您的包存儲庫配置 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 始終將身份驗證令牌傳遞給甚至對於
GET
請求,請按如下方式設置始終身份驗證配置變量。 CodeCatalystnpm 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
指令來安裝 CodeCatalyst 套件儲存庫或其上游儲存庫中的 npm 套件。
npm install
lodash
通過以下方式從 npmjs 安裝 npm 軟件包 CodeCatalyst
您可以透過儲存庫使用連線至 npmjs.com
若要從 npmjs 安裝套件
-
如果您尚未這麼做,請依照中的步驟
npm
使用 CodeCatalyst套件儲存庫進行設定使用 npm 配置 CodeCatalyst。 -
檢查您的存放庫是否已將閘道儲存庫新增為上游連線。npm-public-registry-gateway您可以按照中的指示新增上游存放庫並選擇npm-public-registry-gateway存放庫,來檢查要新增或新增哪些上游來源npm-public-registry-gateway作為上游來源。
-
使用
npm install
指令安裝套件。npm install
package_name
如需有關從上游存放庫要求套件的詳細資訊,請參閱請求具有上游存儲庫的軟件包版本。
將 npm 套件發佈到您的 CodeCatalyst 套件存放庫
完成後使用 npm 配置 CodeCatalyst,您可以執行npm
命令。
您可以使用npm publish
指令將 npm 套件發佈至 CodeCatalyst 套件儲存庫。
npm publish
如需如何建立 npm 套件的詳細資訊,請參閱在 npm 文件上建立 Node.js 模組
npm 命令支持
下列段落摘要說明 CodeCatalyst套裝程式儲存區域支援的命令,並列出不支援的特定命令。npm
支援與套件儲存庫互動的指令
本節列出npm
用npm
戶端對其設定的登錄發出一或多個要求的命令 (例如,npm
config set registry
)。這些指令已經過驗證,在針對 CodeCatalyst 套件儲存區域叫用時可以正確運作。
Command | 描述 |
---|---|
猜測套件錯誤追蹤器的位置URL,然後嘗試開啟它。 |
|
使用乾淨的石板安裝專案。 |
|
棄用套件的版本。 |
|
修改封裝發佈標籤。 |
|
猜測軟件包文檔的位置URL,然後嘗試使用 |
|
執行一組檢查,以驗證您的 npm 安裝是否可以管理您的 JavaScript 套件。 |
|
安裝套件。 |
|
使用乾淨的平板安裝項目並運行測試。別名: |
|
安裝軟件包並運行測試。運行 |
|
檢查設定的登錄,以判斷是否有任何已安裝的套件已過期。 |
|
ping 配置或給定的 npm 註冊表並驗證身份驗證。 |
|
將套件版本發佈至登錄。 |
|
猜測套件存放庫的位置URL,然後嘗試使用 |
|
顯示套件中繼資料。也可用於列印中繼資料屬性。 |
支援的用戶端命
這些命令不需要與套件儲存庫進行任何直接互動,因此 CodeCatalyst不需要任何東西來支援它們。
Command | 描述 |
---|---|
顯示 NPM |
|
構建一個包。 |
|
操作套件快取。 |
|
在所有 npm 命令中啟用選項卡完成。 |
|
更新使用者和全域 |
|
搜尋本機套件樹狀結構,並嘗試將相依性往上移動樹狀結構,以便讓多個相依套件更有效地共用這些相依性。 |
|
編輯已安裝的套件。選取目前工作目錄中的相依性,並在預設編輯器中開啟套件目錄。 |
|
瀏覽已安裝的套件。在指定的已安裝套件的目錄中產生一個子 shell。如果指定了一個命令,那麼它在子 shell 中運行,然後立即關閉。 |
|
獲取關於 npm 的幫助。 |
|
搜索 npm 幫助文檔。 |
|
建立 |
|
符號鏈接一個包目錄。 |
|
列出已安裝的套件。 |
|
從封裝建立壓縮包。 |
|
顯示首碼。除非另外指定,否則這 |
|
移除父套件相依性清單中未列出的套件。 |
|
在相符的資料夾上執行 |
|
執行套件的停止、重新啟動和啟動指令碼,以及相關的前置指令碼和後置指令碼。 |
|
將有效目 |
|
執行任意套件指令碼。 |
|
鎖定要發佈的相依性版本。 |
|
解除安裝套件。 |
不支援的命
CodeCatalyst 套件儲存區域不支援這些npm
指令。
Command | 描述 | 備註 |
---|---|---|
設定已發佈封裝的存取層級。 |
CodeCatalyst 使用與公共 npmjs 存儲庫不同的權限模型。 |
|
新增登錄使用者帳戶 |
CodeCatalyst 使用與公共 npmjs 存儲庫不同的用戶模型。 |
|
執行安全稽核。 |
CodeCatalyst 目前沒有出現安全漏洞數據。 |
|
管理 npm 掛鉤,包括添加,刪除,列出和更新。 |
CodeCatalyst 目前不支援任何變更通知機制。 |
|
驗證使用者。這是 |
CodeCatalyst 使用與公共 npmjs 存儲庫不同的身份驗證模型。如需相關資訊,請參閱 使用 npm 配置 CodeCatalyst。 |
|
登出登錄。 |
CodeCatalyst 使用與公共 npmjs 存儲庫不同的身份驗證模型。無法從 CodeCatalyst 存儲庫註銷,但是身份驗證令牌在其可配置的到期時間後過期。默認令牌持續時間為 12 小時。 |
|
管理套件擁有者。 |
CodeCatalyst 使用與公共 npmjs 存儲庫不同的權限模型。 |
|
變更登錄設定檔的設定。 |
CodeCatalyst 使用與公共 npmjs 存儲庫不同的用戶模型。 |
|
在登錄中搜尋符合搜尋字詞的套件。 |
CodeCatalyst 不支援該 |
|
標記您最喜歡的軟件包。 |
CodeCatalyst 目前不支持任何收藏夾機制。 |
|
檢視標記為我的最愛的套件。 |
CodeCatalyst 目前不支持任何收藏夾機制。 |
|
管理團隊和團隊成員資格。 |
CodeCatalyst 使用與公共 npmjs 存放庫不同的使用者和群組成員資格模型。 |
|
t |
管理您的身份驗證令牌。 |
CodeCatalyst 使用不同的模型來獲取身份驗證令牌。如需相關資訊,請參閱 使用 npm 配置 CodeCatalyst。 |
從登錄中移除套件。 |
CodeCatalyst 不支持使用 npm 客戶端從存儲庫中刪除軟件包版本。您可以在主控台中刪除套件。 |
|
顯示 npm 使用者名稱。 |
CodeCatalyst 使用與公共 npmjs 存儲庫不同的用戶模型。 |