還原貨運套件 (CLI)

Azure Artifacts 可讓開發人員在摘要中裝載各種套件類型,無論是直接發佈還是從上游來源儲存。 本指南可協助您設定專案、使用 Azure Artifacts 摘要進行驗證,以及使用命令列直接從摘要還原 Cargo 套件。

先決條件

產品 要求
Azure DevOps - Azure DevOps 組織。
- Azure DevOps 項目。
- 下載並安裝 rustup。 您需要 Cargo 1.74.0 版或更高版本。

建立訂閱源

若要透過 Azure Artifacts 取用及發佈 Rust crates,建議使用兩個不同的 Feed:一個專門用來取用來自 crates.io 的 crates,另一個則用來發佈您的內部 crates。 如需詳細資訊,請參閱 來源取代 。 如果您尚未設定摘要,請按照以下步驟建立摘要:

  1. 登入您的 Azure DevOps 組織,然後流覽至您的專案。

  2. 選取 [工件],然後選取 [建立動態消息]。

  3. 請為您的摘要來源輸入 名稱,並設定其 可見性。 如果此摘要來源是用於使用來自 crates.io 的 crate,請勾選 包含來自常見公用來源的套件 選項。 如果此套件來源是用來發佈私有套件,請將該選項保留為未勾選狀態。 最後為您的摘要選擇合適的 範圍 。 建議將 Feed 的範圍限定於特定專案,而非整個組織。

  4. 完成後,選擇 建立。

    展示如何在 Azure Artifacts 中建立新訂閱源的截圖。

恢復套件

若要還原您的相依性,請確認已在 Cargo.toml 的 [dependencies] 下方列出您的相依性。 如果您使用 replace-with 組態透過上游摘要參照來自 crates.io 的 crate,請如下指定它們:

[dependencies]
CRATE_NAME = "VERSION_NUMBER"

如果您要參考私人 Azure Artifacts 摘要來源中的 crate,則必須明確指定登錄來源:

[dependencies]
CRATE_NAME = { version = "VERSION_NUMBER", registry = "FEED_NAME" }
  1. 如果您尚未使用摘要進行驗證,請依照 專案設定 中的步驟設定設定檔、設定認證提供者,然後登入登錄。

  2. 在專案目錄中執行下列命令,以建置專案,並從摘要還原相依性:

    cargo build
    

下載的 crate 會快取在您本機的 ~/.cargo/registry/cache/<registry-hash>/ 中,其中 registry-hash 是根據您的摘要來源 URL 產生的唯一識別碼。

截圖顯示 cargo fetch 指令的結果。