Operador de NetApp Trident

Configurar el almacenamient NetApp Trident e para los clústeres de IBM Cloud Satellite®. Puede utilizar plantillas de almacenamiento de Satellite para crear configuraciones de almacenamiento. Cuando asigne una configuración de almacenamiento a los clústeres, los controladores de almacenamiento del proveedor de almacenamiento seleccionado se instalan en el clúster.

Debe desplegar la plantilla de Trident de NetApp en los clústeres para poder crear configuraciones con las plantillas de NetApp ONTAP-NAS o NetApp ONTAP-SAN.

Antes de poder implementar plantillas de almacenamiento en los clústeres de tu ubicación, asegúrate de configurar « Satellite Config» seleccionando la opción «Habilitar acceso de administrador de clúster para Satellite Config» en la consola o incluyendo la opción « --enable-config-admin » al crear tu clúster.

No es posible limitar el ámbito de un servicio de almacenamient Satellite e a grupos de recursos. Sin embargo, si estás asignando otros recursos —como la ubicación y el clúster— a grupos de recursos, debes añadir un rol de « Satellite » (lector) y otro de «administrador de enlaces» para todos los recursos de la cuenta.

Requisitos previos para NetApp Trident

  1. Cree una ubicación de Satellite.

Creación y asignación de una configuración en la consola

  1. En la consola Ubicaciones, selecciona la ubicación en la que deseas crear una configuración de almacenamiento.
  2. Seleccione Almacenamiento > Crear configuración de almacenamiento
  3. Especifique un nombre para la configuración.
  4. Selecciona el tipo de almacenamiento.
  5. Selecciona la versión y haz clic en Siguiente
  6. Si el Tipo de almacenamiento que ha seleccionado acepta parámetros personalizados, especifíquelos en la pestaña Parámetros.
  7. Si el Tipo de almacenamiento que ha seleccionado requiere secretos, especifíquelos en la pestaña Secretos.
  8. En la pestaña Clases de almacenamiento, revise las clases de almacenamiento desplegadas por la configuración o cree una clase de almacenamiento personalizada.
  9. En la pestaña Asignar al servicio, seleccione el servicio al que desea asignar la configuración.
  10. Pulse Completo para asignar la configuración de almacenamiento.

Creación de una configuración en la CLI

  1. Inicie una sesión en la CLI de IBM Cloud.

    ibmcloud login

  2. Liste las ubicaciones de Satellite y apunte la columna Managed from.

    ibmcloud sat location ls

  3. Ponga como destino la región Managed from de la ubicación de Satellite. Por ejemplo, para wdc, ponga como destino us-east. Puede obtener información adicional consultando regiones de Satellite.

    ibmcloud target -r us-east

  4. Si utiliza un grupo de recursos distinto del default (predeterminado), póngalo como destino.

    ibmcloud target -g RESOURCE_GROUP

  5. Copie uno de los siguientes mandatos de ejemplo para la versión de plantilla que desea utilizar. Para obtener más información sobre el mandato, consulte ibmcloud sat storage config create en la referencia de mandatos.

    Mandato de ejemplo para crear una configuración de la versión 24.02.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-trident --template-version 24.02

    Ejemplo de comando para crear una configuración de versión 25.06.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-trident --template-version 25.06

  6. Personalice el mandato en función de los valores que desee utilizar.

  7. Ejecuta el comando para crear una configuración.

  8. Comprueba que se haya creado tu configuración.

    ibmcloud sat storage config get --config CONFIG

Creación de una configuración en la API

  1. Genere una clave de API y, a continuación, solicite una señal de renovación. Para obtener más información, consulte Generación de una señal de IAM de IBM Cloud utilizando una clave de API.

  2. Copie una de las siguientes solicitudes de ejemplo y sustituya las variables que desea utilizar.

    Solicitud de ejemplo para crear una configuración de la versión 24.02.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"netapp-trident\", \"storage-template-version\": \"24.02\", \"update-assignments\": true}

    Ejemplo de solicitud para crear una configuración de versión 25.06.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"netapp-trident\", \"storage-template-version\": \"25.06\", \"update-assignments\": true}

Creación de una tarea en la CLI

  1. Enumera tus configuraciones de almacenamiento y toma nota de la configuración de almacenamiento que deseas asignar a tus clústeres.

    ibmcloud sat storage config ls

  2. Obtenga el ID del clúster, del grupo de clústeres o del servicio al que desea asignar almacenamiento.

    Para asegurarse de que el clúster está registrado en Satellite Config, o para crear grupos, consulte Configuración de clústeres para su uso con Satellite Config.

    Mandato de ejemplo para listar grupos de clústeres.

    ibmcloud sat group ls

    Mandato de ejemplo para listar clústeres.

    ibmcloud oc cluster ls --provider satellite

    Mandato de ejemplo para listar los servicios de Satellite.

    ibmcloud sat service ls --location LOCATION

  3. Asigne la configuración de almacenamiento al clúster, grupo o servicio que ha recuperado anteriormente. Para obtener más información, consulta el. ibmcloud sat storage assignment createcomando

    Mandato de ejemplo para asignar una configuración a un grupo de clústeres.

    ibmcloud sat storage assignment create --group GROUP --config CONFIG --name NAME

    Mandato de ejemplo para asignar una configuración a un clúster.

    ibmcloud sat storage assignment create --cluster CLUSTER --config CONFIG --name NAME

    Mandato de ejemplo para asignar una configuración a un clúster de servicio.

    ibmcloud sat storage assignment create --service-cluster-id CLUSTER --config CONFIG --name NAME

  4. Verifique que la asignación se ha creado.

    ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)

Creación de una asignación de almacenamiento en la API

  1. Copie una de las siguientes solicitudes de ejemplo.

    Solicitud de ejemplo para asignar una configuración de a un clúster.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignmentByCluster" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"CLUSTER-ID\", \"controller\": \"LOCATION-ID\", \"name\": \"ASSIGNMENT-NAME\"}"

    Solicitud de ejemplo para asignar configuración a un grupo de clústeres.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"string\", \"groups\": [ \"CLUSTER-GROUP\" ], \"name\": \"ASSIGNMENT-NAME\"}"

  2. Sustituya las variables por sus detalles y ejecute la solicitud.

  3. Verifique que la asignación se ha creado listando las asignaciones.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignments" -H "accept: application/json" -H "Authorization: Bearer TOKEN"

Actualización de asignaciones de almacenamiento en la consola

Puede utilizar la consola deSatellite para aplicar las últimas actualizaciones de parches a sus asignaciones.

  1. En la página Ubicaciones de la consola deSatellite, seleccione su ubicación.

  2. Pulse el separador Almacenamiento para ver las configuraciones.

  3. Haz clic en la configuración que quieras actualizar.

  4. Pulse el icono Información (i) para aplicar la última revisión o parche.

  5. Opcional: habilite las actualizaciones de parches automáticas para la asignación de almacenamiento. La habilitación de las actualizaciones automáticas de parches garantiza que la asignación siempre tenga los últimos arreglos de seguridad.

Si habilita las actualizaciones automáticas de parches, debe seguir aplicando las actualizaciones principales manualmente.

Actualización manual de asignaciones en la CLI

Actualice una asignación para utilizar la última revisión de plantilla de almacenamiento.

  1. Liste las asignaciones de almacenamiento de Satellite, tome nota de la asignación de Satellite que desea actualizar.

    ibmcloud sat storage assignment ls

  2. Liste las plantillas de almacenamiento de Satellite para ver las últimas versiones disponibles.

    ibmcloud sat storage template ls

  3. Actualice la asignación de Satellite.

    Mandato de ejemplo para actualizar una asignación.

    ibmcloud sat storage assignment upgrade --assignment ASSIGNMENT

Habilitación de actualizaciones automáticas de parches para configuraciones y asignaciones en la CLI

Puede utilizar la CLI de sat storage assignment autopatch enable para habilitar las actualizaciones de parches automáticas para las asignaciones. La habilitación de actualizaciones automáticas de parches aplica automáticamente las revisiones de plantilla de almacenamiento (parches) más recientes. Debe seguir aplicando las actualizaciones principales manualmente.

  1. Obtener una lista de configuraciones de almacenamiento de Satellite. Anota el ID de configuración.

    ibmcloud sat storage assignment ls

  2. Ejecute uno de los siguientes mandatos de ejemplo para habilitar las actualizaciones de parches automáticas para la configuración y sus asignaciones asociadas. Introduce el ID de configuración que has obtenido en el paso anterior.

    Mandato de ejemplo para habilitar actualizaciones de parches automáticas para una asignación.

    ibmcloud sat storage assignment autopatch enable --config CONFIG  (--all | --assignment ASSIGNMENT-ID [--assignment ASSIGNMENT-ID])

    Mandato de ejemplo para habilitar actualizaciones de parches automáticas para todas las asignaciones de almacenamiento en una configuración determinada.

    ibmcloud sat storage assignment autopatch enable --config CONFIG --all

    Mandato de ejemplo para inhabilitar las actualizaciones de parches automáticas para todas las asignaciones en una configuración específica.

    ibmcloud sat storage assignment autopatch disable --config CONFIG --all

    Mandato de ejemplo para inhabilitar las actualizaciones de parches automáticas para una única asignación y una configuración específica.

    ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID

    Mandato de ejemplo para inhabilitar las actualizaciones automáticas de parches para una asignación múltiple y una configuración específica.

    ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID --assignment ASSIGNMENT-ID

Actualización manual de configuraciones en la CLI

Puedes actualizar las configuraciones de almacenamiento de Satellite para obtener la última revisión de la plantilla de almacenamiento dentro de la misma versión principal.

  1. Liste las configuraciones de almacenamiento de Satellite , tome nota de la configuración de Satellite que desea actualizar.

    ibmcloud sat storage config ls

  2. Actualice la configuración de Satellite. Tenga en cuenta que solo se actualiza la configuración. Si desea actualizar las asignaciones que utilizan esta configuración, puede especificar la opción --include-assignments o puede actualizar manualmente cada asignación utilizando el mandato assignment update .

    Mandato de ejemplo para actualizar una configuración a la última revisión.

    ibmcloud sat storage config upgrade --config CONFIG [--include-assignments]

    Mandato de ejemplo para actualizar una configuración y sus asignaciones asociadas a la última revisión.

    ibmcloud sat storage config upgrade --config CONFIG --include-assignments

Actualización de una configuración y asignaciones en la API

Puede utilizar la API de /v2/storage/satellite/updateAssignment para actualizar las asignaciones con nuevos clústeres o grupos de clústeres. Establezca updateConfigVersion en true para aplicar la actualización de revisión.

  1. Copie la siguiente solicitud de ejemplo y sustituya las variables para los grupos de clúster y las asignaciones que desea actualizar.

    curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/updateAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"groups\": [ \"CLUSTER-GROUPS\" ], \"name\": \"ASSIGNMENT-NAME\", \"updateConfigVersion\": true, \"uuid\": \"ASSIGNMENT-ID\"}"

  2. Ejecute la solicitud.

  3. Obtenga los detalles de la asignación para verificar la actualización.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"

Habilitación de actualizaciones automáticas de parches para asignaciones en la API

Puede utilizar la API de /v2/storage/satellite/setAssignmentAutoupgrade para habilitar las actualizaciones de parches automáticas para las asignaciones. La habilitación de actualizaciones automáticas de parches aplica automáticamente las revisiones de plantilla de almacenamiento (parches) más recientes. Debe seguir aplicando las actualizaciones principales manualmente.

  1. Copie la siguiente solicitud de ejemplo y sustituya las variables para los grupos de clúster y las asignaciones que desea actualizar.

    curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/setAssignmentAutoupgrade" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d { "config": "string", "controller": "string", "autopatch": boolean,"assignment" : { "all": boolean, "uuid": ["string", "string", ...], } }

  2. Ejecute la solicitud.

  3. Obtenga los detalles de la asignación para verificar la actualización.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"

Eliminación de la asignación y configuración del almacenamiento de NetApp Trident desde la consola

Utilice la consola para eliminar una asignación de almacenamiento y una configuración de almacenamiento.

  1. En el panel de control de almacenamiento de Satellite, seleccione la configuración de almacenamiento que desea suprimir.
  2. Seleccione Acciones > Suprimir
  3. Especifique el nombre de la configuración de almacenamiento.
  4. Seleccione Suprimir.

Eliminación de la asignación y de una configuración de almacenamiento Trident de NetApp desde la CLI

Utilice la CLI para eliminar asignaciones de almacenamiento y de configuración.

  1. Obtenga una lista de las asignaciones de almacenamiento y busque la que ha utilizado para el clúster.

    ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)

  2. Elimine la asignación. Una vez eliminada la asignación, se eliminan los pods de controlador Trident de NetApp y la clase de almacenamiento de todos los clústeres que formaban parte de dicha asignación.

    ibmcloud sat storage assignment rm --assignment ASSIGNMENT_ID

  3. Liste los pods del espacio de nombres trident y compruebe que se hayan eliminado los pods de controlador de almacenamiento Trident de NetApp.

    oc get pods -n trident

  4. Compruebe que el espacio de nombres trident se ha eliminado.

    oc get ns

    Si el espacio de nombres trident se queda atascado en el estado Terminating, siga los pasos para eliminar el espacio de nombres. Como alternativa, puedes seguir la documentación de « NetApp » para desinstalar el operador Trident.

  5. Opcional: Liste las configuraciones de almacenamiento y elimine la configuración de Trident.

    ibmcloud sat storage config ls

    ibmcloud sat storage config rm --config CONFIG_NAME

Obtención de ayuda y soporte para NetApp Trident

Si tienes algún problema con NetApp Trident, puedes visitar la página de asistencia de NetApp.