Esta página ainda não foi traduzida: mostrando a versão em inglês.
Servers
Servers é onde você roda os game servers que hospedam as suas salas. A página mostra o estado e as réplicas de cada frota, além dos seus logs. É também onde você define como as salas da frota se comportam, e onde e em quantas máquinas ela roda. A página é limitada ao Environment selecionado na barra superior, e o número ao lado de Servers na barra lateral é a quantidade de game servers no Project.
O modelo
Um game server é um tipo de servidor, não uma máquina: game server → instância → sala.
| Termo | O que é |
|---|---|
| Fleet (frota) | Um game server: uma Function declarada com o tipo game_server. |
| Replica (réplica) | Uma cópia em execução de uma frota. Em uma frota pooled, cada máquina ativa do pool é uma réplica. |
| Instance (instância) | Um processo de game server conectado ao PlayServ. Uma instância pode manter várias salas. |
| Deployment point (ponto de implantação) | Um ponto de presença do PlayServ onde uma frota pode rodar. |
| Machine pool (pool de máquinas) | Máquinas aquecidas que o PlayServ mantém rodando a imagem do seu servidor em um ponto de implantação. |
Três formas de rodar uma frota, fixadas quando o game server é declarado.
| Caminho | Modo de execução | Quem faz o quê |
|---|---|---|
| PlayServ SDK · Cloud Run | Managed | O PlayServ cuida da integração do protocolo, do runtime, da hospedagem e do ciclo de vida. |
| Third-party · Docker | Pooled | O PlayServ roda a sua imagem de contêiner em um pool de máquinas. |
| Third-party · VM | External | Você roda o servidor, nas suas próprias máquinas ou pelo Edgegap. O PlayServ provisiona a infraestrutura, mas não interpreta o protocolo do seu jogo. |
Estados de réplica e de frota. O estado de uma frota é consolidado a partir das suas réplicas; vale o primeiro estado da tabela de frotas que se aplicar.
| Réplica | Significado |
|---|---|
| Healthy | Atendendo jogadores normalmente. |
| Draining | Ativa, mas saindo de serviço de propósito: um desligamento gracioso, não uma falha. |
| Unhealthy | Rodando, mas os health checks estão falhando. |
| Starting | Inicializando, ainda sem aceitar sessões. |
| Stopped | Não está rodando. |
| Frota | Significado |
|---|---|
| State unavailable | O PlayServ não conseguiu ler o estado da frota, ou ela não tem réplicas. Uma lacuna de monitoramento, não prova de que a frota está fora do ar. |
| Deploy failed | O último deploy falhou; a versão anterior continua atendendo. |
| Deploying | Uma nova versão está sendo implantada. |
| Down | Nenhuma réplica saudável. |
| Degraded | Pelo menos uma réplica não está saudável. |
| Draining | As réplicas estão saindo de serviço de forma graciosa. |
| Healthy | Todas as réplicas estão atendendo. |
Frotas
A lista tem um card por frota, com as que exigem ação primeiro. Quando alguma frota está Deploy failed, Down, Degraded ou State unavailable, um banner no topo as nomeia.
| No card | O que mostra |
|---|---|
| State · Path | O estado consolidado da frota e como ela roda. |
| Version | A versão em execução e o seu commit. |
| Regions | Os pontos de implantação onde ela tem réplicas. |
| Replicas | "X/Y healthy", com as contagens em draining e não saudáveis. |
| Deployed | Quando, e por quem. |
Open abre a frota; o ícone de logs leva direto aos logs dela. Pesquise por nome, versão ou imagem, e filtre por caminho. New fleet abre Pontos de implantação.
Uma frota
Uma frota tem quatro abas, e o menu … oferece Regions & scaling config (abre o Deployment) e Copy image reference.
Deploy e Roll back ainda não estão disponíveis aqui
Os botões aparecem no cabeçalho da frota, mas desativados. Faça o deploy de uma frota managed pelo Functions; faça o deploy de uma frota pooled mudando a versão da imagem do pool na aba Hosting.
| Aba | O que contém |
|---|---|
| Overview | Fleet status (réplicas atendendo, por estado), Serving players now (versão, commit, branch, imagem, momento do deploy, versão anterior, runtime), Regions (réplicas por ponto de implantação), Replicas needing context (as não saudáveis e as em draining, com um atalho para os logs delas) e Recent activity. Banners explicam um deploy com falha, uma implantação em andamento ou um estado que não pode ser lido. |
| Logs | As linhas de log mais recentes, atualizadas a cada 5 segundos enquanto Live está ativo. Filtre por texto, severidade, réplica e região; quebre as linhas; copie o que estiver visível. |
| Rooms | Como as salas deste game server se comportam — configurações de sala — e as instâncias conectadas agora. |
| Hosting | Onde e como a frota roda; para uma frota pooled, os seus pools de máquinas. |
Configurações de sala
As configurações de sala fazem de um game server um tipo de sala. Enquanto não as tiver, a plataforma recusa toda sala que as instâncias dele tentarem registrar. Configure room settings na aba Rooms as cria.
| Configuração | Intervalo | Padrão | Significado |
|---|---|---|---|
| Capacity | 1–1000 | 8 | Jogadores por sala. É apenas um padrão: uma capacidade que o seu servidor reporta para uma sala específica prevalece. |
| Reservation TTL | 1–60 s | 20 s | Por quanto tempo um assento fica reservado para um jogador pareado que ainda não entrou. |
| Room lifetime | Sem limite, ou N segundos | 1800 s | A idade máxima de uma sala; perto do fim, ela entra em draining. No limit desativa o draining e a expiração. |
| Idle timeout | Nunca, ou N segundos | 120 s | Por quanto tempo uma sala pode ficar vazia antes de fechar. |
| Max rooms | 1–10000 | 50 | Salas que este game server pode rodar ao mesmo tempo neste Environment. Registros além disso são recusados; salas ativas nunca são fechadas por esse limite. |
Salvar vale a partir do próximo heartbeat
Cada salvamento cria uma nova versão das configurações, e as instâncias em execução a adotam no próximo heartbeat — sem redeploy, sem reinício. As salas ativas continuam rodando, e reduzir a capacidade não expulsa ninguém.
Um valor fora do intervalo é rejeitado no próprio campo, em vez de ser ajustado. O cabeçalho da aba também mostra o modo de hospedagem, definido na declaração do servidor: Multi-room (um processo de longa duração por máquina hospeda várias salas, o padrão) ou Process per room.
Instâncias
Todo processo de game server conectado agora, com Region, Rooms, Players, quando se conectou (Connected) e a sua Last response, fresh ou stale na mesma janela de 15 segundos das salas. Em uma frota pooled, o launcher de cada máquina agrupa os processos que ela roda. Clique em uma instância para ver as salas dela em Game Rooms.
Hospedagem
| Caminho | O que a aba mostra |
|---|---|
| Managed | O deploy atual, o commit e as réplicas em execução. Deploys, logs, secrets, variáveis de ambiente e escala ficam em Functions — Open in Functions. |
| External | Launches: cada pedido de lançamento com o seu deployment, região, sala esperada, horário e resultado — Launched, Registered, Failed ou Dead. Uma falha indica o motivo, como unreachable, capacity_refused, region_unavailable, credential_rejected ou process_exited. |
| Pooled | Os pools de máquinas da frota. |
Pools de máquinas
Um pool de máquinas mantém máquinas aquecidas em um ponto de implantação, rodando a imagem do seu servidor e prontas para receber uma sala. Uma frota tem um pool por ponto de implantação, cada um com o seu próprio tamanho. O cluster decide o provedor, o tipo de máquina e a região; você define o tamanho, as salas por máquina e a versão da imagem.
| Campo | Intervalo | Padrão | Significado |
|---|---|---|---|
| Size | 0–64 | 2 | Quantas máquinas. |
| Rooms per machine | 1–1000 | 4 | Quantas salas cada processo de servidor pode hospedar. |
| Image version | As suas tags enviadas | — | Só tags linux/amd64 podem ser selecionadas. |
Crie um com Create pool, ou Add deployment point quando a frota já tiver pools. O formulário mostra a capacidade resultante, como "2 machines × 4 rooms = up to 8 rooms at once", e a primeira máquina entra em cerca de 3,5 minutos. Edit pool altera os valores; se outra pessoa tiver mudado o pool nesse meio-tempo, o salvamento é recusado e você recarrega.
Mudar a versão da imagem é o deploy
As máquinas são mantidas e os processos delas reiniciam na nova versão, então os jogadores nelas são desconectados e podem voltar a entrar. Reduzir o tamanho remove máquinas e fecha as salas delas; o tamanho 0 para todas as m áquinas, mas mantém as configurações do pool. Ambas as ações pedem confirmação, com o número de salas e de jogadores afetados.
| Parte de um pool | O que mostra |
|---|---|
| Status strip | Converging (adicionando máquinas, cerca de 3,5 minutos cada), Above size, coming back down, Moving to version ou Destroying this pool. |
| Reason | Um motivo em linguagem simples quando o pool encontra um problema: capacidade recusada, uma cota ou um teto de instâncias atingido, máquinas que não conseguem iniciar. |
| Machines | Todas as máquinas, inclusive as mortas, com o estado, as salas em uso e o tempo naquele estado: Requested → Booting → Ready → In rotation → Draining → Dead. Ready significa que a máquina responde; in rotation significa que o processo do servidor se conectou e pode receber salas. Remove destrói uma máquina e as salas dela, e o tamanho cai em um. |
| Consumption | Horas de máquina e tráfego em 24 horas, 7 dias ou 30 dias. |
Pontos de implantação
Pontos de implantação é onde você escolhe onde uma frota roda e quanto essa presença custa. Abra com New fleet, ou clicando em uma localização disponível no mapa do Deployment.
| Etapa | O que você faz |
|---|---|
| 1. Escolha os pontos | Clique em um ponto no mapa. O painel dele mostra o estado — Active · N machines, In footprint ou Not selected — e se este cluster pode se conectar a ele; pontos que o cluster não oferece não podem ser escolhidos. |
| 2. Dimensione-os | Escolha um nível de CCU para o ponto (o preço mostrado é uma estimativa do plano) e o número de máquinas, de 0 a 5. Um pool ativo começa no seu tamanho atual. |
| 3. Escolha a frota | Só frotas que não rodam no Cloud Run podem receber um pool. |
| 4. Revise e continue | Selected deployment points lista máquinas, CCU e preço por ponto, com o total. Continue creating server mostra cada mudança antes de aplicá-la, por exemplo "Frankfurt (FRA): 2 → 3 machines", com as salas e os jogadores afetados por uma redução. |
A quantidade de máquinas é aplicada em cerca de 5 minutos, e os planos tarifários a partir do dia 1º do mês seguinte. Uma frota que ainda não tem imagem enviada segue para o formulário do pool na aba Hosting.
Um pool não pode ser removido enquanto houver salas registradas nas máquinas dele: feche-as primeiro em Game Rooms, ou deixe que terminem.
Próximos passos
- Game Rooms — as salas ao vivo que as suas frotas hospedam
- Deployment — todas as localizações a partir das quais o seu Project atende os jogadores
- Hospedagem de Game Server — como escrever o servidor que registra as salas
- Functions — deploys, secrets e escala para game servers gerenciados
Atualizado em 10 de out. de 2026