アップストリームリポジトリの優先順位

1つ以上のアップストリームリポジトリを持つリポジトリからパッケージバージョンをリクエストする場合、その優先順位は、create-repositoryまたはupdate-repositoryコマンドを実行する際にリストアップされた順番に対応します。要求されたパッケージバージョンが見つかると、すべてのアップストリームリポジトリを検索する前に検索は停止します。詳細については、「アップストリームリポジトリを追加または削除する (AWS CLI)」を参照してください。

優先順位を表示するには describe-repositoryコマンドを実行します。

aws codeartifact describe-repository --repository my_repo --domain my_domain --domain-owner 111122223333

結果は次のとおりになります。これは、アップストリームリポジトリの優先順位が、まずupstream-1、次が upstream-2、最後がupstream-3であることを示しています。

{
    "repository": {
        "name": "my_repo",
        "administratorAccount": "123456789012",
        "domainName": "my_domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-east-1:111122223333:repository/my_domain/my_repo",
        "description": "My new repository",
        "upstreams": [
            {
                "repositoryName": "upstream-1"
            },
            {
                "repositoryName": "upstream-2"
            },
            {
                "repositoryName": "upstream-3"
            }
        ],
        "externalConnections": []
    }
}

簡単な優先順位の例

次の図では、my_repoリポジトリには 3 つのアップストリームリポジトリがあります。アップストリームリポジトリの優先順位は、upstream-1、upstream-2、upstream-3の順です。

my_repoでのパッケージバージョンのリクエストでは、それが見つかるか、またはHTTP404 Not Foundレスポンスがクライアントに返されるまで、次の順序でリポジトリを検索します。

パッケージバージョンが見つかると、すべてのアップストリームリポジトリでの検索が終了していなくても、検索は停止します。例えば、パッケージバージョンが upstream-1 で見つかった場合、検索は停止し、CodeArtifact が upstream-2 または upstream-3 を検索することはありません。

AWS CLI コマンドを使用して のパッケージバージョンlist-package-versionsを一覧表示するとmy_repo、 でのみ検索されますmy_repo。アップストリームリポジトリのパッケージバージョンはリストアップされません。

複雑な優先順位の例

アップストリームリポジトリに独自のアップストリームリポジトリがある場合、次のアップストリームリポジトリに移動する前に、同じロジックを使用してパッケージバージョンを検索します。例えば、my_repoリポジトリにはA とBの2つのアップストリームリポジトリがあるとします。リポジトリAにアップストリームリポジトリがある場合、my_repoにあるパッケージバージョンのリクエストは、最初にmy_repo、次にAを検索し、それからAのアップストリームリポジトリを検索する、というように続きます。

次の図では、my_repoリポジトリにアップストリームリポジトリが含まれています。アップストリームリポジトリAには、アップストリームリポジトリが2つあり、Dにはアップストリームリポジトリが1つあります。図内の同じレベルにあるアップストリームリポジトリは、優先順位が左から右に表示されます。(リポジトリAはリポジトリBより優先順位が高く、リポジトリCはリポジトリDより優先順位が高い)。

この例では、my_repo でのパッケージバージョンのリクエストで、それが見つかるか、または、パッケージマネージャーが HTTP404 Not Found レスポンスをクライアントに返すまで、次の順序でリポジトリを検索します。