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á.
# Como implantar aplicativos
Esta seção fornece procedimentos para implantar aplicativos sem servidor a partir do AWS Serverless Application Repository usando o Console de gerenciamento da AWS ou o. AWS CLI
## Implantar um novo aplicativo (console)
Esta seção mostra como implantar um novo aplicativo AWS Serverless Application Repository usando Console de gerenciamento da AWS o. Para obter instruções sobre como implantar uma nova versão de um aplicativo existente, consulte [Atualizar aplicativos](serverlessrepo-how-to-consume-new-version.md).
### Navegar, pesquisar e implantar aplicativos
Encontre, configure e implante um aplicativo no AWS Serverless Application Repository usando o procedimento a seguir.
**Para encontrar e configurar um aplicativo no AWS Serverless Application Repository**
1. Abra a [página inicial pública do AWS Serverless Application Repository](https://aws.amazon.com/serverless/serverlessrepo) ou abra o [AWS Lambda console](https://console.aws.amazon.com/lambda/). Escolha **Create function (Criar função)** e selecione **Browse serverless app repository (Navegar repositório de aplicativos sem servidor)**.
1. 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](acknowledging-application-capabilities.md).
1. Escolha um aplicativo para ver detalhes, como permissões, recursos e o número de vezes que ele foi implantado pelos AWS clientes.
As contagens de implantação são mostradas para a AWS região na qual você está tentando implantar o aplicativo.
1. Na página de detalhes do aplicativo, visualize as permissões e os recursos do aplicativo visualizando o AWS SAM modelo, a licença e o arquivo readme. 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.
1. 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.
1. 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](acknowledging-application-capabilities.md).
1. 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 essa página por meio do console Lambda.
Depois que seu aplicativo for implantado com sucesso, você poderá revisar e gerenciar os recursos que foram criados usando AWS as ferramentas existentes.
## Implantar um novo aplicativo (AWS CLI)
Esta seção mostra como implantar um novo aplicativo a partir do AWS Serverless Application Repository usando AWS CLI o. Para obter instruções sobre como implantar uma nova versão de um aplicativo existente, consulte [Atualizar aplicativos](serverlessrepo-how-to-consume-new-version.md).
### Encontrar e confirmar recursos do aplicativo (AWS CLI)
Para reconhecer os recursos de um aplicativo usando o AWS CLI, siga estas etapas:
1. **Analise os recursos do aplicativo.**Use o AWS CLI comando a seguir para analisar os recursos de um aplicativo:
```
aws serverlessrepo get-application \
--application-id application-arn
```
A resposta [requiredCapabilities](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/applications-applicationid.html#applications-applicationid-prop-version-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](https://docs.aws.amazon.com/goto/WebAPI/serverlessrepo-2017-09-08/GetApplication) no AWS SDKs para obter esses dados.
1. **Crie o conjunto de alterações.**Você deve fornecer o conjunto de [recursos](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/applications-applicationid-changesets.html#applications-applicationid-changesets-createcloudformationchangesetinput-capabilities) necessários ao criar o conjunto de CloudFormation alterações. Por exemplo, use o AWS CLI comando a seguir para implantar um aplicativo reconhecendo seus 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](https://docs.aws.amazon.com/goto/WebAPI/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet) no AWS SDKs para criar o conjunto de alterações.
Por exemplo, o AWS CLI comando a seguir reconhece um aplicativo que contém um [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html)recurso 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
```
1. **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 AWS CLI comando de 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](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet) no AWS SDKs para executar o conjunto de alterações.
## Exclusão de pilhas do aplicativo
Para excluir um aplicativo que você implantou anteriormente usando o AWS Serverless Application Repository, siga o mesmo procedimento usado para excluir uma CloudFormation pilha:
+ **Console de gerenciamento da AWS**: Para excluir um aplicativo usando o Console de gerenciamento da AWS, consulte [Excluindo uma pilha no CloudFormation console no Guia](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-delete-stack.html) do *AWS CloudFormation usuário*.
+ **AWS CLI**: Para excluir um aplicativo usando o AWS CLI, consulte [Excluindo uma pilha no Guia](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-cli-deleting-stack.html) do *AWS CloudFormation usuário*.
# Atualizar aplicativos
Depois de implantar um aplicativo a partir do AWS Serverless Application Repository, talvez você queira atualizá-lo. Por exemplo, talvez queira alterar a configuração de um aplicativo, ou atualizar o aplicativo para a versão mais recente publicada.
As seções a seguir descrevem como implantar uma nova versão de um aplicativo usando o Console de gerenciamento da AWS ou AWS CLI o.
## Atualizar aplicativos (console)
Para atualizar um aplicativo implantado previamente, use o mesmo procedimento usado para implantar um novo aplicativo e *forneça o mesmo nome de aplicativo que foi usado originalmente para implantá-lo*. Em particular, o AWS Serverless Application Repository prefixo `serverlessrepo-` ao nome do seu aplicativo. No entanto, para implantar uma nova versão do aplicativo, forneça o nome do aplicativo original sem o `serverlessrepo-` anexado.
Por exemplo, se você implantou um aplicativo com o nome `MyApplication`, o nome da pilha será `serverlessrepo-MyApplication`. Para atualizar esse aplicativo, você forneceria o nome `MyApplication` novamente — *não* especifique o nome completo da pilha de. `serverlessrepo-MyApplication`
Para todas as demais configurações de aplicativo, é possível manter os valores iguais aos da implantação anterior ou fornecer novos valores.
## Atualizar aplicativos (AWS CLI)
Para atualizar um aplicativo implantado previamente, use o mesmo procedimento usado para implantar um novo aplicativo e *forneça o mesmo `--stack-name` que foi usado originalmente para implantá-lo*. Em particular, AWS Serverless Application Repository acrescenta `serverlessrepo-` ao nome da sua pilha. No entanto, para implantar uma nova versão do aplicativo, forneça o nome da pilha original sem o `serverlessrepo-` anexado.
Por exemplo, se você implantou um aplicativo com o nome da pilha `MyApplication`, o nome da pilha criada será `serverlessrepo-MyApplication`. Para atualizar esse aplicativo, você forneceria o nome `MyApplication` novamente — *não* especifique o nome completo da pilha de. `serverlessrepo-MyApplication`