Referință CLI digna 2026.06¶

2026-09-05

Această pagină documentează setul complet de comenzi disponibile în versiunea 2026.06 a CLI digna, inclusiv exemple de utilizare și opțiuni.

Executabilul se numește digna.

Noțiuni de bază despre CLI¶

Prezentare generală și sintaxă¶

CLI-ul versiunii 2026.06 folosește o ierarhie de comenzi structurată, bazată pe categorii:

digna [GLOBAL_OPTIONS] <COMMAND_CATEGORY> <SUBCOMMAND> [OPTIONS] [ARGUMENTS]

version și serve sunt comenzi de sine stătătoare, fără subcomandă:

digna [GLOBAL_OPTIONS] <COMMAND> [OPTIONS] [ARGUMENTS]

Opțiuni globale¶

Următoarele opțiuni globale se aplică tuturor comenzilor:

--help, -h: Afișează informații de ajutor despre CLI sau despre o anumită categorie de comenzi ori subcomandă.
--stacktrace: În caz de eroare, afișează întregul lanț de erori în loc de doar mesajul de nivel superior.

--stacktrace este o opțiune globală în sens strict: trebuie indicată înainte de categoria de comandă, nu după ea.

digna --stacktrace repo check     # correct
digna repo check --stacktrace     # rejected: unknown argument

Nu există un indicator --version. Folosiți în schimb comanda version.

Cerințe preliminare¶

Majoritatea comenzilor au nevoie de un fișier config.toml lizibil și valid; unele necesită în plus o licență valabilă. Tabelul următor consemnează ce încarcă fiecare categorie de comenzi înainte de a face orice altceva:

Categorie de comenzi	Necesită `config.toml`	Necesită licență valabilă
`version`	nu	nu
`config check`	nu (tocmai acesta este obiectul raportării comenzii)	nu
`license check`	nu	ea este verificarea
`crypt`	da	nu
`serve`	da	nu
`windows`	nu (serviciul îl citește la pornire)	nu
`project`	da	nu
`user`	da	da
`inspection`	da	da
`repo`	da	da

Acolo unde este necesară o licență, se verifică atât semnătura, cât și data de expirare a acesteia, iar comanda se oprește înainte de a atinge repository-ul dacă oricare dintre ele eșuează.

Coduri de ieșire¶

0: comanda a reușit.
1: comanda a eșuat. Mesajul de eroare este scris în stderr, precedat de prefixul Error:.

help¶

Opțiunea --help oferă informații despre categoriile de comenzi, subcomenzile și opțiunile disponibile:

Afișarea ajutorului general:
```
digna --help
```
Obținerea ajutorului pentru categorii și comenzi specifice:
```
digna user --help
digna user add --help
```

Rezultatul include: - Descrierea comenzii: Rezumat al scopului comenzii. - Sintaxa: Argumentele obligatorii și cele opționale. - Opțiunile: Indicatorii și parametrii specifici comenzii.

version¶

Comanda version afișează versiunea instalată a digna. Nu citește nicio configurație și nu validează nicio licență, așa că funcționează și pe o instalare al cărei fișier config.toml sau a cărei licență lipsește ori este invalidă.

Versiunea produsului este independentă de versiunea schemei repository-ului raportată de repo check.

Utilizarea comenzii¶

digna version

Exemplu de ieșire¶

2026.06

Gestionarea configurației¶

config check¶

Comanda config check validează fișierul de configurare (config.toml), verificând dacă toate secțiunile și setările obligatorii sunt prezente și corect formatate. Fiecare secțiune este validată separat, astfel încât o secțiune [app] defectă să nu ascundă starea secțiunii [repo].

Secțiunile raportate sunt:

App config ([app])
Repository config ([repo])
Base config ([base])
Logging config ([logging])
Encryption config ([encryption])
OIDC config(s) (oidc_clients) — opțională; o cheie absentă trece verificarea, iar o listă prezentă, dar formată greșit, nu o trece

Comanda nu încarcă în mod deliberat configurația aplicației așa cum o fac celelalte comenzi, pentru a putea diagnostica un fișier config.toml care ar împiedica pornirea aplicației digna.

Utilizarea comenzii¶

digna config check [OPTIONS]

Opțiuni¶

--configpath, -c: Calea către fișierul de configurare sau către un director care conține config.toml (implicit ./config.toml).
--json: Emite raportul de validare în format JSON. Are prioritate față de --quiet.
--quiet, -q: Suprimă raportul și se bazează exclusiv pe codul de ieșire.

Exemplu¶

digna config check

Validarea unui anumit fișier de configurare și formatarea rezultatului ca JSON:

digna config check --configpath /etc/digna/config.toml --json

Exemplu de ieșire¶

Configuration validation report (source: config.toml):
 - App config: OK
 - Repository config: OK
 - Base config: OK
 - Logging config: OK
 - Encryption config: FAILED
    missing field `aes_gcm_key`
 - OIDC config(s): OK

Overall: FAILED

Un fișier lipsă sau o eroare de sintaxă TOML nu lasă nimic de validat secțiune cu secțiune și este raportat ca o singură eroare în loc de un raport, indiferent de --quiet sau --json.

Gestionarea repository-ului¶

repo check¶

Comanda repo check testează conexiunea la baza de date și verifică instalarea și versiunea repository-ului. Eșuează dacă schema configurată nu există sau dacă există, dar nu conține un repository digna.

Versiunea raportată este versiunea schemei repository-ului, care este versionată separat de versiunea digna afișată de version.

Utilizarea comenzii¶

digna repo check

Exemplu de ieșire¶

Repo version 3.0.0 installed

repo install¶

Comanda repo install instalează un nou repository digna în schema configurată în config.toml, creând toate secvențele, tabelele, indecșii, constrângerile și înregistrările inițiale necesare.

Schema propriu-zisă nu este creată de această comandă — ea trebuie să existe în prealabil. Comanda refuză de asemenea să ruleze dacă în acea schemă este deja instalat un repository și indică repo upgrade dacă versiunea instalată este una mai veche.

Utilizarea comenzii¶

digna repo install

Exemplu de ieșire¶

Installing repo version 3.0.0
✅ Sequences created.
✅ Tables and Indices created.
✅ Constraints created.
✅ Records inserted.
✅ Repo version 3.0.0 successfully installed.

repo upgrade¶

Comanda repo upgrade aplică migrări ale schemei bazei de date pentru a aduce un repository existent la versiunea așteptată de ediția instalată. Actualizările sunt aplicate câte un salt de versiune pe rând, de-a lungul unei căi de actualizare fixe, iar fiecare salt finalizat este consemnat în repository.

Dacă repository-ul se află deja la versiunea așteptată, comanda raportează că nu este necesară nicio actualizare și nu face nicio modificare.

Utilizarea comenzii¶

digna repo upgrade

Exemplu de ieșire¶

Upgrading from 2.3.1 to 2.3.2...
Upgrading from 2.3.2 to 3.0.0...
✅ Repo successfully upgraded to version 3.0.0.

repo prune¶

Comanda repo prune elimină rândurile care au supraviețuit proiectului sau sursei de date căreia îi aparțineau. Ștergerea unui proiect sau a unei surse de date elimină obiectul în sine, dar lasă în urmă profilurile, predicțiile, stările și numărul de rânduri ale acestuia — un compromis deliberat, deoarece o ștergere care ar curăța și aceste tabele l-ar face pe utilizator să aștepte. repo prune este operațiunea de întreținere care le elimină și poate fi rulată oricând în siguranță: elimină doar rândurile al căror proiect sau sursă de date nu mai există.

Rândurile scrise de backend-ul Python în tabele pe care versiunea curentă nu le mai folosește sunt lăsate neatinse.

Utilizarea comenzii¶

digna repo prune [OPTIONS]

Opțiuni¶

--dry-run: Raportează ce ar fi eliminat, fără a elimina nimic.

Sunt listate doar tabelele cu rânduri orfane. Dacă nu există niciunul, comanda raportează No orphaned rows found. și se încheie.

Exemplu¶

digna repo prune

Exemplu de ieșire¶

"check"                                 29342
check_profile                           29342
check_prediction                        29342
check_status                            29342
column_status                              32
inspection_query                          253
---------------------------------------------
total                                  117854

✅ Removed 117854 orphaned row(s).

Pentru a vedea același raport fără a elimina nimic:

digna repo prune --dry-run

Numărul de rânduri este identic; diferă doar linia de încheiere:

---------------------------------------------
total                                  117854

Dry run - nothing was removed.

Gestionarea criptării¶

crypt gen-key¶

Comanda crypt gen-key generează o nouă cheie de criptare AES-GCM, destinată utilizării ca cheie de criptare în config.toml. Trebuie să existe deja un fișier config.toml care poate fi încărcat, chiar dacă cheia generată nu depinde de el.

Utilizarea comenzii¶

digna crypt gen-key

Exemplu de ieșire¶

Encryption key: <base64-encoded key>

crypt encrypt¶

Comanda crypt encrypt criptează un șir de caractere (de exemplu o parolă de bază de date) folosind cheia AES-GCM configurată în config.toml și afișează textul cifrat.

Utilizarea comenzii¶

digna crypt encrypt <VALUE>

Argumente¶

VALUE: Șirul de caractere în clar care trebuie criptat (obligatoriu).

Exemplu¶

digna crypt encrypt mysecretpassword

crypt decrypt¶

Comanda crypt decrypt decriptează un șir de caractere criptat cu AES-GCM folosind cheia configurată în config.toml și afișează textul în clar.

Utilizarea comenzii¶

digna crypt decrypt <VALUE>

Argumente¶

VALUE: Șirul cifrat care trebuie decriptat (obligatoriu).

Exemplu¶

digna crypt decrypt "encrypted_string_here"

Gestionarea utilizatorilor¶

user add¶

Comanda user add creează un cont de utilizator nou în repository-ul digna. Comanda eșuează dacă există deja un utilizator cu adresa de e-mail indicată.

Utilizarea comenzii¶

digna user add <EMAIL> <PASSWORD> <DISPLAY_NAME> [OPTIONS]

Argumente¶

EMAIL: Adresa de e-mail a utilizatorului (obligatoriu).
PASSWORD: Parola inițială a utilizatorului (obligatoriu).
DISPLAY_NAME: Numele complet afișat al utilizatorului (obligatoriu).

Opțiuni¶

--admin, -a: Creează utilizatorul cu privilegii de administrator (superutilizator).

Exemplu¶

digna user add jdoe@example.com "SecurePass123!" "John Doe"

Pentru a crea un cont de administrator:

digna user add admin@example.com "AdminPass123!" "Admin User" --admin

Exemplu de ieșire¶

User created with ID: 42

user list¶

Comanda user list listează toți utilizatorii înregistrați în format tabelar, cu ID, e-mail, nume afișat și indicatorul de administrator.

Utilizarea comenzii¶

digna user list

Exemplu de ieșire¶

ID                   EMAIL                          DISPLAY NAME                   ADMIN
-----------------------------------------------------------------------------------------------
42                   jdoe@example.com               John Doe                       false
43                   admin@example.com              Admin User                     true

user modify¶

Comanda user modify actualizează numele afișat și privilegiile de administrator ale unui cont de utilizator existent, identificat după adresa de e-mail.

Atât numele afișat, cât și indicatorul de administrator sunt scrise de fiecare dată. --admin este un comutator, nu o valoare: omiterea lui revocă privilegiile de administrator, așa că indicați-l ori de câte ori utilizatorul trebuie să le păstreze sau să le primească.

Utilizarea comenzii¶

digna user modify <EMAIL> <DISPLAY_NAME> [OPTIONS]

Argumente¶

EMAIL: Adresa de e-mail a utilizatorului de modificat (obligatoriu).
DISPLAY_NAME: Numele afișat actualizat (obligatoriu).

Opțiuni¶

--admin, -a: Acordă privilegii de administrator. Omiteți-l pentru a le revoca.
--valid-until, -v: Acceptat din motive de compatibilitate, dar momentan neaplicat. Indicarea lui afișează un avertisment și nu schimbă nimic.

Exemplu¶

digna user modify jdoe@example.com "Johnathan Doe" --admin

Exemplu de ieșire¶

User jdoe@example.com modified successfully

user modify-pwd¶

Comanda user modify-pwd actualizează parola unui cont de utilizator existent.

Utilizarea comenzii¶

digna user modify-pwd <EMAIL> <PASSWORD>

Argumente¶

EMAIL: Adresa de e-mail a utilizatorului a cărui parolă trebuie actualizată (obligatoriu).
PASSWORD: Noua parolă (obligatoriu).

Exemplu¶

digna user modify-pwd jdoe@example.com "NewSecurePass456!"

user delete¶

Comanda user delete elimină un cont de utilizator din sistem.

Utilizarea comenzii¶

digna user delete <EMAIL>

Argumente¶

EMAIL: Adresa de e-mail a utilizatorului de șters (obligatoriu).

Exemplu¶

digna user delete jdoe@example.com

Gestionarea proiectelor și a surselor de date¶

project list¶

Comanda project list listează toate proiectele disponibile în repository, afișând ID-ul, numele și descrierea acestora.

Utilizarea comenzii¶

digna project list

Exemplu de ieșire¶

ID                   NAME                           DESCRIPTION
------------------------------------------------------------------------------------------------------
7                    ProjectA                       Sales data quality
8                    ProjectB                       Finance data quality

project list-ds¶

Comanda project list-ds listează toate sursele de date asociate unui proiect dat, afișând ID-ul, numele, tipul, schema și numele tabelei acestora.

Utilizarea comenzii¶

digna project list-ds <PROJECT_NAME>

Argumente¶

PROJECT_NAME: Numele proiectului ale cărui surse de date trebuie listate (obligatoriu). Numele trebuie să corespundă exact.

Exemplu¶

digna project list-ds ProjectA

Exemplu de ieșire¶

ID                   NAME                           KIND            SCHEMA               TABLE
-------------------------------------------------------------------------------------------------------------
101                  orders                         Table           sales                orders
102                  customers                      Table           sales                customers

project export-ds¶

Comanda project export-ds exportă sursele de date ale unui proiect într-un document JSON.

Dacă nu se indică nici --table-name, nici --table-id, sunt exportate toate sursele de date ale proiectului.

Utilizarea comenzii¶

digna project export-ds <PROJECT_NAME> [OPTIONS]

Argumente¶

PROJECT_NAME: Numele proiectului din care se exportă sursele de date (obligatoriu).

Opțiuni¶

--table-name, -n: Numele surselor de date de exportat. Se pot indica mai multe nume, separate prin spații.
--table-id, -i: ID-urile surselor de date de exportat. Se pot indica mai multe ID-uri, separate prin spații.
--exportfile, -f: Calea în care se salvează sursele de date exportate (implicit: data_sources_export.json).

Exemplu¶

Pentru a exporta toate sursele de date din ProjectA:

digna project export-ds ProjectA --exportfile my_export.json

Pentru a exporta anumite tabele:

digna project export-ds ProjectA --table-name users orders -f users_orders_export.json

Exemplu de ieșire¶

Successfully exported 2 data source(s) to users_orders_export.json

project import-ds¶

Comanda project import-ds importă surse de date dintr-un fișier de export într-un proiect țintă și raportează, pentru fiecare obiect, ce a fost creat, actualizat sau omis.

Utilizarea comenzii¶

digna project import-ds <PROJECT_NAME> <EXPORT_FILE> [OPTIONS]

Argumente¶

PROJECT_NAME: Numele proiectului țintă în care se importă (obligatoriu).
EXPORT_FILE: Calea către fișierul JSON de export (obligatoriu).

Opțiuni¶

--output-file, -o: Fișierul în care se scrie raportul de import. Fără el, raportul este trimis la stdout.
--output-format, -f: Formatul raportului de import — table, json sau csv (implicit: table).

Exemplu¶

digna project import-ds ProjectB my_export.json

Pentru a obține un raport care poate fi citit automat:

digna project import-ds ProjectB my_export.json --output-format json --output-file import_report.json

Raportul acoperă patru niveluri de obiecte — sursa de date, definiția setului de date, atributul și regula de validare — fiecare cu acțiunea sa de import, rezultatul, ID-ul obiectului rezultat și eventualele informații suplimentare.

project plan-import-ds¶

Comanda project plan-import-ds prezintă în avans un import de surse de date într-un proiect țintă, arătând ce obiecte ar fi create, actualizate sau omise, fără a modifica nimic. Preia același fișier de export și aceleași opțiuni de raportare ca project import-ds și adaugă un număr de pas pentru fiecare obiect planificat.

Utilizarea comenzii¶

digna project plan-import-ds <PROJECT_NAME> <EXPORT_FILE> [OPTIONS]

Argumente¶

PROJECT_NAME: Numele proiectului țintă (obligatoriu).
EXPORT_FILE: Calea către fișierul de export (obligatoriu).

Opțiuni¶

--output-file, -o: Fișierul în care se scrie planul de import. Fără el, planul este trimis la stdout.
--output-format, -f: Formatul planului de import — table, json sau csv (implicit: table).

Exemplu¶

digna project plan-import-ds ProjectB my_export.json

project cleanup¶

Comanda project cleanup elimină rezultatele inspecțiilor acumulate de un proiect într-un interval de date — profiluri, predicții, număr de rânduri și fiecare stare de verificare, atribut, set de date și sursă de date. Elimină exact ceea ce a scris o inspecție pentru acele date, astfel încât intervalul să poată fi reinspectat ulterior pentru a-l reconstrui.

Istoricul Timeliness și Schema Tracker nu este eliminat: acesta consemnează ce a observat digna într-o anumită zi, nu un rezultat derivat din aceasta, astfel încât curățarea unui interval de date din trecut îl lasă intact.

Fiecare sursă de date este curățată în propria tranzacție, astfel încât o rulare întreruptă lasă surse de date complete, nu una curățată pe jumătate.

Utilizarea comenzii¶

digna project cleanup <PROJECT_NAME> <FROM_DATE> <TO_DATE> [OPTIONS]

Argumente¶

PROJECT_NAME: Proiectul care se curăță (obligatoriu). Un singur proiect per apel.
FROM_DATE: Prima dată pentru care se elimină rezultatele, YYYY-MM-DD (obligatoriu).
TO_DATE: Ultima dată pentru care se elimină rezultatele, inclusiv, YYYY-MM-DD (obligatoriu).

Opțiuni¶

--table-name, -n: Limitează curățarea la aceste surse de date. Se pot indica mai multe nume, separate prin spații.
--table-filter: Limitează curățarea la sursele de date al căror nume conține acest subșir.
--dry-run: Listează sursele de date care ar fi curățate, fără a elimina nimic.
--timing: Afișează cât a durat curățarea.

--table-name și --table-filter se combină ca un SAU — o sursă de date este curățată dacă este numită sau dacă subșirul se potrivește. Comanda eșuează dacă nicio sursă de date nu se potrivește, în loc să raporteze succes pentru o curățare care nu a făcut nimic.

Exemplu¶

digna project cleanup ProjectA 2026-01-01 2026-06-30

Limitat la o singură sursă de date:

digna project cleanup ProjectA 2026-01-01 2026-06-30 --table-name Table1

Exemplu de ieșire¶

Cleaning up project 'ProjectA' from 2026-01-01 to 2026-06-30:
- Table1
- Table2
- Table3

✅ Cleaned up 3 data source(s).

Pentru a vedea ce surse de date ar fi curățate, fără a elimina nimic:

digna project cleanup ProjectA 2026-01-01 2026-06-30 --dry-run

Fiecare linie este marcată, astfel încât o rulare de probă nu poate fi confundată cu una reală:

Cleaning up project 'ProjectA' from 2026-01-01 to 2026-06-30:
- Table1 (dry run, nothing removed)
- Table2 (dry run, nothing removed)
- Table3 (dry run, nothing removed)

Dry run - 3 data source(s) would be cleaned up.

Gestionarea inspecțiilor¶

inspection run¶

Comanda inspection run creează o cerere de inspecție pentru un proiect și un interval de date, iar apoi — în funcție de opțiunile indicate — fie o așteaptă, fie se încheie imediat, fie o execută în propriul proces.

Cele trei moduri de execuție sunt:

Implicit (fără indicator): cererea este pusă în coadă pentru backend, iar CLI-ul o interoghează la fiecare două secunde, afișând progresul sarcinilor până când inspecția ajunge într-o stare finală. Este necesar un digna serve în execuție, altfel nimic nu preia cererea.
--async-mode: cererea este pusă în coadă, iar ID-ul ei este afișat imediat. Folosiți inspection status pentru a o urmări.
--bypass-backend: inspecția este executată chiar de procesul CLI și nu este pusă în coadă, deci nu este nevoie de un server în execuție.

--async-mode și --bypass-backend se exclud reciproc.

În toate modurile, comanda se încheie cu un cod de ieșire diferit de zero dacă inspecția nu s-a finalizat cu succes.

Utilizarea comenzii¶

digna inspection run <PROJECT_NAME> <START_DATE> <END_DATE> [OPTIONS]

Argumente¶

PROJECT_NAME: Numele proiectului țintă (obligatoriu). Numele trebuie să corespundă exact.
START_DATE: Data de început a intervalului, în formatul YYYY-MM-DD (obligatoriu).
END_DATE: Data de sfârșit a intervalului, în formatul YYYY-MM-DD (obligatoriu).

Opțiuni¶

--table-name: Restrânge inspecția la o singură sursă de date a proiectului, indicată prin numele sursei de date. Fără ea, sunt inspectate toate sursele de date ale proiectului.
--async-mode: Pune inspecția în coadă și afișează ID-ul cererii în loc să o aștepte. Nu poate fi combinată cu --bypass-backend.
--bypass-backend: Rulează inspecția direct în procesul CLI în loc să o pună în coadă pentru backend. Nu poate fi combinată cu --async-mode.

Exemplu¶

digna inspection run ProjectA 2024-01-01 2024-01-31

Pentru a trimite o inspecție asincronă:

digna inspection run ProjectA 2024-01-01 2024-01-31 --async-mode

Pentru a inspecta o singură sursă de date:

digna inspection run ProjectA 2024-01-01 2024-01-31 --table-name orders

Exemplu de ieșire¶

Modul implicit:

Inspection request submitted. Waiting for completion (Request ID: 1024)...
Progress: 3/10 tasks completed (0 failed)
Progress: 10/10 tasks completed (0 failed)
Inspection completed successfully.
Inspection successful for project: ProjectA

Modul asincron:

Inspection request submitted successfully. Request ID: 1024

inspection status¶

Comanda inspection status interoghează starea și progresul sarcinilor unei cereri de inspecție după ID-ul cererii.

Utilizarea comenzii¶

digna inspection status <INSPECTION_REQUEST_ID>

Argumente¶

INSPECTION_REQUEST_ID: ID-ul numeric al cererii de inspecție (obligatoriu).

Exemplu¶

digna inspection status 1024

Exemplu de ieșire¶

Inspection Request ID: 1024
Status: Running
Project ID: 7
Date Range: 2024-01-01 to 2024-01-31
Progress: 3/10 tasks completed (0 failed)

inspection abort¶

Comanda inspection abort solicită anularea cererilor de inspecție în execuție sau în așteptare. Ea consemnează un eveniment de oprire pentru fiecare cerere vizată; backend-ul este cel care acționează pe baza lui, deci o întrerupere este o cerere de oprire, nu o oprire imediată.

Utilizarea comenzii¶

digna inspection abort [INSPECTION_REQUEST_ID] [OPTIONS]

Argumente¶

INSPECTION_REQUEST_ID: ID-ul cererii de inspecție care trebuie întreruptă. Obligatoriu, cu excepția cazului în care se indică --killall.

Opțiuni¶

--killall: Întrerupe toate cererile de inspecție aflate în execuție și în așteptare. Are prioritate față de un ID de cerere indicat alături de ea.

Exemplu¶

Pentru a întrerupe o anumită cerere:

digna inspection abort 1024

Pentru a întrerupe toate inspecțiile active și cele din coadă:

digna inspection abort --killall

Exemplu de ieșire¶

--killall raportează ce a făcut; întreruperea unei singure cereri nu produce niciun rezultat afișat și semnalează succesul prin codul său de ieșire.

All running and pending inspections have been aborted.

Gestionarea licențelor¶

license check¶

Comanda license check validează fișierul license.toml, verificându-i semnătura cu ajutorul cheii publice livrate împreună cu instalarea și controlând că nu a expirat. Nu citește nicio configurație a aplicației, deci funcționează și înainte ca config.toml să fie configurat.

Utilizarea comenzii¶

digna license check

Exemplu de ieșire¶

License is valid

O semnătură invalidă și o licență expirată sunt raportate ca erori distincte, ambele cu codul de ieșire 1.

Server și servicii de fundal¶

serve¶

Comanda serve lansează serverul REST API al aplicației digna, împreună cu planificatorul de inspecții și managerul de inspecții care rulează în fundal. La pornire, marchează de asemenea ca eșuată orice inspecție pe care repository-ul o mai consemnează ca fiind în execuție, întrucât nimic nu poate să fi supraviețuit dintr-un proces anterior.

Comanda rulează în prim-plan până când este oprită.

Utilizarea comenzii¶

digna serve [OPTIONS]

Opțiuni¶

--address: Adresa de rețea la care se leagă serverul API (implicit: 127.0.0.1).
--port: Numărul portului pe care se ascultă (implicit: 8000).

Exemplu¶

digna serve --address 0.0.0.0 --port 8000

Exemplu de ieșire¶

Server running on http://0.0.0.0:8000

Gestionarea serviciului Windows¶

Disponibil doar pe Windows. Comenzile înregistrează backend-ul digna în managerul de servicii Windows și îl controlează; serviciul în sine rulează serve în fundal. Fiecare comandă trebuie rulată dintr-un Command Prompt cu drepturi ridicate și fiecare acceptă --name, astfel încât să poată fi adresat un serviciu înregistrat sub un nume diferit de cel implicit.

windows install¶

Comanda windows install înregistrează digna ca serviciu Windows.

Adresa și portul indicate aici sunt consemnate în înregistrarea serviciului și sunt cele la care se leagă serviciul — nu sunt citite din config.toml. Pentru a le modifica ulterior, dezinstalați serviciul și instalați-l din nou.

Utilizarea comenzii¶

digna windows install [OPTIONS]

Opțiuni¶

--name: Numele sub care se înregistrează serviciul (implicit: digna).
--display-name: Numele afișat în services.msc (implicit: digna).
--description: Descrierea afișată în services.msc (implicit: digna data quality backend).
--address: Adresa la care serviciul își leagă API-ul (implicit: 127.0.0.1).
--port: Portul la care serviciul își leagă API-ul (implicit: 8000).
--working-dir: Directorul care conține config.toml și license.toml, pe care serviciul îl folosește ca director de lucru (implicit: directorul executabilului digna).
--start-type: Când pornește serviciul — auto odată cu Windows, manual doar la cerere, disabled înregistrat, dar refuză să pornească (implicit: auto).
--account: Contul sub care rulează, de ex. DOMAIN\user sau .\user (implicit: LocalSystem).
--password: Parola pentru --account.

Exemplu¶

digna windows install --address 0.0.0.0 --port 8082

Înregistrare sub un al doilea nume, rulând cu un cont de domeniu:

digna windows install --name digna-test --display-name "digna (test)" --account DOMAIN\svc_digna --password <password>

windows start¶

Comanda windows start pornește un serviciu înregistrat.

Utilizarea comenzii¶

digna windows start [OPTIONS]

Opțiuni¶

--name: Numele sub care este înregistrat serviciul (implicit: digna).

windows stop¶

Comanda windows stop oprește un serviciu aflat în execuție. Opriți serviciul înainte de a înlocui orice fișier al aplicației.

Utilizarea comenzii¶

digna windows stop [OPTIONS]

Opțiuni¶

--name: Numele sub care este înregistrat serviciul (implicit: digna).

windows uninstall¶

Comanda windows uninstall anulează înregistrarea serviciului. Opriți-l mai întâi.

Utilizarea comenzii¶

digna windows uninstall [OPTIONS]

Opțiuni¶

--name: Numele sub care este înregistrat serviciul (implicit: digna).