Afficher et mettre à jour les détails et les dépendances des versions du package

Vous pouvez consulter les informations relatives à la version d'un package, y compris les dépendances, dans CodeArtifact. Vous pouvez également mettre à jour le statut d'une version de package. Pour plus d'informations sur l'état de la version du package, consultezÉtat de la version du package.

Afficher les détails de la version du package

Utilisez la describe-package-version commande pour afficher les détails relatifs aux versions des packages. Les détails de la version du package sont extraits d'un package lorsqu'il est publié sur CodeArtifact. Les détails des différents packages varient et dépendent de leurs formats et de la quantité d'informations que leurs auteurs y ont ajoutées.

La plupart des informations contenues dans le résultat de la describe-package-version commande dépendent du format du package. Par exemple, describe-package-version extrait les informations d'un package npm de son package.json fichier. La révision est créée par CodeArtifact. Pour plus d’informations, consultez Spécification d'une révision de version de package.

Deux versions de package portant le même nom peuvent se trouver dans le même référentiel si elles se trouvent chacune dans des espaces de noms différents. Utilisez le --namespace paramètre facultatif pour spécifier un espace de noms. Pour plus d’informations, consultez Afficher les détails de la version du package npm ou Afficher les détails de la version du package Maven.

L'exemple suivant renvoie des détails sur la version 1.9.0 d'un package Python nommé pyhamcrest qui se trouve dans le my_repo référentiel.

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

Le résultat peut ressembler à ce qui suit.

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

Afficher les détails de la version du package npm

Pour afficher les détails d'une version de package npm, définissez la valeur de l'--formatoption sur. npm Vous pouvez éventuellement inclure l'espace de noms de version du package (npm scope) dans l'--namespaceoption. La valeur de l'--namespaceoption ne doit pas inclure le début@. Pour rechercher l'espace de noms@types, définissez la valeur sur types.

Ce qui suit renvoie des détails sur 4.41.5 la version d'un package npm nommé webpack dans le @types scope.

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

Le résultat peut ressembler à ce qui suit.

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

Afficher les détails de la version du package Maven

Pour afficher les détails d'une version de package Maven, définissez la valeur de l'--formatoption sur maven et incluez l'espace de noms de version du package dans l'--namespaceoption.

L'exemple suivant renvoie des détails sur 1.2 la version d'un package Maven nommé commons-rng-client-api qui se trouve dans l'espace de org.apache.commons noms et dans le my_repo référentiel.

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

Le résultat peut ressembler à ce qui suit.

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

Note

CodeArtifact n'extrait pas les informations détaillées sur la version du package des fichiers POM parents. Les métadonnées d'une version de package donnée incluront uniquement des informations dans le POM pour cette version de package exacte, et non pour le POM parent ou tout autre POM référencé de manière transitive à l'aide de la parent balise POM. Cela signifie que la sortie de describe-package-version omettra les métadonnées (telles que les informations de licence) pour les versions de package Maven qui reposent sur une parent référence pour contenir ces métadonnées.

Afficher les dépendances entre les versions du package

Utilisez la list-package-version-dependencies commande pour obtenir la liste des dépendances d'une version de package. La commande suivante répertorie les dépendances d'un package npm nommémy-package, version4.41.5, dans le my_repo référentiel, dans le my_domain domaine.

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

Le résultat peut ressembler à ce qui suit.

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

Pour connaître la plage de valeurs prises en charge pour le champ DependencyType, consultez le type de PackageDependencydonnées dans l'CodeArtifact API.

Afficher le fichier readme de la version du package

Certains formats de package, tels que npm, incluent un README fichier. Utilisez le get-package-version-readme pour obtenir le README fichier d'une version de package. La commande suivante renvoie le README fichier d'un package npm nommémy-package, version4.41.5, dans le my_repo référentiel, dans le my_domain domaine.

Note

CodeArtifact ne prend pas en charge l'affichage de fichiers readme à partir de packages génériques ou 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

Le résultat peut ressembler à ce qui suit.

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