O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Gerenciar o Trident usando o tridentctl

10/31/2024 Colaboradores

PDFs

O "Pacote de instalação do Trident" inclui o tridentctl utilitário de linha de comando para fornecer acesso simples ao Trident. Os usuários do Kubernetes com Privileges suficientes podem usá-lo para instalar o Trident ou gerenciar o namespace que contém o pod Trident.

Comandos e sinalizadores globais

Você pode executar tridentctl help para obter uma lista de comandos disponíveis tridentctl ou anexar o --help sinalizador a qualquer comando para obter uma lista de opções e sinalizadores para esse comando específico.

tridentctl [command] [--optional-flag]

O utilitário Trident tridentctl suporta os seguintes comandos e sinalizadores globais.

Comandos

create: Adicione um recurso ao Trident.
delete: Remova um ou mais recursos do Trident.
get: Obtenha um ou mais recursos do Trident.
help: Ajuda sobre qualquer comando.
images: Imprima uma tabela das imagens de contentor que o Trident necessita.
import: Importar um recurso existente para o Trident.
install: Instale o Trident.
logs: Imprimir os registos a partir do Trident.
send: Enviar um recurso do Trident.
uninstall: Desinstale o Trident.
update: Modificar um recurso no Trident.
update backend state: Suspender temporariamente as operações de back-end.
upgrade: Atualizar um recurso no Trident.
version: Imprima a versão do Trident.

Bandeiras globais

-d, --debug

Saída de depuração.

-h, --help

Ajuda para tridentctl.

-k, --kubeconfig string

Especifique KUBECONFIG o caminho para executar comandos localmente ou de um cluster do Kubernetes para outro.

Como alternativa, você pode exportar a KUBECONFIG variável para apontar para um cluster Kubernetes específico e emitir tridentctl comandos para esse cluster.

-n, --namespace string

Namespace da implantação do Trident.

-o, --output string

Formato de saída. Um de JSON|yaml|name|wide|ps (padrão).

-s, --server string

Endereço/porta da interface REST do Trident.

A interface REST DO Trident pode ser configurada para ouvir e servir apenas em 127.0.0.1 (para IPv4) ou [::1] (para IPv6).

Opções de comando e sinalizadores

criar

Use o create comando para adicionar um recurso ao Trident.

tridentctl create [option]

Opções: backend: Adicione um backend ao Trident.

eliminar

Use o delete comando para remover um ou mais recursos do Trident.

tridentctl delete [option]

Opções: backend: Excluir um ou mais backends de armazenamento do Trident.
snapshot: Excluir um ou mais snapshots de volume do Trident.
storageclass: Excluir uma ou mais classes de armazenamento do Trident.
volume: Excluir um ou mais volumes de armazenamento do Trident.

obter

Use o get comando para obter um ou mais recursos do Trident.

tridentctl get [option]

Opções: backend: Obtenha um ou mais backends de armazenamento do Trident.
snapshot: Obter um ou mais snapshots do Trident.
storageclass: Obtenha uma ou mais classes de armazenamento do Trident.
volume: Obtenha um ou mais volumes do Trident.
Bandeiras: -h, --help: Ajuda para volumes.
--parentOfSubordinate string: Limitar consulta ao volume de origem subordinado.
--subordinateOf string: Limitar consulta a subordinados de volume.

imagens

Use images sinalizadores para imprimir uma tabela das imagens de contentor que o Trident precisa.

tridentctl images [flags]

Bandeiras: -h, --help: Ajuda para imagens.
-v --k8s-version string, : Versão semântica do cluster do Kubernetes.

importar volume

Use o import volume comando para importar um volume existente para o Trident.

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

Aliases: volume, v
Bandeiras: -f --filename string, : Caminho para o arquivo PVC YAML ou JSON.
-h, --help: Ajuda para volume.
--no-manage: Criar apenas PV/PVC. Não assuma o gerenciamento do ciclo de vida do volume.

instale

Use os install sinalizadores para instalar o Trident.

tridentctl install [flags]

Bandeiras: --autosupport-image string: A imagem do contentor para telemetria AutoSupport (predefinição "NetApp/Trident AutoSupport:<current-version>").
--autosupport-proxy string: O endereço/porta de um proxy para o envio de telemetria AutoSupport.
--enable-node-prep: Tentativa de instalar os pacotes necessários nos nós.
--generate-custom-yaml: Gere arquivos YAML sem instalar nada.
-h --help, : Ajuda para instalar.
--http-request-timeout: Substituir o tempo limite da solicitação HTTP para a API REST do controlador Trident (1m30s padrão).
--image-registry string: O endereço/porta de um Registro de imagem interno.
--k8s-timeout duration: O tempo limite para todas as operações do Kubernetes (3m0s padrão).
--kubelet-dir string: A localização do host do estado interno do kubelet (padrão "/var/lib/kubelet").
--log-format string: O formato de log do Trident (texto, json) (texto padrão).
--node-prep: Permite que o Trident prepare os nós do cluster do Kubernetes para gerenciar volumes usando o protocolo de storage de dados especificado. Atualmente, iscsi é o único valor suportado.
--pv string: o nome do PV herdado usado pelo Trident, garante que isso não existe (padrão "Trident").
--pvc string: O nome do PVC legado usado pelo Trident, garante que isso não existe (padrão "Trident").
--silence-autosupport: Não envie pacotes AutoSupport automaticamente para o NetApp (padrão verdadeiro).
--silent: Desativar a saída MOST durante a instalação.
--trident-image string: A imagem Trident a instalar.
--use-custom-yaml: Use todos os arquivos YAML existentes que existem no diretório de configuração.
--use-ipv6: Utilizar IPv6 para a comunicação do Trident.

registos

Use logs sinalizadores para imprimir os logs do Trident.

tridentctl logs [flags]

Bandeiras: -a, --archive: Crie um arquivo de suporte com todos os logs, a menos que especificado de outra forma.
-h --help, : Ajuda para logs.
-l --log string, : Trident log a ser exibido. Um dos Trident|auto|Trident-operator|All (predefinição "auto").
--node string: O nome do nó Kubernetes do qual você pode coletar logs do pod de nó.
-p --previous, : Obtém os registos para a instância de contentor anterior, se existir.
--sidecars: Obter os logs para os recipientes sidecar.

enviar

Use o send comando para enviar um recurso do Trident.

tridentctl send [option]

Opções: autosupport: Enviar um arquivo AutoSupport para o NetApp.

desinstalar

Use uninstall sinalizadores para desinstalar o Trident.

tridentctl uninstall [flags]

Bandeiras: -h, --help: Ajuda para desinstalar.
--silent: Desativar a saída MOST durante a desinstalação.

atualização

Use o update comando para modificar um recurso no Trident.

tridentctl update [option]

Opções: backend: Atualize um backend no Trident.

atualizar estado de back-end

Use o update backend state comando para suspender ou retomar as operações de back-end.

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

Pontos a considerar

Se um back-end for criado usando um TridentBackendConfig (tbc), o back-end não poderá ser atualizado usando um backend.json arquivo.
Se o userState foi definido em um tbc, ele não pode ser modificado usando o tridentctl update backend state <backend-name> --user-state suspended/normal comando.
Para recuperar a capacidade de definir a userState via tridentctl depois de ter sido definida via tbc, o userState campo deve ser removido do tbc. Isso pode ser feito usando o kubectl edit tbc comando. Depois que o userState campo for removido, você pode usar o tridentctl update backend state comando para alterar o userState de um backend.
Utilize os tridentctl update backend state para alterar o userState. Você também pode atualizar o userState usando TridentBackendConfig ou backend.json arquivo; isso aciona uma reinicialização completa do back-end e pode ser demorado.

Bandeiras

-h --help, : Ajuda para o estado de back-end.
--user-state: Defina como suspended para pausar operações de back-end. Defina como normal para retomar as operações de back-end. Quando definido para suspended:
AddVolume e Import Volume estão em pausa.
CloneVolume ResizeVolume, , PublishVolume UnPublishVolume , CreateSnapshot, , , GetSnapshot RestoreSnapshot, , DeleteSnapshot RemoveVolume , GetVolumeExternal, , , ReconcileNodeAccess permanecer disponível.

Você também pode atualizar o estado de back-end usando userState o campo no arquivo de configuração de back-end TridentBackendConfig ou backend.json. Para obter mais informações, "Opções para gerenciar backends"consulte e "Execute o gerenciamento de back-end com o kubectl".

Exemplo:

JSON

Siga estas etapas para atualizar o userState usando o backend.json arquivo:

Edite o backend.json arquivo para incluir o userState campo com o seu valor definido como 'uspended'.
Atualize o backend usando o tridentctl backend update comando e o caminho para o arquivo atualizado backend.json.

Exemplo: 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

Você pode editar o tbc depois que ele foi aplicado usando o kubectl edit <tbc-name> -n <namespace> comando. O exemplo a seguir atualiza o estado de back-end para suspender usando a userState: suspended opção:

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

versão

Use version sinalizadores para imprimir a versão do tridentctl e o serviço Trident em execução.

tridentctl version [flags]

Bandeiras: --client: Somente versão do cliente (nenhum servidor necessário).
-h, --help: Ajuda para a versão.

Suporte ao plugin

O Trigentctl suporta plugins semelhantes ao kubectl. O tridentctl deteta um plugin se o nome do arquivo binário do plugin seguir o esquema "tridentctl-<plugin>", e o binário está localizado em uma pasta listada a variável de ambiente PATH. Todos os plugins detetados estão listados na seção plugin da ajuda do tridentctl. Opcionalmente, você também pode limitar a pesquisa especificando uma pasta de plug-in na variável de enviornment TRIDENCTL_PLUGIN_PATH (exemplo: TRIDENTCTL_PLUGIN_PATH=~/tridentctl-plugins/). Se a variável for usada, tridenctl pesquisará somente na pasta especificada.