Deploy a partir do Docker Hub

O App Platform permite implantar uma aplicação diretamente a partir do Docker Hub sem a necessidade de vincular contas ou configurar autenticação. O único requisito é que a imagem seja pública.

Essa abordagem é ideal para iniciar rapidamente soluções prontas, especialmente quando você não precisa modificar a imagem manualmente. Por exemplo, você pode implantar o n8n ou outros serviços distribuídos via Docker Hub.

Gerenciamento de portas

O App Platform expõe automaticamente sua aplicação por meio de um proxy reverso.

A porta da aplicação é determinada com base em:

• Metadados da imagem Docker (por exemplo, EXPOSE);
• Variáveis de ambiente, caso definam explicitamente uma porta.

Se nenhuma porta for especificada, será utilizado um valor padrão.

Não é necessário configurar o proxy manualmente — a plataforma direciona automaticamente o tráfego das portas externas 80 e 443 para a porta interna do contêiner.

Durante reimplantações, a aplicação pode ficar temporariamente indisponível.

Etapa 1: Selecionar a aplicação

1. Acesse a seção Plataforma de Apps e clique em Criar aplicativo.
2. Em Tipo, selecione a aba Docker Hub.

Etapa 2: Escolher região e configuração do servidor

As aplicações são executadas em servidores dedicados na nuvem. Selecione a região de implantação e uma configuração de servidor adequada. Você pode escolher entre planos pré-definidos ou configurar manualmente na aba Custom.

Se necessário, você poderá fazer upgrade para um plano mais robusto posteriormente.

Etapa 3: Configurar uma rede privada

Crie ou selecione uma rede privada para a aplicação e defina o endereço IP que ela utilizará.

Observe que a rede privada não pode ser alterada após a implantação.

Etapa 4: Configurar a aplicação

Defina os parâmetros do contêiner:

• Nome da imagem no Docker Hub a ser implantada;
• Tag ou digest para especificar a versão exata da imagem;
• Variáveis de ambiente (você pode reutilizar existentes ou criar novas).

Apenas imagens públicas são suportadas.

Posteriormente, você pode atualizar a imagem, a tag e as variáveis de ambiente nas configurações da aplicação e iniciar uma nova implantação.

Etapa 5: Definir os detalhes da aplicação

Opcionalmente, defina um nome para a aplicação e adicione uma descrição. Essas informações serão exibidas no painel de controle.

Você também pode selecionar o projeto ao qual a aplicação será vinculada.

Essas configurações podem ser alteradas a qualquer momento.

Etapa 6: Implantar

Clique em Pedido. Assim que o processo for iniciado, você poderá acompanhar o progresso na aba Deploy.

Os logs de implantação geralmente contêm todas as informações necessárias para diagnosticar problemas. Caso algo dê errado — por exemplo, erros no código — os logs exibirão mensagens detalhadas indicando a causa.

Durante a primeira implantação, o provisionamento do servidor pode levar algum tempo. Quando o processo for concluído, o status da aplicação será atualizado e uma mensagem de confirmação aparecerá nos logs.

Você pode encontrar o endereço IP da aplicação e o domínio técnico padrão na aba Painel de Controle. Também é possível configurar um domínio personalizado.