title | description | meta_tags | namespace | permalink |
---|---|---|---|---|
Como criar edge applications com o Astro Boilerplate |
O Astro Boilerplate fornece uma solução de automação para criar uma edge application Astro na Azion. |
templates, guias, Azion Marketplace |
docs_guides_astro_boilerplate |
/documentacao/produtos/guias/astro-boilerplate/ |
import Badge from '~/components/Badge.astro';
PreviewO Astro Boilerplate da Azion ajuda você a criar uma Astro Single-Page Application (SPA) e executá-la diretamente no edge da rede. O boilerplate encapsula e automatiza diversas etapas, desde o gerenciamento do repositório até a implantação no edge.
Este boilerplate usa o Astro versão 2.6.4
.
- Uma conta no GitHub para conectar com a Azion e criar seu novo repositório.
- Cada push será implantado automaticamente neste repositório para manter seu projeto atualizado.
- Habilitar o Edge Functions na sua conta Azion.
Para fazer isso:
- Acesse o Azion Console > Account menu.
- Selecione a opção Billing & Subscriptions.
- Clique na aba Subscriptions.
- Ative o switch do módulo.
:::caution[Atenção] Se esse módulo estiver ativado, a execução deste template poderá gerar custos relacionados ao uso. Consulte a página de preços para obter mais informações. :::
Para começar a usar o Astro Boilerplate:
- Acesse o Azion Console.
- Clique no botão + Create na página inicial.
- No modal, selecione a opção Templates.
- Navegue e selecione o card do Astro Boilerplate.
Uma vez que você está na página do template, clique na aba Settings para abrir o formulário de configuração e fornecer as informações para configurar sua aplicação.
Os campos identificados com asterisco são obrigatórios.
- Application Name *: o nome da sua aplicação. Ele é usado para identificar e gerenciar sua aplicação na plataforma da Azion.
- Digite um nome único e fácil de lembrar. Se o nome já tiver sido usado, a plataforma retornará uma mensagem de erro.
- GitHub Personal Token *: seu personal token do GitHub.
:::tip Ao gerar seu token pessoal no GitHub, garanta que seu scope tenha permissões para autorizar uma OAuth app ou um token pessoal para acessar repositórios públicos e privados, incluindo acesso de leitura e escrita no código. Você também deve ativar a opção de workflow para permitir a adição e atualização de arquivos de workflow do GitHub Actions.
Observe que as permissões podem ter como escopo um usuário, uma organização ou um repositório. Leia a documentação sobre como criar um token de acesso pessoal para obter mais informações. :::
Depois de preencher todas as informações, clique no botão Next, localizado no canto inferior direito para iniciar o deployment.
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.
- Conecte a Azion com sua conta no GitHub.
- Uma janela pop-up será aberta para confirmar a instalação da 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.
- Selecione o Git Scope com o qual trabalhar.
- Defina um nome para sua edge application.
- O bucket para armazenamento e a edge 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.
- Clique no botão Save 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.
:::note O link para sua edge application permite que você veja como ela fica no navegador. No entanto, leva um certo tempo para propagar e configurá-la nas edge locations 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. :::
A aplicação passa por um processo de criação otimizado, enfatizando um melhor desempenho e eficiência, aproveitando os recursos da Plataforma de Edge da Azion.
O script cria um repositório do GitHub para gerenciar o código-fonte e, em seguida, instala todas as dependências necessárias. também inclui uma GitHub Action para habilitar a implantação contínua.
Além disso, sua aplicação é implantada na plataforma da Azion e inclui múltiplas configurações prontas, como o setup da edge application e do seu domínio para hospedar seu projeto Astro e uma edge function para lógica personalizada.
O script também confirma os detalhes da implantação no repositório do GitHub do usuário para manter um histórico transparente e rastreável, incluindo informações relacionadas à versão implantada e um registro de data e hora da implantação.
Se você quiser saber mais sobre como editar e personalizar as configurações do seu projeto, acesse a seção 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 aplicação, siga estas etapas:
- Acesse o Azion Console.
- No canto superior esquerdo, selecione Products menu > Edge Application.
- Você será redirecionado para a página de Edge Application. Ela lista todas as edge applications que você criou.
- Encontre a edge application relacionada ao Astro Boilerplate e selecione-a.
- 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 edge 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 configurar.
:::tip Leia a documentação sobre o gerenciamento de edge applications para obter mais detalhes. :::
A edge application criada tem um domínio Azion 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.
import Button from '~/components/Button.astro';
import ContributorList from '~/components/ContributorList.astro'
Contribuidores Contributor