Configuración de su entorno CLI y API

Antes de poder crear un « IBM® Storage Ceph® as a Service » mediante la API o la CLI, debes configurar tu entorno.

Requisitos previos generales

Configura tu cuenta para acceder a IBM Storage Ceph as a Service. Asegúrese de que su cuenta se haya actualizado a una cuenta de pago.
Asegúrese de tener a mano la lista de puntos finales locales que se proporcionaron para la implementación.

Puede establecer los puntos finales como variables de entorno.

Requisitos previos de la CLI

Antes de poder utilizar la CLI, debes instalar la CLI de « IBM Cloud » y el complemento de la CLI de « IBM Storage Ceph as a Service ».

Asegúrese de que el entorno desde el que se ejecutará la CLI está conectado a la red local antes de utilizar la CLI en la implantación local de IBM Storage Ceph as a Service.

Instale el CLI de IBM Cloud.
Instale el plug-in IBM Storage Ceph as a Service CLI software-defined-storage.
```
ibmcloud plugin install software-defined-storage
```
Las acciones CLI de IBM Storage Ceph as a Service también utilizan los alias sds. Para aprender a utilizar los mandatos de la CLI, puede ejecutar los siguientes mandatos:
```
ibmcloud sds --help
ibmcloud sds volume-create --help
ibmcloud sds host-create --help
```

Acceso a CLI a través del punto final de la API

Para configurar el CLI para que utilice el punto final de la API, siga estos pasos:

Si necesita descargar la CLI de IBM Cloud y los plug-ins asociados, debe poder acceder al repositorio público donde se encuentran.

Asegúrese de que el núcleo IBM Cloud CLI y IBM Storage Ceph as a Service plug-in están actualizados a la última versión:
```
ibmcloud update
```
```
ibmcloud plugin update software-defined-storage
```
Para especificar un punto final de API, introduzca el siguiente comando:
```
ibmcloud login -a https://cloud.ibm.com
```
Para obtener más información sobre los detalles de la opción CLI, consulte ibmcloud login.

Configurar el token IAM

Antes de poder utilizar la CLI para crear tu IBM Storage Ceph as a Service, debes obtener un token de IAM, guardar el punto final como variable y comprobar que tienes acceso al servicio IBM Storage Ceph as a Service.

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

Requisitos previos de la API

Antes de poder utilizar la API para crear tu IBM Storage Ceph as a Service, debes obtener un token de IAM, guardar el punto final como variable y comprobar que tienes acceso al servicio de la API CephaaS.

En los ejemplos siguientes se utiliza el punto final regional us-south.

Paso 1: Almacenar la clave de API como una variable

Ejecute el mandato siguiente para almacenar la clave de API correspondiente a la cuenta en una variable de entorno. Si no tiene ninguna clave de API, consulte Creación de una clave de API.

apikey="<YOUR_API_KEY>"

Paso 2: Obtener una señal de IBM Identity and Access Management (IAM)

Ejecuta el siguiente comando para obtener y analizar un token de IAM utilizando la utilidad de procesamiento de JSON jq. Puede modificar el mandato para utilizar otra herramienta de análisis, o bien puede eliminar la última parte del mandato si prefiere analizar la señal de forma manual.

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)'`

Para ver el token IAM, ejecute echo $IAM_TOKEN. El resultado se parecerá al siguiente:

Bearer <your token>

La cabecera de autorización espera que la señal empiece por "Bearer". Si el resultado no incluye "Bearer", actualice la variable IAM_TOKEN para incluirlo. En estos ejemplos se presupone que "Bearer" está incluido en IAM_TOKEN.

Una señal IAM es válida hasta 60 minutos y está sujeta a cambios. Cuando una señal caduca, debe generar una nueva. Utiliza la propiedad «expires_in» para establecer la fecha de caducidad del token de IAM que acabas de crear.

Paso 3: Almacenar el punto final de la API como una variable

$sds_endpoint es una variable de entorno que apunta al punto final que se le proporcionó cuando se configuró IBM Storage Ceph as a Service. Está en el formulario de " URL ". Por ejemplo, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}. Ejecute el siguiente mandato para almacenar el punto final de la API en una variable para poderla reutilizar en la sesión.

Por ejemplo:

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

Para verificar que esta variable se ha guardado, ejecute echo $sds_endpoint y asegúrese de que la respuesta no esté vacía.

Paso 4: Comprueba que tienes acceso a la API

Ahora que tiene un punto final y su token IAM, verifique su acceso a la API a través de una de las API descritas en la Referencia de API.

Si recibe resultados inesperados, añada el distintivo --verbose (depuración) después del mandato curl para obtener información de registro detallada.