Fazer deploy de um app Axum

Você pode encontrar o guia passo a passo para fazer deploy aqui.

Este guia explica como fazer build e deploy de uma aplicação Axum na Hostman App Platform. Também mostra como a plataforma identifica o binário correto para execução e quais requisitos a aplicação deve atender para funcionar corretamente em produção.

Build da Aplicação

A aplicação é compilada usando o seguinte ambiente:

• Rust
• Cargo

O processo de build é executado na raiz do repositório ou no diretório definido no campo Caminho do diretório do projeto.

O template utiliza um processo de build em múltiplos estágios. Na primeira etapa, o binário da aplicação é compilado em modo release. Na segunda etapa, a imagem final executa a aplicação compilada.

Por padrão, o seguinte comando é executado durante o build:

cargo build --locked --release

Certifique-se de que o projeto contém um arquivo Cargo.toml válido com todas as dependências configuradas corretamente.

A flag --locked faz com que o Cargo utilize as versões definidas no arquivo Cargo.lock. Garanta que o Cargo.lock esteja atualizado e versionado no repositório.

Se a aplicação precisar de pacotes adicionais do sistema durante o build, como bibliotecas OpenSSL, adicione-os no campo Dependências. Esses pacotes serão instalados antes da execução do comando cargo build.

Selecionando o Binário de Execução

Depois que o build é concluído, a App Platform seleciona o binário de execução usando a seguinte lógica:

1. Se o comando de build incluir explicitamente a flag --bin <name> ou --bin=<name>, esse binário será utilizado.
2. Se a flag --bin não for informada, o template tentará identificar o binário usando o valor default-run definido no Cargo.toml através do cargo metadata.
3. Caso default-run não esteja configurado, o template fará uma varredura no diretório target/release.
4. Se apenas um binário executável for encontrado, ele será utilizado automaticamente.
5. Se houver múltiplos binários executáveis, o build será finalizado com erro. Nesse caso, informe explicitamente o binário no comando de build:

cargo build --locked --release --bin <name>

Requisitos da Aplicação

Certifique-se de que a aplicação esteja escutando em 0.0.0.0 e não em 127.0.0.1. Caso contrário, conexões externas não conseguirão acessar a aplicação.