Compartir vía


Publicación e instalación de paquetes de Python (CLI)

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

Azure Artifacts permite a los desarrolladores administrar sus dependencias desde una sola fuente. Puede publicar e instalar paquetes de Python en y desde la fuente mediante la línea de comandos. En este artículo aprenderá a:

  • Cree una nueva fuente.
  • Publique paquetes de Python en una fuente.
  • Instale paquetes de Python desde una fuente.

Requisitos previos

Crear feed

  1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

  2. Seleccione Artefactos y, a continuación, Crear feed.

  3. Proporcione un nombre para la fuente, elija la opción Visibilidad que define quién puede ver los paquetes, active Incluir paquetes de orígenes públicos comunes si desea incluir paquetes de orígenes como nuget.org o npmjs.com, y para Ámbito, decida si la fuente debe tener ámbito en el proyecto o en toda la organización.

  4. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps Services.

  1. Inicie sesión en el servidor de Azure DevOps y vaya al proyecto.

  2. Seleccione Artefactos y, a continuación, Crear feed.

  3. Proporcione un nombre para la fuente, elija la opción Visibilidad que define quién puede ver los paquetes, active Incluir paquetes de orígenes públicos comunes si desea incluir paquetes de orígenes como nuget.org o npmjs.com, y para Ámbito, decida si la fuente debe tener ámbito en el proyecto o en toda la organización.

  1. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps 2022.

  1. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps 2020.

  1. Inicie sesión en el servidor de Azure DevOps y vaya al proyecto.

  2. Seleccione Artefactos y, a continuación, seleccione Nueva fuente.

  3. En Nombre, escriba un nombre descriptivo para la fuente.

    En Visibilidad, seleccione una opción para indicar quién puede ver los paquetes dentro de la fuente.

    Si desea incluir paquetes de orígenes públicos, seleccione la opción Usar paquetes de orígenes públicos a través de esta fuente .

  4. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps 2019.

Nota:

De forma predeterminada, las fuentes recién creadas tienen el valor del servicio de compilación del proyecto establecido en Fuente y Lector ascendente (Colaborador).

Publicar paquetes

  1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

  2. Seleccione Artefactos y, a continuación, seleccione Conectar a la fuente.

  3. Seleccione twine en el área de navegación izquierda. Si esta es la primera vez que usa Azure Artifacts con twine, asegúrese de instalar los requisitos previos seleccionando Obtener las herramientas y siguiendo los pasos proporcionados.

  4. Agregue un archivo .pypirc al directorio principal y pegue el fragmento de código proporcionado en él. El archivo debe tener un aspecto similar al siguiente fragmento de código. Si ya tiene un .pypirc que contiene credenciales para el índice de PyPI público, se recomienda quitar la sección [pypi] para evitar la publicación accidental de paquetes privados en PyPI.

    [distutils]
    Index-servers =
    FEED_NAME
    
    [FEED_NAME]
    Repository = https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/upload/
    
  5. Ejecute el siguiente comando en el directorio del proyecto para crear distribuciones de origen y ruedas.

    python setup.py sdist bdist_wheel
    
  6. Ejecute el siguiente comando para publicar el paquete. Use la marca -r REPOSITORY_NAME para asegurarse de que los paquetes privados no se publican accidentalmente en PyPI.

    twine upload -r REPOSITORY_NAME dist/*
    

Importante

Debe tener twine 1.13.0 o superior para usar artefactos y llaves. Consulte Requisitos de uso para obtener más detalles.

Instalar paquetes

  1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

  2. Seleccione Artefactos y, a continuación, seleccione Conectar a la fuente.

  3. Seleccione pip en el área de navegación izquierda. Si es la primera vez que usa Azure Artifacts con pip, asegúrese de instalar los requisitos previos seleccionando Obtener las herramientas y siguiendo los pasos proporcionados.

  4. Cree un entorno virtual.

  5. Agregue un archivo pip.ini (Windows) o pip.conf (Mac/Linux) a su virtualenv y pegue el fragmento de código proporcionado en él. El archivo debe tener un aspecto similar al siguiente fragmento de código:

    [global]
    index-url=https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/simple/
    
  6. Ejecute este comando en el directorio del proyecto para instalar los paquetes:

    pip install
    

Importante

Debe tener pip 19.2 o superior para usar el keyring de artefactos. Consulte Requisitos de uso para obtener más detalles.