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.

Implantar manualmente o operador Trident (modo padrão)

10/31/2025 Colaboradores

PDFs

Você pode implantar manualmente o operador Trident para instalar o Trident. Este processo aplica-se a instalações onde as imagens de contentor exigidas pelo Trident não são armazenadas em um Registro privado. Se tiver um registo de imagens privado, utilize o "processo para implantação off-line".

Informações críticas sobre o Trident 25.10

Você deve ler as seguintes informações críticas sobre o Trident.

<strong> informações críticas sobre o Trident </strong>

O Kubernetes 1.34 agora é compatível com o Trident. Atualize o Trident antes de atualizar o Kubernetes.
O Trident reforça estritamente o uso de configuração multipathing em ambientes SAN, com um valor recomendado de find_multipaths: no no arquivo multipath.conf.

O uso de configuração não multipathing ou o uso find_multipaths: yes de ou find_multipaths: smart valor no arquivo multipath.conf resultará em falhas de montagem. A Trident recomenda o uso de find_multipaths: no desde a versão 21,07.

Implante manualmente o operador Trident e instale o Trident

Revise "a visão geral da instalação" para garantir que você atendeu aos pré-requisitos de instalação e selecionou a opção de instalação correta para o seu ambiente.

Antes de começar

Antes de iniciar a instalação, faça login no host Linux e verifique se ele está gerenciando um trabalho e "Cluster compatível com Kubernetes"se você tem o Privileges necessário.

Com OpenShift, use oc em vez de kubectl em todos os exemplos que se seguem, e faça login como system:admin primeiro executando oc login -u system:admin ou oc login -u kube-admin.

Details

Verifique sua versão do Kubernetes:
```
kubectl version
```
Verifique o Privileges do administrador do cluster:
```
kubectl auth can-i '*' '*' --all-namespaces
```
Verifique se você pode iniciar um pod que usa uma imagem do Docker Hub e alcançar seu sistema de armazenamento pela rede de pod:
```
kubectl run -i --tty ping --image=busybox --restart=Never --rm -- \
  ping <management IP>
```

Passo 1: Baixe o pacote de instalação do Trident

O pacote de instalação do Trident contém tudo o que você precisa para implantar o operador Trident e instalar o Trident. Baixe e extraia a versão mais recente do instalador do Trident a partir "A seção assets no GitHub"do .

wget https://github.com/NetApp/trident/releases/download/v25.10.0/trident-installer-25.10.0.tar.gz
tar -xf trident-installer-25.10.0.tar.gz
cd trident-installer

Passo 2: Crie o `TridentOrchestrator` CRD

Crie o TridentOrchestrator Definição de Recurso Personalizado (CRD). Você criará um TridentOrchestrator Recurso personalizado mais tarde. Use a versão CRD YAML apropriada em deploy/crds para criar o TridentOrchestrator CRD.

kubectl create -f deploy/crds/trident.netapp.io_tridentorchestrators_crd_post1.16.yaml

Etapa 3: Implante o operador Trident

O instalador do Trident fornece um arquivo de pacote que pode ser usado para instalar o operador e criar objetos associados. O arquivo bundle é uma maneira fácil de implantar o operador e instalar o Trident usando uma configuração padrão.

Para clusters que executam o Kubernetes 1,24, bundle_pre_1_25.yaml use o .
Para clusters que executam o Kubernetes 1,25 ou posterior, bundle_post_1_25.yaml use o .

Antes de começar

Por padrão, o instalador do Trident implanta o operador no trident namespace. Se o trident namespace não existir, crie-o usando:
```
kubectl apply -f deploy/namespace.yaml
```
Para implantar o operador em um namespace diferente do trident namespace, atualizar serviceaccount.yaml clusterrolebinding.yaml operator.yaml e gerar o arquivo do pacote usando o kustomization.yaml.
1. Crie o kustomization.yaml usando o seguinte comando onde <bundle.yaml> está bundle_pre_1_25.yaml ou bundle_post_1_25.yaml baseado na sua versão do Kubernetes.
  cp deploy/kustomization_<bundle.yaml> deploy/kustomization.yaml
2. Compile o pacote usando o seguinte comando onde <bundle.yaml> está bundle_pre_1_25.yaml ou bundle_post_1_25.yaml baseado na sua versão do Kubernetes.
  kubectl kustomize deploy/ > deploy/<bundle.yaml>

Passos

Crie os recursos e implante o operador:
```
kubectl create -f deploy/<bundle.yaml>
```
Verifique se o operador, a implantação e as replicasets foram criados.
```
kubectl get all -n <operator-namespace>
```

Deve haver apenas uma instância do operador em um cluster do Kubernetes. Não crie várias implantações do operador Trident.

Passo 4: Crie o `TridentOrchestrator` e instale o Trident

Agora você pode criar e instalar o TridentOrchestrator Trident. Opcionalmente, você pode "Personalize a instalação do Trident" usar os atributos na TridentOrchestrator especificação.

kubectl create -f deploy/crds/tridentorchestrator_cr.yaml
tridentorchestrator.trident.netapp.io/trident created

kubectl describe torc trident

Name:        trident
Namespace:
Labels:      <none>
Annotations: <none>
API Version: trident.netapp.io/v1
Kind:        TridentOrchestrator
...
Spec:
  Debug:     true
  Namespace: trident
  nodePrep:
  - iscsi
Status:
  Current Installation Params:
    IPv6:                      false
    Autosupport Hostname:
    Autosupport Image:         netapp/trident-autosupport:25.10
    Autosupport Proxy:
    Autosupport Serial Number:
    Debug:                     true
    Image Pull Secrets:
    Image Registry:
    k8sTimeout:           30
    Kubelet Dir:          /var/lib/kubelet
    Log Format:           text
    Silence Autosupport:  false
    Trident Image:        netapp/trident:25.10.0
  Message:                  Trident installed  Namespace:                trident
  Status:                   Installed
  Version:                  v25.10.0
Events:
    Type Reason Age From Message ---- ------ ---- ---- -------Normal
    Installing 74s trident-operator.netapp.io Installing Trident Normal
    Installed 67s trident-operator.netapp.io Trident installed

Verifique a instalação

Existem várias maneiras de verificar sua instalação.

`TridentOrchestrator`Usando o status

O status de TridentOrchestrator indica se a instalação foi bem-sucedida e exibe a versão do Trident instalado. Durante a instalação, o status das TridentOrchestrator alterações de Installing para Installed. Se você observar o Failed status e o operador não conseguir recuperar sozinho, "verifique os logs".

Estado Descrição

Estado	Descrição
A instalar	O operador está a instalar o Trident utilizando este `TridentOrchestrator` CR.
Instalado	O Trident foi instalado com sucesso.
Desinstalação	O operador está desinstalando o Trident, porque `spec.uninstall=true`.
Desinstalado	O Trident é desinstalado.
Falha	O operador não pôde instalar, corrigir, atualizar ou desinstalar o Trident; o operador tentará recuperar automaticamente deste estado. Se este estado persistir, será necessário resolver o problema.
A atualizar	O operador está atualizando uma instalação existente.
Erro	O `TridentOrchestrator` não é utilizado. Outro já existe.

A instalar

O operador está a instalar o Trident utilizando este TridentOrchestrator CR.

Instalado

O Trident foi instalado com sucesso.

Desinstalação

O operador está desinstalando o Trident, porque
spec.uninstall=true.

Desinstalado

O Trident é desinstalado.

Falha

O operador não pôde instalar, corrigir, atualizar ou desinstalar o Trident; o operador tentará recuperar automaticamente deste estado. Se este estado persistir, será necessário resolver o problema.

A atualizar

O operador está atualizando uma instalação existente.

Erro

O TridentOrchestrator não é utilizado. Outro já existe.

Usando o status de criação do pod

Você pode confirmar se a instalação do Trident foi concluída revisando o status dos pods criados:

kubectl get pods -n trident

NAME                                       READY   STATUS    RESTARTS   AGE
trident-controller-7d466bf5c7-v4cpw        6/6     Running   0           1m
trident-node-linux-mr6zc                   2/2     Running   0           1m
trident-node-linux-xrp7w                   2/2     Running   0           1m
trident-node-linux-zh2jt                   2/2     Running   0           1m
trident-operator-766f7b8658-ldzsv          1/1     Running   0           3m

Utilização `tridentctl`

Você pode usar tridentctl para verificar a versão do Trident instalada.

./tridentctl -n trident version

+----------------+----------------+
| SERVER VERSION | CLIENT VERSION |
+----------------+----------------+
| 25.10.0        | 25.10.0        |
+----------------+----------------+