Skip to main content
È disponibile una versione più recente di questo prodotto.
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Gestisci Astra Trident usando tridentctl

Collaboratori
https://github.com/NetApp/trident/releases["Pacchetto di installazione Trident"^]Include l' `tridentctl`utility a riga di comando per fornire un semplice accesso ad Astra Trident. Gli utenti Kubernetes con privilegi sufficienti possono usarlo per installare Astra Trident o gestire il namespace che contiene il pod Astra Trident.

Comandi e flag globali

Si può eseguire tridentctl help per ottenere un elenco di comandi disponibili per o aggiungere il --help flag a qualsiasi comando per tridentctl ottenere un elenco di opzioni e flag per quel comando specifico.

tridentctl [command] [--optional-flag]

L'utility Astra Trident tridentctl supporta i seguenti comandi e flag globali.

Comandi
create

Aggiungi una risorsa a Astra Trident.

delete

Rimozione di una o più risorse da Astra Trident.

get

Ottieni una o più risorse da Astra Trident.

help

Aiuto su qualsiasi comando.

images

Stampare una tabella delle immagini container di cui Astra Trident ha bisogno.

import

Importa una risorsa esistente in Astra Trident.

install

Installa Astra Trident.

logs

Stampare i registri da Astra Trident.

send

Invia una risorsa da Astra Trident.

uninstall

Disinstallare Astra Trident.

update

Modifica una risorsa in Astra Trident.

update backend state

Sospendere temporaneamente le operazioni di backend.

upgrade

Aggiorna una risorsa in Astra Trident.

version

Stampa la versione di Astra Trident.

Flag globali
-d, --debug

Output di debug.

-h, --help

Guida per tridentctl.

-k, --kubeconfig string

Specifica il KUBECONFIG percorso per eseguire comandi in locale o da un cluster Kubernetes a un altro.

Nota In alternativa, puoi esportare la KUBECONFIG variabile in modo da puntare a un cluster Kubernetes specifico ed emettere tridentctl comandi a quel cluster.
-n, --namespace string

Namespace dell'implementazione di Astra Trident.

-o, --output string

Formato di output. Uno tra json|yaml|name|wide|ps (impostazione predefinita).

-s, --server string

Indirizzo/porta dell'interfaccia REST Astra Trident.

Attenzione L'interfaccia REST di Trident può essere configurata per l'ascolto e la distribuzione solo su 127.0.0.1 (per IPv4) o [::1] (per IPv6).

Opzioni di comando e flag

creare

Utilizza il create comando per aggiungere una risorsa a Astra Trident.

tridentctl create [option]

Opzioni

backend: Aggiungere un backend ad Astra Trident.

eliminare

Utilizza il delete comando per rimuovere una o più risorse da Astra Trident.

tridentctl delete [option]

Opzioni

backend: Eliminare uno o più backend di storage da Astra Trident.
snapshot: Eliminare uno o più snapshot di volume da Astra Trident.
storageclass: Eliminare una o più classi di storage da Astra Trident.
volume: Eliminare uno o più volumi di storage da Astra Trident.

ottieni

Utilizza il get comando per ottenere una o più risorse da Astra Trident.

tridentctl get [option]

Opzioni

backend: Ottieni uno o più backend di storage da Astra Trident.
snapshot: Ottieni uno o più snapshot da Astra Trident.
storageclass: Ottieni una o più classi di storage da Astra Trident.
volume: Ottenere uno o più volumi da Astra Trident.

Allarmi

-h, --help: Guida per i volumi.
--parentOfSubordinate string: Limita la query al volume di origine subordinato.
--subordinateOf string: Limita la query ai subordinati del volume.

immagini

Utilizzare images i flag per stampare una tabella delle immagini contenitore di cui necessita Astra Trident.

tridentctl images [flags]

Allarmi

-h, --help: Guida per le immagini.
-v, --k8s-version string: Versione semantica del cluster Kubernetes.

importa volume

Utilizza il import volume comando per importare un volume esistente in Astra Trident.

tridentctl import volume <backendName> <volumeName> [flags]

Alias

volume, v

Allarmi

-f, --filename string: Percorso al file PVC YAML o JSON.
-h, --help: Guida per il volume.
--no-manage: Creare solo PV/PVC. Non presupporre la gestione del ciclo di vita dei volumi.

installare

Utilizza le install flag per installare Astra Trident.

tridentctl install [flags]

Allarmi

--autosupport-image string: L'immagine contenitore per la telemetria AutoSupport (predefinita "NetApp/Trident AutoSupport:<current-version>").
--autosupport-proxy string: L'indirizzo/porta di un proxy per l'invio della telemetria AutoSupport.
--enable-node-prep: Tentativo di installare i pacchetti richiesti sui nodi.
--generate-custom-yaml: Generare file YAML senza installare nulla.
-h, --help: Guida per l'installazione.
--http-request-timeout: Ignorare il timeout della richiesta HTTP per l'API REST del controller Trident (valore predefinito 1m30).
--image-registry string: L'indirizzo/porta di un registro interno dell'immagine.
--k8s-timeout duration: Il timeout per tutte le operazioni Kubernetes (predefinito 3 m0s).
--kubelet-dir string: La posizione host dello stato interno di kubelet (default "/var/lib/kubelet").
--log-format string: Il formato di registrazione Astra Trident (text, json) (default "text").
--pv string: Il nome del PV esistente utilizzato da Astra Trident, garantisce che non esista (default "Trident").
--pvc string: Il nome del PVC legacy usato da Astra Trident, garantisce che non esista (default "Trident").
--silence-autosupport: Non inviare pacchetti AutoSupport a NetApp automaticamente (default true).
--silent: Consente di disattivare la maggior parte dell'output durante l'installazione.
--trident-image string: L'immagine Astra Trident da installare.
--use-custom-yaml: Utilizzare i file YAML esistenti nella directory di installazione.
--use-ipv6: Utilizzare IPv6 per la comunicazione di Astra Trident.

registri

Utilizzare logs i flag per stampare i registri da Astra Trident.

tridentctl logs [flags]

Allarmi

-a, --archive: Creare un archivio di supporto con tutti i registri, se non diversamente specificato.
-h, --help: Guida per i registri.
-l, --log string: Astra Trident log da visualizzare. Uno di Trident|auto|Trident-operator|all (impostazione predefinita "auto").
--node string: Il nome del nodo Kubernetes da cui raccogliere i log dei pod dei nodi.
-p, --previous: Ottiene i log per l'istanza contenitore precedente, se esiste.
--sidecars: Ottenere i tronchi per i contenitori del sidecar.

invia

Utilizza il send comando per inviare una risorsa da Astra Trident.

tridentctl send [option]

Opzioni

autosupport: Inviare un archivio AutoSupport a NetApp.

disinstallazione

Utilizzare uninstall flag per disinstallare Astra Trident.

tridentctl uninstall [flags]

Allarmi

-h, --help: Guida per la disinstallazione.
--silent: Consente di disattivare la maggior parte dell'output durante la disinstallazione.

aggiornamento

Utilizzare il update comando per modificare una risorsa in Astra Trident.

tridentctl update [option]

Opzioni

backend: Aggiornare un backend in Astra Trident.

aggiorna stato backend

Utilizzare il update backend state comando per sospendere o riprendere le operazioni di backend.

tridentctl update backend state <backend-name> [flag]

Punti da considerare
  • Se un backend viene creato utilizzando un TridentBackendConfig (tbc), non è possibile aggiornare il backend utilizzando un backend.json file.

  • Se il userState è stato impostato in un tbc, non può essere modificato utilizzando il tridentctl update backend state <backend-name> --user-state suspended/normal comando .

  • Per recuperare la capacità di impostare il userState tridentctl via una volta che è stato impostato tramite tbc, il userState campo deve essere rimosso dal tbc. Questo può essere fatto usando il kubectl edit tbc comando. Una volta rimosso il userState campo, è possibile utilizzare il tridentctl update backend state comando per modificare il userState di un backend.

  • Utilizzare il tridentctl update backend state per modificare il userState. È anche possibile aggiornare il userState file Using TridentBackendConfig o backend.json ; questo attiva una reinizializzazione completa del backend e può richiedere molto tempo.

    Allarmi

    -h, --help: Guida per lo stato backend.
    --user-state: Impostare su suspended per sospendere le operazioni di backend. Impostare su normal per riprendere le operazioni di backend. Quando impostato su suspended:

  • AddVolume e Import Volume sono in pausa.

  • CloneVolume, , ResizeVolume, , PublishVolume UnPublishVolume, , CreateSnapshot GetSnapshot RestoreSnapshot, , , , DeleteSnapshot RemoveVolume, , GetVolumeExternal ReconcileNodeAccess rimangono disponibili.

È inoltre possibile aggiornare lo stato backend utilizzando il userState campo nel file di configurazione backend TridentBackendConfig o backend.json. Per ulteriori informazioni, fare riferimento a "Opzioni per la gestione dei backend" e "Eseguire la gestione del back-end con kubectl".

Esempio:

Per aggiornare utilizzando il file, procedere come segue userState backend.json :

  1. Modificare il backend.json file per includere il userState campo con il valore impostato su 'sospeso'.

  2. Aggiornare il backend utilizzando il tridentctl backend update comando e il percorso del file aggiornato backend.json .

    Esempio: 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",
}

versione

Utilizzare version i flag per stampare la versione di tridentctl e il servizio Trident in esecuzione.

tridentctl version [flags]

Allarmi

--client: Solo versione client (non è richiesto alcun server).
-h, --help: Guida per la versione.