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á.
# Criação de instruções de uso de produtos de contêiner e AMI para AWS Marketplace
Como AWS Marketplace vendedor, você entrega seus produtos aos compradores de maneiras diferentes. Ao entregar com Amazon Machine Images (AMIs) e imagens de contêiner, você é responsável por escrever instruções de uso para elas. As seções a seguir apresentam os requisitos e as recomendações sobre como gravar instruções de uso para esses tipos de produto.
Para obter mais informações, consulte [Produtos baseados em AMI no AWS Marketplace](ami-products.md).
**Topics**
+ [Requisitos](#ami-write-usage-instructions)
+ [Gravação das notas de versão](#writing-the-release-notes)
+ [Gravação das instruções de uso](#writing-the-usage-instructions)
+ [Gravação das instruções de upgrade](#writing-upgrade-instructions)
+ [Escrevendo instruções CloudFormation de entrega](#ami-cloudformation-delivery)
## Requisitos
Ao criar instruções de uso para seu produto, você deve incluir as seguintes informações:
+ Localização de todas as informações confidenciais salvas pelos clientes.
+ Explique toda a configuração da criptografia de dados. Forneça instruções detalhadas sobre como o usuário interage com a aplicação para descriptografar dados necessários se a aplicação fizer uso de alguma técnica de criptografia.
+ Se o produto incluir material criptográfico, você deverá incluir requisitos de rodízio nas instruções de uso. Consulte [Requisitos de produto baseados em AMI para AWS Marketplace](product-and-ami-policies.md) para saber os requisitos básicos das listas que usam credenciais e chaves criptográficas.
+ Se algum dos armazenamentos de dados em seu produto for proprietário, forneça step-by-step instruções para configuração, backup e recuperação.
+ Step-by-step instruções sobre como avaliar e monitorar a saúde e o funcionamento adequado do aplicativo. Por exemplo:
+ Navegue até o [console do Amazon EC2](https://us-east-1.signin.aws.amazon.com/oauth?response_type=code&client_id=arn%3Aaws%3Aiam%3A%3A015428540659%3Auser%2Fec2&redirect_uri=https%3A%2F%2Fus-east-1.console.aws.amazon.com%2Fec2%2Fv2%2Fhome%3Fregion%3Dus-east-1%26state%3DhashArgs%2523Home%253A%26isauthcode%3Dtrue&forceMobileLayout=0&forceMobileApp=0&code_challenge=aRqwDZ0gdWGXfWQgSpY_ge8vSRw2poGnBZ_8qsU5fiA&code_challenge_method=SHA-256) e verifique se você está na região correta.
+ Escolha **Instância** e selecione a instância executada.
+ Selecione o servidor para exibir a página de metadados e escolha a guia **Verificações de status** na parte inferior da página para verificar se suas verificações de status foram aprovadas ou falharam.
+ Orientação prescritiva sobre o gerenciamento de cotas de AWS serviços. Para obter mais informações, consulte [Guia de referência geral da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).
+ Um detalhamento de preços, incluindo o custo dos AWS recursos operacionais adicionados acima da cota padrão. Isso pode ser incluído nas instruções de uso do produto ou vinculado à [documentação](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) contendo informações detalhadas sobre como gerenciar e solicitar maiores cotas de serviço.
## Gravação das notas de versão
Cada vez que atualizar um produto, será necessário fornecer uma descrição das alterações nas notas de lançamento. As notas de lançamento devem conter informações específicas para ajudar o usuário a decidir se deseja instalar a atualização. Use etiquetas claras para a atualização, como "Essencial" para uma atualização de segurança e "Importante" ou "Opcional" para outros tipos de atualizações.
## Gravação das instruções de uso
Forneça instruções de uso que ajudam a garantir que o comprador possa configurar e executar o software com êxito. As instruções de uso fornecidas são mostradas durante o processo de configuração.
Para escrever instruções de uso eficazes, siga estas diretrizes:
+ Suponha que o usuário esteja interessado, mas desinformado.
+ Forneça ao usuário todas as informações necessárias para lançar e usar seu produto, incluindo quaisquer configurações e etapas especiais.
Exemplo de instruções de uso:
1. Inicialize o produto usando o 1-Click.
1. Use um navegador da Web para acessar a aplicação em `https:///index.html`.
1. Faça login usando as seguintes credenciais:
+ Nome de usuário: `user`
+ Senha: o ID da instância (`instance_id`)
## Gravação das instruções de upgrade
Forneça detalhes sobre como o comprador pode atualizar a partir de uma versão anterior do produto. Inclua informações sobre como preservar dados e configurações ao criar outra instância. Se não houver caminho de atualização, edite esse campo para mencionar especificamente isso.
Exemplo de instruções de atualização:
1. Faça \*\*\*\* e \*\*\*\*.
1. Verifique se todos os plug-ins usados por seu projeto são compatíveis com a versão \*.\*, executando \*\*\*. Se não forem compatíveis, \*\*\*.
1. Faça um backup de seus dados. Para isso, \*\*\*.
## Escrevendo instruções CloudFormation de entrega
Ao usar a CloudFormation entrega, você também deve incluir o seguinte:
+ Uma finalidade para cada função AWS Identity and Access Management (IAM) e política do IAM criada pelo CloudFormation modelo
+ A finalidade e a localização de cada chave criada pelo CloudFormation modelo
+ Detalhes da configuração de rede em implantações envolvendo mais de um único elemento
+ Um guia detalhado sobre como seus aplicativos são lançados e como eles são configurados para se comunicar se a implantação incluir vários AWS recursos
+ Um detalhamento de preços que inclui o custo dos AWS recursos operacionais adicionados acima dos limites padrão. Forneça orientação prescritiva sobre como gerenciar os limites do AWS serviço.
+ Toda a configuração da criptografia de dados. Por exemplo: criptografia do lado do servidor do Amazon S3, criptografia do Amazon Elastic Block Store (Amazon EBS), Linux Unified Key Setup (LUKS) etc.)