ADO-Git
ADO-Git mostra i repository git di Azure DevOps direttamente nel wiki: consultazione dell'albero, resa del codice sorgente, modifica e commit di un file, e i comandi clone, pull e push attraverso un proxy. Il pacchetto è pensato per i lettori, che devono vedere il codice senza una licenza ADO propria, per gli autori, che mostrano un repository su una pagina wiki, e per gli operatori, che collegano i repository e ne stabiliscono la visibilità.
Primi passi
Creare la connessione → Montare il repository → Stabilire la visibilità → Mostrare il repository su una pagina
{{wk:adogit>…}} su una pagina. È il motivo più frequente dell'impressione che un mount non funzioni.
Attività frequenti
| Che cosa volete | Per chi | Dove si fa | Istruzioni |
|---|---|---|---|
| impostare una connessione ad Azure DevOps | operatori | do=wkdoado su una pagina di progetto | Guida: connessione |
| montare un repository | operatori | Amministrazione > Mount dei repository ADO-Git | Guida: mount |
stabilire la visibilità (private, readonly, public o team) | operatori | la stessa schermata, scelta del livello | Guida: livello di visibilità |
| mostrare un repository su una pagina | autori | pagina wiki nel progetto, marcatura {{wk:adogit>…}} | Guida: la pagina con il browser |
| aprire un repository senza una pagina propria | lettori | %do=wkdoadogit_repo&ns=<spazio dei nomi del mount>% | Riferimento: schermata del repository (tedesco) |
| aprire una cartella o un file | lettori | l'albero sulla pagina | Guida: cartella e file |
| mostrare codice sorgente su una pagina | autori | marcatura {{source>ado:…}} | Come: mostrare il codice sorgente |
| modificare un file ed eseguire il commit | redattori | il pulsante accanto al file nell'albero | Come: modificare un file |
usare clone, pull e push in locale | sviluppatori | l'indirizzo del proxy git | Come: clonare un repository |
| rilasciare un token git personale | sviluppatori | do=wkdoadogit_tokens | Come clonare: token personale |
| scaricare un'istantanea come archivio ZIP | lettori dal livello 2 | il browser dei repository | Guida: cartella e file |
| individuare la causa di un errore | tutti | – | Diagnostica |
Il flusso in breve
Il percorso di un repository da Azure DevOps fino a un file visibile nel wiki:
| Passo | Dove | Che cosa accade |
|---|---|---|
| 1 | do=wkdoado su una pagina di progetto | Nasce la connessione: chiave, indirizzo del server e riferimento al segreto. Senza di essa non si può leggere nulla |
| 2 | Amministrazione > Mount dei repository ADO-Git | Nasce il mount: il repository viene legato a uno spazio dei nomi del wiki |
| 3 | la stessa schermata, scelta del livello | Il livello di visibilità scrive automaticamente i permessi di quello spazio dei nomi |
| 4 | una pagina wiki interna al progetto | Un autore inserisce la marcatura {{wk:adogit>…}}. Solo questa pagina mostra il repository |
| 5 | l'albero su quella pagina | Un lettore apre una cartella e un file; il file compare nel cassetto del codice sorgente |
| 6 | do=wkdoadogit_tokens | Chi vuole usare git clone fuori dal wiki si rilascia un token personale |
Funzioni principali
- Browser dei repository su una pagina wiki. La marcatura
{{wk:adogit>connessione:progetto:repository}}disegna l'intestazione con il livello di visibilità e l'albero delle cartelle; le sottocartelle si caricano solo all'apertura. - Resa di un singolo file. La marcatura
{{source>ado:…}}mostra un file, se si desidera solo un intervallo di righe. - Modifica e commit di un singolo file. Il commit si applica alla revisione che l'autore ha visto; in caso contrario il server lo rifiuta.
- Creazione di un ramo o di un tag direttamente dal browser, per gli utenti con permesso di scrittura.
- Proxy git per
clone,pullepushcon un client ordinario. L'autenticazione avviene con un token personale, non con la password del wiki. - Download di un'istantanea come archivio ZIP dal browser dei repository.
- Un unico comando per la visibilità: il livello del mount, che scrive automaticamente i permessi.
Concetti chiave
Una connessione descrive il server ADO e appartiene a un progetto DWDO; un mount lega un repository di quella connessione a uno spazio dei nomi del wiki e porta un livello di visibilità, che ne scrive i permessi. Una connessione porta un numero qualsiasi di mount.
Lo spazio dei nomi del mount è virtuale: non contiene alcuna pagina, e ogni accesso — il browser, la resa dei file, il proxy git e il download dell'archivio — chiede i permessi di quello spazio dei nomi, non quelli della pagina su cui si trova il lettore. Su Azure DevOps si autentica sempre un solo account di servizio; chi può fare che cosa lo decidono perciò esclusivamente i permessi di DokuWiki.
Per esteso, con la tabella dei livelli e il doppio significato di un livello: Riferimento tecnico, sezione «Livello di visibilità e ACL di DokuWiki».
Amministrazione
- Amministrazione > Mount dei repository ADO-Git (
do=admin&page=wkdoadogit_mounts) — collegare repository, cambiare spazio dei nomi e livello - Amministrazione > Token di accesso ADO-Git — consultare e revocare i token rilasciati
- Amministrazione > Connessioni Subversion di ADO-Git — endpoint Subversion della stessa connessione
- Impostazioni del pacchetto — valori, valori predefiniti e loro effetto
Diagnostica
Per sviluppatori
- Riferimento tecnico — gestione dei mount, marcatura, azioni, token, impostazioni
- Concetti — mount, livello di visibilità, secondo fattore, limiti
- wkdoado — la connessione ADO irrobustita su cui questo pacchetto si appoggia
- wksourceview — la resa del codice sorgente che questo pacchetto alimenta
- wkcore — il registro attraverso cui entrambi i servizi vengono trovati
Argomenti correlati
- Mostrare per la prima volta un repository ADO nel wiki — mostrare per la prima volta un repository nel wiki, dalla connessione al file
- Come mostrare codice sorgente su una pagina wiki — mostrare codice sorgente su una pagina wiki
- Come modificare un file ed eseguire il commit dal wiki — modificare un file ed eseguire il commit dal wiki
- Diagnostica — sintomo, causa e rimedio