Configuração inicial do Starlight Hyperlift

Starlight™ Hyperlift é a plataforma de implementação na cloud que te permite focar no teu produto, não na infraestrutura. Só precisas de indicar o caminho do Dockerfile e o Hyperlift vai buscar o teu código ao GitHub. Depois, constrói e implementa uma imagem de contentor, para que possas lançar o teu produto online.

Se ainda não tens uma aplicação de produção completa, preparámos uma implementação de teste do Starlight™ Hyperlift usando um repositório de exemplo. Isto permite-te testar rapidamente o processo de build e implementação antes de avançares para o teu ambiente de produção.

Começar com o Hyperlift é rápido e fácil. Se precisares de uma ajudinha, preparámos este vídeo para te guiar em cada passo, desde indicar o caminho do teu Dockerfile até lançares o teu projeto online.

Como configurar o Hyperlift

Para colocares a tua app a funcionar, vais precisar de:

  1. Vai ao Hyperlift Manager do Starlight e liga o teu repositório GitHub.

  2. Adiciona um Dockerfile ao repositório especificado. Tem de começar com uma imagem base válida.

    O Hyperlift depende de um Dockerfile adequado como base para a tua aplicação. Permite-te instalar pacotes, adicionar ficheiros e configurar o ambiente conforme as necessidades da tua app.

    Consulta a documentação oficial do Dockerfile para orientação.

    Nota! Para abrir uma porta para a aplicação, usa as variáveis de ambiente em vez de a expores no Dockerfile.

  3. Depois de ligares a conta GitHub, vais ser redirecionado para o menu Hyperlift Manager.  Aí, o painel lateral de configuração abre automaticamente e podes continuar a configuração:



    O mesmo painel lateral também pode ser acedido a partir do menu Hyperlift Manager > Configuração:


  4. Quando a aplicação estiver configurada, podes fazer o build e depois implementar. Para começares o build da aplicação, clica no botão Build :



    Depois do processo terminar com sucesso, a implementação começa automaticamente. A faturação é ativada neste momento. A informação correspondente é apresentada na seguinte notificação: 


  5. Depois de tudo configurado e a aplicação a funcionar, podes iniciar, parar ou reiniciar a aplicação conforme precisares:

O menu dividido do Hyperlift Manager

Também é possível gerir a aplicação Hyperlift a partir do menu dividido. Os seguintes menus estão disponíveis a partir daí:

  • Variáveis de ambiente - Guarda definições como chaves API, URLs de bases de dados, portas e detalhes de configuração.

    Nota: A porta padrão da aplicação Hyperlift é 8080, mas podes usar este menu para a alterar e atualizar conforme necessário.

  • Definições da aplicação - Aqui podes ajustar definições como o nome da aplicação, repositório GitHub, ramo do repositório e o caminho do Dockerfile da aplicação.

  • Instruções de autenticação - Isto redireciona para o guia “Como ligar um repositório GitHub ao Starlight Hyperlift”.

  • Registos da aplicação -  Os registos recolhidos durante a execução da aplicação serão apresentados aqui.

  • Ligações - Vê as ligações ativas (domínios, certificados SSL, etc.) instaladas para a subscrição Hyperlift.

Builds automáticos


Também podes escolher se os builds são acionados manualmente ou automaticamente. 

Com as definições de build automático, sempre que fizeres push de código para o ramo especificado, o Hyperlift vai construir e implementar automaticamente a tua app a partir do GitHub usando o teu Dockerfile.

Para ativares isto durante a configuração da aplicação, vai ao menu Hyperlift Manager > Definições da aplicação > Configurar aplicação. Aqui podes ativar ou desativar os builds automáticos:



Se a opção “Build automático” estiver desativada (o respetivo botão está desligado), então o build manual está configurado e não são feitas atualizações automáticas da aplicação.

Recomendações

  • Usa imagens base pequenas e eficientes para o Dockerfile.

  • Etiqueta explicitamente as versões das imagens base (por exemplo, python:3.12).

  • Define variáveis de ambiente no menu correspondente do Starlight Hyperlift.

  • Monitoriza os registos de build e da aplicação.

É necessário um email válido