クイック スタート: コマンド ラインを使用して Azure Artifacts で Python パッケージを発行して使用する (CLI)

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

このクイック スタートでは、Azure Artifacts フィードを作成し、フィードを使用して、ローカル開発環境のコマンド ラインから Python パッケージを発行および使用する方法について説明します。 完了すると、フィードに公開され、フィードからローカル開発環境にインストールされた Python パッケージが作成されます。

Azure Pipelines でパッケージを発行して使用するには、「Azure Pipelines を使用して Python パッケージを発行する」を参照してください。

前提条件

次の手順を実行するには、次のものが必要です。

ローカル Python パッケージを作成する

フィードに発行するには Python パッケージが必要です。 発行するパッケージがない場合は、GitHub からサンプル Python パッケージを複製できます。

サンプル Python パッケージを複製する

GitHub のサンプル Python パッケージを使用するには、次の手順に従います。

1. 次の GitHub リポジトリに移動します。

   https://github.com/microsoft/python-package-template
   

2. GitHub アカウントにリポジトリをフォークする。

3. フォークしたリポジトリに移動し、[コード] を選択します。

4. フォークしたリポジトリの URL をコピーします。

5. ローカル コンピューター上の CLI から、フォークしたリポジトリからコピーした URL を使用して、次のコマンドを使用してリポジトリを複製します。

   git clone <REPOSITORY_URL>
   

6. 複製されたリポジトリにディレクトリを変更します。

   cd python-package-template
   

パッケージをビルドする

ホイールとソース配布をビルドするには、プロジェクト ディレクトリで次のコマンドを実行します。

pip install --upgrade build
python -m build

Python プロジェクトにファイルがある場合は setup.py 、次のコマンドを使用してパッケージをビルドできます。

python setup.py sdist bdist_wheel

フィードの作成

フィードにパッケージを発行する

Twine を使用して、パッケージを Azure Artifacts フィードにアップロードします。

1. Azure DevOps プロジェクトに移動し、[成果物] を選択します。

2. フィードを選択し、[フィードに接続] を選択 します。

   

3. [Python] セクションで [twine] を選択します。

   

4. 開発用コンピューターに、twine がインストールされていることを確認します。

   pip install --upgrade twine
   

5. 「プロジェクトのセットアップ」セクションの指示に従って、ファイルを設定します.pypirc。

   

6. パッケージを発行するたびに個人用アクセス トークンを入力する必要がないように、資格情報をファイルに .pypirc 追加できます。 個人用アクセス トークンをパブリック リポジトリにチェックしていないことを確認します。

   資格情報を持 .pypirc つファイルの例:

   [distutils]
   Index-servers =
       <FEED_NAME>
   
   [<FEED_NAME>]
   Repository = <FEED_URL>
   username = <FEED_NAME>
   password = <YOUR_PERSONAL_ACCESS_TOKEN>
   

7. パッケージをアップロードするには、F Enterprise Edition D_NAME> をフィード名に置き換えて<、プロジェクト ディレクトリで次のコマンドを実行します。 Windows では、引数を使用してファイルの場所--config-fileを.pypirc指定することが必要になる場合があります。

   twine upload --repository <FEED_NAME> dist/*
   

フィードからパッケージをインストールする

1. Azure DevOps プロジェクトに移動し、[成果物] を選択します。

2. フィードを選択し、[フィードに接続] を選択 します。

   

3. [Python] セクションで [pip] を選択します。

   

4. ローカル Python 環境を準備します。

   • Windows
   • Linux と macOS

   1. pip がインストールされ、最新であることを確認します。

      python -m pip install --upgrade pip
      

   2. Python 仮想環境を作成してアクティブ化します。

      python -m venv myenv
      myenv/Scripts/activate
      

5. pip.ini (Windows) または pip.conf (Mac/Linux) ファイルを仮想環境のルート ディレクトリに追加します。 [フィードに接続] ダイアログの [プロジェクトのセットアップ] セクションからコンテンツをコピーし、pip.iniまたは pip.conf ファイルに追加します。

   

6. フィードからパッケージをインストールするたびに個人用アクセス トークンを入力する必要がないように、資格情報を pip.ini または pip.conf ファイルに追加できます。 個人用アクセス トークンをパブリック リポジトリにチェックしていないことを確認します。

   資格情報を持つ pip.ini または pip.conf ファイルの例:

   [global]
   extra-index-url=https://<FEED_NAME>:<YOUR_PERSONAL_ACCESS_TOKEN>@<FEED_URL>
   

7. パッケージをインストールするには、PACKAGE_NAMEをフィードのパッケージ名に置き換えて<>、次のコマンドを実行します。

   pip install <PACKAGE_NAME>
   

リソースをクリーンアップする

作成したリソースが完了したら、それらを削除して料金が発生しないようにすることができます。 プロジェクトを削除すると、そのプロジェクト レベルのすべての成果物フィードが削除されます。

プロジェクトを削除するには:

1. [プロジェクトの設定] を選択します。
2. [プロジェクトの詳細] ページで、ページの下部にある [削除] を選択します。
3. 確認するプロジェクトの名前を入力し、[削除] を選択 します。

フィードのみを削除する場合:

1. [ 成果物] を選択し、ドロップダウン メニューからフィードを選択します。
2. 設定ボタンを選択します。
3. [フィードの設定] タブで、[フィードの削除] を選択します。
4. [削除] ボタンを選択して確定します。

ローカル開発環境をクリーンするには:

1. 仮想環境を非アクティブ化するには、次のコマンドを実行します。

   deactivate
   

2. 仮想環境を削除するには、仮想環境が作成されたディレクトリを削除します。

3. .pypircホーム ディレクトリからファイルを削除します。

サンプル Python パッケージを複製した場合は、ローカル コンピューターと GitHub アカウントからリポジトリを削除できます。

次のステップ

• フィード ビューを使用してパッケージを共有する

• Azure Pipelines で Python パッケージを発行する

• Python アプリをビルドする

関連記事

• 成果物のキーリング

• Python 仮想環境