Поделиться через

Использование пакетов из Crates.io

  • Статья

Azure DevOps Services | Azure DevOps Server 2022

Источники вышестоящих источников артефактов Azure позволяют разработчикам использовать пакеты из общедоступных реестров, таких как Crates.io и nuget.org. В этой статье описано, как настроить проект и использовать командную строку для использования crates из Crates.io.

В этой статье описано, как:

  • Создание веб-канала артефактов Azure
  • Подключение к веб-каналу
  • Использование ящиков из вышестоящего потока

Необходимые компоненты

Создание веб-канала

Azure Artifacts рекомендует использовать выделенный веб-канал для использования контейнеров из crates.io и отдельного канала исключительно для публикации внутренних ящиков.

  1. Войдите в организацию Azure DevOps и перейдите к проекту.

  2. Выберите артефакты и нажмите кнопку "Создать веб-канал".

  3. Введите имя веб-канала, определите его видимость и выберите область. Установите флажок " Вышестоящий источник" , чтобы включить пакеты из общедоступных реестров.

  4. После завершения работы выберите Создать.

    Снимок экрана, на котором показано, как создать веб-канал для вышестоящего потока грузов.

Подключение к веб-каналу

  1. Войдите в организацию Azure DevOps и перейдите к проекту.

  2. Выберите артефакты и выберите веб-канал в раскрывающемся меню.

  3. Выберите "Подключиться к каналу" и выберите "Cargo " в области навигации слева.

  4. Если вы впервые используете Cargo с Azure Artifacts, убедитесь, что вы установили rustup.

  5. Добавьте предоставленный фрагмент из раздела установки Project в файл .cargo/config.toml в исходном репозитории:

    • Веб-канал с областью действия проекта:

      [registries]
<FEED_NAME> = { index = "sparse+https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/Cargo/index/" }

[source.crates-io]
replace-with = "<FEED_NAME>"

    • Веб-канал с областью действия организации:

      [registries]
<FEED_NAME> = { index = "sparse+https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/Cargo/index/" }

[source.crates-io]
replace-with = "<FEED_NAME>"

  1. Войдите в коллекцию Azure DevOps и перейдите к проекту.

  2. Выберите артефакты и выберите веб-канал в раскрывающемся меню.

  3. Выберите "Подключиться к каналу" и выберите "Cargo " в области навигации слева.

  4. Если вы впервые используете Cargo с Azure Artifacts, убедитесь, что вы установили rustup.

  5. Добавьте предоставленный фрагмент из раздела установки Project в файл .cargo/config.toml в исходном репозитории:

    • Веб-канал с областью действия проекта:

      [registries]
<FEED_NAME> = { index = "sparse+https://pkgs.dev.azure.com/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/Cargo/index/" }

[source.crates-io]
replace-with = "<FEED_NAME>"

    • Веб-канал с областью действия коллекции:

      [registries]
<FEED_NAME> = { index = "sparse+https://pkgs.dev.azure.com/<COLLECTION_NAME>/_packaging/<FEED_NAME>/Cargo/index/" }

[source.crates-io]
replace-with = "<FEED_NAME>"

Настройка поставщика учетных данных

Чтобы использовать Cargo с артефактами Azure, необходимо настроить поставщика учетных данных. Указанные параметры настраивают вспомогательный компонент учетных данных по умолчанию для текущего пользователя:

Вставьте следующий фрагмент кода в файл %USERPROFILE%.cargo\config.toml:

[registry]
global-credential-providers = ["cargo:token", "cargo:wincred"]

Вход в реестр

  1. Создайте личный маркер доступа с областями чтения и записи для>проверки подлинности в веб-канале.

  2. Выполните следующую команду, чтобы войти в реестр. Замените заполнитель именем веб-канала и вставьте личный маркер доступа, созданный на предыдущем шаге при появлении запроса:

    "Basic " + [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("PAT:" + (Read-Host -MaskInput "Enter PAT"))) | cargo login --registry <FEED_NAME>

Сохранение пакетов из Crates.io

Примечание.

Чтобы сохранить пакеты из вышестоящих версий, необходимо иметь роль "Канал" и "Средство чтения выше" ("Совместная работа") или более поздней версии. Дополнительные сведения см. в разделе "Управление разрешениями ".

Теперь, когда мы настроили проект, настроили поставщика учетных данных и вошли в наш веб-канал, мы можем начать использовать пакеты из вышестоящего канала. Azure Artifacts сохраняет копию любого пакета, который вы устанавливаете из вышестоящего канала.

В этом примере используется serde crate, платформа сериализации и десериализации:

  1. Выполните следующую команду в каталоге проекта, чтобы добавить к файлу cargo.toml запись:

    cargo add serde

  2. Выполните следующую команду, чтобы создать проект и использовать ваш ящик:

    cargo build

После установки пакета копия будет сохранена в веб-канале. Перейдите к веб-каналу, чтобы проверить его присутствие. Пакет должен быть доступен в веб-канале, как показано ниже:

Снимок экрана, на котором показана скорость *serde*, потребляемая из вышестоящего потока.