Publikowanie pakietów języka Python za pomocą usługi Azure Pipelines

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

Usługa Azure Pipelines umożliwia deweloperom publikowanie pakietów języka Python w źródłach danych usługi Azure Artifacts i publicznych rejestrach, takich jak PyPi. Ten artykuł przeprowadzi Cię przez proces publikowania pakietów języka Python w kanale informacyjnym usługi Azure Artifacts.

Wymagania wstępne

• Organizacja i projekt usługi Azure DevOps. Utwórz organizację lub projekt, jeśli jeszcze tego nie zrobiono.

• Źródło danych usługi Azure Artifacts. Utwórz kanał informacyjny , jeśli jeszcze go nie masz.

Uwierzytelnianie za pomocą kanału danych

Aby opublikować pakiety języka Python przy użyciu twine, musisz najpierw uwierzytelnić się za pomocą kanału Azure Artifacts. Zadanie TwineAuthenticate udostępnia poświadczenia bliźniaczych reprezentacji do zmiennej środowiskowejPYPIRC_PATH. Ta zmienna jest następnie używana przeztwine do publikowania pakietów bezpośrednio z twojego potoku.

Ważne

Poświadczenia przechowywane w zmiennej środowiskowej PYPIRC_PATH mają pierwszeństwo przed poświadczeniami w plikach .ini i .conf.

Jeśli dodasz wiele zadań TwineAuthenticate na różnych etapach pipeline'u, każde wykonanie zadania rozszerzy (nie zastąpi) istniejącą zmienną środowiskową PYPIRC_PATH.

YAML

1. Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.

2. Wybierz element Pipelines, a później wybierz definicję "pipeline".

3. Wybierz pozycję Edytuj, a następnie dodaj następujący fragment kodu do potoku YAML.

   steps:
   - task: UsePythonVersion@0
     displayName: 'Use Python 3.x'
   
   - task: TwineAuthenticate@1
     inputs:
       artifactFeed: <PROJECT_NAME/FEED_NAME>     ## For an organization-scoped feed, use: artifactFeed: <FEED_NAME>
   

Klasyczny

1. Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.

2. Wybierz pozycję Potoki, wybierz definicję potoku, a następnie wybierz pozycję Edytuj.

3. Wybierz znak +, aby dodać nowe zadanie, a następnie dodaj zadanie Użyj wersji Python oraz zadanie Python twine upload authenticate do definicji pipeline'u. Możesz pozostawić zadanie UsePythonVersion@0 z ustawieniami domyślnymi i skonfigurować TwineAuthenticate@1 w następujący sposób:

   1. Wybierz źródło danych z menu rozwijanego Moja nazwa kanału informacyjnego. Aby uwierzytelnić się za pomocą kanału informacyjnego spoza organizacji, wybierz kanał informacyjny z organizacji zewnętrznych i utwórz nowe połączenie z usługą.

   

Publikowanie pakietów języka Python w kanale informacyjnym

Uwaga

Aby opublikować pakiety w kanale przy użyciu usługi Azure Pipelines, upewnij się, że zarówno tożsamość usługi Project Collection Build Service, jak i tożsamość usługi kompilacji projektu są przypisane do roli publikatora kanału (współtwórca) w ustawieniach kanału. Aby uzyskać szczegółowe informacje, zobacz Zarządzanie uprawnieniami .

YAML

1. Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.

2. Wybierz pozycję Pipelines, a następnie wybierz swoją definicję pipeline'u.

3. Wybierz Edytuj, a następnie dodaj następujący fragment do rurku YAML.

   steps:
   - task: UsePythonVersion@0
     displayName: 'Use Python 3.x'
   
   - script: |
       pip install build
       pip install twine
     displayName: 'Install build and twine'
   
   - script: |
       python -m build -w
     displayName: 'Python build'
   
   - task: TwineAuthenticate@1
     inputs:
       artifactFeed: <PROJECT_NAME/FEED_NAME>                ## For an organization-scoped feed, use: artifactFeed: <FEED_NAME>
     displayName: 'Twine Authenticate'
   
   - script: |
       python -m twine upload -r <FEED_NAME> --config-file $(PYPIRC_PATH) dist/*.whl
     displayName: 'Upload to feed'
   

Klasyczny

1. Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.

2. Wybierz pozycję Potoki, wybierz definicję potoku, a następnie wybierz pozycję Edytuj.

3. Wybierz znak +, aby dodać nowe zadanie, a następnie dodaj zadanie Użyj wersji języka Python do potoku. W tym przykładzie ustawiamy specyfikację wersji na >= 3.7.

4. Dodaj zadanie wiersza polecenia do potoku i wklej następujące polecenia w polu tekstowym Script, aby zainstalować kompilację i twine na agencie:

   pip install build
   pip install twine
   

5. Dodaj nowe zadanie wiersza polecenia do potoku, a następnie wklej następujące polecenie w pole tekstowe skryptu , aby skompilować projekt:

   python -m build -w
   

6. Dodaj zadanie Twine Authenticate do swojego potoku i wybierz swoje źródło danych z menu rozwijanego Moja nazwa kanału.

7. Dodaj kolejne zadanie wiersza polecenia do potoku i wklej następujące polecenie w polu tekstowym skryptu , aby opublikować pakiet w swoim strumieniu, zastępując symbol zastępczy nazwą swojego strumienia:

   python -m twine upload -r <FEED_NAME> --config-file $(PYPIRC_PATH) dist/*.whl
   

   

Powiązana zawartość

• Publikowanie i Pobieranie Artefaktów Przepływu Danych
• Konfigurowanie nadrzędnych źródeł
• Użyj pliku artifactignore