

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

# Crie seu primeiro aplicativo com o Infrastructure Composer
<a name="getting-started-build"></a>

Neste tutorial, você usa AWS Infrastructure Composer para criar, ler, atualizar e excluir (CRUD) um aplicativo sem servidor que gerencia usuários em um banco de dados.

Para este tutorial, usamos o Infrastructure Composer no Console de gerenciamento da AWS. Recomendamos que você use Google Chrome ou Microsoft Edge e uma janela do navegador em tela cheia.

**Você é novato na tecnologia sem servidor?**  
Recomendamos uma compreensão básica do seguinte:  
[Arquitetura orientada a eventos](what-is-concepts.md#what-is-concepts-terms-eda)
[infraestrutura como código (IaC)](what-is-concepts.md#what-is-concepts-terms-iac)
[Tecnologias sem servidor](what-is-concepts.md#what-is-concepts-terms-serverless)
Para saber mais, consulte [Conceitos sem servidor para AWS Infrastructure Composer](what-is-concepts.md).

**Topics**
+ [Referência de propriedades do recurso](#getting-started-build-reference)
+ [Etapa 1: Crie seu projeto](#getting-started-build-start)
+ [Etapa 2: adicionar cartões à tela](#getting-started-build-rest-cards)
+ [Etapa 3: Configurar a API REST do API Gateway](#getting-started-build-rest)
+ [Etapa 4: Configurar suas funções do Lambda](#getting-started-build-functions)
+ [Etapa 5: Conecte seus cartões](#getting-started-build-connect)
+ [Etapa 6: organizar a tela](#getting-started-build-organize)
+ [Etapa 7: Adicionar e conectar uma tabela do DynamoDB](#getting-started-build-table)
+ [Etapa 8: revise seu AWS CloudFormation modelo](#getting-started-build-template)
+ [Etapa 9: Integre-se aos seus fluxos de trabalho de desenvolvimento](#getting-started-build-integrate)
+ [Próximas etapas](#getting-started-build-next)

## Referência de propriedades do recurso
<a name="getting-started-build-reference"></a>

Ao criar seu aplicativo, use essa tabela como referência para configurar as propriedades do Amazon API Gateway e AWS Lambda dos recursos.


| Método | Path | Nome da função | 
| --- | --- | --- | 
| GET | /itens | Obtenha itens | 
| GET | /itens/ {id} | getItem | 
| PUT | /itens/ {id} | Atualizar item | 
| POST | /item | Adicionar item | 
| DELETE | /itens/ {id} | deleteItem | 

## Etapa 1: Crie seu projeto
<a name="getting-started-build-start"></a>

**Para começar a usar seu aplicativo CRUD sem servidor, crie um novo projeto no Infrastructure Composer e ative a sincronização local.**

**Para criar um novo projeto em branco**

1. Faça login no [console do Infrastructure Composer](https://console.aws.amazon.com/composer/home).

1. Na página **inicial**, escolha **Criar projeto**.

Conforme mostrado na imagem a seguir, o Infrastructure Composer abre a tela visual e carrega um modelo de aplicativo inicial (em branco).

![Compositor de infraestrutura com uma tela visual em branco.](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_t2_01.png)


**Para ativar a sincronização local**

1. No **menu** Infrastructure Composer, selecione **Salvar** > **Ativar sincronização local**.  
![Um menu do Infrastructure Composer com a opção Ativar sincronização local selecionada.](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_t2_09.png)

1. Em **Localização do projeto**, pressione **Selecionar pasta** e escolha um diretório. É aqui que o Infrastructure Composer salvará e sincronizará seus arquivos e pastas de modelo conforme você projeta. 

   O local do projeto não deve conter um modelo de aplicativo existente.
**nota**  
A **sincronização local** requer um navegador compatível com a API de acesso ao sistema de arquivos. Para obter mais informações, consulte [O Data Infrastructure Composer obtém acesso a](reference-fsa.md#reference-fsa-access).

1. Quando solicitado a permitir o acesso, selecione **Exibir arquivos**.

1. Pressione **Ativar** para ativar a **sincronização local**. Quando solicitado a salvar as alterações, selecione **Salvar alterações**.

   Quando ativado, o indicador de **salvamento automático** será exibido na área superior esquerda da tela.

## Etapa 2: adicionar cartões à tela
<a name="getting-started-build-rest-cards"></a>

Comece a projetar sua arquitetura de aplicativo usando placas de componentes aprimoradas, começando com uma API REST do API Gateway e cinco funções Lambda.

**Para adicionar cartões API Gateway e Lambda à tela**

Na paleta **Recursos**, na seção **Componentes aprimorados**, faça o seguinte:

1. Arraste um cartão do **API Gateway** para a tela.

1. Arraste um cartão **da Função Lambda** para a tela. Repita até adicionar cinco cartões de **Função Lambda** à tela.

![Uma visualização em tela do Infrastructure Composer com um API Gateway e cinco cartões de função Lambda.](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_t2_02.png)


## Etapa 3: Configurar a API REST do API Gateway
<a name="getting-started-build-rest"></a>

Em seguida, adicione cinco rotas em sua placa API Gateway.

**Para adicionar rotas ao cartão API Gateway**

1. Abra o painel **de propriedades do recurso** para o cartão **API Gateway**. Para abrir o painel, clique duas vezes no cartão. Ou selecione o cartão e, em seguida, escolha **Detalhes**.

1. No painel **Propriedades do recurso**, em **Rotas**, faça o seguinte:
**nota**  
Para cada uma das rotas a seguir, use o método HTTP e os valores de caminho especificados na [tabela de referência de propriedades do recurso](#getting-started-build-reference).

   1. Em **Método**, escolha o método HTTP especificado. Por exemplo, **GET**.

   1. Em **Caminho**, insira o caminho especificado. Por exemplo, .**/items**

   1. Selecione **Adicionar rota**.

   1. Repita as etapas anteriores até adicionar todas as cinco rotas especificadas.

1. Escolha **Salvar**.

![A tela visual do Infrastructure Composer com um recurso do API Gateway com cinco rotas. O Resource properties painel mostra as seleções para Método, Caminho e Adicionar rota.](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_t2_03.png)


## Etapa 4: Configurar suas funções do Lambda
<a name="getting-started-build-functions"></a>

Nomeie cada uma das cinco funções do Lambda conforme especificado na tabela de [referência de propriedades do recurso](#getting-started-build-reference).

**Para nomear as funções Lambda**

1. Abra o painel **de propriedades do recurso** de um cartão de **função Lambda**. Para abrir o painel, clique duas vezes no cartão. Ou selecione o cartão e, em seguida, escolha **Detalhes**.

1. No painel **Propriedades do recurso**, em **ID lógica**, insira um nome de função especificado. Por exemplo, .**getItems**

1. Escolha **Salvar**.

1. Repita as etapas anteriores até nomear todas as cinco funções.

![A tela visual do Infrastructure Composer com cinco cartões de recursos nomeados da Função Lambda.](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_t2_04.png)


## Etapa 5: Conecte seus cartões
<a name="getting-started-build-connect"></a>

Conecte cada rota em sua placa do **API Gateway** à placa relacionada **da Função Lambda**, conforme especificado na tabela de [referência de propriedades do recurso](#getting-started-build-reference).

**Para conectar seus cartões**

1. Clique em uma porta direita na placa **API Gateway** e arraste-a para a porta esquerda da placa **Lambda Function** especificada. Por exemplo, clique na porta **GET /items** e arraste-a para a porta esquerda de **GetItems**.

1. Repita a etapa anterior até conectar todas as cinco rotas na placa **API Gateway** às placas de **função Lambda** correspondentes.

![A tela visual do Infrastructure Composer com a API REST conectada a cinco funções Lambda.](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_t2_05.png)


## Etapa 6: organizar a tela
<a name="getting-started-build-organize"></a>

Organize a tela visual agrupando suas funções do Lambda e organizando todos os cartões.

**Para agrupar suas funções**

1. Pressione e segure a **tecla Shift** e selecione cada cartão **da Função Lambda** na tela.

1. Escolha **Grupo**.

**Para nomear seu grupo**

1. Clique duas vezes na parte superior do grupo, perto do nome do grupo (**Grupo**).

   O painel **Propriedades do grupo** é aberto.

1. No painel **Propriedades do grupo**, em **Nome do grupo**, insira**API**.

1. Escolha **Salvar**.

**Para organizar seus cartões**

Na tela, acima da área de exibição principal, escolha **Organizar**.

O Infrastructure Composer organiza e alinha todos os cartões na tela visual, incluindo seu novo grupo (**API**), conforme mostrado aqui:

![A tela visual do Infrastructure Composer organizada com todas as funções do Lambda agrupadas.](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_t2_06.png)


## Etapa 7: Adicionar e conectar uma tabela do DynamoDB
<a name="getting-started-build-table"></a>

Agora, adicione uma tabela do DynamoDB à arquitetura do seu aplicativo e conecte-a às suas funções do Lambda.

**Para adicionar e conectar uma tabela do DynamoDB**

1. Na paleta de recursos (**Recursos**), na seção **Componentes aprimorados**, arraste um cartão de tabela **do DynamoDB para a tela**.

1. **Clique na porta direita em uma placa de **função Lambda** e arraste-a até a porta esquerda da placa de tabela do DynamoDB.**

1. **Repita a etapa anterior até conectar todos os cinco cartões de **função Lambda** ao cartão de tabela do DynamoDB.**

1. **(Opcional) Para reorganizar e realinhar os cartões na tela, escolha Organizar.**

![](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_t2_07.png)


## Etapa 8: revise seu AWS CloudFormation modelo
<a name="getting-started-build-template"></a>

Parabéns\! Você projetou com sucesso um aplicativo sem servidor que está pronto para implantação. Por fim, escolha **Modelo** para revisar o AWS CloudFormation modelo que o Infrastructure Composer gerou automaticamente para você.

No modelo, o Infrastructure Composer definiu o seguinte:
+ A `Transform` declaração, que especifica o modelo como um modelo AWS Serverless Application Model (AWS SAM). Para obter mais informações, consulte [anatomia do AWS SAM modelo](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-specification-template-anatomy.html) no *Guia do AWS Serverless Application Model desenvolvedor*.
+ Um `AWS::Serverless::Api` recurso que especifica sua API REST do API Gateway com suas cinco rotas.
+ Cinco `AWS::Serverless::Function` recursos, que especificam as configurações de suas funções do Lambda, incluindo suas variáveis de ambiente e políticas de permissões.
+ Um `AWS::DynamoDB::Table` recurso que especifica sua tabela do DynamoDB e suas propriedades.
+ A `Metadata` seção, que contém informações sobre seu grupo de recursos (**API**). Para obter mais informações sobre essa seção, consulte [Metadados](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/metadata-section-structure.html) no *Guia do AWS CloudFormation usuário*.

![A visualização do modelo do Infrastructure Composer mostrando o código do modelo do aplicativo.](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_t2_08.png)


## Etapa 9: Integre-se aos seus fluxos de trabalho de desenvolvimento
<a name="getting-started-build-integrate"></a>

Use o arquivo de modelo e os diretórios do projeto que o Infrastructure Composer criou para testes e implantação adicionais.
+ Com a **sincronização local**, você pode conectar o Infrastructure Composer ao IDE em sua máquina local para acelerar o desenvolvimento. Para saber mais, consulte [Conecte o console do Infrastructure Composer ao seu IDE local](other-services-ide.md).
+ Com a **sincronização local**, você pode usar a interface de linha de AWS Serverless Application Model comando (AWS SAM CLI) em sua máquina local para testar e implantar seu aplicativo. Para saber mais, consulte [Implemente seu aplicativo sem servidor Infrastructure Composer na nuvem AWS](other-services-cfn.md).

## Próximas etapas
<a name="getting-started-build-next"></a>

Agora você está pronto para criar seus próprios aplicativos com o Infrastructure Composer. Para obter detalhes detalhados sobre o uso do Infrastructure Composer, consulte. [Como compor em AWS Infrastructure Composer](using-composer-basics.md) Quando estiver pronto para implantar seu aplicativo, consulte[Implemente seu aplicativo sem servidor Infrastructure Composer na nuvem AWS](other-services-cfn.md).