- Documentação
- Começando
- Conceitos
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:
| Status | Descricao |
|---|---|
| Pendente | O deploy foi criado e esta aguardando na fila. |
| Buildando | A imagem da aplicacao esta sendo construida a partir do seu codigo. |
| Deployando | A nova versao esta sendo disponibilizada. |
| Saudavel | O deploy foi concluido com sucesso e a aplicacao esta rodando. |
| Falhou | Ocorreu 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:
| Permissao | Owner | Admin | Member | Viewer |
|---|---|---|---|---|
| Ver servicos e deploys | Sim | Sim | Sim | Sim |
| Criar e editar servicos | Sim | Sim | Sim | Nao |
| Fazer deploy | Sim | Sim | Sim | Nao |
| Gerenciar variaveis de ambiente | Sim | Sim | Sim | Nao |
| Convidar membros | Sim | Sim | Nao | Nao |
| Alterar papeis de membros | Sim | Sim | Nao | Nao |
| Configuracoes do projeto | Sim | Sim | Nao | Nao |
| Excluir projeto | Sim | Nao | Nao | Nao |
| Transferir propriedade | Sim | Nao | Nao | Nao |
Planos
O Guara Cloud inicia novas contas em um teste gratis temporario e oferece cinco planos pagos:
| Recurso | Starter | Pro | Max | Business | Enterprise |
|---|---|---|---|---|---|
| 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.