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á. # Gerenciar produtos Você pode criar e atualizar produtos criando uma nova versão com base em um modelo atualizado e agrupar produtos em portfólios para distribuí-los aos usuários. As novas versões de produtos são propagadas para todos os usuários que tenham acesso ao produto por meio de um portfólio. Quando você distribui uma atualização, os usuários finais podem atualizar produtos provisionados existentes. **Topics** + [Visualizar a página de produtos](#productmgmt-menu) + [Criar produtos](productmgmt-cloudresource.md) + [Adicionar produtos a portfólios](catalogs_portfolios_adding-products.md) + [Atualizar produtos](productmgmt-update.md) + [Sincronização de produtos com arquivos de modelo do GitHub, GitHub Enterprise ou Bitbucket](git-synced-sc-products.md) + [Excluir produtos](productmgmt-delete.md) + [Gerenciar versões](managing-versions.md) ## Visualizar a página de produtos Você gerencia **produtos na página Lista de produtos** no console AWS Service Catalog do administrador. **Visualizar a página **Lista de produtos**** 1. Abra o console do Service Catalog em [https://console.aws.amazon.com/servicecatalog/](https://console.aws.amazon.com/servicecatalog/). 1. Escolha **Lista de produtos**. # Criar produtos Você cria produtos na página **Produtos** no console do AWS Service Catalog administrador. **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](getstarted-Terraform.md). **Para criar um novo AWS Service Catalog produto** 1. Navegue até a página **Lista de produtos**. 1. Escolha **Criar produto** e, em seguida, escolha **Criar produto**. 1. **Detalhes do produto** — Permite que você escolha o tipo de produto que deseja criar. AWS Service Catalog suporta os CloudFormation tipos de produtos Terraform Cloud e External (compatível com 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. 1. **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 CloudFormation modelo ou um arquivo de configuração tar.gz do Terraform a partir de uma unidade local. + **Use um URL do Amazon S3** - especifique um URL que aponte para um modelo 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 Catalog permite 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](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/managing-versions.html). 1. **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): um 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**. 1. **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. 1. **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 é implantado em AWS Service Catalog](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-S3-servicecatalog.html). Você pode definir propriedades de parâmetros em seu modelo 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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) no *Guia do Usuário 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-\$1***" e onde AWS Service Catalog armazena o modelo do artefato de provisionamento. + O bucket interno que começa com "***sc-\$1***" 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-*/*" ] } ``` # Adicionar produtos a portfólios Você pode adicionar produtos em qualquer número de portfólios. Quando um produto é atualizado, todos os portfólios que contêm o produto recebem automaticamente a nova versão, incluindo portfólios compartilhados. **Para adicionar um produto de seu catálogo a um portfólio** 1. Navegue até a página **Lista de produtos**. 1. Selecione um produto e, em seguida, escolha **Ações**. No menu suspenso, escolha **Adicionar produto ao portfólio**. Você será direcionado para a página **Adicionar *name-of-product* ao portfólio**. 1. Escolha um portfólio e, em seguida, escolha **Adicionar produto ao portfólio**. Ao adicionar um produto Terraform a um portfólio, o produto requer uma restrição de lançamento. Você deve selecionar um perfil do IAM na sua conta, inserir um ARN do perfil do IAM ou inserir um nome de perfil. Se você especificar o nome do perfil, quando uma conta usar a restrição de lançamento, o perfil do IAM com esse nome na conta será usado. Isso permite que as restrições de perfil de lançamento sejam independentes da conta para que seja possível criar menos recursos por conta compartilhada. Para obter detalhes e instruções, consulte [Etapa 6: Adicionar uma restrição de lançamento ao seu produto Terraform](getstarted-launchconstraint-Terraform.md) Um portfólio pode conter vários produtos que são uma mistura de tipos CloudFormation de produtos Terraform. # Atualizar produtos Quando você precisa atualizar o modelo de um produto, você cria uma nova versão do produto. Novas versões do produto são disponibilizadas automaticamente para todos os usuários que têm acesso a um portfólio que contém o produto. **nota** Ao atualizar um produto existente, você não pode alterar o tipo de produto (CloudFormation ou o Teraform). Por exemplo, se você atualizar um CloudFormation produto, não poderá substituir o CloudFormation modelo existente por um arquivo de configuração tar.gz do Terraform. Você deve atualizar o arquivo CloudFormation de modelo existente com um novo arquivo CloudFormation de modelo. Os usuários finais que estiverem executando um produto provisionado da versão anterior do produto no momento podem atualizar seu produto provisionado para a nova versão. Quando uma nova versão de um produto está disponível, os usuários podem usar o comando **Atualizar produto provisionado** nas páginas **Lista de produto provisionado** ou **Detalhes do produto provisionado**. Antes de criar uma nova versão de um produto, AWS Service Catalog recomenda que você teste as atualizações do produto no mecanismo Terraform CloudFormation ou no mecanismo Terraform para garantir que elas funcionem corretamente. **Para criar uma nova versão do produto** 1. Navegue até a página **Lista de produtos**. 1. Escolha o produto que você deseja atualizar. Você será direcionado para a página de *Detalhes do produto*. 1. Na página *Detalhes do produto*, expanda a guia **Versões** e, em seguida, escolha **Criar nova versão**. 1. Em **Detalhes da versão**, faça o seguinte: + **Escolha o modelo** - há quatro maneiras de adicionar um arquivo de modelo. *Use um arquivo de modelo local* - Carregue um CloudFormation modelo ou um arquivo de configuração tar.gz do Terraform a partir de uma unidade local. *Use um URL do Amazon S3* - especifique um URL que aponte para um modelo CloudFormation ou arquivo de configuração tar.gz do Terraform armazenado no Amazon S3. Se você especificar um URL do Amazon S3, dele deverá começar com https://. *Use um repositório externo*: especifique seu repositório de código GitHub, GitHub Enterprise ou Bitbucket. AWS Service Catalog permite 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. + **Bloco de versã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. 1. Escolha **Criar versão de produto**. Você também pode usar CodePipeline para criar e configurar um pipeline para implantar seu modelo de produto e entregar suas alterações em seu repositório de origem. AWS Service Catalog Para obter mais informações, consulte [Tutorial: Criar um pipeline que seja implantado em AWS Service Catalog](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-S3-servicecatalog.html). # Sincronização de produtos com arquivos de modelo do GitHub, GitHub Enterprise ou Bitbucket AWS Service Catalog permite sincronizar produtos com arquivos de modelo que são gerenciados por meio de um provedor de repositório externo. AWS Service Catalog refere-se a produtos com esse tipo de conexão de modelo como produtos sincronizados com *Git*. As opções de repositório incluem GitHub GitHub Enterprise ou Bitbucket. Depois de autorizar sua conta Conta da AWS com um repositório externo, você pode criar novos AWS Service Catalog produtos ou atualizar produtos existentes para sincronizar com um arquivo de modelo no repositório. Quando alterações são feitas no arquivo de modelo e confirmadas no repositório (por exemplo, usando git-push), AWS Service Catalog automaticamente detecta as alterações e cria uma nova versão do produto (artefato). **Topics** + [Permissões necessárias para sincronizar produtos com arquivos de modelo externos](#required-perms-synced-repo) + [Crie uma conexão de conta](#create-synced-product) + [Visualizar conexões de produtos sincronizadas com o Git](#view-repo-sync) + [Atualizar conexões de produtos sincronizadas com o Git](#update-repo-sync) + [Excluir conexões de produtos sincronizadas com o Git](#delete-repo-sync) + [Sincronização de produtos Terraform com arquivos de modelo do GitHub, GitHub Enterprise ou Bitbucket](#git-synced-Terraform) + [Região da AWS suporte para produtos sincronizados com Git](git-sync-supported-regions.md) ## Permissões necessárias para sincronizar produtos com arquivos de modelo externos Você pode usar a política a seguir AWS Identity and Access Management (IAM) como modelo para permitir que AWS Service Catalog os administradores sincronizem produtos com arquivos de modelo de um repositório externo. Essa política inclui as permissões necessárias de ambos CodeConnections AWS Service Catalog e. AWS Service Catalog recomenda que você copie o modelo de política abaixo e também use a [política AWS Service Catalog`AWSServiceCatalogAdminFullAccess` gerenciada](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/security-iam-awsmanpol) ao habilitar produtos sincronizados com o repositório. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "CodeStarAccess", "Effect": "Allow", "Action": [ "codestar-connections:UseConnection", "codestar-connections:PassConnection", "codestar-connections:CreateConnection", "codestar-connections:DeleteConnection", "codestar-connections:GetConnection", "codestar-connections:ListConnections", "codestar-connections:ListInstallationTargets", "codestar-connections:GetInstallationUrl", "codestar-connections:StartOAuthHandshake", "codestar-connections:UpdateConnectionInstallation", "codestar-connections:GetIndividualAccessToken" ], "Resource": "arn:aws:codestar-connections:*:*:connection/*" }, { "Sid": "CreateSLR", "Effect": "Allow", "Action": "iam:CreateServiceLinkedRole", "Resource": "arn:aws:iam::*:role/aws-service-role/sync.servicecatalog.amazonaws.com/AWSServiceRoleForServiceCatalogArtifactSync", "Condition": { "StringLike": { "iam:AWSServiceName": "sync.servicecatalog.amazonaws.com" } } } ] } ``` ------ ## Crie uma conexão de conta Antes de sincronizar um arquivo de modelo com um AWS Service Catalog produto, você deve criar e autorizar uma conexão única. account-to-account Você usa essa conexão para especificar os detalhes do repositório que contém o arquivo de modelo desejado. Você pode criar uma conexão usando o AWS Service Catalog console, o CodeConnections console AWS Command Line Interface (CLI) ou. CodeConnections APIs Depois de estabelecer uma conexão, você pode usar o AWS Service Catalog console, a AWS Service Catalog API ou a CLI para criar um produto sincronizado AWS Service Catalog . AWS Service Catalog os administradores podem criar produtos novos ou atualizar AWS Service Catalog produtos existentes com base em um arquivo de modelo em um repositório e ramificação. Se uma alteração for confirmada no repositório, a AWS Service Catalog detectará automaticamente e criará uma nova versão do produto. As versões anteriores do produto são mantidas até o limite de versão prescrito e atribuiu um status **obsoleto**. Além disso, cria AWS Service Catalog automaticamente uma função vinculada ao serviço (SLR) após a criação da conexão. Essa SLR permite AWS Service Catalog detectar qualquer alteração no arquivo de modelo que esteja confirmada no repositório. A SLR também permite AWS Service Catalog criar automaticamente novas versões de produtos para produtos sincronizados. Para obter mais informações sobre permissões e funcionalidades da SLR, consulte [Perfis vinculados ao serviço para AWS Service Catalog](#required-perms-synced-repo). **Como criar um novo produto sincronizado com o Git** 1. No painel de navegação, escolha **Lista de produtos** e, em seguida, selecione **Criar produto**. 1. Insira os **Detalhes do produto**. 1. Em Detalhes da versão, escolha **Especificar seu repositório de código usando um AWS CodeStar provedor** e, em seguida, escolha o link **Criar uma nova AWS CodeStar conexão**. 1. Depois de criar a conexão, atualize a lista de conexões e selecione a nova conexão. Especifique os detalhes do repositório, incluindo o **repositório**, a **ramificação** e o **caminho do arquivo de modelo**. Para obter mais informações sobre o uso de arquivos de configuração Terraform, consulte [Sincronização de produtos Terraform com arquivos de modelo do GitHub, GitHub Enterprise ou Bitbucket](#git-synced-Terraform). 1. (Opcional ao criar um novo recurso de AWS Service Catalog produto) Na seção **Support Details**, adicione metadados do produto. 1. (Opcional ao criar um novo recurso de AWS Service Catalog produto) Na seção **Tags**, escolha **Adicionar nova tag** e insira os pares de **chave** e **valor**. 1. Selecione **Criar novo produto**. **Para criar vários produtos sincronizados com o Git** 1. No painel de navegação esquerdo do AWS Service Catalog console, escolha **Lista de produtos** e, em seguida, escolha **Criar vários produtos gerenciados pelo git**. 1. Insira os **Detalhes comuns do produto**. 1. Em Detalhes do repositório externo, selecione uma **conexão AWS CodeStar ** e, em seguida, especifique o **repositório** e a **ramificação**. 1. No painel Adicionar produtos, insira o **Caminho do arquivo de modelo** e o **Nome do produto**. Escolha **Adicionar novo item** e continue adicionando produtos conforme desejado. 1. Depois de adicionar todos os produtos desejados, escolha **Criar produtos em massa**. **Para conectar um AWS Service Catalog produto existente a um repositório externo** 1. No painel de navegação esquerdo do AWS Service Catalog console, escolha **Lista de produtos** e, em seguida, escolha **Conectar produtos a um repositório externo**. 1. Na página Selecionar produtos, escolha os produtos que você deseja conectar a um repositório externo e escolha **Próximo**. 1. Na página Especificar detalhes da fonte, selecione uma AWS CodeStar conexão existente e, em seguida, especifique o **repositório**, a **ramificação** e o **caminho do arquivo de modelo**. 1. Escolha **Próximo**. 1. Na página Revisar e enviar, verifique os detalhes da conexão e escolha **Conectar produtos a um repositório externo**. ## Visualizar conexões de produtos sincronizadas com o Git Você pode usar o AWS Service Catalog console, a API ou visualizar AWS CLI os detalhes da conexão do repositório. Para AWS Service Catalog produtos vinculados a um arquivo de modelo, você pode recuperar informações sobre a conexão do repositório e a última vez em que o modelo foi sincronizado com o produto a partir do Status da **última** sincronização. **nota** Você pode visualizar as informações do repositório e o **Status da última sincronização** no nível do produto. Os usuários devem ter permissões do IAM no CodeConnections APIs para visualizar os detalhes do repositório. Consulte [Permissões necessárias para sincronizar AWS Service Catalog produtos com arquivos de modelo](#required-perms-synced-repo) para obter mais informações sobre a política necessária para essas permissões do IAM. **Para visualizar os detalhes da conexão e do repositório usando Console de gerenciamento da AWS** 1. No painel de navegação à esquerda, escolha **Lista de produtos**. 1. Selecione o produto na lista. 1. Na página **Produto**, navegue até a seção **Detalhes da fonte do produto**. 1. Para ver a ID da revisão de origem de uma versão do produto, escolha o link **Última versão criada**. A seção **Detalhes da versão** exibe a ID da revisão de origem. **Para visualizar os detalhes da conexão e do repositório usando AWS CLI** A partir do AWS CLI, execute os seguintes comandos: `$ aws servicecatalog describe-product-as-admin` `$ aws servicecatalog describe-provisioning-artifact` `$ aws servicecatalog search-product-as-admin` `$ aws servicecatalog list-provisioning-artifacts` ## Atualizar conexões de produtos sincronizadas com o Git Você pode atualizar as conexões de contas existentes e os produtos sincronizados com o Git usando o AWS Service Catalog console, AWS Service Catalog a API ou. AWS CLI Para saber como conectar um AWS Service Catalog produto existente a um arquivo de modelo, consulte [Criação de novas conexões de produto sincronizadas com o Git](#create-synced-product). **Para atualizar os produtos existentes para produtos sincronizados com o Git** 1. No painel de navegação à esquerda, escolha **Lista de produtos** e, em seguida, escolha uma das seguintes opções: + Para atualizar um **único produto**, selecione o produto, navegue até a seção **Detalhes da fonte do produto** e escolha **Editar detalhes**. + Para atualizar **vários produtos**, escolha **Conectar produtos a um repositório externo**, selecione até dez produtos e escolha **Próximo**. 1. Na seção **Detalhes da fonte do produto**, execute as seguintes atualizações: + Especificar a conexão. + Especificar o repositório. + Especificar a ramificação. + Nomear o arquivo de modelo. 1. Escolha **Salvar alterações**. **nota** Para produtos que ainda não estão conectados a um repositório externo, você pode usar a opção **Conectar a um repositório externo** exibida no alerta na parte superior da página de informações do produto após selecionar o produto. Você também pode usar o AWS Service Catalog console ou AWS CLI o + Conectar um AWS Service Catalog produto existente a um arquivo de modelo em um repositório externo + Atualize os metadados do produto, incluindo nome, descrição e tags do produto. + Reconfigure (atualize a sincronização para usar uma fonte de repositório diferente) uma conexão para um produto AWS Service Catalog conectado anteriormente. **Para atualizar os detalhes da conexão e do repositório usando o console AWS Service Catalog** 1. No painel de navegação esquerdo **do AWS Service Catalog console, escolha Lista** de produtos e selecione um produto que esteja atualmente conectado a um repositório externo. 1. Na seção **Detalhes da fonte do produto**, escolha **Editar fonte do produto**. 1. Na seção **Detalhes da fonte do produto**, especifique o novo repositório desejado. 1. Escolha **Salvar alterações**. **Para atualizar os detalhes da conexão e do repositório usando AWS CLI** A partir da AWS CLI execução dos `$ aws servicecatalog update-provisioning-artifact` comandos `$ aws servicecatalog update-product` e. ## Excluir conexões de produtos sincronizadas com o Git Você pode excluir uma conexão entre um AWS Service Catalog produto e um arquivo de modelo usando o AWS Service Catalog console, a CodeConnections API ou AWS CLI. Quando você desconecta um produto de um arquivo de modelo, o AWS Service Catalog produto sincronizado muda para um produto gerenciado regularmente. Depois de desconectar o produto, se o arquivo de modelo for alterado e confirmado no repositório conectado anteriormente, as alterações *não* serão refletidas. Para reconectar um AWS Service Catalog produto a um arquivo de modelo em um repositório externo, consulte [Atualização de conexões e produtos sincronizados AWS Service Catalog](). **Para desconectar um produto sincronizado com o Git usando o console AWS Service Catalog** 1. No Console de gerenciamento da AWS, escolha **Lista de produtos** no painel de navegação esquerdo. 1. Selecione um produto na lista. 1. Na página **Produto**, navegue até a seção **Detalhes da fonte do produto**. 1. Escolha **Desconectar**. 1. Confirme a ação e escolha **Desconectar**. **Para desconectar um produto sincronizado com o Git usando AWS CLI** A partir do AWS CLI, execute o `$ aws servicecatalog update-product` comando. Na entrada `ConnectionParameters`, remova a conexão especificada. **Para excluir uma conexão usando a CodeConnections API ou AWS CLI** Na CodeConnections API ou AWS CLI, execute o `$ aws codestar-connections delete-connection` comando. ## Sincronização de produtos Terraform com arquivos de modelo do GitHub, GitHub Enterprise ou Bitbucket Ao criar um produto sincronizado com o Git usando um arquivo de configuração do Terraform, o caminho do arquivo aceita somente o formato tar.gz. Os formatos de pasta do Terraform não são aceitos no caminho do arquivo. # Região da AWS suporte para produtos sincronizados com Git AWS Service Catalog suporta produtos sincronizados com o Git Regiões da AWS conforme indicado na tabela abaixo. **** | Região da AWS nome | Região da AWS identidade | Suporte para produtos sincronizados com o Git | | --- | --- | --- | | Leste dos EUA (Norte da Virgínia) | us-east-1 | Sim | | Leste dos EUA (Ohio) | us-east-2 | Sim | | Oeste dos EUA (N. da Califórnia) | us-west-1 | Sim | | Oeste dos EUA (Oregon) | us-west-2 | Sim | | África (Cidade do Cabo) | af-south-1 | Não | | Ásia-Pacífico (Hong Kong) | ap-east-1 | Não | | Ásia-Pacífico (Jacarta) | ap-southeast-3 | Não | | Ásia-Pacífico (Mumbai) | ap-south-1 | Sim | | Ásia Pacifico (Osaka) | ap-northeast-3 | Não | | Ásia-Pacífico (Seul) | ap-northeast-2 | Sim | | Ásia-Pacífico (Singapura) | ap-southeast-1 | Sim | | Ásia-Pacífico (Sydney) | ap-southeast-2 | Sim | | Ásia-Pacífico (Tóquio) | ap-northeast-1 | Sim | | Canadá (Central) | ca-central-1 | Sim | | Europa (Frankfurt) | eu-central-1 | Sim | | Europa (Irlanda) | eu-west-1 | Sim | | Europa (Londres) | eu-west-2 | Sim | | Europa (Milão) | eu-south-1 | Não | | Europa (Paris) | eu-west-3 | Sim | | Europa (Estocolmo) | eu-north-1 | Sim | | Oriente Médio (Barém) | me-south-1 | Não | | América do Sul (São Paulo) | sa-east-1 | Sim | | AWS GovCloud (Leste dos EUA) | us-gov-east-1 | Não | | AWS GovCloud (Oeste dos EUA) | us-gov-west-1 | Não | # Excluir produtos Quando você exclui um produto, AWS Service Catalog remove todas as versões do produto de cada portfólio que contém o produto. AWS Service Catalog permite que você exclua um produto usando o AWS Service Catalog console ou AWS CLI. Para excluir um produto com sucesso, você deve primeiro desassociar todos os recursos associados ao produto. Exemplos de associações de recursos de produtos incluem associações de portfólio TagOptions, orçamentos e ações de serviço. **Importante** Você não pode recuperar um produto depois que ele for excluído. **Para excluir um produto usando o AWS Service Catalog console** 1. Navegue até a página **Portfólios** e selecione o portfólio que contém o produto que você deseja excluir. 1. Selecione o produto que você deseja excluir e escolha **Excluir** na parte superior direita do painel de produtos. 1. Para produtos *sem recursos associados*, confirme o produto que você deseja excluir digitando **excluir** na caixa de texto e escolha **Excluir**. Para produtos *com recursos associados*, prossiga para a etapa 4. 1. Na janela **Excluir produto**, revise a tabela **Associações**, que exibe todos os recursos associados ao produto. AWS Service Catalog tenta desassociar esses recursos quando você exclui o produto. 1. Confirme que você deseja excluir o produto e remover todos os recursos associados inserindo **excluir** na caixa de texto. 1. Escolha **Desassociar e excluir**. Se AWS Service Catalog não conseguir desassociar todos os recursos do produto, o produto não será excluído. A janela **Excluir produto** exibe o número de dissociações com falha e uma descrição de cada falha. Para obter mais informações sobre como resolver dissociações de recursos com falha ao excluir um produto, consulte *Resolver dissociações de recursos com falha ao excluir um produto* abaixo. **Topics** + [Excluindo produtos usando o AWS CLI](product-delete-cli.md) + [Resolver falhas na dissociação de recursos ao excluir um produto](product-delete-exception.md) # Excluindo produtos usando o AWS CLI AWS Service Catalog permite que você use o [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)(AWS CLI) para excluir produtos do seu portfólio. AWS CLI É uma ferramenta de código aberto que permite interagir com AWS serviços usando comandos em seu shell de linha de comando. A função AWS Service Catalog de exclusão forçada requer um [AWS CLI alias](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-alias.html), que é um atalho que você pode criar AWS CLI para encurtar comandos ou scripts que você usa com frequência. ## Pré-requisitos + Instale e configure a AWS CLI. Para obter mais informações, consulte [Instalação ou atualização da versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) e [Configuração básica](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html). Use uma AWS CLI versão mínima de 1.11.24 ou 2.0.0. + O alias da CLI de exclusão do produto requer um terminal compatível com bash e o processador JQ de linha de comando JSON. Para obter mais informações sobre como instalar o processador JSON de linha de comando, consulte [Download jq](https://stedolan.github.io/jq/download/). + Crie um AWS CLI alias para chamadas de `Disassociation` API em lote, permitindo que você exclua um produto em um único comando. Para excluir um produto com sucesso, você deve primeiro desassociar todos os recursos associados ao produto. Exemplos de associações de recursos de produtos incluem associações de portfólio, orçamentos, opções de tags e ações de atendimento. Ao usar a CLI para excluir um produto, o alias `force-delete-product` da CLI permite que você chame a API `Disassociate` para desassociar quaisquer recursos que impeçam a API `DeleteProduct`. Isso evita uma chamada separada para dissociações individuais. **nota** Os caminhos de arquivo mostrados nos procedimentos abaixo podem variar dependendo do sistema operacional usado para realizar essas ações. ## Criação de um AWS CLI alias para excluir produtos AWS Service Catalog Ao usar o AWS CLI para excluir um AWS Service Catalog produto, o `force-delete-product` alias da CLI permite que você chame a `Disassociate` API para desassociar quaisquer recursos que impeçam a chamada. `DeleteProduct` **Crie um `alias` arquivo na sua pasta AWS CLI de configuração** 1. No AWS CLI console, navegue até a pasta de configuração. Por padrão, a pasta de configuração é `~/.aws/` no Linux e no macOS ou `%USERPROFILE%\.aws\` no Windows. 1. Crie uma subpasta chamada `cli` usando a navegação de arquivos ou digitando o seguinte comando em seu terminal preferido: ``` $ mkdir -p ~/.aws/cli ``` O caminho padrão da pasta `cli` resultante é `~/.aws/cli/` no Linux e no macOS ou `%USERPROFILE%\.aws\cli` no Windows. 1. Na nova pasta `cli`, crie um arquivo de texto chamado `alias` sem extensão de arquivo. Você pode criar o arquivo `alias` usando a navegação de arquivos ou digitando o seguinte comando no terminal de sua preferência: ``` $ touch ~/.aws/cli/alias ``` 1. Entre `[toplevel]` na primeira linha. 1. Salve o arquivo. Em seguida, você pode adicionar o force-delete-product alias ao seu `alias` arquivo colando manualmente o script de alias no arquivo ou usando um comando na janela do terminal. **Adicione manualmente o force-delete-product alias ao seu arquivo `alias`** 1. No AWS CLI console, navegue até a pasta AWS CLI de configuração e abra o `alias` arquivo. 1. Insira o seguinte alias de código no arquivo, abaixo da linha `[toplevel]`: ``` [command servicecatalog] force-delete-product = !f() { if [ "$#" -ne 1 ]; then echo "Illegal number of parameters" exit 1 fi if [[ "$1" != prod-* ]]; then echo "Please provide a valid product id." exit 1 fi productId=$1 describeProductAsAdminResponse=$(aws servicecatalog describe-product-as-admin --id $productId) listPortfoliosForProductResponse=$(aws servicecatalog list-portfolios-for-product --product-id $productId) tagOptions=$(echo "$describeProductAsAdminResponse" | jq -r '.TagOptions[].Id') budgetName=$(echo "$describeProductAsAdminResponse" | jq -r '.Budgets[].BudgetName') portfolios=$(echo "$listPortfoliosForProductResponse" | jq -r '.PortfolioDetails[].Id') provisioningArtifacts=$(echo "$describeProductAsAdminResponse" | jq -r '.ProvisioningArtifactSummaries[].Id') provisioningArtifactServiceActionAssociations=() for provisioningArtifactId in $provisioningArtifacts; do listServiceActionsForProvisioningArtifactResponse=$(aws servicecatalog list-service-actions-for-provisioning-artifact --product-id $productId --provisioning-artifact-id $provisioningArtifactId) serviceActions=$(echo "$listServiceActionsForProvisioningArtifactResponse" | jq -r '[.ServiceActionSummaries[].Id] | join(",")') if [[ -n "$serviceActions" ]]; then provisioningArtifactServiceActionAssociations+=("${provisioningArtifactId}:${serviceActions}") fi done echo "Before deleting a product, the following associated resources must be disassociated. These resources will not be deleted. This action may take some time, depending on the number of resources being disassociated." echo "Portfolios:" for portfolioId in $portfolios; do echo "\t${portfolioId}" done echo "Budgets:" if [[ -n "$budgetName" ]]; then echo "\t${budgetName}" fi echo "Tag Options:" for tagOptionId in $tagOptions; do echo "\t${tagOptionId}" done echo "Service Actions on Provisioning Artifact:" for association in "${provisioningArtifactServiceActionAssociations[@]}"; do echo "\t${association}" done read -p "Are you sure you want to delete ${productId}? y,n " if [[ ! $REPLY =~ ^[Yy]$ ]]; then exit fi for portfolioId in $portfolios; do echo "Disassociating ${portfolioId}" aws servicecatalog disassociate-product-from-portfolio --product-id $productId --portfolio-id $portfolioId done if [[ -n "$budgetName" ]]; then echo "Disassociating ${budgetName}" aws servicecatalog disassociate-budget-from-resource --budget-name "$budgetName" --resource-id $productId fi for tagOptionId in $tagOptions; do echo "Disassociating ${tagOptionId}" aws servicecatalog disassociate-tag-option-from-resource --tag-option-id $tagOptionId --resource-id $productId done for association in "${provisioningArtifactServiceActionAssociations[@]}"; do associationPair=(${association//:/ }) provisioningArtifactId=${associationPair[0]} serviceActionsList=${associationPair[1]} serviceActionIds=${serviceActionsList//,/ } for serviceActionId in $serviceActionIds; do echo "Disassociating ${serviceActionId} from ${provisioningArtifactId}" aws servicecatalog disassociate-service-action-from-provisioning-artifact --product-id $productId --provisioning-artifact-id $provisioningArtifactId --service-action-id $serviceActionId done done echo "Deleting product ${productId}" aws servicecatalog delete-product --id $productId }; f ``` 1. Salve o arquivo. **Use a janela do terminal para adicionar o force-delete-product alias ao seu arquivo `alias`** 1. Abra uma janela de terminal e execute o seguinte comando: `$ cat >> ~/.aws/cli/alias` 1. Cole o script de alias na janela do terminal e pressione *CTRL\$1D* para sair do comando `cat`. **Ligue para o force-delete-product alias** 1. Na janela do terminal, execute os comandos seguintes para chamar o alias do produto excluído `$ aws servicecatalog force-delete-product {product-id} ` O exemplo abaixo mostra o comando alias `force-delete-product` e sua resposta resultante ``` $ aws servicecatalog force-delete-product prod-123 ``` ``` Before deleting a product, the following associated resources must be disassociated. These resources will not be deleted. This action may take some time, depending on the number of resources being disassociated. Portfolios: port-123 Budgets: budgetName Tag Options: tag-123 Service Actions on Provisioning Artifact: pa-123:act-123 Are you sure you want to delete prod-123? y,n ``` 1. Digite `y` para confirmar se você deseja excluir o produto. Depois de excluir o produto com sucesso, a janela do terminal exibe os seguintes resultados ``` Disassociating port-123 Disassociating budgetName Disassociating tag-123 Disassociating act-123 from pa-123 Deleting product prod-123 ``` ## Recursos adicionais do Para obter mais informações sobre AWS CLI o uso de aliases e a exclusão de AWS Service Catalog produtos, consulte os seguintes recursos: + [Criação e uso de AWS CLI aliases](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-alias.html) no guia do *AWS Command Line Interface usuário (CLI*). + AWS CLI repositório de [alias repositório](https://github.com/awslabs/awscli-aliases) git. + [Excluir produtos do AWS Service Catalog](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/productmgmt-delete.html). + [AWS re:Invent 2016: O usuário AWS CLI efetivo](https://youtu.be/Xc1dHtWa9-Q?t=1593) em. *YouTube* # Resolver falhas na dissociação de recursos ao excluir um produto Se sua tentativa anterior de [excluir um produto](https://docs.aws.amazon.com/servicecatalog/latest/adminguide/productmgmt-delete.html) falhou devido a exceções de dissociação de recursos, consulte a lista de exceções e suas resoluções abaixo. **nota** Se você fechou a janela **Excluir produtos** antes de receber a mensagem de falha na dissociação de recursos, poderá seguir as etapas de um a três na seção *Excluir um produto* em andamento para abrir a janela novamente. **Como resolver uma falha na dissociação de recursos** Na janela **Excluir produto**, revise a coluna **Status** da tabela de associações. Identifique a exceção de falha na dissociação de recursos e as resoluções sugeridas: **** | Tipo de exceção de status | Causa | Resolução | | --- | --- | --- | | Produto prod-\$1\$1\$1\$1 | AWS Service Catalog não foi possível excluir o produto porque o produto ainda tem orçamentos associados TagOptions, pelo menos um ProvisioningArtifact com ações associadas, o produto ainda está atribuído a um portfólio, o produto tem usuários ou o produto tem restrições. | Tente excluir o produto novamente. | | Usuário: username não tem autorização para executar: | O usuário que está tentando excluir o produto não tem as permissões necessárias para desassociar os recursos do produto. | AWS Service Catalog recomenda entrar em contato com o administrador da conta para obter mais informações sobre como desassociar recursos de produtos que você atualmente não tem permissão para desassociar. | # Gerenciar versões Você atribui versões do produto ao criar um produto, além de poder atualizar versões de produto a qualquer momento. As versões têm um CloudFormation modelo, um título, uma descrição, um status e orientação. ## Status da versão Uma versão pode ter um dos três status: + **Active (Ativa)** – uma versão ativa aparece na lista de versões e permite que os usuários a lancem. + **Inactive (Inativa)** – uma versão inativa está oculta na lista de versões. Os produtos provisionados existentes lançados a partir desta versão não serão afetados. + **Excluído** - se uma versão for excluída, ela será removida da lista de versões. A exclusão de uma versão não pode ser desfeita. ## Orientação da versão Você pode definir a orientação da versão para fornecer informações a usuários finais sobre a versão do produto. A orientação da versão afeta somente as versões de produto ativas. Há duas opções para a orientação da versão: + **Nenhum** - por padrão, as versões do produto não têm nenhuma orientação. Os usuários finais podem usar essa versão para atualizar e lançar produtos provisionados. + **Obsoleto** - os usuários não podem lançar novos produtos provisionados usando uma versão obsoleta do produto. Se um produto provisionado lançado anteriormente usa uma versão agora obsoleta, os usuários só podem atualizar esse produto provisionado usando a versão existente ou uma nova versão. ## Atualizar versões Você atribui versões do produto ao criar um produto e também pode atualizar uma versão a qualquer momento. Para obter mais informações sobre como criar um produto, consulte [Criar produtos](productmgmt-cloudresource.md). **Como atualizar uma versão do produto** 1. No AWS Service Catalog console, escolha **Produtos**. 1. Na lista de produtos, escolha o produto cuja versão deseja atualizar. 1. Na página **Product details (Detalhes do produto)**, escolha a guia **Versions (Versões)** e escolha a versão que deseja atualizar. 1. Na página **Version details (Detalhes da versão)**, edite a versão do produto e escolha **Save changes (Salvar alterações)**.