Farms de servidores
Um farm de servidores é um grupo dos seus servidores que compartilham chaves de acesso: uma chave funciona em todos os servidores do farm a que pertence. O farm também define o certificado que as chaves dele contêm e as configurações com que os servidores dele funcionam.
Onde encontrá-los
Abra Server Farms. Todo projeto começa com um farm, Server Farm 1, e ele basta até que alguns servidores precisem de chaves próprias. A lista mostra o perfil de servidor de cada farm, quantos servidores ele tem e quantas das chaves dele os aplicativos usaram nos últimos sete dias.
Selecione um farm para abrir a página dele. As configurações ficam em Server Farm, e os certificados em SSL / TLS Certificates, como explica Certificados SSL/TLS.
203.0.113.10, e Push token to clients está ativado.
Quando adicionar um farm
Uma chave só funciona nos servidores do farm dela. Adicione um farm para servidores cujos usuários não devem alcançar seus outros servidores, ou para servidores que precisam de domínio ou configurações próprios: as chaves de um farm contêm um único certificado, e os servidores dele compartilham um perfil de servidor.
Criar um farm
Abra Server Farms, selecione Add, dê um nome ao farm e selecione OK. O MANAGER abre a página do novo farm.
Um farm novo usa o perfil de servidor padrão do projeto, tem Push token to clients ativado e tem um certificado autoassinado com nome provisório, que as chaves dele contêm até você usar seu próprio domínio.
Ele não pode distribuir chaves até ter um servidor: o MANAGER monta as chaves a partir dos endereços dos servidores dele. Até que um deles seja instalado, a página do farm mostra uma mensagem em vermelho abaixo do nome.
Os servidores do farm
Todo servidor pertence a um farm. Ao adicionar um servidor, escolha o Server Farm dele; o campo aparece quando o projeto tem mais de um farm.
Para mover um servidor para outro farm, abra o servidor e edite o Server Farm dele. Ele passa a usar o certificado e o perfil de servidor do novo farm, e as chaves do farm antigo deixam de funcionar nele. O MANAGER recusa a mudança enquanto o servidor tiver certificados próprios: exclua-os primeiro.
Se ele era o único servidor do farm antigo com um endereço nas chaves, as chaves do farm antigo não alcançam nenhum servidor até que outro servidor desse farm tenha um.
As chaves do farm
Toda chave de acesso pertence a um farm e funciona em todos os servidores dele. Escolha o farm ao criar a chave em Access Tokens; o campo aparece quando o projeto tem mais de um farm.
Uma chave contém o que os aplicativos precisam para alcançar o farm: os endereços dos servidores dele que vão nas chaves, e o domínio e a impressão digital do certificado dele. A seção Access Points do farm mostra esses dados. Pontos de acesso explica quais endereços entram, e Certificados SSL/TLS, qual certificado.
Uma chave movida para outro farm, editando o Server Farm dela, deixa de funcionar nos servidores do farm antigo, e o MANAGER não consegue atualizá-la por lá: entregue-a de novo aos usuários dela.
Enviar o token aos aplicativos (Push token to clients)
Uma chave contém os endereços e o certificado que o farm dela tinha quando você a copiou. Com Push token to clients, na página do farm, o MANAGER passa a cada aplicativo os endereços e o certificado atuais do farm quando ele se conecta; assim, os aplicativos se atualizam após uma mudança sem que você precise entregar chaves novas. A opção vem ativada em todo farm novo.
O MANAGER só envia a nova chave enquanto todos os servidores cujo endereço está nas chaves estiverem em funcionamento, para que os aplicativos recebam só endereços que já funcionam. Uma chave sem endereço, só com um domínio, como atrás de um proxy reverso, não espera.
Um aplicativo só recebe a nova chave ao se conectar com a que já tem. Por isso, após uma mudança, mantenha o endereço ou o certificado antigo por alguns dias, como mostra Alterar um endereço, ou dê ao farm URLs de token.
URLs de token do farm
Uma URL de token do farm aponta para um arquivo na web onde o MANAGER publica os endereços e o certificado atuais do farm, criptografados para que só as chaves do farm possam lê-los. Todas as chaves do farm contêm as URLs, e um aplicativo que não consegue se conectar as lê e tenta de novo com o que encontrar, mesmo quando todos os endereços que conhecia sumiram ou foram bloqueados.
Na página do farm, selecione Farm Token Urls e depois Add. Publish Url é onde os aplicativos leem o arquivo: em um site ou CDN que seus usuários consigam acessar. Preencha Name e escolha em Auto Upload como o arquivo chega lá:
- Off: você mesmo coloca o arquivo lá. Selecione Farm Token na página do farm e depois Download, e repita após cada mudança.
- POST, PUT ou PUT & POST: o MANAGER envia o arquivo após cada mudança, com a requisição que File Url e os campos ao redor descrevem. Para um arquivo em um repositório do GitHub, GitLab ou Bitbucket, o MANAGER preenche esses campos a partir de Publish Url, e você só adiciona um Access Token que possa gravar o arquivo.
A lista mostra se cada arquivo contém o token atual do farm. O arquivo pode estar em cache; por isso, confira de novo alguns minutos após uma mudança.
As chaves contêm as URLs que o farm tinha quando você as copiou; por isso, adicione as URLs antes de distribuir as chaves. Aplicativos com uma chave mais antiga as recebem por meio de Push token to clients.
Renomear ou excluir um farm
Para renomear um farm, edite o campo Name. Para excluí-lo, selecione Delete na página dele: o MANAGER exclui as chaves dele junto, e a confirmação informa quantas são. Um farm com servidores não pode ser excluído: mova-os para outro farm, ou exclua-os, primeiro.
