View a markdown version of this page

Afficher et mettre à jour les détails de la version du package et les dépendances - CodeArtifact
Afficher les détails de la version du packageAfficher les détails de la version du package npmAfficher les détails de la version du package MavenAfficher les dépendances entre les versions des packagesAfficher le fichier readme de la version du package

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Afficher et mettre à jour les détails de la version du package et les dépendances

Vous pouvez consulter des informations sur la version d'un package, y compris les dépendances, dans CodeArtifact. Vous pouvez également mettre à jour le statut de la version d'un 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 des informations détaillées sur les versions des packages. Les détails de la version du package sont extraits d'un package lors de sa publication sur CodeArtifact. Les informations contenues dans les différents packages varient et dépendent de leur format et de la quantité d'informations que leurs auteurs y ont ajoutées.

La plupart des informations contenues dans la sortie de la describe-package-version commande dépendent du format du package. Par exemple, describe-package-version extrait les informations d'un package npm à partir de son package.json fichier. La révision est créée par CodeArtifact. Pour de plus amples informations, veuillez consulter Spécifier 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 informations 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

La sortie 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"
}
Note

CodeArtifact récupère les détails de la version du package, tels que la page d'accueil du package ou les informations de licence du package, à partir des métadonnées fournies par l'auteur du package. Si l'une de ces informations dépasse 400 Ko, ce qui correspond à la taille limite des éléments DynamoDB, vous CodeArtifact ne pourrez pas traiter ces données et vous risquez de ne pas voir ces informations sur la console ou dans la réponse de. describe-package-version Par exemple, un package Python https://pypi.org/project/rapyd-sdk/ possède un champ de licence très volumineux, de sorte que ces informations ne seraient pas traitées par CodeArtifact.

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 la version du package (portée npm) 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 la @types portée. 

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

La sortie 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 la version du package dans l'--namespaceoption.

L'exemple suivant renvoie des informations sur la version 1.2 d'un package Maven nommé commons-rng-client-api qui se trouve dans l'org.apache.commonsespace de 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

La sortie 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 à partir des fichiers POM parents. Les métadonnées pour une version de package donnée incluront uniquement des informations dans le POM pour cette version exacte du package, pas 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 packages Maven qui s'appuient sur une parent référence pour contenir ces métadonnées.

Afficher les dépendances entre les versions des packages

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

La sortie 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 PackageDependency donné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 du 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

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