Nesta página

Visao Geral de Servicos

Um servico e a unidade fundamental de deploy no Guara Cloud. Ele representa sua aplicacao rodando na nuvem — seja uma API, um site, um worker ou qualquer outro processo que rode em container.

O que e um servico?

Cada servico corresponde a uma aplicacao deployada. Voce pode ter varios servicos dentro de um mesmo projeto, cada um com sua propria configuracao, variaveis de ambiente e dominio.

Ao criar um servico, ele recebe automaticamente:

  • Endpoint HTTP — uma URL publica no formato seu-servico-seu-projeto.guaracloud.com com HTTPS incluso
  • Recursos computacionais — CPU e memoria alocados de acordo com o plano do seu projeto
  • Variaveis de ambiente — configuracoes e segredos injetados no seu container
  • Dominio padrao — subdominio automatico *.guaracloud.com com certificado SSL gratuito

Como servicos funcionam

Servicos rodam em containers. Voce pode fornecer um Dockerfile no seu repositorio ou deixar o Guara Cloud detectar automaticamente o ambiente da sua aplicacao usando Buildpacks. Tambem e possivel deployar diretamente a partir de uma imagem Docker pre-construida.

Cada servico opera de forma independente. Isso significa que voce pode deployar, parar, reiniciar ou escalar um servico sem afetar os outros servicos do mesmo projeto.

Ciclo de vida de um servico

Um servico passa pelas seguintes etapas:

  1. Criar — voce define o nome, a fonte (GitHub ou imagem Docker) e as configuracoes iniciais
  2. Configurar — voce adiciona variaveis de ambiente, define a porta e ajusta os recursos
  3. Deployar — o Guara Cloud constroi a imagem (se necessario) e coloca o servico no ar
  4. Saudavel — o servico esta rodando e respondendo a requisicoes

O que voce pode fazer com servicos

  • Deploy via GitHub — conecte seu repositorio e tenha deploys automaticos a cada push
  • Deploy via imagem Docker — use uma imagem pre-construida de qualquer registry publico
  • Variaveis de ambiente — gerencie configuracoes e segredos de forma segura
  • Escalabilidade — ajuste replicas, CPU e memoria conforme a demanda
  • Armazenamento persistente — volumes que sobrevivem a reinicializacoes do servico
  • Dominios customizados — aponte seu proprio dominio para qualquer servico

Proximos passos