Solução de problemas do AWS Systems ManagerDistributor

As informações a seguir podem ajudá-lo a solucionar problemas que podem ocorrer ao usar o Distributor, uma ferramenta do AWS Systems Manager.

Pacote incorreto com o mesmo nome está instalado

Problema: você instalou um pacote, mas o Distributor instalou um pacote diferente.

Causa: durante a instalação, o Systems Manager localiza pacotes publicados pela AWS como resultados, antes dos pacotes externos definidos pelo usuário. Se o nome do pacote definido pelo usuário for o mesmo que um nome de pacote publicado pela AWS, o pacote da AWS será instalado em vez do seu pacote.

Solução: para evitar esse problema, dê um nome ao seu pacote que seja diferente do nome de um pacote publicado pela AWS.

Erro: falha ao recuperar manifesto: não foi possível encontrar a versão mais recente do pacote

Problema: você recebeu um erro semelhante ao seguinte:

Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package 
arn:aws:ssm:::package/package-name status code: 400, request id: guid

Causa: você está usando uma versão do SSM Agent cujo com o Distributor, que é anterior à versão 2.3.274.0.

Solução: atualize a versão do SSM Agent para a versão 2.3.274.0 ou posterior. Para ter mais informações, consulte Atualização do SSM Agent por meio de Run Command ou Walkthrough: Automatically update SSM Agent with the AWS CLI.

Erro: falha ao recuperar manifesto: exceção de validação

Problema: você recebeu um erro semelhante ao seguinte:

Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn'
at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern:
arn:aws:ssm:region-id:account-id:package/package-name

Causa: você está usando uma versão do SSM Agent cujo com o Distributor, que é anterior à versão 2.3.274.0.

Solução: atualize a versão do SSM Agent para a versão 2.3.274.0 ou posterior. Para ter mais informações, consulte Atualização do SSM Agent por meio de Run Command ou Walkthrough: Automatically update SSM Agent with the AWS CLI.

O pacote não é compatível (a ação de instalação está faltando no pacote)

Problema: você recebeu um erro semelhante ao seguinte:

Package is not supported (package is missing install action)

Causa: a estrutura do diretório do pacote está incorreta.

Solução: não compacte um diretório pai contendo o software e os scripts necessários. Em vez disso, crie um arquivo .zip de todos os conteúdos necessários diretamente no caminho absoluto. Para verificar se o .zip foi criado corretamente, descompacte o diretório da plataforma de destino e revise a estrutura do diretório. Por exemplo, o caminho absoluto do script de instalação deve ser /ExamplePackage_targetPlatform/install.sh.

Erro: Falha ao baixar o manifesto: Documento com nome não existe

Problema: você recebeu um erro semelhante ao seguinte:

Failed to download manifest - failed to retrieve package document description: InvalidDocument: Document with name filename does not exist.

Causa 1: o Distributor não consegue encontrar o pacote pelo nome ao compartilhar um pacote do Distributor de outra conta.

Solução 1: ao compartilhar um pacote de outra conta, use o nome do recurso da Amazon (ARN) completo do pacote, não apenas o nome.

Causa 2: ao usar uma VPC, você não forneceu ao seu perfil de instância do IAM acesso ao bucket do S3 gerenciado pela AWS que contém o documento AWS-ConfigureAWSPackage para a Região da AWS que você está direcionando.

Solução 2: certifique-se de que seu perfil de instância do IAM forneça ao SSM Agent acesso ao bucket do S3 gerenciado pela AWS que contém o documento AWS-ConfigureAWSPackage para a Região da AWS que você está direcionando, conforme explicado em Comunicações do SSM Agent com os buckets do S3 gerenciados pela AWS.

O upload falhou.

Problema: você recebeu um erro semelhante a este.

Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.

Causa: o nome do pacote de software inclui um espaço. Por exemplo, Hello World.msi falharia no upload.