Criar produtos

Você cria os produtos na página Products (Produtos) no console do administrador do AWS Service Catalog.

nota

A criação de produtos Terraform exige configuração adicional, incluindo um mecanismo de provisionamento do Terraform e um perfil de lançamento. Para obter mais informações, consulte Conceitos básicos de um produto Terraform.

Para criar um novo produto do AWS Service Catalog

1. Navegue até a página Lista de produtos.

2. Escolha Criar produto e, em seguida, escolha Criar produto.

3. Detalhes do produto - permite que você escolha o tipo de produto que deseja criar. AWS Service Catalog oferece suporte aos tipos de produtos AWS CloudFormation, Terraform Cloud e Externo (suporta Terraform Community Edition). Os detalhes do produto também contêm os metadados que aparecem quando você pesquisa e visualiza produtos em uma lista ou página de detalhes. Insira o seguinte:

   • Nome do produto – o nome do produto.

   • Descrição do produto - a descrição aparece na lista de produtos para ajudar você a escolher o produto correto.

   • Proprietário - a pessoa ou organização que publica este produto. O proprietário pode ser o nome da sua organização de TI ou administrador.

   • Distribuidor (opcional) - o nome do publicador do aplicativo. Esse campo permite que os usuários classifiquem sua lista de produtos para facilitar a localização dos produtos necessários.

4. Os detalhes da versão permitem que você adicione seu arquivo de modelo e crie seu produto. Insira o seguinte:

   • Escolha o método - há quatro maneiras de adicionar um arquivo de modelo.

     • Use um arquivo de modelo local - carregue um modelo AWS CloudFormation ou um arquivo de configuração tar.gz do Terraform a partir de uma unidade local.

     • Use uma URL do Amazon S3 - especifique uma URL que aponte para um modelo AWS CloudFormation ou arquivo de configuração tar.gz do Terraform armazenado no Amazon S3. Se você especificar uma URL do Amazon S3, ele deverá começar com https://.

     • Use um repositório externo: especifique seu repositório de código GitHub, GitHub Enterprise ou Bitbucket. AWS Service Catalogpermite sincronizar produtos com arquivos de modelo. Para produtos Terraform, é necessário que o formato do arquivo de modelo seja um único arquivo arquivado em Tar e compactado em Gzip.

     • Use uma CloudFormation pilha existente - insira o ARN de uma CloudFormation pilha existente. Este método não oferece suporte a produtos Terraform Cloud ou externos.

   • Nome da versão (opcional) - o nome da versão do produto (por exemplo, “v1”, “v2beta”). Espaços não são permitidos.

   • Descrição (opcional) - uma descrição da versão do produto, incluindo como essa versão difere da versão anterior.

   • Orientação - Gerenciado na guia Versões em uma página Detalhes do produto. Quando uma versão do produto é criada, durante o fluxo de trabalho de criação do produto, a orientação para essa versão é definida como padrão. Para saber mais sobre orientação, consulte Gerenciamento de versões.

5. Detalhes do suporte identificam a organização dentro da sua empresa e fornecem um ponto de contato para suporte. Insira o seguinte:

   • Contato por e-mail (opcional) – o endereço de e-mail para relatório de problemas com o produto.

   • Link de suporte (opcional) – uma URL de um site onde os usuários podem localizar informações de suporte ou abrir tickets. A URL deve começar com http:// ou https://. Os administradores são responsáveis por manter a precisão e o acesso às informações de suporte.

   • Descrição do suporte (opcional) – uma descrição de como os usuários devem usar o Contato por e-mail e o Link de suporte.

6. Gerenciar tags (opcional) - além de usar tags para categorizar seus recursos, você também pode usá-las para autenticar suas permissões para criar esse recurso.

7. Criar produto - depois de preencher o formulário, selecione Criar produto. Após alguns segundos, o produto será exibido na página Lista de produtos. Talvez seja necessário atualizar o navegador para ver o produto.

Você também pode usar CodePipeline para criar e configurar um pipeline para implantar seu modelo de produto AWS Service Catalog e entregar as alterações que você fez no seu repositório de origem. Para obter mais informações, consulte Tutorial: criar um pipeline que seja implantado no AWS Service Catalog.

Você pode definir propriedades de parâmetros em seu modelo AWS CloudFormation ou no modelo do Terraform e aplicar essas regras durante o provisionamento. Essas propriedades podem definir o comprimento mínimo e máximo, os valores mínimo e máximo, os valores permitidos e uma expressão regular para o valor. AWS Service Catalog emite um aviso durante o provisionamento se o valor fornecido não estiver de acordo com a propriedade do parâmetro. Para saber mais sobre as propriedades dos parâmetros, consulte Parâmetros no Guia do Usuário AWS CloudFormation.

Solução de problemas

É necessário ter permissão para recuperar objetos dos buckets do Amazon S3. Caso contrário, você poderá encontrar a seguinte mensagem de erro ao iniciar ou atualizar um produto.

Error: failed to process product version s3 access denied exception

Se você encontrar essa mensagem, certifique-se de ter permissão para recuperar objetos dos seguintes buckets:

• O bucket em que o modelo do artefato de provisionamento é armazenado.

• O bucket que começa com “cf-templates-*” e onde AWS Service Catalog armazena o modelo do artefato de provisionamento.

• O bucket interno que começa com “sc-*” e onde AWS Service Catalog armazena os metadados. Não será possível ver esse bucket na sua conta.

O exemplo de política a seguir mostra as permissões mínimas necessárias para recuperar objetos dos buckets mencionados anteriormente.

{
          "Sid": "VisualEditor1",
          "Effect": "Allow",
          "Action": "s3:GetObject*",
          "Resource": [
              "arn:aws:s3:::YOUR_TEMPLATE_BUCKET",
              "arn:aws:s3:::YOUR_TEMPLATE_BUCKET/*",
              "arn:aws:s3:::cf-templates-*",
              "arn:aws:s3:::cf-templates-*/*",
              "arn:aws:s3:::sc-*",
              "arn:aws:s3:::sc-*/*"
          ]
      }