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。 如需詳細資訊,請參閱 來源取代 。 如果您尚未設定摘要,請按照以下步驟建立摘要:
登入您的 Azure DevOps 組織,然後流覽至您的專案。
選取 [工件],然後選取 [建立動態消息]。
請為您的摘要來源輸入 名稱,並設定其 可見性。 如果此摘要來源是用於使用來自 crates.io 的 crate,請勾選 包含來自常見公用來源的套件 選項。 如果此套件來源是用來發佈私有套件,請將該選項保留為未勾選狀態。 最後為您的摘要選擇合適的 範圍 。 建議將 Feed 的範圍限定於特定專案,而非整個組織。
完成後,選擇 建立。
恢復套件
若要還原您的相依性,請確認已在 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" }
如果您尚未使用摘要進行驗證,請依照 專案設定 中的步驟設定設定檔、設定認證提供者,然後登入登錄。
在專案目錄中執行下列命令,以建置專案,並從摘要還原相依性:
cargo build
下載的 crate 會快取在您本機的 ~/.cargo/registry/cache/<registry-hash>/ 中,其中 registry-hash 是根據您的摘要來源 URL 產生的唯一識別碼。