As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Publicando e consumindo pacotes genéricos
<a name="publishing-using-generic-packages"></a>

Para publicar uma versão genérica do pacote e seus ativos relacionados, use o comando `publish-package-version`. Você pode listar os ativos de um pacote genérico usando o comando `list-package-version-asset` e baixá-los usando `get-package-version-asset`. O tópico a seguir contém step-by-step instruções para publicar pacotes genéricos ou baixar ativos de pacotes genéricos usando esses comandos.

## Publicando um pacote genérico
<a name="publishing-generic-packages"></a>

Um pacote genérico consiste em um nome de pacote, namespace, versão e um ou mais ativos (ou arquivos). Este tópico demonstra como publicar um pacote chamado `my-package`, com o namespace `my-ns`, a versão `1.0.0` e contendo um ativo chamado `asset.tar.gz`.

**Pré-requisitos:**
+ Configure e configure o AWS Command Line Interface com CodeArtifact (consulte[Configurando com AWS CodeArtifact](get-set-up-for-codeartifact.md))
+ Tenha um CodeArtifact domínio e um repositório (consulte[Conceitos básicos do uso da AWS CLI](getting-started-cli.md))

**Para publicar um pacote genérico**

1. Use o comando a seguir para gerar o SHA256 hash para cada arquivo que você deseja carregar em uma versão do pacote e coloque o valor em uma variável de ambiente. Esse valor é usado como uma verificação de integridade para conferir se o conteúdo do arquivo não foi alterado após o envio original. 

------
#### [ Linux ]

   ```
   export ASSET_SHA256=$(sha256sum asset.tar.gz | awk '{print $1;}')
   ```

------
#### [ macOS ]

   ```
   export ASSET_SHA256=$(shasum -a 256 asset.tar.gz | awk '{print $1;}')
   ```

------
#### [ Windows ]

   ```
   for /f "tokens=*" %G IN ('certUtil -hashfile asset.tar.gz SHA256 ^| findstr /v "hash"') DO SET "ASSET_SHA256=%G"
   ```

------

1. Chame `publish-package-version` para carregar o pacote e criar uma nova versão dele.
**nota**  
 Se seu pacote contiver mais de um ativo, você poderá chamar `publish-package-version` uma vez para que cada ativo seja carregado. Inclua o argumento `--unfinished` para cada chamada de `publish-package-version`, exceto ao fazer o carregamento do ativo final. Omitir `--unfinished` definirá o status da versão do pacote como `Published` e impedirá que ativos adicionais sejam enviados para ele.  
 Como alternativa, inclua `--unfinished` para cada chamada de `publish-package-version` e, em seguida, defina o status da versão do pacote como `Published` usando o comando `update-package-versions-status`.

------
#### [ Linux/macOS ]

   ```
   aws codeartifact publish-package-version --domain my_domain --repository my_repo \
         --format generic --namespace my-ns --package my-package --package-version 1.0.0 \
         --asset-content asset.tar.gz --asset-name asset.tar.gz \
         --asset-sha256 $ASSET_SHA256
   ```

------
#### [ Windows ]

   ```
   aws codeartifact publish-package-version --domain my_domain --repository my_repo ^
         --format generic --namespace my-ns --package my-package --package-version 1.0.0 ^
         --asset-content asset.tar.gz --asset-name asset.tar.gz ^  
         --asset-sha256 %ASSET_SHA256%
   ```

------

   A seguir, é mostrada a saída.

   ```
   {
       "format": "generic",
       "namespace": "my-ns",
       "package": "my-package",
       "version": "1.0.0",
       "versionRevision": "REVISION-SAMPLE-1-C7F4S5E9B772FC",
       "status": "Published",
       "asset": {
           "name": "asset.tar.gz",
           "size": 11,
           "hashes": {
               "MD5": "41bba98d5b9219c43089eEXAMPLE-MD5",
               "SHA-1": "69b215c25dd4cda1d997a786ec6EXAMPLE-SHA-1",
               "SHA-256": "43f24850b7b7b7d79c5fa652418518fbdf427e602b1edabe6EXAMPLE-SHA-256",
               "SHA-512": "3947382ac2c180ee3f2aba4f8788241527c8db9dfe9f4b039abe9fc560aaf5a1fced7bd1e80a0dca9ce320d95f0864e0dec3ac4f2f7b2b2cbEXAMPLE-SHA-512"
           }
       }
   }
   ```

## Listando ativos de pacotes genéricos
<a name="listing-generic-package-assets"></a>

Para listar os ativos contidos em um pacote genérico, use o comando `list-package-version-assets`. Para obter mais informações, consulte [Listar ativos da versão do pacote](list-assets.md).

O exemplo a seguir lista os ativos da versão `1.0.0` do pacote `my-package`.

**Para listar ativos da versão do pacote**
+ Chame `list-package-version-assets` para listar os ativos contidos em um pacote genérico.

------
#### [ Linux/macOS ]

  ```
  aws codeartifact list-package-version-assets --domain my_domain \
    --repository my_repo --format generic --namespace my-ns \
    --package my-package --package-version 1.0.0
  ```

------
#### [ Windows ]

  ```
  aws codeartifact list-package-version-assets --domain my_domain ^
    --repository my_repo --format generic --namespace my-ns ^
    --package my-package --package-version 1.0.0
  ```

------

  A seguir, é mostrada a saída.

  ```
  {
      "assets": [
          {
              "name": "asset.tar.gz",
              "size": 11,
              "hashes": {
                  "MD5": "41bba98d5b9219c43089eEXAMPLE-MD5",
                  "SHA-1": "69b215c25dd4cda1d997a786ec6EXAMPLE-SHA-1",
                  "SHA-256": "43f24850b7b7b7d79c5fa652418518fbdf427e602b1edabe6EXAMPLE-SHA-256",
                  "SHA-512": "3947382ac2c180ee3f2aba4f8788241527c8db9dfe9f4b039abe9fc560aaf5a1fced7bd1e80a0dca9ce320d95f0864e0dec3ac4f2f7b2b2cbEXAMPLE-SHA-512"
              }
          }
      ],
      "package": "my-package",
      "format": "generic",
      "namespace": "my-ns",
      "version": "1.0.0",
      "versionRevision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"
  }
  ```

## Baixando ativos de pacotes genéricos
<a name="downloading-generic-package-assets"></a>

Para baixar os ativos de um pacote genérico, use o comando `get-package-version-asset`. Para obter mais informações, consulte [Baixe ativos da versão do pacote](download-assets.md).

O exemplo a seguir baixa o ativo `asset.tar.gz` da versão `1.0.0` do pacote `my-package` para o diretório de trabalho atual em um arquivo também chamado `asset.tar.gz`.

**Para baixar ativos da versão do pacote**
+ Chame `get-package-version-asset` para baixar ativos de um pacote genérico.

------
#### [ Linux/macOS ]

  ```
  aws codeartifact get-package-version-asset --domain my_domain \
    --repository my_repo --format generic --namespace my-ns --package my-package \
    --package-version 1.0.0 --asset asset.tar.gz \ 
    asset.tar.gz
  ```

------
#### [ Windows ]

  ```
  aws codeartifact get-package-version-asset --domain my_domain ^
    --repository my_repo --format generic --namespace my-ns --package my-package ^
    --package-version 1.0.0 --asset asset.tar.gz ^
    asset.tar.gz
  ```

------

  A seguir, é mostrada a saída.

  ```
  {
      "assetName": "asset.tar.gz",
      "packageVersion": "1.0.0",
      "packageVersionRevision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"
  }
  ```