PyPI プライベートリポジトリでは、アーティファクトのプッシュ、プル、表示、無効化、削除を行うことができます。
前提条件
PyPI プライベートリポジトリでアーティファクトを管理するには、まず PyPI リポジトリを作成する必要があります。詳細については、「リポジトリの作成」をご参照ください。
PyPI リポジトリの使用
お使いの PyPI リポジトリで、[ユーザーガイド] をクリックし、手順に従ってプッシュとプルを設定してください。
[Manual Upload and Download] ガイドには [Push] タブと [Pull] タブがあります。[Push] タブには [Set push credentials] セクションが含まれており、~/.pypirc ファイルの設定テンプレートが記載されています。このテンプレートには、[distutils] セクションと、リポジトリ固有の URL、ユーザー名、パスワードを設定するセクションが含まれます。また、twine upload コマンドの使用方法も示されています。アーティファクトのプッシュは、設定ファイルを使用する方法と、--repository-url、-u、-p パラメータをインラインで指定する方法のいずれかで実行できます。
PyPI アーティファクトの表示と管理
リポジトリのホームページで [アーティファクト] をクリックすると、すべてのアーティファクトが表示されます。名前でアーティファクトを検索することもできます。
アーティファクトバージョンの詳細
[アーティファクト名] をクリックすると、詳細が表示されます。デフォルトで最新バージョンが表示されます。必要に応じて [バージョンを切り替える] ことができます。
詳細パネルには [Artifact Information]、[File Information]、[Metadata] タブがあり、バージョンの総数、ダウンロード総数、ストレージサイズ、アーティファクトタグが表示されます。このパネルから [Delete This Version] または [Disable Artifact] を実行することもできます。
アーティファクトバージョンの無効化
アーティファクト詳細ページで、[アーティファクトの無効化] をクリックして現在のバージョンを無効化します。
ダイアログボックスが表示されたら、無効化の理由を入力 し、[OK] をクリックします。
無効化はアーティファクト全体ではなく、特定のバージョンにのみ適用されます。たとえば、バージョンの詳細ページで sampleproject 3.0.0 を無効化した場合、sampleproject 3.0.0 はダウンロードできなくなりますが、sampleproject 4.0.0 などの他のバージョンは引き続き利用可能です。
アーティファクトメタデータの管理
「アーティファクト詳細」ページで、[メタデータ] タブをクリックします。追加するメタデータは、選択したバージョンにのみ適用されます。
[Custom Metadata] セクションで、キーと値のペアを入力し、[Add Metadata] をクリックします。
アーティファクトバージョンの削除
「アーティファクト詳細ページ」で、[このバージョンを削除] をクリックします。削除されたバージョンは、「アーティファクトのごみ箱」から復元できます。