Esta página ainda não foi traduzida: mostrando a versão em inglês.
Environments
Um Environment é uma cópia totalmente separada do backend do seu Project. Cada um tem os próprios dados, Schema, catálogo, Functions, segredos, Players e API keys, então o que você faz em dev nunca afeta prod. Todo Project começa com dev e prod; adicione outros, como staging, sempre que precisar de mais um estágio.
Os Environments também são a forma como o PlayServ versiona os seus dados: não existe um recurso de versionamento à parte. Para guardar uma versão dos dados e do conteúdo, copie o Environment; para testar uma mudança com segurança, faça-a primeiro em uma cópia.
Alternar entre Environments
O seletor de Environment na barra superior define o que a maior parte do Backoffice mostra: Data, Functions, Servers, Game Rooms, API keys e assim por diante seguem essa escolha. Os Environments aparecem com o estado deles, e só um Environment Ready pode ser selecionado.
A mesma separação vale fora do Backoffice: uma API key pertence a um Environment, e o CLI trabalha no Environment da key com que fez login.
Criar um Environment
Abra New environment pelo menu de Environments na barra superior ou pela aba Environments nas configurações do Project.
| Campo | Regras |
|---|---|
| Name | De 2 a 16 caracteres: letras minúsculas, dígitos e hifens simples, começando com uma letra. Único no Project. |
| Copy from another environment | Deixe desmarcado para um Environment vazio, ou escolha uma origem Ready para começar de uma cópia. |
Um Environment vazio fica pronto quase na hora. Uma cópia é feita em segundo plano, e o estado mostra o quanto ela já avançou.
| Estado | Significado |
|---|---|
| Creating… · Copying… | Em preparação. Ainda não pode ser selecionado nem excluído. |
| Ready | Em uso. |
| Error | A cópia falhou; o que já tinha sido copiado é removido. |
| Deleting… · Deleted | Em processo de saída; veja abaixo. |
O que uma cópia inclui
Uma cópia leva o conteúdo do Project, não as pessoas nem o histórico.
| Copiado | Não copiado |
|---|---|
| Records de dados | Players e as sessões deles |
| Schema | Histórico de eventos de analytics |
| Catálogo e lojas | Keys revogadas |
| Segredos | O vínculo que permite fazer o deploy de código novo (veja abaixo) |
| API keys ativas, com segredos novos | |
| Functions, publicadas de novo a partir das builds atuais |
As keys copiadas recebem segredos novos que ninguém viu
Cada key ativa chega com o nome e o tipo, mas com um segredo novo que nunca é mostrado. Para usar uma delas no novo Environment, rotacione-a e obtenha um segredo que você possa guardar.
A cópia lê a origem ao vivo, uma parte de cada vez, então mudanças feitas na origem durante a cópia podem ou não entrar nela. Se você precisa de uma cópia exata, faça-a em um momento sem movimento. Functions que nunca foram publicadas na origem são ignoradas, e segredos vinculados sem valor ficam sem montar; a linha do Environment lista os dois casos.
Religue os deploys antes de enviar código para uma cópia. Um Environment copiado começa com o deploy de código novo bloqueado. A linha dele fica marcada como Deploys unlinked, e os deploys falham com env_not_linked até você clicar em Re-link deploys na aba Environments. Enquanto isso, as Functions copiadas da origem continuam rodando.
Isso é proposital: a cópia não herda os vínculos de branch da origem e não pode ser vinculada a uma branch até você religá-la, então o código destinado à origem nunca vai parar na cópia por acidente.
Excluir e restaurar um Environment
Exclua um Environment pela linha dele na aba Environments e confirme digitando o nome. As keys dele param de se autenticar, as Functions param de rodar, e os dados, o Schema e o catálogo ficam inacessíveis.
Você tem dez segundos para desfazer. Depois disso, o Environment vai para Deleted environments, onde os dados são mantidos até que alguém tome uma ação:
| Ação | Quem | O que acontece |
|---|---|---|
| Restore | Dono ou admin da organização | O Environment volta como estava. |
| Erase | Só o dono | Os dados são apagados de vez. |
Um Environment não pode ser excluído enquanto ainda está sendo criado, enquanto outro Environment está sendo copiado a partir dele ou quando ele é o último do Project.
Próximos passos
- Gerenciamento de API keys — keys para cada Environment
- Deploy com a CLI — envie Functions e Game servers para um Environment
- Como criar um novo Project — configurações do Project, slugs e exclusão de um Project
Atualizado em 15 de out. de 2026