Introducción a los paquetes de Python en Azure Artifacts

  • Artículo
  • 2 minutos para leer

Azure DevOps Services | Azure DevOps Server 2019 | Azure DevOps Server 2020

Esta guía le guiará a través del uso de Azure Artifacts para publicar y consumir paquetes de Python hacia y desde la fuente.

Creación de una fuente

  1. Desde dentro del proyecto, vaya a Azure Artifacts.

    Vaya a Azure Artifacts

  2. Seleccione Crear fuente.

    Botón Nueva fuente

  3. Asigne un nombre a la fuente y elija su visibilidad,orígenes ascendentesy configuración de ámbito.

    Cuadro de diálogo Nueva fuente

  4. Seleccione Crear cuando haya terminado.

Azure Artifacts está instalado de forma predeterminada para los clientes de TFS 2017. Debe actualizar a TFS 2017 para poder usar Azure Artifacts. Si es la primera vez que usa la fuente, es posible que se le pida que asigne una licencia.

  1. Vaya a Build Release (Versión de compilación) y seleccione Packages (Paquetes).

    Vaya a Azure Artifacts TFS

  2. Seleccione + Nueva fuente.

    Nuevo botón de fuente TFS

  3. Asigne a la fuente un nombre,una descripcióny configure quién puede leer , quién puede contribuir y si desea incluir paquetes externos.

    Cuadro de diálogo Nueva fuente TFS

  4. Seleccione Crear cuando haya terminado.

Conectar para la fuente

Hay dos maneras principales de conectarse a una fuente para publicar o consumir los paquetes de Python:

  1. Instale y use el paquete artifacts-keyring, que configurará automáticamente la autenticación.
  2. Configure manualmente las credenciales para pip.inipip.conf para inserciones y .pyconfc para las extracciones con un token de acceso personal (PAT).

Nota:

artifacts-keyring no se admite en las versiones más recientes de Ubuntu.

Uso de artifacts-keyring para configurar la autenticación

El paquete artifacts-keyring permite configurar la autenticación para publicar y consumir los paquetes de Python hacia y desde la fuente. Tanto pip como twine usan la biblioteca de claves de Python para buscar credenciales.

Importante

Debe tener pip 19.2 y twine 1.13.0 o superior para usar artifacts-keyring.

  1. En una ventana del símbolo del sistema con privilegios elevados, ejecute el siguiente comando para instalar el paquete artifacts-keyring:

    pip install artifacts-keyring

  2. Instale paquetes desde la fuente.

    pip install <package-name> --index-url https://pkgs.dev.azure.com/<your-organization-name>/<your-project-name>/_packaging/<your-feed-name>/pypi/simple

  3. Publique paquetes en la fuente.

    twine upload --repository-url https://pkgs.dev.azure.com/<your-organization-name>/<your-project-name>/_packaging/<your-feed-name>/pypi/upload

Nota:

El paquete artifacts-keyring se incluye en capas sobre nuestros Azure Artifacts Proveedor de credenciales. Para obtener opciones de configuración más avanzadas, consulte el repositorio artifacts-credprovider.

Configuración manual de la autenticación

  1. Cree un token de acceso personal con el ámbito de lecturade empaquetado para autenticarse en Azure DevOps.

  2. Desde dentro de la fuente, seleccione Conectar para alimentar.

    Conectar botón de fuente

  3. Seleccione pip en el encabezado de Python.

    Seleccione pip para conectarse a la fuente.

  4. Asegúrese de que ha instalado la versión más reciente de la Azure Artifacts de claves en el menú "Obtener las herramientas".

    Nota:

    El paquete artifacts-keyring proporciona autenticación para publicar y consumir paquetes de Python hacia y desde Azure Artifacts fuente.

  5. Cree un virtualenv, si aún no tiene uno.

  6. Agregue un pip.ini (Windows) o pip.conf (Mac/Linux) a virtualenv. Asegúrese de no comprobar el token de acceso personal en un repositorio público.

    [global]
extra-index-url=https://<your-feed-name>:<your-PAT-key>@pkgs.dev.azure.com/<your-organization-name>/<your-project-name>/_packaging/<your-feed-name>/pypi/simple/

  7. Ejecute el siguiente comando para instalar un paquete.

    pip install <package-name>

Cuando se conecte a Azure DevOps por primera vez, se le pedirán credenciales. Escriba el nombre de usuario (cualquier cadena) y el token de acceso personal en los campos adecuados. Las credenciales se almacenarán en caché localmente y se usarán para iniciar sesión automáticamente la próxima vez que use el servicio.

Nota:

Si desea configurar la autenticación en Azure Pipelines, use la tarea Autenticación de Pip de Python para instalar paquetes o la tarea Autenticación de Python Twine Upload para insertar paquetes.