Configurazione dell'ambiente CLI e API

Prima di poter creare un IBM® Storage Ceph® as a Service utilizzando l'API o la CLI, è necessario configurare l'ambiente.

Prerequisiti generali

Configura il tuo account per accedere a IBM Storage Ceph as a Service. Assicurati che il tuo account sia stato aggiornato a un account a pagamento.
Assicurati di avere a portata di mano l'elenco degli endpoint locali fornito per l'implementazione.

È possibile impostare gli endpoint come variabili di ambiente.

Prerequisiti CLI

Prima di poter utilizzare la CLI, è necessario installare la IBM Cloud CLI e il plug-in IBM Storage Ceph as a Service CLI.

Assicurarsi che l'ambiente da cui verrà eseguita la CLI sia connesso alla rete on-premises prima di utilizzare la CLI sulla distribuzione on-premises di IBM Storage Ceph as a Service.

Installare l' IBM Cloud e CLI.
Installare il plug-in IBM Storage Ceph as a Service CLI software-defined-storage.
```
ibmcloud plugin install software-defined-storage
```
Le azioni CLI dell' IBM Storage Ceph as a Service, utilizzano anche gli alias sds. Per imparare a utilizzare i comandi CLI, puoi eseguire:
```
ibmcloud sds --help
ibmcloud sds volume-create --help
ibmcloud sds host-create --help
```

Accesso a CLI tramite l'endpoint API

Per impostare il CLI in modo che utilizzi l'endpoint API, procedere come segue:

Per scaricare la CLI di IBM Cloud e i plug-in associati, è necessario poter accedere al repository pubblico in cui si trovano.

Assicurarsi che il nucleo di IBM Cloud CLI e il plug-in IBM Storage Ceph as a Service siano aggiornati all'ultima versione:
```
ibmcloud update
```
```
ibmcloud plugin update software-defined-storage
```
Per specificare un endpoint API, inserire il seguente comando:
```
ibmcloud login -a https://cloud.ibm.com
```
Per ulteriori informazioni sui dettagli dell'opzione CLI, vedere ibmcloud login.

Configurazione token IAM

Prima di poter utilizzare la CLI per creare il proprio IBM Storage Ceph as a Service, è necessario ottenere un token IAM, memorizzare l'endpoint come variabile e verificare di disporre dell'accesso al servizio IBM Storage Ceph as a Service.

IAM_TOKEN=$(ibmcloud iam oauth-tokens --output json | jq -r '.iam_token)

Prerequisiti API

Prima di poter utilizzare l'API per creare il proprio IBM Storage Ceph as a Service, è necessario ottenere un token IAM, memorizzare l'endpoint come variabile e verificare di disporre dell'accesso al servizio API CephaaS.

Gli esempi seguenti utilizzano l'endpoint regionale dell' us-south.

Passo 1: Memorizza la tua chiave API come una variabile

Esegui questo comando per memorizzare la chiave API per il tuo account in una variabile di ambiente. Se non hai una chiave API, vedi Creazione di una chiave API.

apikey="<YOUR_API_KEY>"

Passo 2: ottieni un token IBM IAM (Identity and Access Management)

Esegui il seguente comando per recuperare e analizzare un token IAM utilizzando l'utilità di elaborazione JSON jq. Puoi modificare il comando per utilizzare un altro strumento di analisi oppure puoi rimuovere l'ultima parte del comando se preferisci analizzare manualmente il token.

IAM_TOKEN=`curl -k -X POST \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --header "Accept: application/json" \
  --data-urlencode "grant_type=urn:ibm:params:oauth:grant-type:apikey" \
  --data-urlencode "apikey=$apikey" \
  "https://iam.cloud.ibm.com/identity/token"  |jq -r '(.token_type + " " + .access_token)'`

Per visualizzare il token IAM, esegui il comando ` ``echo $IAM_TOKEN```. Il risultato dovrebbe essere simile a questo:

Bearer <your token>

L'intestazione dell'autorizzazione prevede che il token inizi con "Bearer". Se il risultato non include "Bearer", aggiorna la variabile IAM_TOKEN per includerlo. In questi esempi si presuppone che "Bearer" sia incluso in IAM_TOKEN.

Un token IAM ha una validità massima di 60 minuti ed è soggetto a modifiche. Quando un token scade, devi generarne un altro. Utilizza la proprietà expires_in per la scadenza del token IAM appena creato.

Passo 3: Memorizza l'endpoint API come una variabile

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}. Esegui questo comando per memorizzare l'endpoint API in una variabile in modo che possa essere riutilizzato successivamente nella tua sessione.

Ad esempio:

sds_api_endpoint="https://sds-cephaas.936481b2-379d-4ca6-94ed-4dc1911d749f.software-defined-storage.appdomain.cloud:33173"

Per verificare che questa variabile sia stata salvata, esegui il comando ``echo $sds_endpoint`` e assicurati che la risposta non sia vuota.

Passaggio 4: Verifica di disporre dell'accesso all'API

Ora che hai un endpoint e il tuo token IAM, verifica il tuo accesso API tramite una delle API descritte nel Riferimento API.

Se riscontri dei risultati imprevisti, aggiungi l'indicatore --verbose (debug) dopo il comando curl per ottenere informazioni di registrazione dettagliate.