Como implantar o Docusaurus TypeScript Boilerplate

O Docusaurus TypeScript Boilerplate é um exemplo inicial para implantar um projeto estático básico baseado no framework Docusaurus e escrito em TypeScript.

O Docusaurus é um gerador de sites estáticos, que constrói uma single-page application (SPA) com navegação rápida do lado do cliente e aproveita o React para tornar o site interativo. É ideal para recursos de documentação e outros casos, incluindo sites, páginas de produtos, blogs e páginas de destino.

A implantação deste template cria um repositório no GitHub contendo seu projeto, bem como uma edge application e um domínio para facilitar seu acesso e gerenciamento através da Plataforma de Edge da Azion.

Este template usa o Docusaurus 3.

Pré-requisitos

• 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 Application Accelerator na sua conta.
  • Para fazer isso, vá para a seção Billing & Subscriptions e ative o interruptor para cada módulo.
  • Se este módulo não estiver ativado, a execução falhará e um log explicando o motivo será mostrado.
  • Se este módulo estiver ativado, implantar este template pode gerar custos relacionados ao uso. Consulte a página de preços para mais informações.

Implante o template

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

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

2. Selecione o Git Scope com o qual trabalhar.
3. Defina um nome para sua edge application.

• O bucket para armazenamento usará 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. Clique no 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.

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:

1. Acesse o Azion Console.
2. 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.

3. Encontre a edge application relacionada ao template 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.

Adicione um domínio personalizado

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.