Implantar builds usando o Game Manager

Este artigo lista as etapas gerais para implantar/criar builds para VMs usando o Game Manager. Se esta for a primeira vez que você implanta um build, recomendamos implantar um build usando o exemplo C# Windows Runner ou o exemplo Wrapper. Ambos vêm com todos os ativos necessários para realmente implantar servidores.

Para usar e ver o PlayFab Multiplayer Servers, você precisa habilitar o recurso no Game Manager. Para obter instruções, consulte Habilitar o recurso PlayFab Server.

Para obter detalhes sobre os valores que você pode usar em cada parâmetro, consulte Definição do build.

Etapas para implantar pelo Game Manager

Entre no Game Manager
Vá para a página My Studios and Titles e selecione o título do seu jogo para exibir o painel
Vá para a página Multiplayer > Servers e selecione New Build no canto superior direito para criar um novo build
Começando pelos detalhes do build, use uma cadeia de caracteres descritiva como Build Name
Selecione um servidor com uso gratuito limitado, como Dasv4, durante o desenvolvimento. Para saber mais sobre preços, consulte Cobrança do PlayFab Multiplayer Servers
Defina o valor desejado para Servers per machine A imagem abaixo mostra os valores usados na seção de informações.
Em seguida, temos a parte de detalhes do servidor, na qual você precisará selecionar um tipo de sistema operacional, Windows ou Linux. Depois, você selecionará o tipo de servidor, processo ou contêiner, com base no sistema operacional escolhido.

Para a plataforma Linux, você precisa criar sua própria imagem de contêiner. Para obter mais instruções, consulte Criar e implantar builds Linux. Se você já tiver carregado uma imagem de contêiner, ela aparecerá na lista suspensa Image. Para usá-la, selecione a imagem.

Depois de selecionar o tipo de sistema operacional, você poderá escolher o tipo de servidor. Com base no tipo de sistema operacional/servidor, você terá os seguintes recursos que podem ser habilitados.

Virtual Machine Metrics Preview: habilitar as métricas permite ver métricas no nível do sistema, como CPU, memória, rede etc. Para saber mais, leia nosso artigo Métricas de desempenho de VM (versão prévia)
Windows Core Preview: permite testar as versões mais recentes do sistema operacional Windows em builds de teste para ver como seu jogo será executado com o sistema operacional mais recente. Para saber mais, leia Atualizações de nível de patch do sistema operacional para Windows
Automatic Crash Dump Collection: permite habilitar a coleta automática de despejos de memória nos tipos de servidor Windows Container. Você pode escolher entre um despejo completo, mini ou personalizado. Para saber mais, leia Habilitando a coleta automática de despejos de memória

Detalhes do servidor para o modo de processo

A imagem abaixo mostra os valores usados na seção de sistema operacional quando você seleciona Windows como plataforma, mas usa o tipo de servidor baseado em processo. Também há a opção de usar servidores Linux baseados em processo.

Detalhes do servidor com Windows Process selecionado como sistema operacional e tipo de servidor

Detalhes do servidor para o modo de contêiner

A imagem abaixo mostra os valores usados na seção de sistema operacional quando você seleciona Linux como plataforma, mas usa o tipo de servidor baseado em contêiner. Também há a opção de usar servidores Windows baseados em contêiner.

Detalhes do servidor com Linux Container selecionado como sistema operacional e tipo de servidor

Ativos para builds

Em Assets, selecione Upload. Navegue até a pasta com o PlayFab Multiplayer Server Build compilado e selecione o pacote .zip a ser carregado.

Ativos para servidores Windows

Para a plataforma Windows, você deve carregar um PlayFab Game Server Build como ativo. Para saber como criar um PlayFab Game Server Build, consulte Criar um build de servidor de jogo. Carregue ativos para modificar e personalizar a imagem de contêiner Windows. O caminho de montagem dos ativos em servidores Windows deve ter como raiz a unidade C.

Ativos para servidores de contêiner Windows Os ativos para servidores Windows precisarão estar na unidade C; caso contrário, a API poderá retornar um erro. O caminho de montagem é necessário somente para contêineres.

Não forneça um caminho de montagem para servidores baseados em processo.

Ativos para servidores Linux

Para a plataforma Linux, carregar um ativo é opcional, pois o servidor de jogo pode ser incluído como parte da imagem de contêiner. Mas você ainda precisa ter um servidor de jogo; verifique se o caminho de montagem é válido no contêiner que você está carregando.

Se você estiver carregando ativos:

Defina C:\Assets ou selecione um caminho diferente como caminho de montagem
Defina C:\Assets\YourGameServerBuild.exe como Start Command

Seção de ativos de um novo build no MPS, junto com o comando de início.

Configurações de rede

Para a rede, defina o número, o nome e o protocolo da porta.

Definindo a porta para tipos de servidor de contêiner

Se você estiver usando um tipo de servidor de contêiner, deverá especificar o número da porta. Por exemplo, no Game Manager, para um tipo de servidor de contêiner, você poderia especificar:

Nome da porta: “gameServerPort”
Número da porta: 7777
Protocolo: UDP

Configurações de rede no Game Manager para o tipo de servidor de contêiner

Então, no seu código, você faria algo como o seguinte

int port = 7777; // since you already know the port
GameServer gs = new GameServer(port);
gs.start();

No modo de contêiner, cada servidor de jogo é executado em seu próprio namespace de rede. É por isso que todos os servidores de jogo podem escutar na mesma porta. A porta do contêiner é mapeada dinamicamente para uma porta exclusiva na máquina virtual. No entanto, no modo de processo, todos os servidores de jogo são executados no mesmo namespace de rede. Fazer com que todos os servidores de jogo escutem na mesma porta criaria conflitos; é por isso que você precisará obter a ServerListeningPort do GSDK.

Definindo a porta para tipos de servidor de processo

Para o tipo de servidor de processo, você deve usar o GSDK para recuperar o número da porta. Não inclua um número de porta como parte da definição do build.

Configurações de rede no Game Manager para o tipo de servidor de processo

Então, no seu código, você faria algo como:

var gsc = GameServerSDK.GetConnectionInfo();

var gp = gsc.Where(x=>x.Name=="gameServerPort").Single();

GameServer gs = new GameServerPort(gp.ServerListeningPort);

Para ver o código de exemplo completo, acesse GameServerConnectionInfo.cs em GSDK/CSharp/GSDK_CSharp_Standard O exemplo de código acima, que obtém a porta do GSDK, também funcionaria no modo de contêiner.

Comando de início

Comando de início para servidores baseados em contêiner

Seu comando de início deve ser o caminho absoluto (incluindo o caminho de montagem) para o executável do jogo, incluindo todos os argumentos necessários. Por exemplo, seu comando de início poderia ser C:\Assets\wrapper.exe -g C:\Assets\fakegame.exe arg1 arg2. Adicionar a parte “C:\Assets” ao caminho absoluto do comando de início só é necessário se for um servidor Windows baseado em contêiner. Isso ocorre porque esse é o diretório em que o ativo do jogo seria extraído.

Comando de início para servidores Windows baseados em processo

Seu comando de início é o caminho relativo dentro do ativo carregado. Se o executável estiver diretamente na pasta do ativo, você poderá usar apenas <yourGameServerBuild.exe>. Se estiver em outra pasta (por exemplo, GameDirectory), o comando de início será gameDirectory/YourGameServerBuild.exe.

Em Regions, selecione a região em que deseja implantar os servidores. Em seguida, especifique o número de servidores em espera e o máximo de servidores.
Selecione Save para iniciar o processo de implantação. Você será levado à página inicial do build. O build exibirá o status Deploying, como mostrado na imagem abaixo.

Em alguns minutos, seu build deverá estar no estado Deployed. Isso significa que os servidores foram implantados e podem ser alocados. Para obter mais informações sobre a alocação de servidores de jogo, você pode conferir aqui, e também pode usar o MpsAllocatorSample para experimentar a alocação de servidores.

Configurar informações de região

Depois de implantar os builds, você ainda pode modificar os seguintes parâmetros.

Regiões
Servidores em espera
Máximo de servidores

Para definir as configurações regionais:

Vá para a página Servers > Builds
Selecione o build que deseja modificar
Na guia Regions, vá para a seção Servers by region
Adicione/remova regiões e modifique os números de servidores

Durante o desenvolvimento, desative todas as regiões não utilizadas ou não íntegras para evitar o uso de horas de núcleo de VM. O uso de horas de núcleo começa durante a inicialização da VM e continua até que a VM seja desligada. As VMs de uma região não serão desligadas automaticamente, a menos que a meta de servidores em espera da região chegue a 0 ou que a região seja excluída.

Desligando VMs

Há três maneiras de desligar VMs

Definir a meta de servidores em espera de uma região como 0; isso desligará as VMs somente dessa região.
Excluir uma região específica de um build.
Excluir o build inteiro; isso desligará as VMs em todas as regiões desse build.

XBOX Services

PlayFab

Etapas para implantar pelo Game Manager

Detalhes do servidor para o modo de processo

Detalhes do servidor para o modo de contêiner