Projetos e ambientes no Coolify: como organizar suas aplicações

Como o Coolify organiza o que você publica

Tudo o que roda no Coolify fica numa estrutura de três níveis. Entender essa estrutura antes de publicar evita misturar o site no ar com o que ainda está em teste.

• ProjetoUm grupo de ambientes e recursos. Exemplo: o projeto Loja Virtual reúne tudo o que é da loja.
• AmbienteUma camada dentro do projeto, como production, o que está no ar, e staging, o que você está testando.
• RecursoCada item que o Coolify publica: aplicação, banco de dados ou serviço. Ele pertence a um ambiente e roda num servidor.

Os recursos de um ambiente são separados dos recursos de outro. A aplicação de staging tem o próprio endereço, as próprias variáveis e, se você quiser, o próprio banco.

Crie o projeto

1. Clique no + ao lado de Projects

   Na página inicial do painel, a seção Projects (projetos) lista os projetos da equipe. Clique no + ao lado do título.

   painel.example.comToque para ampliar

   

   Fechar

   Dica As boas-vindas do primeiro acesso oferecem criar o My First Project. Você pode usar esse projeto ou criar outro com um nome que diga o que ele guarda.

2. Dê um nome e clique em Create Project

   Preencha os campos e clique em Create Project (criar projeto). A própria janela avisa que o ambiente production será criado sozinho.

   painel.example.com123Toque para ampliar

   123

   Fechar

   1. 1Name: O nome do projeto (aqui, Loja Virtual). É o único campo obrigatório.
   2. 2Description: Uma descrição curta, opcional, para lembrar do que se trata (aqui, Loja e site institucional).
   3. 3Create Project: Cria o projeto e já abre o ambiente production.

3. Confira o ambiente production

   O projeto abre direto no ambiente production, ainda vazio (No resources yet). O botão Add Resource (adicionar recurso) é o ponto de partida para publicar a primeira aplicação, banco ou serviço.

   painel.example.com/project/…Toque para ampliar

   

   Fechar

   Dica Para publicar a primeira aplicação a partir de um repositório, siga o deploy pelo Git.

Adicione um ambiente de testes

No ambiente de testes, que costuma se chamar staging, você publica a mesma aplicação a partir de outro branch, com outro domínio e outras variáveis. Testa lá e só depois leva a mudança para production.

1. Abra o projeto e clique em New Environment

   No painel: Projects›Loja Virtual(Projetos › o seu projeto)

   Clique no nome do projeto, na lista de Projects ou no caminho do alto da página. A página do projeto mostra os ambientes. Clique em New Environment (novo ambiente).

   painel.example.com/project/…Toque para ampliar

   

   Fechar

2. Digite o nome e clique em Create Environment

   Use um nome curto, em letras minúsculas, que diga para que o ambiente serve.

   painel.example.com/project/…12Toque para ampliar

   12

   Fechar

   1. 1Nome do ambiente (Name). Aqui, staging.
   2. 2Botão Create Environment, que cria o ambiente vazio.

3. Confira os dois ambientes

   O projeto agora mostra production e staging, cada um com a contagem de recursos. Clique num ambiente para entrar nele.

   painel.example.com/project/…12Toque para ampliar

   12

   Fechar

   1. 1production: o ambiente do site no ar.
   2. 2staging: o ambiente para testar antes de publicar.

Organize os seus projetos

• Um projeto por cliente ou por sistema. Quem cuida de sites de vários clientes cria um projeto para cada cliente. Quem tem vários sistemas na empresa cria um para cada sistema: loja, blog, sistema interno.
• Nomes que você reconheça. Loja Virtual diz mais do que projeto-1, e o nome aparece em todo o painel.
• Staging para testar antes. Atualização de versão, mudança no banco ou configuração nova passam primeiro pelo staging.
• Banco junto da aplicação. Deixe o banco no mesmo projeto e no mesmo ambiente da aplicação que usa esse banco, para achar tudo no mesmo lugar.
• Acesso por projeto. Na equipe, o acesso de um membro pode ser limitado por projeto ou ambiente. Separar por cliente facilita dar acesso só ao que é de cada um (equipe e notificações).

Renomeie ou apague um projeto

1. Abra as configurações do projeto

   Clique na engrenagem ao lado do nome do projeto. Em Project details (detalhes do projeto) você troca o ícone, o nome e a descrição. Mais abaixo fica Delete Project (apagar projeto).

   painel.example.com/project/…/edit12Toque para ampliar

   12

   Fechar

   1. 1Nome do projeto (Name), que aparece em todo o painel.
   2. 2Botão Delete Project. Ele só apaga projeto vazio.