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 operador Trident usando Helm (modo offline)

10/29/2025 Colaboradores

PDFs

Você pode implantar o operador Trident e instalar o Trident usando o Helm. Este processo aplica-se a instalações onde as imagens de contêiner exigidas pelo Trident estão armazenadas em um registro privado. Se você não possui um registro de imagens privado, utilize o"processo para implantação padrão" .

Informações críticas sobre o Trident 25.06

Você deve ler as seguintes informações críticas sobre 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.
A Trident impõe rigorosamente o uso da configuração de multipathing em ambientes SAN, com um valor recomendado de find_multipaths: no no arquivo multipath.conf.

Utilização de configuração sem multipathing ou utilização de find_multipaths: yes ou find_multipaths: smart O valor no arquivo multipath.conf resultará em falhas de montagem. A Trident recomendou o uso de find_multipaths: no desde a versão de 21/07.

Implante o operador Trident e instale o Trident usando o Helm.

Usando o Trident"Carta do leme" Você pode implantar o operador Trident e instalar o Trident em uma única etapa.

Análise"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

Além do"pré-requisitos de implantação" você precisa"Helm versão 3" .

Ao instalar o Trident em um repositório privado, se você estiver usando o imageRegistry Para especificar a localização do repositório, não use a opção --change. /netapp/ no caminho do repositório.

Passos

Adicione o repositório Trident Helm:

helm repo add netapp-trident https://netapp.github.io/trident-helm-chart

Usar helm install Especifique um nome para sua implantação e o local do registro de imagens. Seu"Imagens do Trident e do CSI" Podem estar localizadas em um único registro ou em registros diferentes, mas todas as imagens CSI devem estar localizadas no mesmo registro. Nos exemplos, 100.2506.0 é a versão do Trident que você está instalando.

Imagens em um único registro

helm install <name> netapp-trident/trident-operator --version 100.2506.0 --set imageRegistry=<your-registry> --create-namespace --namespace <trident-namespace> --set nodePrep={iscsi}

Imagens em diferentes registros

helm install <name> netapp-trident/trident-operator --version 100.2506.0 --set imageRegistry=<your-registry> --set operatorImage=<your-registry>/trident-operator:25.06.0 --set tridentAutosupportImage=<your-registry>/trident-autosupport:25.06 --set tridentImage=<your-registry>/trident:25.06.0 --create-namespace --namespace <trident-namespace> --set nodePrep={iscsi}

Se você já criou um namespace para o Trident, o --create-namespace O parâmetro não criará um namespace adicional.

Você pode usar helm list Para analisar detalhes da instalação, como nome, namespace, gráfico, status, versão do aplicativo e número da revisão.

Passe os dados de configuração durante a instalação.

Existem duas maneiras de passar dados de configuração durante a instalação:

Opção Descrição

Opção	Descrição
`--values`(ou `-f` )	Especifique um arquivo YAML com as configurações personalizadas. Isso pode ser especificado várias vezes e o arquivo mais à direita terá precedência.
`--set`	Especifique as configurações alternativas na linha de comando.

--values(ou -f )

Especifique um arquivo YAML com as configurações personalizadas. Isso pode ser especificado várias vezes e o arquivo mais à direita terá precedência.

--set

Especifique as configurações alternativas na linha de comando.

Por exemplo, para alterar o valor padrão de debug , execute o seguinte comando onde 100.2506.0 Esta é a versão do Trident que você está instalando:

helm install <name> netapp-trident/trident-operator --version 100.2506.0  --create-namespace --namespace trident --set tridentDebug=true

Para adicionar o valor nodePrep, execute o seguinte comando:

helm install <name> netapp-trident/trident-operator --version 100.2506.0  --create-namespace --namespace trident --set nodePrep={iscsi}

Opções de configuração

Esta tabela e a values.yaml O arquivo, que faz parte do gráfico Helm, fornece a lista de chaves e seus valores padrão.

Não remova a afinidade padrão do arquivo values.yaml. Quando você quiser fornecer uma afinidade personalizada, estenda a afinidade padrão.

Opção Descrição Padrão

nodeSelector

Rótulos de nós para atribuição de pods

podAnnotations

Anotações de pods

deploymentAnnotations

Anotações de implantação

tolerations

Tolerâncias para atribuição de pods

affinity

Afinidade pela atribuição de cápsulas

affinity:
  nodeAffinity:
    requiredDuringSchedulingIgnoredDuringExecution:
      nodeSelectorTerms:
        - matchExpressions:
            - key: kubernetes.io/arch
              operator: In
              values:
              - arm64
              - amd64
            - key: kubernetes.io/os
              operator: In
              values:
              - linux

Não remova a afinidade padrão do arquivo values.yaml. Quando você quiser fornecer uma afinidade personalizada, estenda a afinidade padrão.

tridentControllerPluginNodeSelector

Seletores de nós adicionais para pods. Consulte "Entendendo os pods do controlador e os pods do nó" para mais detalhes.

tridentControllerPluginTolerations

Substitui as tolerâncias do Kubernetes para pods. Consulte "Entendendo os pods do controlador e os pods do nó" para mais detalhes.

tridentNodePluginNodeSelector

Seletores de nós adicionais para pods. Consulte "Entendendo os pods do controlador e os pods do nó" para mais detalhes.

tridentNodePluginTolerations

Substitui as tolerâncias do Kubernetes para pods. Consulte "Entendendo os pods do controlador e os pods do nó" para mais detalhes.

imageRegistry

Identifica o registro para o trident-operator , trident e outras imagens. Deixe em branco para aceitar o valor padrão. IMPORTANTE: Ao instalar o Trident em um repositório privado, se você estiver usando o imageRegistry Para especificar a localização do repositório, não use a opção --change. /netapp/ no caminho do repositório.

imagePullPolicy

Define a política de extração de imagens para o trident-operator .

IfNotPresent

imagePullSecrets

Define os segredos de extração de imagens para o trident-operator , trident e outras imagens.

kubeletDir

Permite substituir a localização do host do estado interno do kubelet.

"/var/lib/kubelet"

operatorLogLevel

Permite definir o nível de registro do operador Trident para: trace , debug , info , warn , error , ou fatal .

"info"

operatorDebug

Permite definir o nível de registro do operador Trident como depuração.

true

operatorImage

Permite a substituição completa da imagem para trident-operator .

operatorImageTag

Permite sobrescrever a tag do trident-operator imagem.

tridentIPv6

Permite habilitar o Trident para funcionar em clusters IPv6.

false

tridentK8sTimeout

Substitui o tempo limite padrão de 180 segundos para a maioria das operações da API do Kubernetes (se diferente de zero, em segundos).

O tridentK8sTimeout Este parâmetro aplica-se apenas à instalação do Trident .

180

tridentHttpRequestTimeout

Substitui o tempo limite padrão de 90 segundos para as solicitações HTTP, com 0s sendo uma duração infinita para o tempo limite. Valores negativos não são permitidos.

"90s"

tridentSilenceAutosupport

Permite desativar o relatório periódico do AutoSupport do Trident .

false

tridentAutosupportImageTag

Permite substituir a tag da imagem para o contêiner Trident AutoSupport .

<version>

tridentAutosupportProxy

Permite que o contêiner Trident AutoSupport se comunique com servidores externos através de um proxy HTTP.

tridentLogFormat

Define o formato de registro do Trident.(text ou json ).

"text"

tridentDisableAuditLog

Desativa o registrador de auditoria do Trident .

true

tridentLogLevel

Permite definir o nível de registro do Trident para: trace , debug , info , warn , error , ou fatal .

"info"

tridentDebug

Permite definir o nível de registro do Trident para debug .

false

tridentLogWorkflows

Permite que fluxos de trabalho específicos do Trident sejam habilitados para registro de rastreamento ou supressão de logs.

tridentLogLayers

Permite que camadas específicas do Trident sejam ativadas para registro de rastreamento ou supressão de logs.

tridentImage

Permite a substituição completa da imagem para o Trident.

tridentImageTag

Permite sobrescrever a tag da imagem para o Trident.

tridentProbePort

Permite alterar a porta padrão usada para as sondagens de atividade/prontidão do Kubernetes.

windows

Permite a instalação do Trident em nós de trabalho Windows.

false

enableForceDetach

Permite ativar a função de desprendimento forçado.

false

excludePodSecurityPolicy

Exclui a política de segurança do pod do operador da criação.

false

nodePrep

Permite que o Trident prepare os nós do cluster Kubernetes para gerenciar volumes usando o protocolo de armazenamento de dados especificado. Atualmente, iscsi é o único valor suportado.

A partir do OpenShift 4.19, a versão mínima do Trident suportada para esse recurso é 25.06.1.

Implantar operador Trident usando Helm (modo offline)

Creating your file...

Informações críticas sobre o Trident 25.06

Implante o operador Trident e instale o Trident usando o Helm.

Passe os dados de configuração durante a instalação.

Opções de configuração