Como implantar aplicativos

Esta seção oferece procedimentos para implantar aplicativos sem servidor no AWS Serverless Application Repository usando o AWS Management Console ou a AWS CLI.

Implantar um novo aplicativo (console)

Esta seção mostra como implantar um novo aplicativo do AWS Serverless Application Repository usando o AWS Management Console. Para obter instruções sobre como implantar uma nova versão de um aplicativo existente, consulte Atualizar aplicativos.

Navegar, pesquisar e implantar aplicativos

Encontre, configure e implemente um aplicativo no AWS Serverless Application Repository usando o seguinte procedimento.

Para encontrar e configurar um aplicativo no AWS Serverless Application Repository

1. Abra a página inicial pública do AWS Serverless Application Repository ou abra o AWS Lambda console. Escolha Create function (Criar função) e selecione Browse serverless app repository (Navegar repositório de aplicativos sem servidor).

2. Pesquise um navegue até um aplicativo.

   nota

   Para mostrar os aplicativos que contêm funções do IAM ou políticas de recursos personalizadas, selecione o Mostrar aplicativos que criam funções do IAM ou políticas de recursos personalizadas na caixa de seleção . Para obter mais informações sobre funções do IAM e políticas de recursos personalizadas, consulte Reconhecer recursos do aplicativo.

3. Escolha um aplicativo para ver detalhes como suas permissões, recursos e o número de vezes que ele foi implantado pelosAWS clientes.

   As contagens de implantação são mostradas para aAWS região em que você está tentando implantar o aplicativo.

4. Na página de detalhes do aplicativo, visualize as permissões e os recursos do aplicativo visualizando o modeloAWS SAM, a licença e o arquivo Leia-me. Nesta página, você também pode encontrar o link Source code URL (URL do código-fonte) de aplicativos que são compartilhados publicamente. Se o aplicativo inclui algum aplicativo aninhado, você também pode visualizar os detalhes desses aplicativos nesta página.

5. Configure o aplicativo na seção Configurações do aplicativo. Para obter orientações sobre como configurar um aplicativo específico, consulte o arquivo "readme" do aplicativo em questão.

   Por exemplo, os requisitos de configuração podem incluir a especificação do nome de um recurso ao qual você deseja que o aplicativo tenha acesso. Esse recurso pode ser uma tabela do Amazon DynamoDB, um bucket do Amazon S3 ou uma API do Amazon API Gateway.

6. Escolha Implantar. Isso direcionará você para a página Deployment status.

   nota

   Se o aplicativo tiver recursos que exigem confirmação, marque a caixa de seleção I acknowledge this application creates custom IAM roles or resource polices (Eu entendo que este aplicativo cria funções do IAM ou políticas de recursos personalizadas) antes de implantar o aplicativo. Caso contrário, ocorrerá um erro. Para obter mais informações sobre funções do IAM e políticas de recursos personalizadas, consulte Reconhecer recursos do aplicativo.

7. Na página Deployment status (Status da implantação) você pode visualizar o progresso da implantação. Enquanto aguarda a conclusão da implantação, você pode pesquisar e procurar outros aplicativos e retornar a esta página por meio do console do Lambda.

Depois que seu aplicativo for implantado com êxito, você poderá revisar e gerenciar os recursos que foram criados usandoAWS as ferramentas existentes.

Implantar um novo aplicativo (AWS CLI)

Esta seção mostra como implantar um novo aplicativo do AWS Serverless Application Repository usando a AWS CLI. Para obter instruções sobre como implantar uma nova versão de um aplicativo existente, consulte Atualizar aplicativos.

Encontrar e confirmar recursos do aplicativo (AWS CLI)

Para confirmar os recursos de um aplicativo usando o AWS CLI, siga estas etapas:

1. Analise os recursos do aplicativo.Use oAWS CLI comando a seguir para revisar os recursos de um aplicativo:

   aws serverlessrepo get-application \
   --application-id application-arn

   A resposta requiredCapabilities contém uma lista de recursos do aplicativo que você precisará reconhecer antes de implantar o aplicativo. Você também pode usar a GetApplication API nosAWS SDKs para obter esses dados.

2. Crie o conjunto de alterações.Você deve fornecer o conjunto de recursos necessários ao criar oAWS CloudFormation conjunto de alterações. Por exemplo, use o comando a seguir AWS CLI para implantar um aplicativo ao reconhecer os recursos:

   aws serverlessrepo create-cloud-formation-change-set \
   --application-id application-arn \
   --stack-name unique-name-for-cloud-formation-stack \
   --capabilities list-of-capabilities

   O ID do conjunto de alterações é retornado quando esse comando for executado com êxito. Você precisa do ID do conjunto de alterações para ir para a próxima etapa. Você também pode usar a CreateCloudFormationChangeSet API nosAWS SDKs para criar o conjunto de alterações.

   Por exemplo, oAWS CLI comando a seguir reconhece um aplicativo que contém um AWS::IAM::Rolerecurso com um nome personalizado e um ou mais aplicativos aninhados:

   aws serverlessrepo create-cloud-formation-change-set \
   --application-id application-arn \
   --stack-name unique-name-for-cloud-formation-stack \
   --capabilities CAPABILITY_NAMED_IAM CAPABILITY_AUTO_EXPAND

3. Execute o conjunto de alterações.Executar o conjunto de alterações realiza a implantação. Forneça o ID do conjunto de alterações que foi retornado ao criar o conjunto de alterações na etapa anterior.

   O comando da AWS CLI do exemplo a seguir executa o conjunto de alterações do aplicativo para implantar o aplicativo:

   aws cloudformation execute-change-set \
   --change-set-name changeset-id-arn

   Você também pode usar a ExecuteChangeSet API nosAWS SDKs para executar o conjunto de alterações.

Exclusão de pilhas do aplicativo

Para excluir um aplicativo implantado anteriormente usando o AWS Serverless Application Repository, siga o mesmo procedimento para excluir uma pilha do AWS CloudFormation:

• AWS Management Console: Para excluir um aplicativo usando oAWS Management Console, consulte Excluindo uma pilha noAWS CloudFormation console no Guia doAWS CloudFormation usuário.

• AWS CLI: Para excluir um aplicativo usando oAWS CLI, consulte Excluindo uma pilha no Guia doAWS CloudFormation usuário.