Plugin DevOps Storage

DevOps Storage è l'archivio dati specialistico del livello DWDO: uno schema SQLite versionato per progetti, elementi di lavoro, relazioni, impostazioni e traccia di verifica, con esportazione e ripristino in formato JSONL. Il contenuto delle pagine resta deliberatamente in DokuWiki. Il pacchetto si rivolge agli sviluppatori di plugin della suite e agli amministratori che devono salvare o recuperare dati.

Primi passi

Avvio rapido: la prima esportazione e il suo piano di ripristino — la via più breve al primo risultato, in tre passi.

Esaminare lo schema → Chiarire il confine con le pagine → Predisporre l'esportazione

Attività frequenti

Che cosa volete	Per chi	Dove si fa	Istruzioni
vedere quali tabelle esistono	sviluppatori	–	Lo schema
decidere se i dati appartengono qui	sviluppatori	–	Confine tra banca dati e pagine
esportare dati	amministrazione	–	Esportazione e ripristino
ripristinare dati	amministrazione	–	Esportazione e ripristino
modificare un'impostazione	amministrazione	gestore della configurazione	Configurazione
trovare il servizio SQLite generale	sviluppatori	–	wkstorage

Scopo

L'archivio dati specialistico del livello DWDO: lo schema versionato, uno strato di repository su istruzioni preparate con errori uniformati, oltre a esportazione e ripristino in formato JSONL. L'accesso tecnico è fornito da Storage; questo plugin possiede le tabelle.

Servizi registrati (vedi Core): dwdo.storage, dwdo.repos, dwdo.export.

Lo schema

Versione 013, 22 tabelle. Raggruppate per scopo:

Ambito	Tabelle
Progetti e dati specialistici	`dwdo_projects`, `dwdo_workitems`, `dwdo_relations`, `dwdo_risks`, `dwdo_queries`, `dwdo_settings`
Traccia di verifica	`dwdo_audit`
Pipeline	`dwdo_pipelines`, `dwdo_pipeline_runs`
Repository Git locali (Git)	`dwdo_git_repos`, `dwdo_git_repo_links`, `dwdo_source_links`
Connessione ADO (Azure DevOps Connector)	`dwdo_ado_connections`, `dwdo_ado_repo_map`, `dwdo_ado_workitem_map`
Allineamento ADO (predisposto, nessun plugin attivo)	`dwdo_ado_sync_state`, `dwdo_ado_sync_inbox`, `dwdo_ado_sync_outbox`, `dwdo_ado_sync_conflicts`
Proxy Git ADO (wkdoadogit)	`dwdo_adogit_mounts`, `dwdo_adogit_user_tokens`
Amministrazione	`schema_migrations`

Lo schema è più ampio dell'insieme dei plugin installati. Le tabelle per bacheche, query, rapporti e allineamento ADO sono già pronte; i plugin corrispondenti non sono ancora installati. È una scelta deliberata: inserire in seguito un passo dello schema costa più che lasciare per un certo tempo una tabella vuota.

Dove passa il confine tra banca dati e pagine

Dati strutturati nella banca dati, contenuto nelle pagine. Un elemento di lavoro ha uno stato, relazioni e una traccia di verifica — per questo una tabella è la scelta giusta. La sua descrizione è testo e appartiene a una pagina wiki, dove versionamento, ricerca, confronto ed esportazione funzionano senza alcun intervento.

Vedi anche la nota corrispondente in Storage.

Esportazione e ripristino

Il servizio dwdo.export scrive i dati in JSONL — una riga per record. Il formato è deliberatamente basato sulle righe: si può accodare, filtrare con strumenti comuni e leggere in parte, e una riga danneggiata costa un record anziché l'intero file.

La procedura di ripristino è descritta nel plugin in RECOVERY.md.

Configurazione

Nessuna. La posizione di archiviazione proviene da Storage, il taglio specialistico dallo schema.

Dati del pacchetto

Plugin: wkdostorage
Spazio dei nomi: lib/plugins/wkdostorage/
Autore: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs)
Licenza: GPL 2