Ambientes

Ambientes são ambientes de staging isolados que permitem testar alterações sem afetar a versão principal da aplicação.

Um ambiente é implantado como uma instância independente da aplicação, com seu próprio build, e fica disponível por meio de um domínio técnico separado.

Ambientes estão disponíveis para aplicações frontend, backend e baseadas em Docker.

O número máximo de ambientes por aplicação é 10.

Para aplicações backend e Docker, os ambientes são fornecidos gratuitamente e são implantados na mesma máquina virtual da aplicação principal. Um ambiente utiliza os recursos dessa máquina, portanto é importante garantir que haja capacidade suficiente para sua execução.

Para aplicações frontend, as requisições são cobradas da mesma forma que na aplicação principal.

Ambientes não são suportados para aplicações implantadas via Docker Compose.

Criar um ambiente

Para criar um ambiente:

1. Acesse a seção Plataforma de apps e clique na aplicação.
2. Vá até a aba Ambientes.
3. Se ainda não houver ambientes criados, você verá a etapa de seleção de branch. Clique nela. Caso contrário, clique em Adicionar ambiente.

3. Informe:
   • o nome do ambiente;
   • a branch do repositório;
   • o commit para build ou ative a opção de usar o último commit;
   • as variáveis: selecione variáveis existentes ou adicione novas.
4. Clique em Criar.

O deploy será iniciado automaticamente. Um domínio técnico será gerado automaticamente para acessar a aplicação neste ambiente.

Gerenciar ambientes

Todos os ambientes criados são exibidos na aba Ambientes.

Ver URL da aplicação

Para copiar a URL onde a aplicação está disponível:

1. Acesse a seção Plataforma de apps e clique na aplicação.
2. Na aba Ambientes, passe o cursor sobre o ambiente e clique no ícone de visualização.

Você também pode copiar a URL na aba Configurações.

Atualizar configurações do ambiente

1. Acesse a seção Plataforma de apps e clique na aplicação.
2. Na aba Ambientes, clique no ambiente para abrir os detalhes.
3. Na aba Configurações, você pode:
   • ativar ou desativar o ambiente;
   • renomeá-lo;
   • alterar a branch do repositório;
   • alterar o commit;
   • configurar variáveis;
   • copiar a URL do ambiente.

Ver logs

1. Acesse a seção Plataforma de apps e clique na aplicação.
2. Na aba Ambientes, clique no ambiente para abrir os detalhes.
3. Vá até a aba Logs do ambiente para visualizar:
   • logs de deploy;
   • logs da aplicação (para backend e Docker);
   • logs de acesso (para frontend).

Excluir um ambiente

Para excluir um ambiente:

1. Acesse a seção Plataforma de apps e clique na aplicação.
2. Na aba Ambientes, clique no menu de três pontos ao lado do ambiente e selecione Excluir.
3. Confirme a exclusão.