Como implantarAplicativos

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 visualizar detalhes, como permissões e o número de vezes que ele foi implantado peloAWSclientes.

   As contagens de implantação são mostradas para oAWSRegião na qual 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/navegar até outros aplicativos e retornar a essa página por meio do console do Lambda.

Depois que o aplicativo for implantado com sucesso, você poderá revisar e gerenciar os recursos que foram criados usando o existenteAWSferramentas.

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. Revise os recursos do aplicativo.Use o seguinteAWS CLIPara 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 oGetApplicationAPInoAWSSDKs para obter esses dados.

2. Crie o conjunto de alterações.Você deve fornecer o conjunto de obrigatóriospotencialidadesquando você cria oAWS CloudFormationconjunto 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 oCreateCloudFormationChangeDefinir API donoAWSSDKs para criar o conjunto de alterações.

   Por exemplo, o seguinte comando da AWS CLI reconhece um aplicativo que contém um recurso AWS::IAM::Role 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 oExecuteChangeDefinir API donoAWSSDKs 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, consulteComo excluir uma pilha noAWS CloudFormationConsole donoAWS CloudFormationGuia do usuário do .

• AWS CLI: Para excluir um aplicativo usando oAWS CLI, consulteComo excluir uma pilhanoAWS CloudFormationGuia do usuário do .