> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/ine/installation/installation_instructions.md).

# Instalação e implantação do serviço

## 1. Instalação e implantação

O serviço é conteinerizado com Docker, e há uma imagem Docker em um repositório da Facephi.

```bash
docker login facephicorp.jfrog.io  
user: username
pass: token
```

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-ine-service:#VERSION#
```

Onde `#VERSION#` é o número da versão específica que se deseja baixar (por exemplo, `1.6.0`).

## 2. docker-compose

Uma forma de implantar o serviço é criar um arquivo `docker-compose.yml` com o seguinte conteúdo:

```yaml
version: '3.7'

services:
  ine-service:
    ports:
      - "6982:6982"
    volumes:
      - ./config:/service/config
      - ./logs:/service/logs
    image: facephicorp.jfrog.io/docker-pro-fphi/facephi-ine-service:latest
    container_name: facephi-ine-service
    environment:
      # Proteção JWT opcional
      # - FACEPHI_INE_REST_AUTH_ENABLED=true
      # - FACEPHI_INE_REST_AUTH_JWT_SECRET=shared-secret
      # - FACEPHI_INE_REST_AUTH_ACCEPT_AUTHORIZATION_HEADER=true
      # - FACEPHI_INE_REST_AUTH_ACCEPT_API_KEY_HEADER=true
      # - FACEPHI_INE_REST_AUTH_API_KEY_HEADER_NAME=x-api-key
```

Observe os volumes montados no contêiner. Eles são usados para armazenar os arquivos de configuração do serviço e gravar a saída do logger.

Execute o seguinte comando, dentro da pasta onde está o arquivo docker-compose.yml, para implantar o serviço:

```bash
  docker compose up -d
```

## 3. Configuração

O arquivo de configuração pode conter as seguintes informações:

```json
{
    "port": 6982,                   # Número da porta do serviço.
    "number_of_threads": 1,         # Número de threads de E/S; o padrão é 1. Se o valor for 0, o número de threads será igual ao número de núcleos da CPU.
    "connection_timeout": 60,       # Tempo de vida da conexão sem leitura nem gravação.
    "keep_alive_request_number": 0, # Define o número máximo de solicitações que podem ser atendidas por uma conexão keep-alive.
                                    # Quando o número máximo de solicitações é atingido, a conexão é encerrada.
                                    # O valor padrão 0 significa sem limite.
    "client_max_body_size": 50,     # Tamanho máximo permitido para o corpo das solicitações, em Mb.
                                    # O valor padrão é 100 Mb.
    "logger_path" : "/service",     # Caminho do arquivo de log.
    "logger_file_prefix" : "ine",   # Prefixo usado nos arquivos de log rotacionados.
    "logger_level" : "trace",       # Define o nível de log. [trace|debug|info|warn|error|fatal|off]
    "logger_rotation" : "daily",    # Define a rotação dos logs. [hourly|daily]
    "logger_max_files" : 31,         # Define o número máximo de arquivos de log.
    "auth_enabled": false,           # Habilita ou desabilita a autenticação JWT.
    "auth_jwt_secret": "",          # Segredo compartilhado usado para validar JWTs HS256.
    "auth_accept_authorization_header": true,
    "auth_accept_api_key_header": true,
    "auth_api_key_header_name": "x-api-key"
}
```

O arquivo de configuração pode ser passado como parâmetro para o serviço. Por padrão, o serviço procura um arquivo chamado `/service/config/config.json`.

A ordem de precedência da configuração é:

1. Variáveis de ambiente `FACEPHI_INE_REST_*`
2. `config.json`
3. Valores padrão da API definidos pelo serviço antes da inicialização
4. Valores padrão internos de `Rest::Manager`

A autenticação JWT é opcional e fica desabilitada por padrão.

* Os endpoints públicos continuam acessíveis sem autenticação: `GET /api/v1/health` e `GET /api/v1/version`.
* `POST /api/v1/facial/authentication` exige um JWT válido quando a autenticação JWT está habilitada.
* O serviço não expõe endpoints `GET/POST /config` em tempo de execução, portanto, a configuração JWT não pode ser visualizada nem modificada por meio de uma API de configuração pública.

Variáveis de ambiente JWT compatíveis:

* `FACEPHI_INE_REST_AUTH_ENABLED`
* `FACEPHI_INE_REST_AUTH_JWT_SECRET`
* `FACEPHI_INE_REST_AUTH_ACCEPT_AUTHORIZATION_HEADER`
* `FACEPHI_INE_REST_AUTH_ACCEPT_API_KEY_HEADER`
* `FACEPHI_INE_REST_AUTH_API_KEY_HEADER_NAME`
