View a markdown version of this page

Solução de problemas - Criador de aplicações de IA generativa na AWS
Problema: a implantação de uma configuração habilitada para VPC, com Create a VPC for me, falhaProblema: a pilha de casos de uso não pode ser excluída CloudFormation após a exclusão da pilha do painel de implantaçãoProblema: a interface do usuário do caso de uso não reflete as alterações nas configurações

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á.

Solução de problemas

Esta seção fornece instruções de solução de problemas para implantar e usar a solução.

Se essas instruções não resolverem seu problema, Entre em contato com o suporte fornecerá instruções para abrir um caso de suporte para essa solução.

Problema: a implantação de uma configuração habilitada para VPC, com Create a VPC for me, falha

A pilha do painel de implantação ou a pilha de casos de uso falha na implantação porque não CloudFormation foi possível provisionar recursos de rede VPC.

Resolução

Verifique os limites de cota e a VPCs Elastic IPs em sua conta. Os limites padrão são 5 para cada Elastic IPs e VPCs por conta da AWS, por região da AWS.

nota

Quando a solução cria uma VPC, uma única implantação habilitada para VPC (painel de implantação ou caso de uso) é uma implantação de 2 AZ com 1 sub-rede pública e 1 sub-rede privada em cada AZ, cada sub-rede pública implanta 1 gateway NAT. Com 2 gateways NAT, a implantação consome 2 endereços IP públicos do limite de cota.

Alguns limites que você deve conhecer (por conta, por região):

  • Número de VPCs - 5

  • Número de endereços IP públicos - 5

  • Número de endpoints VPC do gateway - 20

  • Número de endpoints VPC de interface: 20

Problema: a pilha de casos de uso não pode ser excluída CloudFormation após a exclusão da pilha do painel de implantação

Se a pilha do painel de implantação for excluída CloudFormation antes que todas as pilhas de casos de uso sejam excluídas, os casos de uso podem acabar em um estado bloqueado (inutilizável). Isso ocorre porque uma função do IAM criada pela pilha do painel de implantação não existe mais, impedindo modificações na pilha de casos de uso.

Resolução

Atenção

Certifique-se de limpar todas as funções criadas manualmente imediatamente após o uso. Essas são permissões elevadas que os usuários podem explorar para elevar a função.

Recrie a função excluída do IAM para permitir a exclusão das CloudFormation pilhas:

  1. Abra o CloudFormation console e determine a função associada à sua pilha bloqueada.

    1. O ARN da função pode ser encontrado na seção de informações da pilha chamada função do IAM.

    2. O nome da função é o que vem depois de:role/ no ARN da função do IAM (por exemplo, arn:aws:iam: ::role/) <account-id><role-name>

  2. Crie uma nova função no IAM com o mesmo nome da função excluída.

    1. Selecione o serviço da AWS como a entidade confiável e CloudFormationselecione no menu suspenso.

    2. Adicione as permissões necessárias. Se não tiver certeza sobre as permissões necessárias, você pode usar a AdministratorAccesspolítica gerenciada da AWS.

    3. Insira o nome da função exatamente como obtido na Etapa 1.

  3. Volte ao CloudFormation console e exclua as pilhas bloqueadas.

  4. Depois que todas as pilhas bloqueadas forem excluídas com sucesso, retorne ao IAM e exclua todas as funções criadas na Etapa 2.

Problema: a interface do usuário do caso de uso não reflete as alterações nas configurações

Quando os casos de uso são atualizados, a interface do usuário é implantada em. CloudFront No entanto, como armazena em CloudFront cache as implantações e o arquivo de configuração que determina como algumas configurações são mostradas ao usuário, essas alterações podem não ser refletidas imediatamente.

Resolução

A CloudFront distribuição pode ser invalidada para forçar a propagação da nova configuração para usuários front-end.

  1. Abra o CloudFormation console e determine a CloudFront distribuição associada à sua pilha de casos de uso.

    1. A pilha de casos de uso deve começar com o mesmo nome que você usou ao implantar o caso de uso.

    2. Localize a pilha aninhada correspondente à interface do usuário. O nome da pilha aninhada deve começar com WebAppS3 UINested StackS3. UINested StackResource

    3. Na guia Recursos, localize o tipo AWS::CloudFront::Distributionde recurso e selecione a ID física. Isso abrirá a distribuição no CloudFront console.

  2. Navegue até a guia Invalidações, escolha Criar invalidação e insira um caminho de /*. Isso invalidará todos os caminhos.

  3. Em seu próprio navegador, exclua todos os cookies e arquivos em cache relacionados ao caso de uso.