檢視和更新套件版本詳細資訊和相依性 - CodeArtifact
檢視套件版本詳細資訊檢視 npm 套件版本詳細資訊檢視 Maven 套件版本詳細資訊檢視套件版本相依性檢視套件版本 readme 檔案

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

檢視和更新套件版本詳細資訊和相依性

您可以在 CodeArtifact 中檢視套件版本的相關資訊，包括相依性。您也可以更新套件版本的狀態。如需套件版本狀態的詳細資訊，請參閱 套件版本狀態。

檢視套件版本詳細資訊

使用 describe-package-version命令來檢視套件版本的詳細資訊。套件版本詳細資訊會在發佈至 CodeArtifact 時從套件中擷取。不同套件中的詳細資訊會有所不同，取決於其格式，以及作者新增至其中的資訊量。

describe-package-version 命令輸出中的大多數資訊取決於套件格式。例如， 會從其package.json檔案describe-package-version擷取 npm 套件的資訊。此修訂由 CodeArtifact 建立。如需詳細資訊，請參閱指定套件版本修訂。

如果兩個具有相同名稱的套件版本各自位於不同的命名空間中，則可以位於相同的儲存庫中。使用選用--namespace參數來指定命名空間。如需詳細資訊，請參閱 檢視 npm 套件版本詳細資訊 或 檢視 Maven 套件版本詳細資訊 。

下列範例會傳回儲存my_repo庫中名為 1.9.0之 Python pyhamcrest 套件版本的詳細資訊。

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"
}
注意

CodeArtifact 會從套件作者提供的中繼資料中擷取套件版本詳細資訊，例如套件首頁或套件授權資訊。如果此資訊中的任何一個超過 400 KB，即 DynamoDB 項目大小限制，CodeArtifact 將無法處理此類資料，而且您可能無法在主控台或 的回應中看到此資訊describe-package-version。例如，例如 https://pypi.org/project/rapyd-sdk/ 的 python 套件具有非常大的授權欄位，因此 CodeArtifact 不會處理此資訊。

檢視 npm 套件版本詳細資訊

若要檢視 npm 套件版本的詳細資訊，請將 --format選項的值設定為 npm。或者，在 --namespace選項中包含套件版本命名空間 (npm 範圍)。--namespace 選項的值不應包含前置 @。若要搜尋命名空間 @types，請將 值設定為 類型。

以下內容會傳回 @types範圍webpack中名為 4.41.5之 npm 套件版本的詳細資訊。

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中名為 1.2之 Maven 套件版本的詳細資訊。

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 或使用 POM parent標籤暫時參考的任何其他 POM。這表示 的輸出describe-package-version會省略依賴parent參考包含此中繼資料的 Maven 套件版本的中繼資料 （例如授權資訊）。

檢視套件版本相依性

使用 list-package-version-dependencies命令來取得套件版本的相依性清單。下列命令列出 my_domain 網域中儲存my_repo庫中名為 my-package版本 4.41.5之 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 套件中的讀我檔案。

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"
}