Saltar al contenutoSaltar alla navigazione delle pagine: pagina precedente [chiave d’accesso p]/pagina successiva [chiave d’accesso n]
documentation.suse.com › Documentazione di SUSE Enterprise Storage 5 › Guida alla distribuzione › Distribuzione e upgrade del cluster › Personalizzazione della configurazione di default
ContenutoContenuto
Guida alla distribuzione
  1. Informazioni sulla Guida
  2. I SUSE Enterprise Storage
    1. 1 SUSE Enterprise Storage e Ceph
    2. 2 Requisiti hardware e raccomandazioni
    3. 3 Configurazione nodo admin Ceph HA
  3. II Distribuzione e upgrade del cluster
    1. 4 Installazione con DeepSea/Salt
    2. 5 Upgrade dalle release precedenti
    3. 6 Backup della configurazione del cluster
    4. 7 Personalizzazione della configurazione di default
  4. III Installazione di servizi aggiuntivi
    1. 8 Installazione di servizi per l'accesso ai dati
    2. 9 Ceph Object Gateway
    3. 10 Installazione di iSCSI Gateway
    4. 11 Installazione di CephFS
    5. 12 Installazione di NFS Ganesha
    6. 13 Esportazione di CephFS tramite Samba
  5. A Aggiornamenti della documentazione
Navigazione←→
documentation.suse.com › Documentazione di SUSE Enterprise Storage 5 › Guida alla distribuzione › Distribuzione e upgrade del cluster › Personalizzazione della configurazione di default
Su
←→
Si applica a SUSE Enterprise Storage 5

7 Personalizzazione della configurazione di default

7.1 Uso dei file di configurazione personalizzati
7.2 Modifica della configurazione rilevata

È possibile modificare la configurazione di default del cluster generata nella Fase 2 (consultare Descrizione delle fasi di DeepSea). Ad esempio, può essere necessario modificare le impostazioni di rete o il software installato sul Salt master installato di default. È possibile eseguire la prima operazione modificando il Pillar aggiornato dopo la Fase 2, mentre la seconda viene ottenuta creando un file sls personalizzato e aggiungendolo al Pillar. I dettagli sono descritti nelle sezioni seguenti.

7.1 Uso dei file di configurazione personalizzati

In questa sezione vengono elencati diversi task che richiedono aggiunta/modifica dei propri file sls. Tale procedura viene utilizzata in genere quando occorre modificare il processo di distribuzione di default.

Suggerimento
Suggerimento: Aggiungere un prefisso ai file personalizzati .sls

I file .sls personalizzati appartengono alla stessa sottodirectory dei file .sls di DeepSea. Per evitare di sovrascrivere i file .sls con quelli nuovi aggiunti dal pacchetto DeepSea, apporre un prefisso al nome con la stringa custom-.

7.1.1 Disabilitazione di una fase di installazione

Se si indirizza un task specifico esterno al processo di installazione di DeepSea ed è quindi necessario ignorarlo, creare un file "no-operation" seguendo questo esempio:

Procedura 7.1: Disabilitazione della sincronizzazione dell'orario

  1. Creare /srv/salt/ceph/time/disabled.sls con il seguente contenuto e salvarlo: 

    disable time setting:
test.nop

  2. Modificare /srv/pillar/ceph/stack/global.yml, aggiungere la riga seguente e salvarlo: 

    time_init: disabled

  3. Verificare aggiornando il Pillar ed eseguendo la fase: 

    root@master # salt target saltutil.pillar_refresh
root@master # salt 'admin.ceph' state.apply ceph.time
admin.ceph:
  Name: disable time setting - Function: test.nop - Result: Clean

Summary for admin.ceph
------------
Succeeded: 1
Failed:    0
------------
Total states run:     1
    Nota
    Nota: ID univoco

    L'ID del task "disable time setting" può essere qualsiasi messaggio univoco in un file sls. Impedire le collisioni ID specificando descrizioni univoche.

7.1.2 Sostituzione di una fase di installazione

Se occorre sostituire il comportamento di default di una fase specifica con uno personalizzato, creare un file sls personalizzato con contenuto sostitutivo.

Per default, /srv/salt/ceph/pool/default.sls crea un'immagine rbd denominata "demo". Nel nostro esempio, non si desidera creare tale immagine, ma sono richieste due immagini: "archive1" e "archive2".

Procedura 7.2: Sostituendo l'immagine rbd demo con due immagini rbd personalizzate

  1. Creare /srv/salt/ceph/pool/custom.sls con il seguente contenuto e salvarlo: 

    wait:
  module.run:
    - name: wait.out
    - kwargs:
        'status': "HEALTH_ERR"1
    - fire_event: True

archive1:
  cmd.run:
    - name: "rbd -p rbd create archive1 --size=1024"2
    - unless: "rbd -p rbd ls | grep -q archive1$"
    - fire_event: True

archive2:
  cmd.run:
    - name: "rbd -p rbd create archive2 --size=768"
    - unless: "rbd -p rbd ls | grep -q archive2$"
    - fire_event: True

    1

    Il modulo wait va in pausa finché il cluster Ceph non ha lo stato HEALTH_ERR. Nelle nuove installazioni, un cluster Ceph può avere questo stato finché si rende disponibile un numero sufficiente di OSD e viene completata la creazione dei pool.

    2

    Il comando rbd non è idempotente. Se si riesegue lo stesso comando di creazione quando esiste l'immagine, lo stato Salt va in errore. La dichiarazione unless lo impedisce.

  2. Per richiamare il nuovo file personalizzato creato invece di quello di default, occorre modificare /srv/pillar/ceph/stack/ceph/cluster.yml, aggiungere la riga seguente e salvarlo: 

    pool_init: custom

  3. Verificare aggiornando il Pillar ed eseguendo la fase: 

    root@master # salt target saltutil.pillar_refresh
root@master # salt 'admin.ceph' state.apply ceph.pool
Nota
Nota: autorizzazione

La creazione di pool o immagini richiede autorizzazioni sufficienti. Il minion admin.ceph ha un portachiavi admin.

Suggerimento
Suggerimento: Modo alternativo

Un'altra opzione è invece modificare la variabile in /srv/pillar/ceph/stack/ceph/roles/master.yml. Con questo file si riduce l'ingombro dei dati del Pillar per altri minion.

7.1.3 Modifica di una fase di installazione

A volte può essere necessaria una fase specifica per eseguire task aggiuntivi. Si sconsiglia di modificare il file di stato correlato, in quanto potrebbe complicare un futuro upgrade. Creare invece un file separato per eseguire i task aggiuntivi identico a quello descritto in Sezione 7.1.2, «Sostituzione di una fase di installazione».

Assegnare al nuovo file sls un nome descrittivo. Ad esempio, se occorre creare due immagini rbd oltre all'immagine demo, assegnare al file il nome archive.sls.

Procedura 7.3: Creazione di due ulteriori immagini rbd

  1. Creare /srv/salt/ceph/pool/custom.sls con il seguente contenuto e salvarlo: 

    include:
 - .archive
 - .default
    Suggerimento
    Suggerimento: includere la precedenza

    In questo esempio, Salt crea le immagini archive quindi l'immagine demo. In questo esempio, l'ordine è ininfluente. Per cambiare l'ordine, invertire le righe dopo la direttiva include:.

    È possibile aggiungere la riga include direttamente ad archive.sls e verranno così create anche tutte le immagini. Tuttavia, a prescindere dalla posizione della riga include, Salt elabora prima le fasi nel file incluso. Sebbene sia possibile ignorare questo comportamento con dichiarazioni requires e order, un file separato comprendente le altre garantisce l'ordine e riduce le possibilità di confusione.

  2. Modificare /srv/pillar/ceph/stack/ceph/cluster.yml, aggiungere la riga seguente e salvarlo: 

    pool_init: custom

  3. Verificare aggiornando il Pillar ed eseguendo la fase: 

    root@master # salt target saltutil.pillar_refresh
root@master # salt 'admin.ceph' state.apply ceph.pool

7.1.4 Modifica di una fase di installazione

Se occorre aggiungere una fase di installazione completamente separata, creare tre nuovi file, un file sls che esegue il comando, un file di orchestrazione e un file personalizzato che allinea la nuova fase alle fasi di distribuzione originali.

Ad esempio, se occorre eseguire logrotate su tutti i minion nell'ambito della fase di preparazione:

Creare prima un file sls e includere il comando logrotate.

Procedura 7.4: Esecuzione di logrotate su tutti i Salt minion

  1. Creare una directory come /srv/salt/ceph/logrotate.

  2. Creare /srv/salt/ceph/logrotate/init.sls con il seguente contenuto e salvarlo: 

    rotate logs:
  cmd.run:
    - name: "/usr/sbin/logrotate /etc/logrotate.conf"

  3. Verificare che il comando funzioni su un minion: 

    root@master # salt 'admin.ceph' state.apply ceph.logrotate

Poiché il file di orchestrazione deve essere eseguito prima di tutte le fasi di preparazione, aggiungerlo alla fase 0 Prep:

  1. Creare /srv/salt/ceph/stage/prep/logrotate.sls con il seguente contenuto e salvarlo: 

    logrotate:
  salt.state:
    - tgt: '*'
    - sls: ceph.logrotate

  2. Verificare che il file di orchestrazione funzioni: 

    root@master # salt-run state.orch ceph.stage.prep.logrotate

L'ultimo file è quello personalizzato che comprende la fase aggiuntiva con le fasi originali:

  1. Creare /srv/salt/ceph/stage/prep/custom.sls con il seguente contenuto e salvarlo: 

    include:
  - .logrotate
  - .master
  - .minion

  2. Ignorare il comportamento di default. Modificare /srv/pillar/ceph/stack/global.yml, aggiungere la riga seguente e salvare il file: 

    stage_prep: custom

  3. Verificare che la Fase 0 sia funzionale: 

    root@master # salt-run state.orch ceph.stage.0
Nota
Nota: perché global.yml?

Il file global.yml viene scelto rispetto a cluster.yml perché durante la fase prep, nessun minion appartiene al cluster Ceph e non ha accesso ad alcuna impostazione in cluster.yml.

7.1.5 Disabilitazione di aggiornamenti e riavvii durante la Fase 0

Durante la Fase 0 (consultare Descrizione delle fasi di DeepSea per ulteriori informazioni sulle fasi di DeepSea). Il Salt master e i Salt minion possono riavviarsi a causa dei nuovi pacchetti aggiornati, ad esempio il kernel, richiede il riavvio del sistema.

Per impedire l'aggiornamento o il riavvio dei nodi del cluster durante la Fase 0, modificare /srv/pillar/ceph/stack/ceph/cluster.yml e aggiungere le opzioni stage_prep_master o stage_prep_minion, se occorre modificare il comportamento del Salt master, di tutti i Salt minion o di tutti i nodi.

Entrambe le opzioni accettano i valori seguenti:

default-no-update-no-reboot

Impedisce ai nodi di aggiornare i pacchetti e il riavvio.

default-no-update-reboot

Impedisce ai nodi di aggiornare i pacchetti, ma i riavvii sono consentiti.

default-update-no-reboot

Impedisce ai nodi di riavviarsi, ma consente l'aggiornamento dei pacchetti.

default

Consente l'aggiornamento dei pacchetti dei nodi e anche il loro riavvio.

7.2 Modifica della configurazione rilevata

Dopo aver completato la Fase 2, è possibile modificare la configurazione rilevata. Per visualizzare le impostazioni correnti, eseguire: 

root@master # salt target pillar.items

Il risultato della configurazione di default per un singolo minion è di solito simile a: 

----------
    available_roles:
        - admin
        - mon
        - storage
        - mds
        - igw
        - rgw
        - client-cephfs
        - client-radosgw
        - client-iscsi
        - mds-nfs
        - rgw-nfs
        - master
    cluster:
        ceph
    cluster_network:
        172.16.22.0/24
    fsid:
        e08ec63c-8268-3f04-bcdb-614921e94342
    master_minion:
        admin.ceph
    mon_host:
        - 172.16.21.13
        - 172.16.21.11
        - 172.16.21.12
    mon_initial_members:
        - mon3
        - mon1
        - mon2
    public_address:
        172.16.21.11
    public_network:
        172.16.21.0/24
    roles:
        - admin
        - mon
        - mds
    time_server:
        admin.ceph
    time_service:
        ntp

Le impostazioni menzionate sopra sono distribuite tra più file di configurazione. La struttura di directory con questi file è definita nella directory /srv/pillar/ceph/stack/stack.cfg. I file seguenti di solito descrivono il cluster:

  • /srv/pillar/ceph/stack/global.yml - il file influisce su tutti i minion nel cluster Salt.

  • /srv/pillar/ceph/stack/ceph/cluster.yml - il file influisce su tutti i minion nel cluster Ceph denominato ceph.

  • /srv/pillar/ceph/stack/ceph/roles/role.yml - influisce su tutti i minion assegnati al ruolo specifico nel cluster ceph.

  • /srv/pillar/ceph/stack/cephminions/minion ID/yml - influisce sul singolo minion.

Nota
Nota: sovrascrittura delle directory con i valori di default

Esiste una struttura di directory parallela che memorizza l'impostazione della configurazione di default in /srv/pillar/ceph/stack/default. Non modificare qui questi valori, in quanto vengono sovrascritti.

La procedura tipica per modificare la configurazione raccolta è la seguente:

  1. Individuare l'ubicazione della voce di configurazione che occorre modificare. Ad esempio, se occorre modificare un'impostazione relativa al cluster come la rete cluster, modificare il file /srv/pillar/ceph/stack/ceph/cluster.yml.

  2. Salvare il file.

  3. Verificare le modifiche eseguendo: 

    root@master # salt target saltutil.pillar_refresh

    quindi 

    root@master # salt target pillar.items
→Parte III Installazione di servizi aggiuntivi←Capitolo 6 Backup della configurazione del cluster
Stampa pagina

© 2022 SUSE