パッケージのバージョンの詳細と依存関係の表示および更新

依存関係を含むパッケージバージョンに関する情報は、 で表示できます CodeArtifact。パッケージバージョンのステータスを更新することもできます。パッケージのバージョンのステータスの詳細については、パッケージバージョンのステータスを参照してください。

パッケージバージョンの詳細を表示

describe-package-versionコマンドを使用して、パッケージのバージョンの詳細を表示します。パッケージバージョンの詳細は、 に公開されたときにパッケージから抽出されます CodeArtifact。異なるパッケージの詳細は異なり、形式や作成者が追加した情報の量によって異なります。

describe-package-versionコマンドの出力にあるほとんどの情報は、パッケージ形式に応じて異なります。例えば、describe-package-versionはpackage.jsonファイルから npm パッケージの情報を抽出します。リビジョンは によって作成されます CodeArtifact。詳細については、「パッケージバージョンリビジョンの指定」を参照してください。

同じ名前を持つ二つのパッケージバージョンは、それぞれ異なるネームスペースに存在する場合、同じリポジトリに配置できます。オプションの--namespaceパラメータを使用して、ネームスペースを指定します。詳細については、npm パッケージバージョンの詳細の表示またはMaven パッケージバージョンの詳細の表示を参照してください。

次の例では、my_repoリポジトリ内のpyhamcrestという名前の Python パッケージのバージョン1.9.0の詳細を返します。

aws codeartifact describe-package-version --domain my_domain --domain-owner 111122223333 --repository my_repo \
--format pypi --package pyhamcrest --package-version 1.9.0

出力は次のようになります。

{
  "format": "pypi",
  "package": "PyHamcrest",
  "displayName": "PyHamcrest",
  "version": "1.9.0",
  "summary": "Hamcrest framework for matcher objects",
  "homePage": "https://github.com/hamcrest/PyHamcrest",
  "publishedTime": 1566002944.273,
  "licenses": [
    {
      "id": "license-id",
      "name": "license-name"
    }
  ],
  "revision": "REVISION-SAMPLE-55C752BEE9B772FC"
}

npm パッケージバージョンの詳細の表示

npm パッケージバージョンの詳細を表示するには、--format オプションの値を npm に設定します。--namespace オプションで、パッケージバージョンの名前空間 (npm scope) をオプションに含めます。--namespaceオプションの値には@の先頭を含めないでください。ネームスペース@typesを検索するには、値を [タイプ] に設定します。

以下は、@types スコープ内の webpack という名前の npm パッケージバージョン 4.41.5 の詳細を返します。

aws codeartifact describe-package-version --domain my_domain --domain-owner 111122223333 --repository my_repo \
--format npm --package webpack --namespace types --package-version 4.41.5

出力は次のようになります。

{
  "format": "npm",
  "namespace": "types",
  "package": "webpack",
  "displayName": "webpack",
  "version": "4.41.5",
  "summary": "Packs CommonJs/AMD modules for the browser. Allows ... further output omitted for brevity",
  "homePage": "https://github.com/webpack/webpack",
  "sourceCodeRepository": "https://github.com/webpack/webpack.git",
  "publishedTime": 1577481261.09,
  "licenses": [
    {
      "id": "license-id",
      "name": "license-name"
    }
  ],
  "revision": "REVISION-SAMPLE-55C752BEE9B772FC",
  "status": "Published",
  "origin": {
            "domainEntryPoint": {
                "externalConnectionName": "public:npmjs"
            },
            "originType": "EXTERNAL"
  }
}

Maven パッケージバージョンの詳細の表示

Maven パッケージバージョンの詳細を表示するには、--format オプションの値を maven に設定し、パッケージバージョンの名前空間を --namespace オプションに含めます。

次の例では、org.apache.commonsネームスペースとmy_repoリポジトリに存在するcommons-rng-client-apiという名前の Maven パッケージのバージョン1.2の詳細を返します。

aws codeartifact describe-package-version --domain my_domain --domain-owner 111122223333 --repository my_repo \
--format maven --namespace org.apache.commons --package commons-rng-client-api --package-version 1.2

出力は次のようになります。

{
  "format": "maven",
  "namespace": "org.apache.commons",
  "package": "commons-rng-client-api",
  "displayName": "Apache Commons RNG Client API",
  "version": "1.2",
  "summary": "API for client code that uses random numbers generators.",
  "publishedTime": 1567920624.849,
  "licenses": [],
  "revision": "REVISION-SAMPLE-55C752BEE9B772FC"
}

注記

CodeArtifact は、親 POM ファイルからパッケージバージョンの詳細情報を抽出しません。特定のパッケージバージョンのメタデータには、正確なパッケージバージョンの POM 内の情報のみが含まれ、POM parent タグを使用して推移的に参照される親 POM やその他の POM の情報は含まれません。つまり、describe-package-version の出力では、このメタデータを含む parent 参照に依存している Maven パッケージバージョンのメタデータ (ライセンス情報など) は省略されます。

パッケージバージョンの依存関係を表示する

list-package-version-dependenciesコマンドを使用すると、パッケージバージョンの依存関係のリストを取得できます。次のコマンドは、my_domainドメインのmy_repoリポジトリのバージョン4.41.5のmy-packageという名前の npm パッケージの依存関係を一覧表示します。

aws codeartifact list-package-version-dependencies --domain my_domain --domain-owner 111122223333 --repository my_repo \
--format npm --package my-package --package-version 4.41.5

出力は次のようになります。

{
  "dependencies": [
    {
      "namespace": "webassemblyjs",
      "package": "ast",
      "dependencyType": "regular",
      "versionRequirement": "1.8.5"
    },
    {
      "namespace": "webassemblyjs",
      "package": "helper-module-context",
      "dependencyType": "regular",
      "versionRequirement": "1.8.5"
    },
    {
      "namespace": "webassemblyjs",
      "package": "wasm-edit",
      "dependencyType": "regular",
      "versionRequirement": "1.8.5"
    }
  ],
  "versionRevision": "REVISION-SAMPLE-55C752BEE9B772FC"
}

dependencyType フィールドでサポートされている値の範囲については、 CodeArtifact API PackageDependencyのデータ型を参照してください。

パッケージバージョンの readme ファイルの表示

npm などの一部のパッケージ形式には、READMEファイルが含まれます。get-package-version-readmeを使用してパッケージバージョンのREADMEファイルを取得します。次のコマンドは、my_domainドメインのmy_repoリポジトリにあるバージョン4.41.5のmy-packageという名前の npm パッケージのREADMEファイルを返します。

注記

CodeArtifact は、汎用パッケージまたは Maven パッケージからの readme ファイルの表示をサポートしていません。

aws codeartifact get-package-version-readme --domain my_domain --domain-owner 111122223333 --repository my_repo \
--format npm --package my-package --package-version 4.41.5

出力は次のようになります。

{  
  "format": "npm",
  "package": "my-package",
  "version": "4.41.5"
  "readme": "<div align=\"center\">\n   <a href=\https://github.com/webpack/webpack\"> ... more content ... \n",
  "versionRevision": "REVISION-SAMPLE-55C752BEE9B772FC"
}