Work in progress

Overview

Usiamo un meccanismo di CI/CD per cui:

• Esiste un git repo unico sia per la parte controller che per la parte compute con 2 branch:
  • Il branch 'main' viene usato  nella cloud di produzione (environment  'production' di puppet)
  • Il branch 'testing' viene usato nella cloud di test (environment 'testing' di puppet
• Il codice puppet che viene usato sta in cld-config. ma non si deve MAI modificare i sorgenti puppet direttamente su cld-config
• Modifiche al codice vanno implementate:
  • Per cloud di test  committando (lavorando sulla propria postazione di lavoro) committando sul branch testing. Queste vengono apoi utomaticamente "scaricate" in cld-config
  • Per cloud di produzione (quindi branch main) solo come pull request lavorando sulla propria postazione di lavoro. Una volta che sono approvate (e quindi mergiate nel branch main) queste vengono automaticamente "scaricate" in cld-config
  • In generale prima si modifica sul branch testing e poi (dopo una fase di testing) la modifica dovrebbe finire anche in main

Setup iniziale dell'ambiente sulla propria postazione di lavoro

Installazione git-crypt

Va installato git-crypt

Per i sistemi RHEL compliant esiste in EPEL (quindi 'yum install git-crypt')

Se non c'e' il pacchetto per la propria distribuzione, si puo' installare da sorgente (dipendenze: gcc-c++ e openssl-devel):

git clone https://github.com/AGWA/git-crypt.git
make
make install PREFIX=/usr/local

Download del repo git

mkdir ~/Workdir
cd ~/Workdir
git clone https://github.com/CloudPadovana/puppet_epoxy.git

Scaricare la chiave per il crypting dei file params.pp

Scarico da cld-config il file /var/puppet/KeyRepoEpoxyTesting e copiarlo ad esempio in ~/Workdir

Modifica del codice puppet per la cloud di test

Mi accerto che la copia locale del mio repo (branch testing) sia aggiornata:

$ cd ~/Workdir/puppet_epoxy/


$ git checkout testing
Switched to branch 'testing'
Your branch is up to date with 'origin/testing'.

$ git pull
Already up to date.

Se serve modificare anche un file params.pp, farne prima il decrypt (decrypt che avviene solo locamente: sul repo i file restano cryptati):

git crypt unlock ~/Workdir/KeyRepoEpoxyTesting

A questo punto faccio le modifiche sul branch testing, che poi committo e pusho:

 # fai modifiche 
git add <files modificati> 
git commit -m "Messaggio" <files modificati> git push

Modifica del codice puppet per la cloud di produzione

Se devo riportare una modifica da testing a main TBC

Se invece la modifica va fatta solo nel branch main (per la cloud di produzione), mi accerto prima di tuto che la copia locale del mio repo (branch main) sia aggiornata:

$ cd ~/Workdir/puppet_epoxy/


$ git checkout main
Switched to branch 'main'
Your branch is up to date with 'origin/main'.

$ git pull
Already up to date.

Se serve modificare anche un file params.pp, farne prima il decrypt (decrypt che avviene solo locamente: sul repo i file restano cryptati):

git crypt unlock ~/Workdir/KeyRepoEpoxyTesting

A questo punto creo un nuovo branch e qua ci faccio le modifiche che committo e pusho:

git checkout -b <nome-del-branch>
# fai modifiche
git add <files modificati>
git commit -m "Messaggio" <files modificati>
git push origin <nome-del-branch>

Creo la pull request:

Vado in: https://github.com/CloudPadovana → Pull requests

Dovrebbe appparire un bottone "Compare & Pull Request" con il nome del branch: cliccaci 

Come base specifica il branch 'main'. In compare deve esserci il nome del branch creato

Metti una breve descrizione e clicca su "Create pull request"

Sincronizzazione tra main e testing

In generale quello che e' su testing prima o poi dovrebbe finire anche su main.

La "sincronizzazione" (ove opportuna) tra main e testing va gestita "a mano" (v. sopra)

Per vedere i file che differiscono:

$ git diff --stat main..testing 
 .gitattributes                              | 3 +++
 README.md                                   | 1 -
 compute_epoxy/manifests/neutron.pp          | 1 +
 compute_epoxy/manifests/nova.pp             | 1 +
 controller_epoxy/manifests/configure_ec2.pp | 1 +
 5 files changed, 6 insertions(+), 1 deletion(-)

Per vedere le differenze in un file:

$ git diff main..testing controller_epoxy/manifests/configure_ec2.pp
diff --git a/controller_epoxy/manifests/configure_ec2.pp b/controller_epoxy/manifests/configure_ec2.pp
index abcbb1a..5bc9adf 100644
--- a/controller_epoxy/manifests/configure_ec2.pp
+++ b/controller_epoxy/manifests/configure_ec2.pp
@@ -8,6 +8,7 @@ class controller_epoxy::configure_ec2 inherits controller_epoxy::params {
 
 ##
 # FF aggiungo questa riga di test
+# e anche un'altra
 ##
 
 file { ['/var/lib/ec2-api',