Pular para o conteúdo principal

​
Lista de verificação de pré-requisitos

Prepare e configure os seguintes componentes externos antes de instalar o Vantage:
  • Uma máquina com Docker e acesso à internet (a partir da qual o Vantage será instalado)
  • Máquinas virtuais (com acesso à internet durante a instalação) para serem usadas como nós do Kubernetes
  • Um registro de contêiner para armazenar imagens Docker
  • Sistemas de Gerenciamento de Banco de Dados Relacionais (RDBMS) para a operação do Vantage
  • Um servidor SMTP para enviar mensagens de e-mail aos usuários do Vantage
  • Um certificado TLS para estabelecer comunicações criptografadas
  • 2 endereços IP estáticos — um para configuração/gerenciamento do Kubernetes, outro para acesso ao Vantage
  • Um registro DNS para acesso ao Vantage
  • Armazenamento externo (opcional em configurações sem alta disponibilidade)

​
Requisitos da Máquina de Instalação

A máquina a partir da qual o Vantage está sendo instalado requer:
  • Sistema operacional Linux ou Windows Subsystem for Linux (WSL)
  • Docker na versão 19.03 ou posterior
  • Acesso de rede a abyvtgonprm27.azurecr.io
  • Arquivos locais contendo uma chave SSH privada (sem senha/passphrase) para a conta de usuário ansible
Todas as máquinas virtuais devem usar a mesma chave SSH.

​
Requisitos de Infraestrutura

Todas as máquinas virtuais podem ser executadas em VMware ou Hyper-V e devem ter:
  • Um endereço IP estático
  • Uma conta de usuário chamada ansible com:
    • Acesso compartilhado por chave SSH
    • Acesso sudo com a opção NOPASSWD
  • Um disco/lvm_volume dedicado e expansível montado em /opt/local-path-provisioner em cada nó worker
  • Acesso à Internet durante a instalação, tanto ao registro de contêineres quanto aos repositórios de pacotes:
    • Registro de contêineres com as imagens sincronizadas preparadas como pré-requisito para a instalação do Vantage. Para obter mais informações, consulte Baixando Imagens de Contêiner.
    • Repositório de pacotes: Ubuntu (archive.ubuntu.com), RHEL (cdn.redhat.com). Em vez de acesso aos repositórios de pacotes, você também pode configurar o acesso ao seu próprio repositório, que deve conter todos os pacotes necessários listados abaixo.
Comum a todas as distribuições:
curl, socat, unzip, e2fsprogs, xfsprogs, ebtables, tar
Pacotes específicos do sistema operacional:
Ubuntu 20.04RHEL 8
python3-apt, apt-transport-https, software-properties-common, conntrack, libseccomp2device-mapper-libs, nss, conntrack, container-selinux, libseccomp

​
Acesso de Rede Pós-Instalação

Após a instalação do cluster, as máquinas virtuais precisam de acesso a:
  • https://licensing-us.abbyy.com
  • Ao servidor de e-mail, para o qual as configurações SMTP são especificadas no arquivo env_specific.yml (para envio de convites por e-mail, recuperação de senhas etc.).
  • A todos os servidores de e-mail a partir dos quais você vai importar seus e-mails em Skills de Processo do Vantage.

​
Configuração de Alta Disponibilidade

É informado o número mínimo necessário de máquinas virtuais. Diferentes requisitos de desempenho podem exigir um número diferente de máquinas virtuais.
Tipo de nó do KubernetesMaster NodesWorker Nodes (Services)Worker Nodes (Workers)
Sistema OperacionalUbuntu 20.04 ou RHEL 8Ubuntu 20.04 ou RHEL 8Ubuntu 20.04 ou RHEL 8
Número de VMs341
Núcleos de CPU (para cada VM)21212
RAM, GB (para cada VM)44848
Armazenamento em disco para Kubernetes, GB (para cada VM)508080
Disco/volume para o ponto de montagem /opt/local-path-provisioner, GBNão é necessárioMínimo 40Mínimo 40
Largura de banda de rede, Gbps (para cada VM)111

​
Sem configuração de alta disponibilidade

Tipo de nó KubernetesNós masterNós worker (Services)Nós worker (Workers)
Sistema operacionalUbuntu 20.04 ou RHEL 8Ubuntu 20.04 ou RHEL 8Ubuntu 20.04 ou RHEL 8
Número de VMs111
Núcleos de CPU (para cada VM)21212
RAM, GB (para cada VM)44848
Armazenamento em disco para Kubernetes, GB (para cada VM)508080
Disco/volume para o ponto de montagem /opt/local-path-provisioner, GBNão é necessárioMínimo 40Mínimo 40
Largura de banda de rede, Gbps (para cada VM)111
A versão 1.33.3 do Kubernetes será instalada durante a instalação do Vantage.

​
Registro de Contêineres

Você pode usar qualquer registro de contêiner.

​
Requisitos do banco de dados

É necessário um banco de dados Microsoft SQL Server ou PostgreSQL com a seguinte configuração:Opção 1: Microsoft SQL Server
VersãoSONúcleos de CPURAM, GBArmazenamento em disco, GBPesquisa de texto completo
Enterprise 2022Linux44Recomendado: 400, mín.: 200Ativada
Opção 2: PostgreSQL
VersãoNúcleos de CPURAM, GBArmazenamento em disco, GB
14+44Recomendado: 400, mín.: 200
Um servidor de banco de dados externo deve ser configurado, e você deve ter as credenciais adequadas para criar e gerenciar o novo banco de dados.O instalador requer o endereço IP do SQL Server, bem como um nome de usuário e senha para se conectar ao banco de dados.

​
Servidor SMTP

O servidor deve operar por meio do protocolo SMTP. O instalador requer o endereço IP/nome DNS e a porta do servidor SMTP, além de uma senha para se conectar ao servidor (se o servidor exigir autenticação). O servidor SMTP deve ter permissão para enviar e-mails aos usuários do Vantage. Configure o SMTP com ou sem autenticação em env_specific.yml.
Recomendamos usar a opção com autenticação (com login e senha).
Com autenticação (recomendado) Com login e senha. Nesse caso, a seção smtp no arquivo env_specific.yml deve ser definida da seguinte forma: 
smtp:
  host: X.X.X.X
  login: email
  password: password
  port: 587
  useSSL: false
  secureSocketOptions: null
Sem autenticação Sem login e senha. Nesse caso, a seção smtp no arquivo env_specific.yml deve ser configurada da seguinte forma: 
mailFrom: email
smtp:
  host: X.X.X.X
  login: null
  password: null
  port: 25
  useSSL: false
  secureSocketOptions: None
Não se esqueça de adicionar o Parameter mailFrom à raiz.
Recomendamos usar a opção com autenticação (login e senha).

​
Certificado TLS

Você precisará de um certificado curinga (wildcard) ou específico para o domínio. Se a sua instalação do Vantage vai se conectar a serviços externos usando a atividade Custom ou exportar para sistemas externos, o certificado deverá ser emitido por uma autoridade certificadora pública, por exemplo, em https://letsencrypt.org/.

​
Endereços IP estáticos

1. Acesso à API do Kubernetes. Um endereço IP estático que será usado como um endereço IP virtual para acessar o endpoint do servidor da API do Kubernetes para configurar e gerenciar o cluster. O endereço IP deve ser definido no arquivo env_specific.yml da seguinte forma. Para obter mais informações, consulte a seção Configuração dos arquivos de configuração:
k8s:
  api:
    ip: X.X.X.X
2. Acesso aos serviços do Vantage. Um endereço IP estático que será usado para acessar os serviços do Vantage por HTTPS. Um registro DNS A apropriado deve ser criado previamente. O endereço IP deve ser definido no arquivo env_specific.yml da seguinte forma. Para mais informações, consulte Installation:
loadbalancer:
  external_ip: X.X.X.X

​
Registro DNS para acesso ao Vantage

Sem requisitos específicos. O instalador requer um domínio principal e um nome DNS que será usado para acessar o Vantage. O registro DNS deve apontar para o endereço IP dedicado ao acesso ao Vantage.

​
Requisitos de Armazenamento

O armazenamento externo é um requisito opcional apenas para a configuração Without high availability. Os requisitos de tamanho de disco para a configuração Highly available são descritos no Performance Guide.ABBYY Vantage implanta armazenamento local em discos rígidos das máquinas virtuais fornecidas, o que acelera a instalação do produto. No entanto, essa opção ainda pode ser afetada por reinicializações inesperadas e falhas das máquinas virtuais. Como isso pode resultar na perda dos dados armazenados, recomenda-se usar um armazenamento externo durante a instalação.ABBYY Vantage permite definir o uso de tipos específicos de armazenamento das formas listadas abaixo.

​
Usando armazenamento local

Nesse caso, volumes com acesso ReadWriteOnce compatível com POSIX serão provisionados localmente no diretório /opt/local_path_provisioner em cada nó Kubernetes. Para tipos de volumes ReadWriteMany, o Vantage irá implantar um in-cluster nfs-kernel-server no primeiro nó abbyy_services (o IP desse nó é o primeiro no bloco correspondente no arquivo inventory). Os dados do servidor NFS serão armazenados no diretório /opt/local_path_provisioner, portanto, verifique se você possui um volume/disco dedicado para esse caminho no primeiro nó abbyy_services (o primeiro nó desse grupo é definido no arquivo inventory) com pelo menos 500 GB de capacidade.Para a configuração Highly available, o primeiro nó abbyy_services também hospedará o armazenamento de volume persistente local. Ele exigirá capacidade adicional de disco rígido dependendo da carga de processamento. Para detalhes sobre as capacidades necessárias, consulte o Performance Guide.
Se o armazenamento de volume persistente local ficar sem espaço, o Vantage poderá parar de funcionar e parte dos dados poderá ser perdida. Recomendamos que você monitore o espaço livre do seu lado e configure alertas para níveis baixos de espaço, para poder adicionar mais armazenamento a tempo e evitar a perda de dados.

​
Usando Armazenamento NFS Externo

O instalador do Vantage permite configurar automaticamente um armazenamento NFS para ser utilizado pelo Vantage em serviços específicos, como importação e exportação para uma pasta compartilhada e armazenamento dos dados coletados pelo monitoramento.A seção no arquivo env_specific.yml terá a seguinte aparência:
k8s:
  storage:
    rwx:
      external:
        enabled: true
        type: "nfs"
        nfs:
          address: <your nfs server IP address>
          path: <compartilhamento exportado do servidor nfs>
Para que o Vantage funcione corretamente, recomendamos que o diretório raiz do servidor NFS (por exemplo, /opt/nfs) tenha as seguintes permissões e o seguinte proprietário:
drwxr-xr-x 4 65532 65532 4096 Dec 12 09:25 /opt/nfs/
A seguir, um exemplo de configuração de diretório no arquivo /etc/exports para quando uma máquina Linux é usada como servidor NFS:
/opt/nfs *(rw,sync,all_squash,insecure,no_subtree_check,anonuid=65532,anongid=65532)
Caso seja necessário conectar outro tipo de armazenamento, consulte a seção Definindo suas próprias classes de armazenamento abaixo.

​
Definindo suas Próprias Classes de Armazenamento

Se você quiser usar um armazenamento externo não baseado em NFS, siga as etapas abaixo:
  1. Durante o processo de instalação, após criar o cluster Kubernetes (etapa 4 em Running the installation scripts), implante os drivers CSI (container storage interface) apropriados e crie classes de armazenamento para eles.
  2. Preencha a seção k8s no arquivo env_specific.yml usando o seguinte código:
k8s:
  storage:
    rwo:
      class_name: "<classe de armazenamento compatível com rwo posix>"
    rwx:
      class_name: "<classe_de_armazenamento_read_write_many>"
  1. Continue com a instalação.
Se o armazenamento local de volume persistente ficar sem espaço, Vantage pode parar de funcionar e causar perda de dados. Monitore o espaço livre e configure alertas.

​
Redis Cluster (somente Azure AKS)

Um cluster Redis é necessário apenas para a configuração de alta disponibilidade (HA) do Azure AKS. Isso não é necessário para implantações em máquinas virtuais ou implantações no Azure sem HA.
Para implantações de alta disponibilidade do Azure AKS, é necessário um cluster Redis externo com a seguinte configuração:
ConfiguraçãoRequisito
Versão do Redis6.2 ou posterior
Número de nós6 ou mais
RAM por nó4 GB (mínimo)
Modo de clusterAtivado
Senha do clusterNecessária
Porta SSH22 (para configuração)
As seguintes opções devem ser definidas em redis.conf: 
appendonly yes
cluster-config-file nodes-6379.conf
cluster-enabled yes
cluster-node-timeout 5000
cluster-require-full-coverage no
maxclients 10000
maxmemory 2048mb
maxmemory-policy noeviction
repl-backlog-size 256mb
repl-ping-slave-period 5
save ""
slave-serve-stale-data yes
stop-writes-on-bgsave-error no
supervised auto
masterauth <password>
requirepass <password>
O valor de maxmemory deve ser configurado como metade da memória disponível em cada nó Redis. Substitua <password> pela senha do seu cluster.
O Azure Cache for Redis não é suportado no momento. Você deve implantar o Redis em máquinas virtuais fora do cluster do AKS. O suporte ao Azure Cache for Redis está planejado para uma versão futura.