Nesta página

Conceitos

Antes de comecar a usar o Guara Cloud, e importante entender alguns conceitos fundamentais da plataforma.

Servicos

Um servico e a unidade de deploy do Guara Cloud. Cada servico representa uma aplicacao rodando na cloud. Voce encontra todos os seus servicos, de todos os projetos, em Servicos no dashboard.

  • Cada servico esta conectado a um repositorio GitHub e uma branch.
  • Voce define a porta HTTP que sua aplicacao expoe (por exemplo, 3000, 8080).
  • Cada servico usa CPU e RAM do pool da conta do seu plano, compartilhado por todos os seus servicos.
  • Voce pode configurar dominios customizados, variaveis de ambiente e volumes persistentes para cada servico.

Projetos

Um projeto agrupa servicos que andam juntos, como o app, a API e o banco de dados de um mesmo produto. Servicos do mesmo projeto se comunicam por uma rede privada.

  • Voce nao precisa criar um projeto para comecar: seu primeiro servico vai para o seu projeto padrao, que voce pode renomear a qualquer momento.
  • Voce pode convidar membros para colaborar no projeto, cada um com um papel especifico.
  • O numero maximo de projetos depende do seu plano.

Deploys

Um deploy acontece toda vez que voce publica uma nova versao do seu servico. Isso pode ser automatico (ao fazer push na branch configurada) ou manual (pelo dashboard).

Cada deploy passa pelos seguintes status:

StatusDescricao
PendenteO deploy foi criado e esta aguardando na fila.
BuildandoA imagem da aplicacao esta sendo construida a partir do seu codigo.
DeployandoA nova versao esta sendo disponibilizada.
SaudavelO deploy foi concluido com sucesso e a aplicacao esta rodando.
FalhouOcorreu um erro durante o build ou o deploy. Verifique os logs.

Cron workers

Um cron worker e um disparador agendado que dispara requisicoes HTTP, publicacoes em NATS / Redis / Valkey / RabbitMQ ou NOTIFYs do Postgres em uma expressao cron que voce controla. E um recurso de primeira classe do projeto — como um servico ou um banco — e elimina a necessidade de rodar um “scheduler” dedicado.

  • Cada cron worker tem nome, expressao cron com timezone IANA, destino e payload JSON opcional.
  • Execucoes ficam persistidas com status, numero de tentativas, tempo e motivo de falha estruturado por 30 dias.
  • A quantidade de workers por projeto depende do seu plano; veja Cron Workers.

Papeis e permissoes

O Guara Cloud possui quatro papeis para controle de acesso dentro de um projeto:

PermissaoOwnerAdminMemberViewer
Ver servicos e deploysSimSimSimSim
Criar e editar servicosSimSimSimNao
Fazer deploySimSimSimNao
Gerenciar variaveis de ambienteSimSimSimNao
Convidar membrosSimSimNaoNao
Alterar papeis de membrosSimSimNaoNao
Configuracoes do projetoSimSimNaoNao
Excluir projetoSimNaoNaoNao
Transferir propriedadeSimNaoNaoNao

Planos

O Guara Cloud inicia novas contas em um teste gratis temporario e oferece cinco planos pagos:

RecursoStarterProMaxBusinessEnterprise
Preço mensal R$ 19,99/mês R$ 49/mês R$ 99/mês R$ 199/mês Sob consulta
Projetos por conta 99 99 99 99 Ilimitado
vCPU total (pool da conta) 1 vCPU 2 vCPU 4 vCPU 6 vCPU Personalizado
RAM total (pool da conta) 2 GB 5 GB 12 GB 25 GB Personalizado
Armazenamento total por projeto 20 GiB 30 GiB 50 GiB 100 GiB 500 GiB
Minutos de build/mês 500 1.000 2.000 4.000 20.000

O teste gratis dura tres dias, nao exige cartao de credito e usa os limites do Starter, exceto o excedente e a Guara AI, que so sao liberados depois que voce escolhe um plano pago. Depois, escolha um plano pago para continuar. Para ver a comparacao completa, acesse a pagina de planos.