diff --git a/README.md b/README.md index 0e65a74..0170ac8 100644 --- a/README.md +++ b/README.md @@ -36,8 +36,8 @@ Ovvero della centralizzazione, automazione delle configurazioni per indivia/orti #### Architettura ##### Gogs - - ###### Organizzazione [opuppet](http://git.lattuga.net/org/opuppet) - A questa fanno riferimento tutti i repository. I permessi sui repository di un'organizzazione non vengono definiti per utente, bensi' per team. + - **Organizzazione [opuppet](http://git.lattuga.net/org/opuppet)** : + a questa fanno riferimento tutti i repository. I permessi sui repository di un'organizzazione non vengono definiti per utente, bensi' per team. In opuppet ne sono definiti tre: - *Owners* possono creare nuovi repository e chiaramente leggere e scrivere. Di questa fanno parte tutti gli sviluppatori @@ -46,7 +46,7 @@ Ovvero della centralizzazione, automazione delle configurazioni per indivia/orti ##### Progetti Git - - ###### [puppet-deploy](http://git.lattuga.net/opuppet/puppet-deploy) + - **[puppet-deploy](http://git.lattuga.net/opuppet/puppet-deploy)** - E' il progetto principale in cui viene mantenuta tutta la configurazione di puppet; - Ogni sviluppatore ha un account read-write sul repository centrale di questo progetto; - Una copia del repository e' distribuita su ogni server, con account read-only, nella directory `/etc/puppet` (su Debian); @@ -54,10 +54,10 @@ Ovvero della centralizzazione, automazione delle configurazioni per indivia/orti - **NON** contiene tabelle utenti; - Il file `manifests/site.pp` contiene tutte le associazioni server/servizio e quindi le dichiarazioni delle classi (**PER ORA**: bisogna valutare se implemntare un semplice [External Node Classifier](https://docs.puppetlabs.com/guides/external_nodes.html) ) - - Tutte le funzionalita', i [moduli puppet](https://docs.puppetlabs.com/puppet/latest/reference/modules_fundamentals.html), sono - `git submodule` del progetto **obbligatoriamente** ospitati su un nostro repository. + - Tutte le funzionalita', i [moduli puppet](https://docs.puppetlabs.com/puppet/latest/reference/modules_fundamentals.html), sono sottomoduli + (`git submodule`) del progetto e **obbligatoriamente** ospitati su un nostro repository. - - ###### module-$name + - **module-$name** - Ogni modulo ha un suo repository con la convenzione `http://git.lattuga.net/opuppet/module-$name`; - Quando possibile il clone iniziale avviene da gli shared puppet module di riseup **NON** dai 'moduli personali' ne' di riseup, ne' dei collettivi (Esempio: `https://labs.riseup.net/git/shared-apt.git` e' il modulo **shared** mentre `https://labs.riseup.net/git/module-apt.git` e' il modulo privato di riseup, @@ -68,20 +68,17 @@ Ovvero della centralizzazione, automazione delle configurazioni per indivia/orti #### Workflow - - ##### Aggiungere uno sviluppatore a opuppet su Gogs - - ##### Aggiungere un server a opuppet su Gogs - - ##### Installare un nuovo server e configurare Git/puppet - - ##### Aggiungere la configurazione di un nuovo server in puppet-deploy - - ##### Aggiungere un submodule a puppet-deploy + - Aggiungere uno sviluppatore a opuppet su Gogs + - Aggiungere un server a opuppet su Gogs + - Installare un nuovo server e configurare Git/puppet + - Aggiungere la configurazione di un nuovo server in puppet-deploy + - Aggiungere un submodule a puppet-deploy #### Appunti - - ##### module naming convention + - **module naming convention** : Dalla [documentazione di puppet](https://docs.puppetlabs.com/puppet/latest/reference/modules_fundamentals.html#manifests): *`init.pp` is special and always contains a class with the same name as the module. You may not have a class named init.* - - ##### riseup clone workaround + - **riseup clone workaround** : Invece di eseguire `git clone https://labs.riseup.net/git/shared-$name.git` e' necessario modificare l'url in modo che diventi `git clone https://labs.riseup.net/code/shared-$name.git` - - -