> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Implantar builds usando o Game Manager

> Etapas para implantar builds de VM do PlayFab Multiplayer Servers pelo Game Manager, incluindo o carregamento de ativos, a seleção de tamanhos de VM e a configuração de regiões e servidores em espera.

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](/pt-BR/services/playfab/multiplayer/servers/windows-runner-sample) ou o [exemplo Wrapper](/pt-BR/services/playfab/multiplayer/servers/wrapper-sample). Ambos vêm com todos os ativos necessários para realmente implantar servidores.

<Note>
  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](/pt-BR/services/playfab/multiplayer/servers/enable-playfab-multiplayer-servers).
</Note>

Para obter detalhes sobre os valores que você pode usar em cada parâmetro, consulte [Definição do build](/pt-BR/services/playfab/multiplayer/servers/build-definition).

## Etapas para implantar pelo Game Manager

1. Entre no [Game Manager](https://developer.playfab.com)

2. Vá para a página **My Studios and Titles** e selecione o título do seu jogo para exibir o painel

3. Vá para a página **Multiplayer** > **Servers** e selecione **New Build** no canto superior direito para criar um novo build

4. Começando pelos detalhes do build, use uma cadeia de caracteres descritiva como Build Name

5. 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](/pt-BR/services/playfab/multiplayer/servers/billing-for-thunderhead)

6. Defina o valor desejado para Servers per machine

   A imagem abaixo mostra os valores usados na seção de informações.

   <img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/multiplayer/servers/newBuild01.PNG?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=272e81b64ef74c10704b7bb3352e9868" alt="Detalhes do build, incluindo Build name, a seleção de máquina virtual Dasv4 e 2 servidores por máquina" width="2266" height="765" data-path="images/playfab/multiplayer/servers/newBuild01.PNG" />

7. 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.

<Note>
  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](/pt-BR/services/playfab/multiplayer/servers/deploying-linux-based-builds). Se você já tiver carregado uma imagem de contêiner, ela aparecerá na lista suspensa **Image**. Para usá-la, selecione a imagem.
</Note>

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)](/pt-BR/services/playfab/multiplayer/servers/vm-metrics)
* 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](/pt-BR/services/playfab/multiplayer/servers/os-patch-updates)
* 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](/pt-BR/services/playfab/multiplayer/servers/crash-dump-collection)

### 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.

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/multiplayer/servers/WindowsProcess.PNG?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=752d3d2d4d9dc354699d632d7cf6cf44" alt="Detalhes do servidor com Windows Process selecionado como sistema operacional e tipo de servidor" width="753" height="389" data-path="images/playfab/multiplayer/servers/WindowsProcess.PNG" />

### 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.

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/multiplayer/servers/LinuxContainer.PNG?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=4b0f42af5689eb5fddc366194d7c1927" alt="Detalhes do servidor com Linux Container selecionado como sistema operacional e tipo de servidor" width="753" height="309" data-path="images/playfab/multiplayer/servers/LinuxContainer.PNG" />

## Ativos para builds

7. 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](/pt-BR/services/playfab/multiplayer/servers/author-a-game-server-build). 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.

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

### 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

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/multiplayer/servers/MPSBuildAssets.PNG?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=3d45f373ddb6d4af2064b4b16e0dd70a" alt="Seção de ativos de um novo build no MPS, junto com o comando de início." width="753" height="379" data-path="images/playfab/multiplayer/servers/MPSBuildAssets.PNG" />

## Configurações de rede

8. 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

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/multiplayer/servers/create-your-first-server/server-network-settings-2.PNG?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=ce869740d1898f65e7f897229642294d" alt="Configurações de rede no Game Manager para o tipo de servidor de contêiner" width="753" height="195" data-path="images/playfab/multiplayer/servers/create-your-first-server/server-network-settings-2.PNG" />

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

```C# theme={null}
int port = 7777; // since you already know the port
GameServer gs = new GameServer(port);
gs.start();
```

<Note>
  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.
</Note>

### 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.

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/multiplayer/servers/create-your-first-server/server-network-settings-process.PNG?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=b73e4a780a7b681e2519efc0425555e2" alt="Configurações de rede no Game Manager para o tipo de servidor de processo" width="753" height="195" data-path="images/playfab/multiplayer/servers/create-your-first-server/server-network-settings-process.PNG" />

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

```C# theme={null}
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](https://github.com/PlayFab/gsdk/blob/master/csharp/GSDK_CSharp_Standard/GameServerConnectionInfo.cs) em [GSDK/CSharp/GSDK\_CSharp\_Standard](https://github.com/PlayFab/gsdk/tree/master/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.

9. 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.
10. 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](/pt-BR/services/playfab/multiplayer/servers/allocating-game-servers-and-configuring-vs-debugging-tools), e também pode usar o [MpsAllocatorSample](/pt-BR/services/playfab/multiplayer/servers/mps-allocator-sample) 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

<img src="https://mintcdn.com/microsoft-4404708b/U1LR64ZWxo45eXwl/images/playfab/multiplayer/servers/create-your-first-server/server-region-settings.PNG?fit=max&auto=format&n=U1LR64ZWxo45eXwl&q=85&s=9182b5742cea659a20472d29799c54d1" alt="Builds implantados no Game Manager" width="2007" height="478" data-path="images/playfab/multiplayer/servers/create-your-first-server/server-region-settings.PNG" />

<Tip>
  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.
</Tip>

### Desligando VMs

Há três maneiras de desligar VMs

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

## Confira também

* [Passo a passo: implantar builds usando o Game Manager](/pt-BR/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-game-manager)
* [Implantar um build usando PowerShell/API](/pt-BR/services/playfab/multiplayer/servers/deploy-using-powershell-api)
* [Criar seu primeiro servidor](/pt-BR/services/playfab/multiplayer/servers/create-your-first-server)
* [Exemplo C# Wrapper](/pt-BR/services/playfab/multiplayer/servers/wrapper-sample)
* [Exemplo MPS Allocator](/pt-BR/services/playfab/multiplayer/servers/mps-allocator-sample)
* [Exemplos e recursos](/pt-BR/services/playfab/multiplayer/servers/server-samples-resources)


## Related topics

- [Passo a passo: implantar builds usando o Game Manager](/pt-BR/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-game-manager.md)
- [Passo a passo: implantar builds usando PowerShell/API](/pt-BR/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-api-powershell.md)
- [Implantar builds usando PowerShell/API](/pt-BR/services/playfab/multiplayer/servers/deploy-using-powershell-api.md)
- [Definição e configuração do build](/pt-BR/services/playfab/multiplayer/servers/build-definition.md)
- [Exemplo Wrapper](/pt-BR/services/playfab/multiplayer/servers/wrapper-sample.md)