Riferimento tecnico
Manuale di consultazione per wkdoadogit: gestione dei mount, marcatura, ogni azione con il suo indirizzo, i token di accesso personali e ogni impostazione. Perché le cose sono costruite così sta nei Concetti; ciò che volete fare, su ADO-Git.
Pacchetto: wkdoadogit · Posizione: lib/plugins/wkdoadogit/
Autore: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs) · Licenza: GPL 2.0-only
Gestione dei mount
La schermata si trova all'indirizzo /doku.php?do=admin&page=wkdoadogit_mounts, nel menu sotto Amministrazione > Mount dei repository ADO-Git. È riservata agli amministratori, perché qui si scrivono permessi validi per l'intero sito.
- La registrazione si svolge in una procedura di quattro schermate: connessione, progetto, repository (con modello di spazio dei nomi e livello) e anteprima. L'elenco di progetti e repository proviene dalla connessione; un campo libero compare solo quando il server non risponde.
- L'anteprima è l'unica schermata che scrive. Mostra ogni riga di permesso che verrà creata e avverte se lo spazio dei nomi contiene già pagine wiki.
- Cambiare livello o spazio dei nomi: nel menu di riga del mount correggere il campo dello spazio dei nomi e la scelta del livello, poi scegliere Salva. Entrambi cambiano in un solo passo e le vecchie regole cadono solo dopo lo spostamento riuscito.
- Rimozione: nel menu di riga scegliere Rimuovi.
- Il menu di riga offre inoltre l'indirizzo per
cloneper ciascuna lingua e le marcature già pronte per mostrare il repository su una pagina wiki.
Ogni azione scrive prima il mount e poi i permessi.
Sintassi
| Marcatura | Forma | Che cosa rende | Dove funziona |
|---|---|---|---|
{{wk:adogit>…}} | connessione:progetto:repository[:ramo[:percorso]], suffisso facoltativo region=<nome> | un albero di cartelle e file | solo su una pagina sotto la radice dei progetti |
{{source>ado:…}} | connessione:progetto:repository:ramo:percorso, suffisso facoltativo #L10-L40 | il contenuto di un singolo file | su una pagina sotto la radice dei progetti oppure dentro lo spazio dei nomi del mount |
Il primo campo è la chiave della connessione, non il suo numero; viene cercata dentro il progetto DWDO a cui appartiene la pagina. Con {{wk:adogit>…}} un ramo omesso indica il ramo predefinito e un percorso omesso la radice. Con {{source>ado:…}} tutti e cinque i campi sono obbligatori.
La marcatura {{source>ado:…}} richiede wksourceview. Senza quel plugin lo schema ado non è registrato e la resa segnala che la sorgente non è disponibile. Dettagli e opzioni di resa sono in Mostrare codice sorgente su una pagina wiki.
Azioni e punti di accesso
| Indirizzo | Chi | Scopo |
|---|---|---|
do=admin&page=wkdoadogit_mounts | amministratore | i mount e i loro livelli |
do=admin&page=wkdoadogit_svn | amministratore | connessioni Subversion; nessuna organizzazione ADO necessaria |
do=admin&page=wkdoadogit | responsabile | token di accesso di tutti gli utenti |
do=wkdoadogit_tokens | ogni utente autenticato | i propri token di accesso |
do=wkdoadogit_archive&ns=…&ref=… | livello 2 o superiore | scaricare un'istantanea come archivio ZIP |
do=wkdoadogit_diag | – | tabella dei servizi risolti |
do=wkdoadogit_stepup | – | ponte per la prova del secondo fattore |
lib/plugins/wkdoadogit/git.php/<percorso-mount> | client git | proxy per clone, pull e push |
Le connessioni non si gestiscono qui, ma in wkdoado, su una pagina di progetto con l'azione do=wkdoado.
Token di accesso personali
I client git esterni si autenticano presso il proxy come utenti del wiki, usando un token personale; la password del wiki non va messa in un client git. Ogni utente autenticato gestisce i propri token all'indirizzo /doku.php?do=wkdoadogit_tokens, gli amministratori anche nel menu Token di accesso ADO-Git. Viene memorizzato solo un valore con hash; il testo in chiaro compare esattamente una volta, al momento del rilascio. Ogni token inizia con il prefisso wkg_.
Per clone serve il livello 2, per push il livello 4. Ai livelli da 4 a 7 sono ammessi solo rami sotto refs/heads/users/<login>/. La procedura è descritta in Clonare un repository montato.
Configurazione
| Chiave | Predefinito | Effetto |
|---|---|---|
mount_languages | de,en,hr,it,sl | i segmenti di lingua in cui si espande un mount che contiene il segnaposto {lang} |
Il pacchetto non ha volutamente altre impostazioni: la connessione proviene da wkdoado, i permessi da DokuWiki, i mount dall'archivio.
Note tecniche (per operatori e sviluppatori): Messa in servizio del proxy git sullo stack portabile · Da dove la registrazione dei mount prende il vocabolario dei livelli.
Approfondimenti: il file README nel repository wkdoadogit; la panoramica dei pacchetti è nella panoramica DWE.
Si basa su: wkcore (registro dei servizi) · wkdocore (progetto e ruoli) · wkdostorage (mount e token) · wkdoado (connessione ad Azure DevOps) · wksourceview (codice sorgente e cassetto) · wkfluentui (componenti e intestazione del documento).
Da non confondere con wkdogit, che serve repository locali tramite un binario git, in sola lettura.
wkcore, wkdocore, wkdostorage, wkdoado, wksourceview, wkfluentui e wkdogit esistono per ora solo in tedesco, perciò i collegamenti portano lì.
Argomenti correlati
- ADO-Git — punto di ingresso e operazioni frequenti
- Concetti — mount, livello di visibilità, secondo fattore, limiti
- Tutorial — dalla connessione al file visibile
- wkdoado (de) — la connessione su cui questo pacchetto si basa
- Clonare un repository — lo stesso endpoint dal lato utente