Exiba e atualize os detalhes e dependências da versão do pacote

Você pode visualizar informações sobre a versão de um pacote, incluindo dependências, em CodeArtifact. Você também pode atualizar o status de uma versão de pacote. Para obter mais informações sobre o status da versão do pacote, consulte Satus da versão do pacote.

Exibir detalhes da versão de pacote

Use o comando describe-package-version para exibir os detalhes sobre as versões de pacote. Os detalhes da versão do pacote são extraídos de um pacote quando ele é publicado no. CodeArtifact Os detalhes em diferentes pacotes variam e dependem de seus formatos e da quantidade de informações que seus autores adicionaram a eles.

A maioria das informações na saída do comando describe-package-version depende do formato do pacote. Por exemplo, describe-package-version extrai as informações de um pacote npm do arquivo package.json. A revisão é criada por CodeArtifact. Para ter mais informações, consulte Especificar uma revisão da versão do pacote.

Duas versões de pacote com o mesmo nome podem estar no mesmo repositório se cada uma estiver em namespaces diferentes. Use o parâmetro --namespace opcional para especificar um namespace. Para obter mais informações, consulte Exibir detalhes da versão de pacote npm ou Exibir detalhes da versão de pacote Maven.

O exemplo a seguir retorna detalhes sobre a versão 1.9.0 de um pacote Python chamado pyhamcrest que está no repositório 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

A saída deverá ser semelhante a:

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

Exibir detalhes da versão de pacote npm

Para exibir detalhes sobre uma versão de pacote npm, defina o valor da opção --format como npm. Como opção, inclua o namespace da versão do pacote (escopo npm) na opção --namespace. O valor da opção --namespace não deve incluir o @ inicial. Para pesquisar o namespace @types, defina o valor como tipos.

O exemplo a seguir retorna detalhes sobre a versão 4.41.5 de um pacote npm chamado webpack no escopo @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

A saída deverá ser semelhante a:

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

Exibir detalhes da versão de pacote Maven

Para exibir detalhes sobre uma versão de pacote Maven, defina o valor da opção --format como maven e inclua o namespace da versão do pacote na opção --namespace.

O exemplo a seguir retorna detalhes sobre a versão 1.2 de um pacote Maven chamado commons-rng-client-api que está no namespace org.apache.commons e no repositório 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

A saída deverá ser semelhante a:

{
  "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 não extrai informações detalhadas da versão do pacote dos arquivos POM principais. Os metadados de uma determinada versão do pacote incluirão apenas informações no POM para essa versão exata do pacote, não para o POM principal ou qualquer outro POM referenciado transitivamente usando a tag parent do POM. Isso significa que a saída de describe-package-version omitirá metadados (como informações de licença) para versões do pacote Maven que dependem de uma referência parent para conter esses metadados.

Exibir dependências de versão de pacote

Use o comando list-package-version-dependencies para obter uma lista das dependências de uma versão do pacote. O comando a seguir lista as dependências de um pacote npm chamado my-package, versão 4.41.5, no repositório my_repo, no domínio 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

A saída deverá ser semelhante a:

{
  "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 o intervalo de valores compatíveis com o campo dependencyType, consulte o tipo de PackageDependencydados na CodeArtifact API.

Exibir arquivo readme da versão do pacote

Alguns formatos de pacote, como npm, incluem um arquivo README. Use get-package-version-readme para obter o arquivo README de uma versão do pacote. O comando a seguir retorna o arquivo README de um pacote npm chamado my-package, versão 4.41.5, no repositório my_repo, no domínio my_domain.

nota

CodeArtifact não suporta a exibição de arquivos readme de pacotes genéricos 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

A saída deverá ser semelhante a:

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