Configurar Edge Server - Pré-visualização

Pré-requisitos

Cada instância do Edge Server se conecta a um serviço em seu projeto Atlas . Antes de poder usar uma instância do Edge Server , você deve criar o serviço relevante e configurar um fornecedor de autenticação e permissões para a instância do Edge Server .

Para obter mais informações, consulte Criar um serviço para o Edge Server.

Requisitos de host do servidor de borda

O host que executa a instância do Edge Server pode ser uma instância do EC2 ou outro servidor de nuvem, ou hardware que você provisiona no local.

Instalar e configurar a instância do Edge Server

Após criar um Serviço de Edge Server ou Serviço de Device Sync , você deve criar uma instância de Edge Server . Cada serviço pode ter muitas instâncias de Edge Server . Ao criar uma instância do Edge Server , você obtém um script de instalação que pode ser usado para baixar uma ferramenta para instalar e gerenciar a instância do Edge Server , edgectl. Você também recebe um token que pode usar para registrar a instância do Edge Server . Para obter mais detalhes, consulte Criar uma instância do Edge Server .

Use o script de instalação para configurar e executar a instância do Edge Server no host.

curl -s https://services.cloud.mongodb.com/edge/install.sh | bash

edgectl init --app-id="<INSERT-YOUR-APP-ID-HERE>" --platform=compose

edgectl config --insecure-disable-auth=true

Iniciar e parar o servidor de borda

Utilize o edgectl para iniciar e parar a instância do Edge Server .

Para iniciar todos os containers de instâncias do Edge Server , use o comando start:

edgectl start

Para parar todos os containers de instância do Edge Server , use o comando stop:

edgectl stop

Verificar o status do servidor de borda

Quando a instância do Edge Server está em execução, você pode ver o status da instância com:

edgectl status

Isso fornece informações sobre o estado dos containers do Edge Server e um status detalhado do servidor de sincronização com um detalhamento de informações importantes. Pode parecer semelhante a:

{
   "mongoContainerStatus": {
      "message": "running"
   },
   "mongoDBStatus": {
      "message": "ready"
   },
   "syncServerContainerStatus": {
      "message": "running"
   },
   "syncServerStatus": {
      "message": "ACTIVE"
   },
   "syncServerDetailedStatus": {
      "version": "v0.22.3",
      "status": "ACTIVE",
      "cloud_connected": true,
      "num_local_clients": 0,
      "query": {
         "Item": "truepredicate"
      }
   }
}

O syncServerDetailedStatus contém informações sobre o estado da instância do Edge Server . Isso inclui detalhes sobre sua conexão com o Atlas e os clientes conectados a ele, como segue:

Atualizar a configuração da instância do Edge Server

Você pode fazer alterações em uma instância de Edge Server existente usando edgectl. Depois de alterar a configuração, reinicie a instância para aplicar as atualizações.

edgectl config --YOUR-FLAG-HERE

edgectl stop

edgectl start

Atualize a versão do servidor de borda

À medida que o Edge Server desenvolve, talvez você queira atualizar sua versão do Edge Server para aproveitar as novas funcionalidades. Além disso, uma instância do Edge Server não pode estar mais do que uma versão principal atrás da mais recente disponível, ou ela entra em um estado FAILED e não pode se conectar ao Atlas.

edgectl update

edgectl config

edgectl start

edgectl clean

edgectl start

edgectl prune

Alternar a Edge Server API chave de do

Para alternar a chave de Edge Server API do :

edgectl config --update-registration-token=true

Especifique a query do Edge Server

Se você não especificar uma query, uma instância do Edge Server padronizará para uma query global do "*", que sincroniza automaticamente todos os dados em todas as coleções em sua fonte de dados vinculada.

Você pode usar alguns argumentos com o comando edgectl config para especificar a query de sincronização da instância do Edge Server :

• Passe uma query de string simples:

  edgectl config --query="Store: store_id == 42"

• Passe vários sinalizadores de query para fornecer queries para várias collections:

  edgectl config --query="Person: age > 10" --query "Pet: type = 'cat'"

• Passe um caminho para um arquivo contendo um objeto JSON mapeando queries mais complexas:

  edgectl config --query-file="/Users/my.user/edge-server/query.json"

• Passe uma query global para usar a mesma query para todas as coleções:

  edgectl config --global-query="shouldSync == true"

A menos que você esteja usando uma query global, as queries do Edge Server assumem a forma de YOUR-SCHEMA-TITLE: YOUR-QUERY:

• YOUR-SCHEMA-TITLE: O campo title de um esquema, que normalmente corresponde ao nome de uma collection em seu banco de dados. No caso de duas collections com nomes idênticos em bancos de dados diferentes, anexamos o nome da collection com o nome do banco de dados; por exemplo, databaseName_collectionName.

  Sua fonte de dados do Atlas vinculada pode conter muitas coleções, cada uma com um esquema correspondente. Se você não usar a query padrão do Edge Server "*" ou uma query global que sincronize tudo, cada esquema que você deseja sincronizar deverá ter sua própria query.

  Se você estiver usando um aplicativo de modelo, esta é a coleção Item .

• YOUR-QUERY: A query que determina quais documentos o Edge Server pode sincronizar com uma coleção. Você pode usar o RQL para definir essa query, com as mesmas ressalvas em Flexible Sync RQL relação às limitações .

edgectl config --global-query="truepredicate"

edgectl config --global-query="store_id == 42"

edgectl config --query="Inventory: store_id == 42"

edgectl config --query="Project: facility_id == 42" --query "Item: priority >= 3"

edgectl config --query-file="/Users/my.user/edge-server/query.json"

{
  "Project": "facility_id == 42",
  "Item": "priority >= 3"
}

Simular conectividade offline

Edge Server fornece um modo de demonstração que você pode usar para simular uma instância do Edge Server perder conectividade com o Atlas. Enquanto a instância do Edge Server estiver no modo de demonstração offline, você pode continuar executando operações CRUD com a instância usando um driver ou ferramenta do MongoDB ou um aplicativo Atlas Device SDK .

Você pode ver a alteração de dados localmente com clientes conectados à instância do Edge Server , mas não veja as alterações refletidas no Atlas. Da mesma forma, as alterações que você faz no Atlas enquanto a instância do Edge Server está offline não são sincronizadas com o Edge Server e refletem nos clientes locais.

Quando você tira a instância do Edge Server do modo de demonstração offline, ela retoma automaticamente a sincronização com o Atlas. Você pode ver os dados da instância do Edge Server refletidos no Atlas, e os dados alterados no Atlas se tornam visíveis para a instância e os clientes conectados.

edgectl config --insecure-enable-offline-demo

edgectl offline-demo disable-connection

edgectl offline-demo enable-connection

Execute múltiplas instâncias de Edge Server em um host

Enquanto sua arquitetura de Edge Server estiver em desenvolvimento, talvez você queira executar várias instâncias de Edge Server em um único host, por exemplo, em seu computador local. Você pode fazer isso usando a funcionalidade de perfil edgectl .

Quando você cria uma instância do Edge Server , o edgectl cria automaticamente um perfil padrão para você. O perfil mapeia seus comandos para uma instância específica do Edge Server .

Quando você cria uma nova instância do Edge Server na mesma máquina, o edgectl define o novo perfil como o perfil padrão. Para emitir um comando que usa um perfil diferente do padrão, adicione o sinalizador --profile com cada comando.

edgectl start --profile=YOUR-PROFILE-NAME

Você pode visualizar os perfis e seus arquivos de configuração associados em:

~/.mongodb-edge/profiles/

edgectl init --app-id="YOUR-APP-ID" --platform=compose --profile=YOUR-PROFILE-NAME

edgectl profile list

edgectl profile inspect YOUR-PROFILE-NAME

{
  "appId" : "YOUR-APP-ID",
  "platform" : "compose"
}

edgectl profile set-default YOUR-PROFILE-NAME

edgectl profile delete YOUR-PROFILE-NAME