---
name: azion-como-implantar-o-azion-starter-kit
description: >-
  Este template acelera a criação de um stack de edge básico para explorar a plataforma da Azion e seus recursos.
---

# Como implantar o Azion Starter Kit

**Azion Starter Kit** é ideal para dar os primeiros passos na Azion Web Platform. Com este template, você pode acelerar a criação de um stack de edge básico para explorar a plataforma e seus recursos.

Este template inclui:

- A implantação de uma nova application, com regras comuns de cache para imagens e arquivos dinâmicos e estáticos.
- Recursos do Azion Image Processor para manipular e processar imagens diretamente na Azion.
- A criação de um novo firewall com regras para executar uma instância de function para o Bot Manager Lite e negar requisições da network list pré-construída Azion IP Tor Exit Nodes.

---

## Pré-requisitos

Para usar este template, você deve:

- Habilitar os módulos de **Functions**, **Application Accelerator**, **Image Processor** e **Network Shield** em sua conta.
- Instalar a versão mais recente do **Bot Manager Lite**.
  - Acesse o [Marketplace da Azion](https://console.azion.com/marketplace) para instalar a integração selecionando o botão **Install**. Consulte o guia [Como instalar o Azion Bot Manager Lite](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/integracoes/bot-manager-lite/) para mais detalhes.
  - Se você não instalou a função Bot Manager Lite antes de tentar usar este template, a execução falhará e um log explicando o motivo será mostrado.
- O template usa [Application Accelerator](/pt-br/documentacao/plataforma/applications/#application-accelerator), [Functions](/pt-br/documentacao/plataforma/functions/), [Image Processor](/pt-br/documentacao/plataforma/applications/#image-processor) e [Network Shield](/pt-br/documentacao/plataforma/firewall/#network-shield). 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/azion/azion-starter-kit)

---

## Configure o template

No formulário de configuração, você deve fornecer as informações para configurar sua aplicação. Preencha os campos apresentados.

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

- **Application Name** \*: o nome da sua nova application, do domain e do firewall na Azion.
  - Use um nome único e fácil de lembrar. Se o nome já foi usado, a plataforma retornará uma mensagem de erro.
- **Origin Address** \*: o endereço da origem de onde a application deve buscar o conteúdo original.
  - Exemplo: `www.yourwebsite.com`
- **Custom Host Header**: em alguns casos, pode ser necessário substituir o valor do cabeçalho `Host` na requisição para a origem. Defina um valor para o cabeçalho `Host` neste campo.
  - Use a variável `${host}` para retirar o valor do cabeçalho `Host` da URI da requisição. Saiba mais sobre o Host Header e como customizá-lo no [documentação de Origins](/pt-br/documentacao/plataforma/connectors/origins/#host-header).

Depois de preencher todas as informações, selecione o botão **Deploy**, localizado no canto inferior direito.

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.

### Regras e configurações

A application implantada inclui as seguintes regras e configurações:

- **Criteria**: if `${uri}` *starts with* `/`.
- **Behavior**: then [Set Origin](/pt-br/documentacao/plataforma/applications/rules-engine/#set-connector) as `Default Origin`.
- Para otimização e cache de imagens, as extensões de arquivo que podem ser aprimoradas são `.jpg`, `.jpeg`, `.bmp`, `.ico`, `.gif`, `.png`.
- Para conteúdo estático, o template suporta as extensões de arquivo estático comuns.
- Além disso, o template:
  - Respeita as configurações de cache da origem (ou usa um TTL padrão para cache).
  - Fornece regras que alteram as configurações de cache para arquivos estáticos com base na extensão do arquivo solicitado para melhorar a entrega.

Além disso, o firewall aprimora a segurança por meio da network list [IP Tor Exit Nodes da Azion](/pt-br/documentacao/guias/seguranca-de-aplicacoes/bots-e-rede/bloquear-redes-tor/) e do [Bot Manager Lite da Azion](/pt-br/documentacao/guias/desenvolvimento-de-aplicacoes/integracoes/bot-manager-lite/).

A instância da função para o Bot Manager Lite tem os seguintes argumentos JSON:

```json
{
  "threshold": 10,
  "action": "allow",
  "internal_logs": 2
}
```

Onde:

- `threshold`: a pontuação máxima que a requisição pode atingir antes que a função execute uma ação. Se não tiver valor, a função não executará ação nenhuma. Valor padrão: `10`.
- `action`: a ação a ser tomada pela função sempre que a pontuação da requisição for maior ou igual ao limite definido. Valores possíveis: `allow`, `custom_html`, `deny`, `drop`, `hold_connection`, `random_delay` e `redirect`. Valor padrão: `allow`.
- `internal_logs`: toda execução do Bot Manager Lite grava logs de relatório, independentemente da pontuação da requisição.

Os logs podem ser consultados no [Real-Time Events](/pt-br/documentacao/plataforma/real-time-events/). Ao analisar os logs gerados pelo Bot Manager Lite, você pode obter insights para entender se são necessárias quaisquer alterações nos argumentos JSON da instância da função. Você também pode usar o [Data Stream da Azion](/pt-br/documentacao/plataforma/data-stream/) como uma ferramenta de observabilidade. Leia mais sobre [Como observar logs e calibrar regras](/pt-br/documentacao/guias/seguranca-de-aplicacoes/bots-e-rede/monitorar-e-calibrar-bot-manager/#leia-o-log-de-report-no-real-time-events).

---

## 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 o [Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/) > **Applications**.

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

2. **Selecione sua application**

   Selecione a aplicação relacionada ao 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/).

Saiba como implantar o Azion Starter Kit:

[How to deploy the Azion Starter Kit](https://www.youtube.com/watch?v=9VDnYVGf5lI)

This template accelerates the creation of a basic edge stack to explore Azion's platform and its features.