Gestión de Astra Trident con tridentctl
La "Paquete de instalación de Trident" incluye la tridentctl
Herramienta de línea de comandos para proporcionar un acceso sencillo a Astra Trident. Los usuarios de Kubernetes que cuentan con suficientes privilegios pueden utilizarlo para instalar Astra Trident o gestionar el espacio de nombres que contiene el pod de Astra Trident.
Comandos e indicadores globales
Puede ejecutar tridentctl help
para obtener una lista de comandos disponibles para tridentctl
o añada la --help
marque cualquier comando para obtener una lista de opciones e indicadores para ese comando específico.
tridentctl [command] [--optional-flag]
Astra Trident tridentctl
la utilidad admite los siguientes comandos y indicadores globales.
Comandos
create
-
Añade un recurso a Astra Trident.
delete
-
Quita uno o varios recursos de Astra Trident.
get
-
Obtén uno o más recursos de Astra Trident.
help
-
Ayuda sobre cualquier comando.
images
-
Imprime una tabla de las imágenes de contenedores que Astra Trident necesita.
import
-
Importar un recurso existente a Astra Trident.
install
-
Instala Astra Trident.
logs
-
Imprime los registros desde Astra Trident.
send
-
Enviar un recurso desde Astra Trident.
uninstall
-
Desinstale Astra Trident.
update
-
Modificar un recurso en Astra Trident.
update backend state
-
Suspender temporalmente las operaciones de backend.
upgrade
-
Actualiza un recurso en Astra Trident.
version
-
Imprime la versión de Astra Trident.
Indicadores globales
-d
,--debug
-
Salida de depuración.
-h
,--help
-
Ayuda de
tridentctl
. -k
,--kubeconfig string
-
Especifique el
KUBECONFIG
Ruta para ejecutar comandos localmente o desde un clúster de Kubernetes a otro.Como alternativa, puede exportar el KUBECONFIG
Variable para apuntar a un clúster y un problema de Kubernetes específicostridentctl
comandos para ese clúster. -n
,--namespace string
-
Espacio de nombres de puesta en marcha de Astra Trident.
-o
,--output string
-
Formato de salida. Uno de json|yaml|name|Wide|ps (predeterminado).
-s
,--server string
-
Dirección/puerto de la interfaz REST DE Astra Trident.
La interfaz DE REST de Trident se puede configurar para escuchar y servir únicamente en 127.0.0.1 (para IPv4) o [::1] (para IPv6).
Opciones de comando y indicadores
cree
Utilice la create
Comando para añadir un recurso a Astra Trident.
tridentctl create [option]
- Opciones
-
backend
: Añadir un back-end a Astra Trident.
eliminar
Utilice la delete
Comando para eliminar uno o más recursos de Astra Trident.
tridentctl delete [option]
- Opciones
-
backend
: Elimine uno o más back-ends de almacenamiento de Astra Trident.
snapshot
: Elimine una o más instantáneas de volumen de Astra Trident.
storageclass
: Elimine una o varias clases de almacenamiento de Astra Trident.
volume
: Elimine uno o varios volúmenes de almacenamiento de Astra Trident.
obtenga
Utilice la get
Comando para obtener uno o más recursos de Astra Trident.
tridentctl get [option]
- Opciones
-
backend
: Obtenga uno o más back-ends de almacenamiento de Astra Trident.
snapshot
: Obtiene una o más instantáneas de Astra Trident.
storageclass
: Obtenga una o más clases de almacenamiento de Astra Trident.
volume
: Obtenga uno o más volúmenes de Astra Trident. - Indicadores
-
-h
,--help
: Ayuda para volúmenes.
--parentOfSubordinate string
: Limite la consulta al volumen de origen subordinado.
--subordinateOf string
: Limite la consulta a las subordinadas del volumen.
imágenes
Uso images
Banderas para imprimir una tabla de las imágenes de contenedores que Astra Trident necesita.
tridentctl images [flags]
- Indicadores
-
-h
,--help
: Ayuda para imágenes.
-v
,--k8s-version string
: Versión semántica del clúster de Kubernetes.
importe volumen
Utilice la import volume
Comando para importar un volumen existente a Astra Trident.
tridentctl import volume <backendName> <volumeName> [flags]
- Alias
-
volume
,v
- Indicadores
-
-f
,--filename string
: Ruta al archivo YLMA o JSON PVC.
-h
,--help
: Ayuda para el volumen.
--no-manage
: Cree sólo PV/PVC. No asuma que se gestiona el ciclo de vida de los volúmenes.
instale
Utilice la install
Banderas para instalar Astra Trident.
tridentctl install [flags]
- Indicadores
-
--autosupport-image string
: La imagen de contenedor para la telemetría de AutoSupport (valor predeterminado «netapp/trident autosupport:<current-version>»).
--autosupport-proxy string
: La dirección/puerto de un proxy para enviar telemetría AutoSupport.
--enable-node-prep
: Intente instalar los paquetes necesarios en los nodos.
--generate-custom-yaml
: Genere archivos YAML sin instalar nada.
-h
,--help
: Ayuda para instalar.
--http-request-timeout
: Sustituya el tiempo de espera de la solicitud HTTP para la API REST del controlador Trident (por defecto 1m30s).
--image-registry string
: La dirección/puerto de un registro de imagen interna.
--k8s-timeout duration
: El tiempo de espera para todas las operaciones de Kubernetes (por defecto 3 m0s).
--kubelet-dir string
: La ubicación del host del estado interno de Kubelet (predeterminado "/var/lib/kubelet").
--log-format string
: El formato de registro de Astra Trident (texto, json) (por defecto "text").
--pv string
: El nombre del PV heredado utilizado por Astra Trident, se asegura de que esto no existe (por defecto "trident").
--pvc string
: El nombre del PVC heredado utilizado por Astra Trident, se asegura de que esto no exista (por defecto “tridente”).
--silence-autosupport
: No envíe los paquetes AutoSupport a NetApp automáticamente (valor predeterminado: TRUE).
--silent
: Desactiva la mayoría de la salida durante la instalación.
--trident-image string
: La imagen de Astra Trident que se va a instalar.
--use-custom-yaml
: Utilice cualquier archivo YAML existente en el directorio de instalación.
--use-ipv6
: Utilice IPv6 para la comunicación de Astra Trident.
registros
Uso logs
Indicadores para imprimir los registros de Astra Trident.
tridentctl logs [flags]
- Indicadores
-
-a
,--archive
: Cree un archivo de soporte con todos los registros a menos que se especifique lo contrario.
-h
,--help
: Ayuda para registros.
-l
,--log string
: Mostrar el registro de Astra Trident. Uno de trident|auto|trident-operator|All (valor predeterminado "auto").
--node string
: El nombre del nodo Kubernetes del que se van a recopilar registros del nodo pod.
-p
,--previous
: Obtiene los registros de la instancia anterior del contenedor si existe.
--sidecars
: Obtener los registros de los contenedores sidecar.
enviar
Utilice la send
Para enviar un recurso desde Astra Trident.
tridentctl send [option]
- Opciones
-
autosupport
: Enviar un fichero AutoSupport a NetApp.
desinstalar
Uso uninstall
Indicadores para desinstalar Astra Trident.
tridentctl uninstall [flags]
- Indicadores
-
-h, --help
: Ayuda para la desinstalación.
--silent
: Desactiva la mayoría de la salida durante la desinstalación.
actualizar
Utilice la update
Comando para modificar un recurso en Astra Trident.
tridentctl update [option]
- Opciones
-
backend
: Actualizar un back-end en Astra Trident.
actualizar estado de backend
Utilice la update backend state
comando para suspender o reanudar operaciones de back-end.
tridentctl update backend state <backend-name> [flag]
-
Si se crea un backend con un TridentBackendConfig (tbc), el backend no se puede actualizar con un
backend.json
archivo. -
Si el
userState
se ha establecido en una tbc, no se puede modificar mediante eltridentctl update backend state <backend-name> --user-state suspended/normal
comando. -
Para recuperar la capacidad de establecer el
userState
tridentctl vía una vez que se ha establecido a través de tbc, eluserState
campo debe eliminarse del tbc. Esto se puede hacer usandokubectl edit tbc
el comando. Una vez eliminado eluserState
campo, puede utilizartridentctl update backend state
el comando para cambiar eluserState
de un backend. -
Utilice el
tridentctl update backend state
para cambiar lauserState
. También puede actualizar eluserState
archivo UsingTridentBackendConfig
ORbackend.json
; esto desencadena una reinicialización completa del backend y puede llevar mucho tiempo.- Indicadores
-
-h
,--help
: Ayuda para el estado de backend.
--user-state
: Establecer ensuspended
para pausar las operaciones de backend. Establezca ennormal
para reanudar las operaciones de back-end. Cuando se establece ensuspended
:
-
AddVolume
Import Volume
y se ponen en pausa. -
CloneVolume
, , ,ResizeVolume
PublishVolume
UnPublishVolume
, ,CreateSnapshot
,GetSnapshot
RestoreSnapshot
, , ,DeleteSnapshot
RemoveVolume
, ,GetVolumeExternal
,ReconcileNodeAccess
seguir estando disponible.
También puede actualizar el estado del backend utilizando userState
el campo en el archivo de configuración de backend TridentBackendConfig
o backend.json
. Para obtener más información, consulte "Opciones para gestionar back-ends" y. "Realice la gestión del entorno de administración con kubectl"
Ejemplo:
Siga estos pasos para actualizar el userState
utilizando el backend.json
archivo:
-
Edite el
backend.json
archivo para incluir eluserState
campo con su valor establecido en 'SUSPENded'. -
Actualice el backend con el
tridentctl backend update
comando y la ruta de acceso al archivo actualizadobackend.json
.Ejemplo:
tridentctl backend update -f /<path to backend JSON file>/backend.json
{ "version": 1, "storageDriverName": "ontap-nas", "managementLIF": "<redacted>", "svm": "nas-svm", "backendName": "customBackend", "username": "<redacted>", "password": "<redacted>", "userState": "suspended", }
Puede editar el tbc después de que se haya aplicado con el kubectl edit <tbc-name> -n <namespace>
comando. En el ejemplo siguiente se actualiza el estado del back-end para suspender con la userState: suspended
opción:
apiVersion: trident.netapp.io/v1 kind: TridentBackendConfig metadata: name: backend-ontap-nas spec: version: 1 backendName: customBackend storageDriverName: ontap-nas managementLIF: <redacted> svm: nas-svm userState: suspended credentials: name: backend-tbc-ontap-nas-secret
versión
Uso version
indicadores para imprimir la versión de tridentctl
Y el servicio Trident que se ejecuta.
tridentctl version [flags]
- Indicadores
-
--client
: Sólo versión de cliente (no se necesita ningún servidor).
-h, --help
: Ayuda para la versión.