共用方式為


開始使用 Azure Artifacts 中的 Cargo 套件

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

您可以使用 Azure Artifacts 來發佈和下載 Cargo 套件,以饋送和公用註冊中心。 本文將指導您設定專案,並將您的 Cargo 套件發佈到 Azure Artifacts 提要中。

必要條件

  • Azure DevOps 組織和專案。 建立組織專案,如果您尚未這樣做。

  • 下載並安裝 rustup

建立訂閱源

如果您已經有可用於 Cargo 的現有 Azure Artifacts 存放庫,您可以跳至下一節。

注意

Azure Artifacts 建議使用不同的資料源來取用 crates.io 的軟件包,並使用專門的資料源來發佈內部軟件包。

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

  2. 選取 工件,然後選取 建立信息源

  3. 為您的摘要指定名稱,並指定其可見度。 如果您想包含來自公用登錄的套件,請勾選 [上游來源] 複選框,然後選取供應來源的範圍。

  4. 完成後,選取 [建立]

連線至資訊源

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

  2. 選取構件,然後從下拉選單中選取您的訂閱源。

  3. 選取 連線至資料供應,然後從工具選取窗格中選取 貨物

  4. 請參照「連接至訂閱源」頁面上的「項目設定」指示。

重要

Azure Artifacts 中的 Cargo 支援需要 Rust 1.74 版或更新版本,其中包含對 'registry-auth' 功能的支援。 若要更新 Rust 版本,請執行 rustup update

重要

Cargo 目前處於搶先體驗階段,可能需要啟用不穩定功能並使用夜間工具鏈。 若要啟用 registry-auth,請將下列內容新增至 .cargo/config.toml

[unstable]
registry-auth = true

若要使用夜間工具鏈,請執行下列命令:

rustup default nightly

發佈套件

若要發佈您的 Cargo 套件,請在專案目錄中執行下列命令:

cargo publish

如果您遇到 GLib-GObject-CRITICAL - libsecret-CRITICAL 錯誤,請確定您遵循下列步驟:

  1. 確認已安裝 libsecret

    sudo apt update && sudo apt install libsecret-1-0
    
  2. 請確定 gnome-keyring 正在執行:

    gnome-keyring-daemon --start --components=secrets
    
  3. 將 Rust 更新為最新的穩定版本,並將穩定設定為預設工具鏈:

    rustup update  
    rustup default stable  
    
  4. 您也應該使用詳細資訊記錄執行貨物發佈,以取得更多詳細數據:

    RUST_LOG=debug cargo publish --registry <REGISTRY_NAME>