Nesta página

Criando um Serviço

Criar um serviço no Guara Cloud leva apenas alguns minutos. Siga o passo a passo abaixo para colocar sua aplicação no ar.

Passo a passo

  1. Acesse seu projeto e clique em “Novo Serviço”

    No dashboard, entre no projeto onde deseja criar o serviço e clique no botão Novo Serviço.

  2. Fonte: dê um nome ao serviço

    Escolha um nome para o serviço (por exemplo, api ou web-app). O slug é gerado automaticamente a partir do nome.

  3. Build: escolha como a aplicação é construída

    Escolha o método de build:

    • GitHub (Dockerfile) — build a partir do Dockerfile do repositório
    • GitHub (Buildpack) — detecção automática da linguagem, sem Dockerfile
    • Imagem Docker — deploy direto de uma imagem existente, de um registry público ou privado

    Para GitHub, selecione o repositório e a branch. Se o GitHub App ainda não estiver instalado, você será redirecionado para conceder acesso. Escolha também o tipo de serviço: Serviço Web (escuta em uma porta e recebe tráfego HTTP) ou Worker (processo em segundo plano, sem tráfego de entrada). Em Opções Avançadas de Build você pode definir o caminho do Dockerfile e os comandos de build e de inicialização.

  4. Ambiente: configure variáveis de ambiente (opcional)

    Adicione as variáveis de ambiente que sua aplicação precisa, como DATABASE_URL, API_KEY ou NODE_ENV. Você pode adicionar ou alterar essas variáveis a qualquer momento após a criação.

  5. Recursos: defina a porta, o endpoint e o armazenamento

    Para um serviço web, defina a porta na qual sua aplicação escuta dentro do container. O padrão é 3000, mas você pode alterá-la (por exemplo, 8080 para uma aplicação Go ou Java).

    Serviços web novos já vêm com o endpoint público ativo, com HTTPS automático. Desative se o serviço só deve ser acessado por outros serviços do projeto, pelo endpoint privado. Se precisar guardar arquivos, ative o armazenamento persistente e defina o tamanho e o caminho de montagem do volume.

  6. Clique em “Criar Serviço”

    O Guara Cloud constrói a imagem da sua aplicação (se necessário) e inicia o deploy automaticamente.

Apos a criacao

Depois de criar o servico, voce pode acompanhar o progresso do build e do deploy diretamente no dashboard. Quando o servico estiver saudavel, ele estara acessivel pela URL automatica.

Voce pode a qualquer momento:

  • Alterar variaveis de ambiente
  • Ajustar o tamanho do pod e as réplicas na aba Recursos
  • Configurar um domínio customizado
  • Ativar ou desativar o endpoint público

Proximos passos