---
name: azion-como-criar-applications-com-o-gatsby-boilerplate
description: >-
  Esse template ajuda você a construir uma Single-Page Application (SPA) baseada no framework Gatsby e executá-la na infraestrutura distribuída da Azion.
---

# Como criar applications com o Gatsby Boilerplate

O **Gatsby Boilerplate** ajuda você a construir uma Single-Page Application (SPA) baseada no framework Gatsby e executá-la diretamente na infraestrutura distribuída da Azion. Ao executar o boilerplate, vários passos são encapsulados e automatizados, desde o gerenciamento do repositório até o deployment.

Este template implanta uma application, um domínio e um repositório GitHub relacionado para facilitar seu acesso e gerenciamento. Ele também contém uma GitHub Action para habilitar um fluxo de trabalho de integração contínua e manter sua aplicação e repositório atualizados.

O Gatsby Boilerplate utiliza a versão `5.13.3` do Gatsby e a versão `18.2.0` do React.

---

## Pré-requisitos

Para usar este template, você deve:

- Ter uma [conta no GitHub](https://github.com/signup) para conectar com a Azion e criar seu novo repositório.
  - Cada push será implantado automaticamente neste repositório para manter seu projeto atualizado.
- O template usa [Application Accelerator](/pt-br/documentacao/plataforma/applications/#application-accelerator). Isso pode gerar custos relacionados ao uso. Consulte a [página de preços](/pt-br/documentacao/fundamentos/precos/) para mais informações.

---

## Implante o template

Você pode obter e configurar seu template pelo Azion Console. Para implantá-lo facilmente na Azion, selecione o botão abaixo.

[Implantar](https://console.azion.com/create/gatsby/gatsby-boilerplate)

---

## Configure o template

No formulário de configuração, forneça as informações para configurar sua aplicação. Preencha os campos apresentados.

Os campos identificados com asterisco são obrigatórios.

1. **Conecte a Azion com sua conta do GitHub**

   - Uma janela pop-up será aberta para confirmar a instalação da [Azion GitHub App](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/automacao/azion-github-app/), uma ferramenta que conecta sua conta do GitHub com a plataforma da Azion.
   - Defina suas permissões e acesso ao repositório conforme desejado.

2. **Selecione o Git Scope**

   Selecione o **Git Scope** com o qual trabalhar.

3. **Defina um nome para sua aplicação**

   - O bucket para armazenamento e a function usarão o mesmo nome.
   - Use um nome único e fácil de lembrar. Se o nome já tiver sido usado, a plataforma retornará uma mensagem de erro.

4. **Selecione Deploy**

   Selecione o botão **Deploy** para iniciar o processo de implantação.

Durante a implantação, você poderá acompanhar o processo através de uma janela mostrando os logs. Quando estiver concluída, a página mostra informações sobre a aplicação e algumas opções para continuar sua jornada.

> **nota**
>
> O link para sua application permite que você veja como ela fica no navegador. No entanto, leva um certo tempo para propagar e configurá-la na infraestrutura distribuída da Azion. Pode ser necessário aguardar alguns minutos para que a URL seja ativada e para que a página da aplicação seja efetivamente exibida no navegador.

---

## Gerencie o template

Considerando que essa configuração inicial pode não ser ideal para sua aplicação, todas as configurações podem ser personalizadas sempre que você precisar usando o Azion Console.

Para gerenciar e editar as configurações da sua application:

1. **Acesse Applications**

   Acesse [Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/) > **Applications**.

   - Você será redirecionado para a página **Applications**. Ela lista todas as applications que você criou.

2. **Selecione sua aplicação**

   Selecione a aplicação relacionada a este template.

   - A lista é organizada em ordem alfabética. Você também pode usar a **barra de busca** localizada no canto superior esquerdo da lista; atualmente, ela é filtrada apenas pelo **Application Name**, ou nome da application.

Depois de selecionar a aplicação em que você trabalhará, você será direcionado para uma página que contém todas as configurações que você pode ajustar.

> **dica**
>
> Consulte a documentação sobre o [gerenciamento de applications](/pt-br/documentacao/plataforma/applications/primeiros-passos/) para obter mais detalhes.

### Adicione um domínio personalizado

A application criada tem um Azion Workload Domain atribuído para torná-la acessível através do navegador. O domínio tem o seguinte formato: `xxxxxxxxxx.map.azionedge.net`. No entanto, você pode adicionar um domínio personalizado para que os usuários acessem sua aplicação por meio dele.

Para mais informações, consulte [Adicione um domínio a um workload](/pt-br/documentacao/guias/plataforma/migracao/configurar-dominio/).