Condividi tramite


Pubblicare e installare pacchetti Python (interfaccia della riga di comando)

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

Azure Artifacts consente agli sviluppatori di gestire le relative dipendenze da un singolo feed. È possibile pubblicare e installare pacchetti Python da e verso il feed usando la riga di comando. In questo articolo vengono illustrate le operazioni seguenti:

  • Creare un nuovo feed.
  • Pubblicare pacchetti Python in un feed.
  • Installare i pacchetti Python da un feed.

Prerequisiti

Creare un feed

  1. Accedere all'organizzazione di Azure DevOps e passare al progetto.

  2. Selezionare Artefatti e quindi Crea feed.

  3. Specificare un nome per il feed, scegliere l'opzione Visibilità che definisce chi può visualizzare i pacchetti, selezionare Includi pacchetti da origini pubbliche comuni se si desidera includere pacchetti da origini come nuget.org o npmjs.com e per Ambito decidere se il feed deve essere definito come ambito per il progetto o l'intera organizzazione.

  4. Al termine, fare clic su Crea.

    Screenshot che mostra le selezioni per la creazione di un nuovo feed in Azure DevOps Services.

  1. Accedere al server Azure DevOps e quindi passare al progetto.

  2. Selezionare Artefatti e quindi Crea feed.

  3. Specificare un nome per il feed, scegliere l'opzione Visibilità che definisce chi può visualizzare i pacchetti, selezionare Includi pacchetti da origini pubbliche comuni se si desidera includere pacchetti da origini come nuget.org o npmjs.com e per Ambito decidere se il feed deve essere definito come ambito per il progetto o l'intera organizzazione.

  1. Al termine, fare clic su Crea.

    Screenshot che mostra le selezioni per la creazione di un nuovo feed in Azure DevOps 2022.

  1. Al termine, fare clic su Crea.

    Screenshot che mostra le selezioni per la creazione di un nuovo feed in Azure DevOps 2020.

  1. Accedere al server Azure DevOps e quindi passare al progetto.

  2. Selezionare Artefatti e quindi nuovo feed.

  3. In Nome immettere un nome descrittivo per il feed.

    In Visibilità selezionare un'opzione per indicare chi può visualizzare i pacchetti all'interno del feed.

    Per includere pacchetti da origini pubbliche, selezionare l'opzione Usa pacchetti da origini pubbliche tramite questa opzione di feed .

  4. Al termine, fare clic su Crea.

    Screenshot che mostra le selezioni per la creazione di un nuovo feed in Azure DevOps 2019.

Nota

Per impostazione predefinita, i feed appena creati hanno il valore del servizio di compilazione del progetto impostato su Feed e lettore upstream (collaboratore).

Pubblicare pacchetti

  1. Accedere all'organizzazione di Azure DevOps e passare al progetto.

  2. Selezionare Artefatti e quindi Selezionare Connetti al feed.

  3. Selezionare twine nell'area di spostamento a sinistra. Se è la prima volta che si usa Azure Artifacts con twine, assicurarsi di installare i prerequisiti selezionando Recupera gli strumenti e seguendo i passaggi forniti.

  4. Aggiungere un file con estensione pypirc alla home directory e incollarvi il frammento specificato. Il file dovrebbe essere simile al frammento di codice seguente. Se si dispone già di un file con estensione pypirc che contiene le credenziali per l'indice PyPI pubblico, è consigliabile rimuovere la sezione [pypi] per evitare la pubblicazione accidentale di pacchetti privati in PyPI.

    [distutils]
    Index-servers =
    FEED_NAME
    
    [FEED_NAME]
    Repository = https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/upload/
    
  5. Eseguire il comando seguente nella directory del progetto per creare distribuzioni di origine e rotellina.

    python setup.py sdist bdist_wheel
    
  6. Eseguire il comando seguente per pubblicare il pacchetto. Usare il flag -r REPOSITORY_NAME per assicurarsi che i pacchetti privati non vengano pubblicati accidentalmente in PyPI.

    twine upload -r REPOSITORY_NAME dist/*
    

Importante

È necessario avere twine 1.13.0 o versione successiva per usare artifacts-keyring. Per altri dettagli, vedere Requisiti di utilizzo.

Installare i pacchetti

  1. Accedere all'organizzazione di Azure DevOps e passare al progetto.

  2. Selezionare Artefatti e quindi Selezionare Connetti al feed.

  3. Selezionare pip nell'area di spostamento a sinistra. Se questa è la prima volta che si usa Azure Artifacts con pip, assicurarsi di installare i prerequisiti selezionando Recupera gli strumenti e seguendo i passaggi forniti.

  4. Creare un ambiente virtuale.

  5. Aggiungere un file pip.ini (Windows) o pip.conf (Mac/Linux) al proprio virtualenv e incollarvi il frammento specificato. Il file dovrebbe essere simile al frammento di codice seguente:

    [global]
    index-url=https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/pypi/simple/
    
  6. Eseguire questo comando nella directory del progetto per installare i pacchetti:

    pip install
    

Importante

Per usare il keyring degli artefatti, è necessario avere pip 19.2 o versione successiva. Per altri dettagli, vedere Requisiti di utilizzo.