Partager via

Publier et installer des packages Python (CLI)

  • Article

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Azure Artifacts permet aux développeurs de gérer leurs dépendances à partir d’un seul flux. Vous pouvez publier et installer des packages Python vers et à partir de votre flux à l’aide de la ligne de commande. Dans cet article, vous apprendrez comment :

  • Créez un flux.
  • Publiez des packages Python dans un flux.
  • Installez des packages Python à partir d’un flux.

Prérequis

Créer un flux

  1. Connectez-vous à votre organisation Azure DevOps et accédez à votre projet.

  2. Sélectionnez Artifacts, puis sélectionnez Créer un flux.

  3. Fournissez un nom pour votre flux, choisissez l’option Visibilité qui définit qui peut afficher vos packages, cochez Inclure des packages à partir de sources publiques courantes si vous souhaitez inclure des packages à partir de sources telles que nuget.org ou npmjs.com, et pour étendue, déterminez si le flux doit être limité à votre projet ou à l’ensemble de l’organisation.

  4. Sélectionnez Créer lorsque vous avez terminé.

    Capture d’écran montrant les sélections pour la création d’un flux dans Azure DevOps Services.

  1. Connectez-vous à votre serveur Azure DevOps, puis accédez à votre projet.

  2. Sélectionnez Artifacts, puis sélectionnez Créer un flux.

  3. Fournissez un nom pour votre flux, choisissez l’option Visibilité qui définit qui peut afficher vos packages, cochez Inclure des packages à partir de sources publiques courantes si vous souhaitez inclure des packages à partir de sources telles que nuget.org ou npmjs.com, et pour étendue, déterminez si le flux doit être limité à votre projet ou à l’ensemble de l’organisation.

  1. Sélectionnez Créer lorsque vous avez terminé.

    Capture d’écran montrant les sélections permettant de créer un flux dans Azure DevOps 2022.

  1. Sélectionnez Créer lorsque vous avez terminé.

    Capture d’écran montrant les sélections pour la création d’un flux dans Azure DevOps 2020.

  1. Connectez-vous à votre serveur Azure DevOps, puis accédez à votre projet.

  2. Sélectionnez Artefacts, puis nouveau flux.

  3. Pour Nom, entrez un nom descriptif pour votre flux.

    Pour visibilité, sélectionnez une option pour indiquer qui peut afficher les packages dans le flux.

    Si vous souhaitez inclure des packages à partir de sources publiques, sélectionnez l’option Utiliser des packages à partir de sources publiques via cette option de flux .

  4. Sélectionnez Créer lorsque vous avez terminé.

    Capture d’écran montrant les sélections pour la création d’un flux dans Azure DevOps 2019.

Remarque

Par défaut, les flux nouvellement créés ont la valeur du service de build de leur projet définie sur Feed and Upstream Reader (Collaborateur).

Publier des packages

  1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

  2. Sélectionnez Artefacts, puis connectez-vous au flux.

  3. Sélectionnez twine dans la zone de navigation de gauche. S’il s’agit de votre première utilisation d’Azure Artifacts avec twine, veillez à installer les prérequis en sélectionnant Obtenir les outils et en suivant les étapes fournies.

  4. Ajoutez un fichier .pypirc à votre répertoire de base et collez-y l’extrait de code fourni. Votre fichier doit ressembler à l’extrait de code suivant. Si vous disposez déjà d’un fichier .pypirc qui contient des informations d’identification pour l’index PyPI public, nous vous recommandons de supprimer la section [pypi] pour éviter de publier accidentellement des packages privés sur PyPI.

    [distutils]
Index-servers =
FEED_NAME

[FEED_NAME]
Repository = https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/upload/

  5. Exécutez la commande suivante dans votre répertoire de projet pour créer des distributions source et de roue.

    python setup.py sdist bdist_wheel

  6. Exécutez la commande suivante pour publier votre package. Utilisez l’indicateur -r REPOSITORY_NAME pour vous assurer que vos packages privés ne sont pas publiés accidentellement sur PyPI.

    twine upload -r REPOSITORY_NAME dist/*

Important

Vous devez disposer de twine 1.13.0 ou version ultérieure pour utiliser le keyring d’artefacts. Pour plus d’informations, consultez les conditions d’utilisation .

Installer des packages

  1. Connectez-vous à votre organisation Azure DevOps puis accédez à votre projet.

  2. Sélectionnez Artefacts, puis connectez-vous au flux.

  3. Sélectionnez pip dans la zone de navigation de gauche. S’il s’agit de votre première utilisation d’Azure Artifacts avec pip, veillez à installer les prérequis en sélectionnant Obtenir les outils et en suivant les étapes fournies.

  4. Créez un environnement virtuel.

  5. Ajoutez un fichier pip.ini (Windows) ou pip.conf (Mac/Linux) à votre virtualenv et collez l’extrait de code fourni dans celui-ci. Votre fichier doit ressembler à l’extrait de code suivant :

    [global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/simple/

  6. Exécutez cette commande dans le répertoire de votre projet pour installer vos packages :

    pip install

Important

Vous devez disposer de pip 19.2 ou version ultérieure pour utiliser le keyring d’artefacts. Pour plus d’informations, consultez les conditions d’utilisation .

Contenu connexe