Adicionar uma versão a um pacote do Distributor - AWS Systems Manager
Adicionar uma versão de pacote usando o consoleAdicionar uma versão de pacote usando a AWS CLI

Adicionar uma versão a um pacote do Distributor

Para adicionar uma versão do pacote, crie um pacote e use o Distributor para adicionar uma versão do pacote, acrescentando uma entrada ao documento AWS Systems Manager (SSM) que já existe para versões mais antigas. O Distributor é um recurso do AWS Systems Manager. Para economizar tempo, atualize o manifesto para uma versão mais antiga do pacote, altere o valor da entrada version no manifesto (por exemplo, de Test_1.0 para Test_2.0) e salve-o como manifesto para a nova versão. O fluxo de trabalho simples Add version (Adicionar versão) no console do Distributor faz a atualização do arquivo de manifesto para você.

Uma nova versão do pacote pode:

  • Substituir pelo menos um dos arquivos de instalação anexados à versão atual.

  • Adicionar novos arquivos de instalação para oferecer suporte a mais plataformas.

  • Excluir arquivos para interromper o suporte para plataformas específicas.

Uma versão mais recente pode usar o mesmo bucket do Amazon Simple Storage Service (Amazon S3), mas deve ter um URL com outro nome de arquivo mostrado no final. É possível usar o console do Systems Manager ou a AWS Command Line Interface (AWS CLI) para adicionar a nova versão. Carregar um arquivo de instalação com o nome exato de um arquivo de instalação existente no bucket do Amazon S3 substitui o arquivo existente. Nenhum arquivo de instalação será copiado da versão mais antiga para a nova. Você deve fazer upload dos arquivos de instalação da versão mais antiga para que eles façam parte de uma nova versão. Depois que o Distributor terminar de criar a nova versão do pacote, você poderá excluir ou redefinir o bucket do Amazon S3, porque o Distributor copia seu software em um bucket interno do Systems Manager como parte do processo de versionamento.

nota

Cada pacote é mantido em um máximo de 25 versões. Você pode excluir versões que não são mais necessárias.

Adicionar uma versão de pacote usando o console

Antes de realizar estas etapas, siga as instruções em Criar um pacote no Distributor a fim de criar um pacote para a versão. Então, use o console do Systems Manager para adicionar uma nova versão de pacote ao Distributor.

Adicionar uma versão de pacote usando o fluxo de trabalho Simples

Para adicionar uma versão do pacote usando o fluxo de trabalho Simple (Simples), prepare os arquivos de instalação atualizados ou adicione arquivos instaláveis com suporte a mais plataformas e arquiteturas. Depois, use o Distributor para fazer upload de arquivos de instalação novos e atualizados e adicionar uma versão do pacote. O fluxo de trabalho simplificado Add version (Adicionar versão) no console do Distributor faz a atualização do arquivo de manifesto e o documento SSM associado para você.

Para adicionar uma versão de pacote usando o fluxo de trabalho Simples

  1. Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

  2. No painel de navegação, escolha Distributor.

  3. Na página inicial do Distributor, selecione o pacote ao qual você deseja adicionar outra versão.

  4. Na página Add version (Adicionar versão), escolha Simple (Simples).

  5. Em Version name (Nome da versão), digite um nome para a versão. O nome da versão nova precisa ser diferente do antigo. Os nomes de versões podem ter no máximo 512 caracteres e não devem conter caracteres especiais.

  6. Em S3 bucket name (Nome do bucket do S3), escolha um bucket do S3 existente na lista. Ele pode ser o mesmo bucket que você usou para armazenar arquivos de instalação de versões mais antigas, mas os nomes dos arquivos de instalação precisam ser diferentes para evitar substituições de arquivos existentes no bucket.

  7. Em S3 key prefix (Prefixo de chave do S3), insira a subpasta do bucket em que os ativos instaláveis estão armazenados.

  8. Em Upload software (Fazer upload de software), procure os arquivos de software instaláveis que você quiser anexar à nova versão. Os arquivos de instalação de versões existentes não são automaticamente copiados para uma nova versão. Você precisa fazer upload dos arquivos de instalação de versões mais antigas do pacote se quiser que qualquer um dos mesmos arquivos de instalação façam parte da nova versão. Você pode fazer upload de mais de um arquivo de software com uma única ação.

  9. Em Target platform (Plataforma de destino), verifique se a plataforma do sistema operacional de destino exibida para cada arquivo de instalação está correta. Se o sistema operacional correto não for o exibido, escolha o correto na lista suspensa.

    No fluxo de trabalho de versionamento Simple (Simples), como você carrega cada arquivo de instalação somente uma vez, etapas adicionais são necessárias para direcionar um único arquivo a mais de um sistema operacional. Por exemplo, se você carregar um arquivo de software instalável chamado Logtool_v1.1.1.rpm, você precisará alterar alguns valores padrão no fluxo de trabalho Simple (Simples) para instruir o Distributor a direcionar o mesmo software aos dois sistemas operacionais, Amazon Linux e Ubuntu. Você pode seguir um dos seguintes procedimentos para contornar essa limitação.

    • Use o fluxo de trabalho de versionamento Advanced (Avançado), compacte cada arquivo de instalação em um arquivo .zip antes de começar e crie o manifesto manualmente de modo que aquele arquivo de instalação possa ser direcionado a mais de uma plataforma ou versão de sistema operacional. Para ter mais informações, consulte Adicionar uma versão de pacote usando o fluxo de trabalho Avançado.

    • Edite manualmente o arquivo manifesto no fluxo de trabalho Simple (Simples) para que seu arquivo .zip seja direcionado a mais de uma plataforma ou versão de sistema operacional. Para obter mais informações sobre como fazer isso, consulte o final da etapa 4 em Etapa 2: Criar o manifesto do pacote JSON.

  10. Em Platform version (Versão da plataforma), verifique se a versão exibida da plataforma do sistema operacional é _any, uma versão importante seguida pelo curinga (7.*) ou a versão específica do sistema operacional ao qual você deseja que o software se aplique. Para obter mais informações sobre como especificar uma versão de plataforma, consulte a etapa 4 em Etapa 2: Criar o manifesto do pacote JSON.

  11. Em Architecture (Arquitetura) escolha, na lista suspensa, a arquitetura do processador correta para cada arquivo de instalação. Para obter mais informações sobre as arquiteturas compatíveis, consulte Plataformas de pacotes e arquiteturas compatíveis.

  12. (Opcional) Expanda Scripts e revise os scripts de instalação e desinstalação que o Distributor gerou para o software instalável.

  13. Para adicionar mais arquivos de software instaláveis à nova versão, escolha Add software (Adicionar software). Senão, siga para a próxima etapa.

  14. (Opcional) Expanda Manifest (Manifesto) e revise o manifesto do pacote JSON que o Distributor gerou para o software instalável. Se você tiver alterado qualquer informação sobre seu software instalável desde que começou esse procedimento, como a versão da plataforma ou plataforma de destino, escolha Generate manifest (Gerar manifesto) para exibir o manifesto do pacote atualizado.

    Você pode editar o manifesto manualmente se quiser direcionar o software instalável para mais de um sistema operacional, conforme descrito na etapa 9. Para obter mais informações sobre a edição de manifesto, consulte Etapa 2: Criar o manifesto do pacote JSON.

  15. Quando terminar de adicionar o software e revisar os dados da plataforma de destino, da versão e da arquitetura, escolha Add version (Adicionar versão).

  16. Aguarde até que o Distributor termine de carregar o software e criar sua nova versão do pacote. O Distributor mostra o status do upload de cada arquivo de instalação. Dependendo do número e do tamanho dos pacotes que você está adicionando, isso pode levar alguns minutos. O Distributor automaticamente redirecionará você para a página Package details (Detalhes do pacote) do pacote, mas você pode optar por abri-la após o software ser carregado. A página Package details (Detalhes do pacote) não mostra todas as informações sobre ele quando o Distributor finalizar o processo de criação do novo pacote. Para interromper o upload e criação da versão do pacote, escolha Stop upload (Parar upload).

  17. Se o Distributor não conseguir fazer upload de qualquer um dos arquivos de instalação do software, ele exibirá a mensagem Upload failed (Falha no upload). Para tentar fazer upload novamente, escolha Retry upload (Tentar novamente). Para obter mais informações sobre como solucionar as falhas de criação da versão do pacote, consulte Solução de problemas do AWS Systems ManagerDistributor.

  18. Quando o Distributor terminar de criar a nova versão do pacote, na página de Details (Detalhes) do pacote, na guia Versions (Versões), visualize a nova versão na lista versões disponíveis do pacote. Defina uma versão padrão do pacote escolhendo uma versão e, em seguida, escolhendo Set default version (Definir versão padrão).

    Se você não definir uma versão padrão, a versão mais recente do pacote será a versão padrão.

Adicionar uma versão de pacote usando o fluxo de trabalho Avançado

Para adicionar uma versão do pacote, crie um pacote e use o Distributor para adicionar uma versão do pacote, adicionando uma entrada ao documento que existe para versões mais antigas. Para economizar tempo, atualize o manifesto para uma versão mais antiga do pacote, altere o valor da entrada version no manifesto (por exemplo, de Test_1.0 para Test_2.0) e salve-o como manifesto para a nova versão. Você precisa ter um manifesto atualizado para adicionar uma nova versão do pacote usando o fluxo de trabalho Advanced (Avançado).

Para adicionar uma versão de pacote usando o fluxo de trabalho Avançado

  1. Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

  2. No painel de navegação, escolha Distributor.

  3. Na página inicial do Distributor, selecione o pacote ao qual você quer adicionar outra versão e escolha Add version (Adicionar versão).

  4. Em Version name (Nome da versão), insira o valor exato que está na entrada version do arquivo manifesto.

  5. Em S3 bucket name (Nome do bucket do S3), escolha um bucket do S3 existente na lista. Ele pode ser o mesmo bucket que você usou para armazenar arquivos de instalação de versões mais antigas, mas os nomes dos arquivos de instalação precisam ser diferentes para evitar substituições de arquivos existentes no bucket.

  6. Em S3 key prefix (Prefixo de chave do S3), insira a subpasta do bucket em que os ativos instaláveis estão armazenados.

  7. Em Manifest (Manifesto), escolha Extract from package (Extrair do pacote) para usar um manifesto enviado ao bucket do S3 com os arquivos .zip.

    (Opcional) Se você não carregou o manifesto JSON revisado no bucket do Amazon S3 em que armazenou os arquivos .zip, escolha New manifest (Novo manifesto). Você pode criar ou colar o manifesto inteiro no campo de edição JSON. Para obter mais informações sobre como criar o manifesto JSON, consulte Etapa 2: Criar o manifesto do pacote JSON.

  8. Quando terminar o manifesto, escolha Add package version (Adicionar versão do pacote).

  9. Na página de Detalhes do pacote, na guia Versions, visualize a nova versão na lista de versões de pacote disponíveis. Defina uma versão padrão do pacote escolhendo uma versão e, em seguida, escolhendo Set default version (Definir versão padrão).

    Se você não definir uma versão padrão, a versão mais recente do pacote será a versão padrão.

Adicionar uma versão de pacote usando a AWS CLI

Você pode usar a AWS CLI para adicionar uma nova versão de pacote ao Distributor. Antes de executar esses comandos, você deve criar uma nova versão do pacote e fazer upload dela no S3, como descrito no início deste tópico.

Para adicionar uma versão de pacote usando a AWS CLI

  1. Execute o comando a seguir para editar o documento do AWS Systems Manager com uma entrada para uma nova versão do pacote. Substitua document-name pelo nome do seu documento. Substitua amzn-s3-demo-bucket pela URL do manifesto JSON que você copiou em Etapa 3: Fazer upload do pacote e do manifesto em um bucket do Amazon S3. S3-bucket-URL-of-package é a URL do bucket do Amazon S3 no qual o pacote inteiro está armazenado. Substitua version-name-from-updated-manifest pelo valor de version no manifesto. Defina o parâmetro --document-version para $LATEST para fazer o documento associado a essa versão do pacote a versão mais recente do documento.

    aws ssm update-document \
    --name "document-name" \
    --content "S3-bucket-URL-to-manifest-file" \
    --attachments Key="SourceUrl",Values="amzn-s3-demo-bucket" \
    --version-name version-name-from-updated-manifest \
    --document-version $LATEST

    Veja um exemplo a seguir.

    aws ssm update-document \
    --name ExamplePackage \
    --content "https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage/manifest.json" \
    --attachments Key="SourceUrl",Values="https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage" \
    --version-name 1.1.1 \
    --document-version $LATEST

  2. Execute o seguinte comando para verificar se o pacote foi atualizado e mostrar o manifesto do pacote. Substitua package-name pelo nome de seu pacote e, opcionalmente, document-version pelo número da versão do documento (não o mesmo que a versão do pacote) que você atualizou. Se essa versão do pacote estiver associada à versão mais recente do documento, você pode especificar $LATEST para o valor do parâmetro opcional --document-version.

    aws ssm get-document \
    --name "package-name" \
    --document-version "document-version"

Para obter informações sobre outras opções que podem ser usadas com o comando update-document, consulte update-document na seção AWS Systems Manager da Referência de comando da AWS CLI.