L'articolo richiesto non è disponibile. O non si applica a questa versione del prodotto oppure in questa versione della documentazione le informazioni pertinenti sono organizzate diversamente. Puoi eseguire una ricerca, navigare o tornare all'altra versione.

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

10/30/2024 Collaboratori

PDF

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.

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.

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:

JSON

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

Modificare il backend.json file per includere il userState campo con il valore impostato su 'sospeso'.
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",
}

YAML

È possibile modificare il tbc dopo averlo applicato utilizzando il kubectl edit <tbc-name> -n <namespace> comando . Nell'esempio riportato di seguito viene aggiornato lo stato backend per la sospensione mediante l' userState: suspended opzione:

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

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.