La configurazione di Ceph Object Gateway richiede l'esecuzione del cluster di storage Ceph. Ceph Object Gateway è un client del cluster di storage Ceph. Come client del cluster di storage Ceph, richiede:

Ogni istanza deve avere un nome utente e una chiave per comunicare con un cluster di storage Ceph. Nei passaggi seguenti, si utilizza un nodo monitor per creare un portachiavi di bootstrap, quindi si crea il portachiavi utente dell'istanza di Object Gateway sul bootstrap uno. Quindi, si crea una chiave e un nome utente del client. Si aggiunge in seguito la chiave al cluster di storage Ceph. Infine, si distribuisce il portachiavi al nodo contenente l'istanza del gateway.

Suggerimento: utilizzare il portachiavi bootstrap

Un modo alternativo è creare il portachiavi bootstrap di Object Gateway, quindi creare da qui il portachiavi Object Gateway:

1. Creare un portachiavi bootstrap di Object Gateway su uno dei seguenti nodi monitor:

   cephadm > sudo ceph \
    auth get-or-create client.bootstrap-rgw mon 'allow profile bootstrap-rgw' \
    --connect-timeout=25 \
    --cluster=ceph \
    --name mon. \
    --keyring=/var/lib/ceph/mon/ceph-node_host/keyring \
    -o /var/lib/ceph/bootstrap-rgw/keyring

2. Creare la directory /var/lib/ceph/radosgw/ceph-rgw_name per memorizzare il portachiavi bootstrap:

   cephadm > sudo mkdir \
   /var/lib/ceph/radosgw/ceph-rgw_name

3. Creare un portachiavi Object Gateway dal portachiavi bootstrap appena creato:

   cephadm > sudo ceph \
    auth get-or-create client.rgw.rgw_name osd 'allow rwx' mon 'allow rw' \
    --connect-timeout=25 \
    --cluster=ceph \
    --name client.bootstrap-rgw \
    --keyring=/var/lib/ceph/bootstrap-rgw/keyring \
    -o /var/lib/ceph/radosgw/ceph-rgw_name/keyring

4. Copiare il portachiavi Object Gateway sull'host Object Gateway:

   cephadm > sudo scp \
   /var/lib/ceph/radosgw/ceph-rgw_name/keyring \
   rgw_host:/var/lib/ceph/radosgw/ceph-rgw_name/keyring

I Ceph Object Gateway richiedono pool del cluster di storage Ceph per memorizzare dati del gateway specifici. Se l'utente creato dispone delle corrette autorizzazioni, il gateway crea automaticamente i pool. Tuttavia, accertare di aver impostato un numero appropriato di default di gruppi di posizionamento per pool nel file di configurazione Ceph.

I nomi dei pool seguono il ZONE_NAME.Sintassi di POOL_NAME. Quando si configura un gateway con zona e regione di default, il nome zona di default è "default" come nell'esempio:

.rgw.root
default.rgw.control
default.rgw.meta
default.rgw.log
default.rgw.buckets.index
default.rgw.buckets.data

Per creare manualmente i pool, vedere Sezione 7.2.2, «Creazione di un pool».

Importante: pool Object Gateway ed Erasure Coded

Solo il default.rgw.buckets.data può essere Erasure Coded. Tutti gli altri pool devono essere replicati, in caso contrario il gateway non è accessibile.

Aggiungere la configurazione di Ceph Object Gateway al file di configurazione Ceph. La configurazione di Ceph Object Gateway richiede di identificare l'istanza di Ceph Object Gateway. Specificare, quindi, il nome host dove è stato installato il daemon Ceph Object Gateway, un portachiavi (da utilizzare con cephx) ed eventualmente un file di registro. Ad esempio:

[client.rgw.instance-name]
host = hostname
keyring = /etc/ceph/ceph.client.rgw.keyring

Suggerimento: file di registro di Object Gateway

Per ignorare il file di registro di default di Object Gateway, includere quanto segue:

log file = /var/log/radosgw/client.rgw.instance-name.log

La parte [client.rgw.*] dell'istanza del gateway identifica questa parte del file di configurazione Ceph come configurando un client del cluster di storage Ceph dove il tipo di client è un Ceph Object Gateway (radosgw). Segue il nome dell'istanza. Ad esempio:

[client.rgw.gateway]
host = ceph-gateway
keyring = /etc/ceph/ceph.client.rgw.keyring

Nota

L'host deve essere il nome host del computer, escluso il nome di dominio.

Disattivare quindi print continue. Se è stato impostato su true, potrebbero riscontrarsi problemi con le operazioni PUT:

rgw print continue = false

Per utilizzare un Ceph Object Gateway con chiamate di sottodominio S3 (ad esempio http://bucketname.hostname), occorre aggiungere il nome DNS del Ceph Object Gateway nella sezione [client.rgw.gateway] del file di configurazione Ceph:

[client.rgw.gateway]
...
rgw dns name = hostname

Considerare anche di installare un server DNS come Dnsmasq sul computer client quando si utilizza http://bucketname.Sintassi di hostname. Il file dnsmasq.conf deve includere le impostazioni seguenti:

address=/hostname/host-ip-address
listen-address=client-loopback-ip

Aggiungere quindi l'indirizzo IP client-loopback-ip come il primo server DNS sul(i) computer client.

Gli script di distribuzione potrebbero non creare la directory dati di default di Ceph Object Gateway. Se non è già stato fatto, creare directory dati per ogni istanza di un daemon radosgw. Le variabili host nel file di configurazione Ceph determinano quale host esegue ciascuna istanza di un daemon radosgw. La forma tipica specifica il daemon radosgw, il nome del cluster e l'ID del daemon.

cephadm > sudo mkdir -p /var/lib/ceph/radosgw/cluster-id

Utilizzando le impostazioni ceph.conf dell'esempio precedente, eseguire:

cephadm > sudo mkdir -p /var/lib/ceph/radosgw/ceph-radosgw.gateway

Per accertare che tutti i componenti abbiano ricaricato le proprie configurazioni, si consiglia di riavviare il servizio del cluster di storage Ceph. Avviare quindi il servizio radosgw. Per ulteriori informazioni, vedere Capitolo 2, Introduzione e Sezione 11.3, «Funzionamento del servizio Object Gateway».

Quando il servizio è attivo e in esecuzione, è possibile effettuare una richiesta anonima GET per vedere se il gateway restituisce una risposta. Una semplice richiesta HTTP al nome di dominio dovrebbe restituire:

<ListAllMyBucketsResult>
      <Owner>
              <ID>anonymous</ID>
              <DisplayName/>
      </Owner>
      <Buckets/>
</ListAllMyBucketsResult>