Vai al contenuto principale
Questo argomento è disponibile anche per Linux.
Questa sezione fornisce istruzioni su come eseguire ABBYY FineReader Engine 12 all’interno di un container Docker. Questo scenario utilizza due container:
  1. un container con ABBYY FineReader Engine
  2. un container con il servizio di gestione delle licenze
L’implementazione di questo scenario aumenta la tolleranza ai guasti e garantisce il funzionamento continuo di tutti i container. Se uno dei container si arresta in modo anomalo, puoi riavviarlo senza interrompere gli altri. Per questo scenario viene utilizzata una Licenza online, che si connette al server licenze *.abbyy.com.
ABBYY Licensing Service può funzionare solo con una Licenza online alla volta.
Sono necessari:
  • il tuo Customer Project ID
  • un file token della Licenza online
  • la password del file token della licenza
Per utilizzare una Licenza online ovunque sia installato ABBYY Licensing Service, devono essere soddisfatte le seguenti condizioni:
  • Connessione Internet attiva
  • Connessioni consentite a *.abbyy.com sulla porta 443 (HTTPS)
  • GoDaddy Trusted Root Certification Authority
Il certificato radice GoDaddy per l’autorità di certificazione deve essere installato nell’archivio certificati Trusted Root Certification Authorities del computer locale. Per informazioni dettagliate sul certificato, consulta il sito web di GoDaddy.
Per eseguire ABBYY FineReader Engine 12 in un container Docker:
  1. Scarica e installa Docker for Windows sul tuo computer.
  2. Abilita le funzionalità Windows Hyper-V e Containers.
  3. Durante l’installazione del container, seleziona l’opzione “Use Windows containers instead of Linux containers”.
  4. Crea una directory vuota e inserisci al suo interno:
  • docker-compose.yml — un file di configurazione di Docker Compose (vedi il relativo contenuto di seguito)
  • TestAppFolder — una directory contenente
    • il file token della Licenza online
    • l’applicazione di test compilata per utilizzare questo file token, nonché la relativa password e il tuo Customer Project ID
  • Dockerfile_ls — un Dockerfile per il container con il servizio di gestione delle licenze (vedi il relativo contenuto di seguito)
Dockerfile_ls è destinato alla creazione di un container che funzionerà solo con un singolo container creato da Dockerfile_worker . Non configurare più repliche del container con ABBYY FineReader Engine per operare con un singolo servizio di gestione delle licenze.
  • LicensingSettings_ls.xml - un file con i parametri di gestione delle licenze per il servizio di gestione delle licenze (vedi il relativo contenuto di seguito)
  • DeployLS.ps1 — uno script per avviare il servizio di gestione delle licenze (vedi il relativo contenuto di seguito)
Nota: questo script avvia il servizio di gestione delle licenze con la chiave /standalone. Con questa chiave, il servizio di gestione delle licenze viene eseguito come processo in primo piano, che rappresenta la procedura consigliata per l’utilizzo nei container Docker.
  • Dockerfile_worker — un Dockerfile per il container con ABBYY FineReader Engine e l’applicazione di test (Vedi il contenuto di seguito)
  • LicensingSettings_worker.xml - un file con i parametri di gestione delle licenze per la libreria ABBYY FineReader Engine (Vedi il contenuto di seguito)
  • SetUpWorkerLicensing.ps1 - uno script per sostituire il nome del server in LicensingSettings_worker.xml con il nome specificato in docker-compose.yml (Vedi il contenuto di seguito)
  • RunTestApp.ps1 — uno script da riga di comando per eseguire l’applicazione di test (Vedi il contenuto di seguito)
  1. Estrai il pacchetto di distribuzione di ABBYY FineReader Engine nella directory creata in precedenza con il comando:
installRnt64.exe /extract InstallDir="<your_directory>/FRE"
  1. Per creare ed eseguire i container, utilizza il comando seguente:
docker-compose up
I risultati dell’esecuzione dell’applicazione di test verranno visualizzati nella console.
Se utilizzi Windows Server Core come immagine di base del container, configura i font dopo aver distribuito ABBYY FineReader Engine, come descritto in Uso dei font
version: '3'
services:
  ls:
    build:
      context: .
      dockerfile: Dockerfile_ls
    hostname: servername
    networks:
      frenet:
        aliases:
          - servername
    restart: on-failure
  worker:
    build:
      context: .
      dockerfile: Dockerfile_worker
      args:
        - service_address=servername
    depends_on:
      - ls
    networks:
      frenet:
    restart: on-failure
networks:
  frenet:
Dockerfile_ls
# Copia del servizio di gestione delle licenze
FROM mcr.microsoft.com/windows/servercore:ltsc2019 as fre12_ls
WORKDIR /app
ADD ./FRE/Licensing /app/FRE_Licensing
ADD ./LicensingSettings_ls.xml /app/FRE_Licensing/LicensingSettings.xml
WORKDIR /app/FRE_Licensing
# Installazione del servizio di gestione delle licenze
COPY ./DeployLS.ps1 /app/DeployLS.ps1
EXPOSE 3022
SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]
ENTRYPOINT /app/DeployLS.ps1
LicensingSettings_ls.xml
<?xml version="1.0" encoding="utf-8"?>
<LicensingSettings xmlns="http://www.abbyy.com/Protection/LicensingSettings">
  <LocalLicenseServer>
    <ConnectionProtocol ProtocolType="TCP/IP" />
  </LocalLicenseServer>
</LicensingSettings>

echo "Preparazione della cartella dei log:"
$folder = "C:\ProgramData\ABBYY\SDK\12\Licenses"
echo $folder
if( (Test-Path -Path $folder) -ne $True ) {
    New-Item -Path $folder -ItemType Directory
}
echo "LicensingSettings.xml trovato:"
cd "C:/app/FRE_Licensing"
type LicensingSettings.xml
echo "Avvio del servizio di gestione delle licenze..."
.\LicensingService.exe /standalone
 
echo "Servizio di gestione delle licenze arrestato."
return 500
Dockerfile_worker
FROM mcr.microsoft.com/windows/servercore:ltsc2019 as fre12installation
# Copia la libreria estratta nella cartella C:/app/FRE12
ARG library_src="./FRE/FineReader Engine"
ADD $library_src /app/FRE12
ADD ./LicensingSettings_worker.xml /app/FRE12/Bin64/LicensingSettings.xml
# Sostituisce <service_address> nel file LicensingSetting.xml del worker
ARG service_address
COPY ./SetUpWorkerLicensing.ps1 /app/SetUpWorkerLicensing.ps1
SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]
RUN /app/SetUpWorkerLicensing.ps1 -ServerAddress $service_address
# Copia ed esegue un'applicazione di test
COPY ./TestAppFolder /app/TestAppFolder
COPY ./RunTestApp.ps1 /app/RunTestApp.ps1
CMD /app/RunTestApp.ps1
LicensingSettings_worker.xml
<?xml version="1.0" encoding="utf-8"?>
<LicensingSettings xmlns="http://www.abbyy.com/Protection/LicensingSettings">
  <LicensingServers>
    <MainNetworkLicenseServer ServerAddress="<server_address>" ProtocolType="TCP/IP" />
  </LicensingServers>
</LicensingSettings>

Param (
[string]$service_address
)
# Script per preparare la cartella dei log della gestione delle licenze del client e impostare ServerAddress in LicesingSettings.xml
echo "Preparing logging folder:"
echo "C:\ProgramData\ABBYY\SDK\12\Licenses"
New-Item -Path "C:\ProgramData\ABBYY\SDK\12\Licenses" -ItemType Directory
echo "LicensingSettings.xml found:"
cd "C:/app/FRE12/Bin64"
type LicensingSettings.xml
echo "Setting service address to: "
echo $service_address
((Get-Content -path LicensingSettings.xml -Raw) -replace '<server_address>',$Env:service_address) `
| Set-Content -Path LicensingSettings.xml
echo "LicensingSettings.xml was set:"
type LicensingSettings.xml

# Script per eseguire un'applicazione di test dalla cartella TestAppFolder
# Avvia l'applicazione di test con argomenti (CommandLineInterface.exe viene usato come applicazione di test)
cd C:\app\TestAppFolder
.\CommandLineInterface.exe  -pi -if Demo.tif -f PDF -of Demo.pdf
# Per utilizzare l'esempio di codice CommandLineInterface in un container Docker, è necessario:
# 1)specificare i dati del container Docker in SamplesConfig.h:
# - GetLicensePath, GetCustomerProjectId, GetLicensePassword
# - L"C:\\app\\FRE12\\Bin64\\FREngine.dll" come GetFreDllPath
# 2)ricompilare il progetto per la configurazione x64.
# 3)copiare nella cartella \TestAppFolder il file di licenza CommandLineInterface.exe, *.ABBYY.ActivationToken
#  e l'immagine demo (Demo.tif).

​
Vedi anche

Installazione del servizio di gestione delle licenze su Windows Gestione delle licenze Attivazione