Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

Habilitando Recursos Experimentais

O Rancher inclui algumas funcionalidades que são experimentais e desativadas por padrão. Você pode querer habilitar essas funcionalidades, por exemplo, se decidir que os benefícios de usar um tipo de armazenamento não suportado superam o risco de usar uma funcionalidade não testada. As flags de funcionalidade foram introduzidas para permitir que você experimente essas funcionalidades que não estão habilitadas por padrão.

As funcionalidades podem ser habilitadas de três maneiras:

Cada funcionalidade tem dois valores:

  • Um valor padrão, que pode ser configurado com uma flag ou variável de ambiente a partir da linha de comando

  • Um valor definido, que pode ser configurado com a API ou com a interface do Rancher

Se nenhum valor tiver sido definido, o Rancher usa o valor padrão.

Como a API define o valor real e a linha de comando define o valor padrão, isso significa que se você habilitar ou desabilitar uma funcionalidade com a API ou com a interface do Rancher, isso irá sobrescrever qualquer valor definido pela linha de comando.

Por exemplo, se você instalar o Rancher, então definir uma flag de funcionalidade como verdadeira com a API do Rancher, e depois fazer upgrade do Rancher com um comando que define a flag de funcionalidade como falsa, o valor padrão ainda será falso, mas a funcionalidade ainda estará habilitada porque foi definida com a API do Rancher. Se você então deletar o valor definido (verdadeiro) com a API do Rancher, definindo-o como NULL, o valor padrão (falso) entrará em vigor. Veja a página de flags de funcionalidade para mais informações.

Habilitando Funcionalidades ao Iniciar o Rancher

Ao instalar o Rancher, ative a funcionalidade desejada com uma flag de funcionalidade. O comando é diferente dependendo se você está instalando o Rancher em um único nó ou se está fazendo uma instalação do Rancher no Kubernetes.

Ativando Funcionalidades para Instalações no Kubernetes

Os valores definidos pela API do Rancher substituirão o valor passado pela linha de comando.

Ao instalar o Rancher com um Helm chart, use a opção --set. No exemplo abaixo, duas funcionalidades são ativadas passando os nomes das flags de funcionalidade em uma lista separada por vírgulas:

helm install rancher rancher-prime/rancher \
  --namespace cattle-system \
  --set hostname=rancher.my.org \
  --set 'extraEnv[0].name=CATTLE_FEATURES'
  --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true'

Ativando Funcionalidades para Instalações em Air Gap

Para realizar uma instalação em air gap do Rancher, adicione um repositório de Helm charts e baixe um Helm chart, em seguida, instale o Rancher com o Helm.

Ao instalar o Helm chart, você deve passar os nomes das flags de funcionalidade em uma lista separada por vírgulas, como no seguinte exemplo:

helm install rancher ./rancher-<VERSION>.tgz \
  --namespace cattle-system
  --set hostname=<RANCHER.YOURDOMAIN.COM> \
  --set image.registry=<REGISTRY.YOURDOMAIN.COM:PORT> \
  --set ingress.tls.source=secret \
  --set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \ # Set a default private registry to be used in Rancher
  --set useBundledSystemChart=true # Use the packaged Rancher system charts
  --set 'extraEnv[0].name=CATTLE_FEATURES'
  --set 'extraEnv[0].value=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true'

Ativando Funcionalidades para Instalações com Docker

Ao instalar o Rancher com Docker, use a opção --features. No exemplo abaixo, duas funcionalidades são ativadas passando os nomes das flags de funcionalidade em uma lista separada por vírgulas:

docker run -d -p 80:80 -p 443:443 \
  --restart=unless-stopped \
  rancher/rancher:rancher-latest \
  --features=<FEATURE-FLAG-NAME-1>=true,<FEATURE-FLAG-NAME-2>=true

Ativando Funcionalidades com a Interface do Usuário do Rancher

  1. No canto superior esquerdo, clique em ☰ > Configurações Globais.

  2. Clique em Flags de Funcionalidade.

  3. Para ativar uma funcionalidade, vá até a funcionalidade desativada que você deseja ativar e clique em ⋮ > Ativar.

Resultado: A funcionalidade está ativada.

Desativando Funcionalidades com a Interface do Usuário do Rancher

  1. No canto superior esquerdo, clique em ☰ > Configurações Globais.

  2. Clique em Flags de Funcionalidade. Você verá uma lista de funcionalidades experimentais.

  3. Para desativar uma funcionalidade, vá até a funcionalidade ativada que você deseja desativar e clique em ⋮ > Desativar.

Resultado: A funcionalidade está desativada.

Ativando Funcionalidades com a API do Rancher

  1. Consulte a <RANCHER-SERVER-URL>/v3/features.

  2. Na seção data, você verá um array contendo todas as funcionalidades que podem ser ativadas com flags de funcionalidade. O nome da funcionalidade está no campo id. Clique no nome da funcionalidade que você deseja ativar.

  3. No canto superior esquerdo da tela, sob Operações, clique em Editar.

  4. No menu suspenso Valor, clique em Verdadeiro.

  5. Clique em Mostrar Requisição.

  6. Clique em Enviar Requisição.

  7. Clique em Fechar.

Resultado: A funcionalidade está ativada.

Desativando Funcionalidades com a API do Rancher

  1. Consulte a <RANCHER-SERVER-URL>/v3/features.

  2. Na seção data, você verá um array contendo todas as funcionalidades que podem ser ativadas com flags de funcionalidade. O nome da funcionalidade está no campo id. Clique no nome da funcionalidade que você deseja ativar.

  3. No canto superior esquerdo da tela, sob Operações, clique em Editar.

  4. No menu suspenso Valor, clique em Falso.

  5. Clique em Mostrar Requisição.

  6. Clique em Enviar Requisição.

  7. Clique em Fechar.

Resultado: A funcionalidade está desativada.