Importe um projeto do GitHub
Importe um repositório do GitHub no Azion Console para fazer o build e o deploy dele como uma aplicação, com um novo deploy a cada push.
Você pode importar um repositório do GitHub no Azion Console para fazer o build e o deploy dele como uma aplicação. Após a importação, cada push no repositório faz o deploy dele de novo. Para fazer o deploy de um projeto pelo terminal, consulte Azion CLI deploy.
Pré-requisitos
- Uma conta Azion. Para criar uma, consulte Criar uma conta.
- Uma conta do GitHub.
- Um repositório construído com um framework que a lista Preset traz: Next.js, Angular, Astro, Hexo, React ou Vue. Para detalhes de cada framework, consulte Compatibilidade com web frameworks.
- O código do projeto na raiz do repositório, não em um subdiretório.
Para começar de um projeto que funciona, faça fork de um dos exemplos de código da Azion e importe o seu fork.
Importe o repositório
O formulário de importação conecta o Azion Console à sua conta do GitHub, lê um repositório e faz o deploy dele com o preset de framework que você seleciona.
Para importar o repositório no Azion Console:
Acesse Azion Console > Create. O diálogo New abre.
No diálogo New, selecione a aba Import from GitHub. Em uma conta sem deployments, o botão Import da página Home abre a mesma aba.
Na aba Import from GitHub, selecione o card. A página Import from GitHub abre.
Na seção GitHub Connection, selecione Connect with GitHub. Uma janela do GitHub abre e pede que você instale o Azion GitHub App. Defina as permissões e o acesso aos repositórios e confirme a instalação.
O botão Connect with GitHub aparece somente enquanto nenhuma conta do GitHub está conectada.
Em Git Scope, selecione a conta do GitHub da qual importar. Para conectar outra conta, selecione Add GitHub Account.
Em Repository, selecione o repositório. A lista fica indisponível até você selecionar um escopo.
Na seção General, mantenha ou altere o Application Name. O Console preenche o campo com o nome do repositório.
O nome deve ser único na sua conta; um nome já em uso retorna um erro. O bucket de armazenamento e a function do projeto recebem o mesmo nome.
Em Preset, selecione o framework do repositório: Next.js, Angular, Astro, Hexo, React ou Vue. O preset define as configurações iniciais para esse framework.
Em Root Directory, mantenha /, o padrão. O valor deve começar com / e não pode conter .. nem espaços.
Em Install Command, informe o comando que instala o projeto. Por exemplo: npm install.
Na seção Variables, selecione Variable e informe uma Key e um Value. Por exemplo: chave API_URL, valor www.apiurl.com/abc.
A chave aceita letras maiúsculas, números e underscores. Após o deploy, você pode editar uma variável, ou transformá-la em um segredo, na página Variables do menu Account.
O botão Deploy fica indisponível até que cada campo obrigatório tenha um valor válido.
A página de deploy abre com o título Deploy: <Application Name> e mostra Project is being created enquanto o build roda.
Verifique o deployment
A página de deploy de um repositório importado mostra a saída do build no painel Deploy Log e traz o link da aplicação quando o deploy termina.
Para verificar o deployment no Azion Console:
Na página de deploy, leia a saída do build no painel Deploy Log. Quando o deploy termina, a notificação Successfully created! aparece.
No card da aplicação, selecione o link do domínio. O domínio tem o formato xxxxxxxxxx.map.azionedge.net.
Selecione Manage. As configurações da aplicação abrem no Console. Depois, você acessa as mesmas configurações pela página Applications.
A aplicação responde no seu domínio Azion. O primeiro deploy pode levar vários minutos para responder de todas as localidades. Se o domínio ainda não responder, aguarde alguns minutos e tente de novo.
Se o deploy falhar, a página mostra Creation failed. O painel Deploy Log traz os detalhes da falha.
O repositório continua conectado após a importação: cada push nele faz o deploy da aplicação de novo. Para servir a aplicação no seu próprio domínio em vez do domínio Azion, adicione um domínio personalizado.