Instalação e implantação do serviço
1. Instalação e implantação
O serviço está dockerizado e existe uma imagem Docker em um repositório da Facephi.
docker login facephicorp.jfrog.io
user: username
pass: tokendocker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-backend1n-service:#VERSION#Onde #VERSION# é o número de versão específico que queremos baixar (por exemplo, 4.2.0).
2. Bancos de dados.
Antes do início do serviço, o administrador deverá criar e configurar os bancos de dados pertinentes, bem como um usuário específico para o serviço. Este usuário/senha deverá ser indicado na string de conexão. A tecnologia de BD que o serviço utilizará será decidida na inicialização, em função do prefixo desta string de conexão.
2.1 MongoDB
Deverá ser criada a variável de ambiente DATABASE_CONNECT_STRING apontando para o MongoDB.
# Prefixos aceitos para MongoDB.
# mongodb://
# mongodb+srv://
export DATABASE_CONNECT_STRING=mongodb://user:pass@localhost:32902/?directConnection=true&serverSelectionTimeoutMS=5000O próprio serviço criará um banco de dados chamado db-backend, se não existir previamente. Nele hospedará duas coleções:
mediapara armazenar images.patternspara armazenar padrões biométricos.
2.2 PostgreSQL
Da mesma forma, deve ser criada a variável de ambiente DATABASE_CONNECT_STRING apontando para o PostgreSQL.
O caso do PostgreSQL difere ligeiramente do MongoDB. Um banco de dados com o nome db_backend deve ter sido criado previamente pelo administrador do sistema. PostgreSQL dificulta a criação de bancos de dados a partir do próprio cliente. Um exemplo dos comandos prévios que o administrador deveria executar seria:
Dentro do BD PostgreSQL, o serviço criará duas tabelas, assim como acontecia com MongoDB:
mediapara armazenar images.patternspara armazenar padrões biométricos.
3. docker-compose
Uma forma de implantar o serviço é criar um arquivo docker-compose.yml com o seguinte conteúdo, alterando o valor das variáveis conforme necessário.
Primeiro, você deve criar um diretório de usuário com permissões de leitura e escrita, por exemplo ~/backend1n/config, e colocar estes dois arquivos:
O arquivo de licença do SelphID
license.lic(obrigatório).O arquivo de configuração do serviço
config.json(opcional).
Nesse mesmo diretório, o serviço gravará os arquivos de log.
Além disso, você deve informar a variável de ambiente DATABASE_CONNECT_STRING com a string de conexão com o banco de dados (por exemplo, mongodb://127.0.0.1:27017). Para fins de depuração, você pode desabilitar as operações de banco de dados fornecendo o valor no-db. Exemplo: DATABASE_CONNECT_STRING=no-db
Execute o seguinte comando, dentro da pasta onde se encontra o arquivo docker-compose.yml, para implantar o serviço:
4. Configuração adicional
Seguindo os passos da seção 2, o serviço fica pronto para iniciar. Se você precisar criar volumes adicionais para os diferentes tipos de recursos, pode seguir estas configurações adicionais.
4.1 Licença
Você pode montar um volume adicional e definir a variável de ambiente LICENSE_PATH, caso queira instalar a licença fora do diretório de configuração habitual.
LICENSE_PATHé uma pasta com o arquivolicense.lice permissões de leitura e escrita. Neste exemplo,~/backend1n/license/license.lic.
4.2 Configuração do serviço
Você pode especificar outro local para o arquivo config.json com os parâmetros do serviço:
CONFIG_FILEé o caminho para o arquivo de configuração no volume adicional.
Se nenhum config.json, serão usados estes dados padrão:
Os mesmos parâmetros de JWT podem ser injetados por meio de variáveis de ambiente usando o prefixo FACEPHI_BACKEND1N_REST_. Por exemplo:
4.3 Caminho de depuração e de uso
Por fim, você pode especificar um volume/caminho específico com permissões de leitura e escrita para as informações de depuração do SDK e os dados de uso do SDK, por meio das variáveis de ambiente DEBUG_PATH e USAGE_PATH:
4.4 Configuração de rede
Para poder se conectar com nossos servidores de licenças, você deve adicionar às regras do seu firewall as seguintes regras:
52.223.22.71
443
TCP/IP
35.71.188.31
443
TCP/IP
75.2.113.112
443
TCP/IP
99.83.149.57
443
TCP/IP
Em seguida, adicione os seguintes DNS à sua lista de permissões:
Atualizado