Ver y actualizar los detalles y las dependencias de la versión del paquete

Puede ver información sobre la versión de un paquete, incluidas las dependencias, en. CodeArtifact También puede actualizar el estado de una versión del paquete. Para obtener más información sobre el estado de la versión del paquete, consulte El estado de la versión del paquete.

Ver detalles de la versión del paquete

Utilice el comando describe-package-version para ver detalles sobre versiones de paquetes. Los detalles de la versión del paquete se extraen de un paquete cuando se publica en CodeArtifact. Los detalles de los diferentes paquetes varían y dependen de sus formatos y de la cantidad de información que les hayan agregado sus autores.

La mayor parte de la información de la salida del comando describe-package-version depende del formato del paquete. Por ejemplo, describe-package-version extrae la información de un paquete npm de su archivo package.json. La revisión la crea CodeArtifact. Para obtener más información, consulte Especificación de una versión de paquete.

Dos versiones de paquetes con el mismo nombre pueden estar en el mismo repositorio si cada una está en espacios de nombres diferentes. Utilice el parámetro --namespace opcional para especificar un espacio de nombres. Para obtener más información, consulte Ver los detalles de la versión del paquete npm o Ver los detalles de la versión del paquete Maven.

El siguiente ejemplo devuelve detalles sobre la versión 1.9.0 de un paquete de Python denominado pyhamcrest que se encuentra en el repositorio my_repo.

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

El resultado puede tener el siguiente aspecto.

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

Ver los detalles de la versión del paquete npm

Para ver los detalles sobre la versión de un paquete npm, defina el valor de la opción --format en npm. Si lo desea, incluya el espacio de nombres de la versión del paquete (alcance npm) en la opción --namespace. El valor de la opción --namespace no debe incluir el @ inicial. Para buscar el espacio de nombres@types, defina el valor en types.

A continuación, se muestran detalles sobre la versión 4.41.5 de un paquete npm denominado webpack en el alcance @types.

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

El resultado puede tener el siguiente aspecto.

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

Ver los detalles de la versión del paquete Maven

Para ver los detalles sobre la versión de un paquete de Maven, establezca el valor de la opción --format en maven e incluya el espacio de nombres de la versión del paquete en la opción --namespace.

El siguiente ejemplo devuelve detalles sobre la versión 1.2 de un paquete de Maven denominado commons-rng-client-api que se encuentra en el espacio de nombres org.apache.commons y en el repositorio my_repo.

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

El resultado puede tener el siguiente aspecto.

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

nota

CodeArtifact no extrae la información detallada de la versión del paquete de los archivos principales. POM Los metadatos de una versión de paquete determinada solo incluirán información de esa versión exacta del POM paquete, no de la versión principal POM ni de ninguna otra a la que POM se haga referencia transitivamente mediante la POM parent etiqueta. Esto significa que la salida de describe-package-version omitirá metadatos (como información de licencia) para las versiones del paquete Maven que dependen de una referencia parent para contener estos metadatos.

Ver las dependencias de la versión del paquete

Use el comando list-package-version-dependencies para obtener una lista de las dependencias de la versión de un paquete. El siguiente comando muestra las dependencias de un paquete npm denominado my-package, versión 4.41.5, en el repositorio my_repo, en el dominio my_domain.

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

El resultado puede tener el siguiente aspecto.

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

Para ver el rango de valores admitidos para el dependencyType campo, consulte el tipo de PackageDependencydatos en. CodeArtifact API

Ver el archivo readme de la versión del paquete

Algunos formatos de paquete, como npm, incluyen un archivo README. Use get-package-version-readme para obtener el archivo README de una versión de paquete. El siguiente comando devuelve el archivo README de un paquete npm llamado my-package, versión 4.41.5, en el repositorio my_repo, en el dominio my_domain.

nota

CodeArtifact no admite la visualización de archivos readme de paquetes genéricos o de 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

El resultado puede tener el siguiente aspecto.

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