- Documentação
- Serviços
- Criando um Serviço
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
-
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.
-
Fonte: dê um nome ao serviço
Escolha um nome para o serviço (por exemplo,
apiouweb-app). O slug é gerado automaticamente a partir do nome. -
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.
-
Ambiente: configure variáveis de ambiente (opcional)
Adicione as variáveis de ambiente que sua aplicação precisa, como
DATABASE_URL,API_KEYouNODE_ENV. Você pode adicionar ou alterar essas variáveis a qualquer momento após a criação. -
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,
8080para 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.
-
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
- Deploy via GitHub — configure deploys automaticos
- Deploy via imagem Docker — use uma imagem pre-construida
- Configuracao de build — escolha entre Dockerfile e Buildpack
- Links de deploy — abra este assistente pre-preenchido por uma URL