Organizzazione 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
Developers ha permessi di lettura/scrittura sui repository esistenti.
Deploy ha i permessi di lettura sui repository. A questo team appartengono tutti i server.

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);
NON contiene dati sensibili (chiavi e password);
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 )
Tutte le funzionalita', i moduli puppet, sono sottomoduli (git submodule) del progetto e obbligatoriamente ospitati su un nostro repository.
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, https://git.puppet.immerda.ch/module-apt/ e' il modulo di quelli di immerda;
Quando nel progetto principale viene eseguito un git submodule add questo DEVE puntare ad un url ospitata dal nostro repository.

Creare l'utente dalla pagina di registrazione. L'indirizzo email deve essere valido per procedere all'attivazione dell'utente;
Aggiungere l'utente al team "Developer" dell'organizzazione opuppet.

Creare un indirizzo email da associare all'utente. Per esempio, su indivia, php vmail.php -na <hostname>@ortiche.net gestione@posta.indivia.net ;
Se non esiste gia', generare sul server una nuova coppia di chiavi ssh per l'utente root (ssh-keygen -b 4096 -t rsa). Se i filename delle chiavi non vengono modificati allora e' sufficiente questo passo, altrimenti sara' necessario aggiungere le entry corrispondenti in /root/.ssh/config ;
Creare l'utente dalla pagina di registrazione. L'indirizzo email deve essere valido per procedere all'attivazione dell'utente;
Associare la chiave ssh generata, all'utente su gogs;
Aggiungere l'utente al team "Deploy" dell'organizzazione opuppet.
Testare eseguendo git clone --recursive gogs@lattuga.net:opuppet/puppet-deploy.git sul server

Da root apt-get install puppet git
Eliminare i file esistenti per puppet: rm -rf /etc/puppet
Aggiungere l'utente specifico del server sulla piattaforma Gogs (vedi piu' in alto)
Clonare il repository puppet-deploy al punto della configurazione di puppet: cd /etc && git clone --recursive gogs@lattuga.net:opuppet/puppet-deploy.git

module naming convention Dalla documentazione di puppet: 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 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

Puppet-deploy