Sobre os Modelos RKE1

Os modelos RKE podem ser criados na interface do Rancher ou definidos em formato YAML. Eles podem definir todos os mesmos parâmetros que podem ser especificados quando você usa o Rancher para provisionar nós personalizados ou nós de um provedor de infraestrutura:

A seção de complemento de um modelo RKE é especialmente poderosa porque permite uma ampla gama de opções de personalização.

Os modelos RKE são suportados para clusters provisionados pelo Rancher. Os modelos podem ser usados para provisionar clusters personalizados ou clusters que são lançados por um provedor de infraestrutura.

Os modelos RKE servem para definir configurações do Kubernetes e do Rancher. Os modelos de nó são responsáveis por configurar nós. Para dicas sobre como usar modelos RKE em conjunto com hardware, consulte Modelos RKE e Hardware.

Modelos RKE podem ser criados do zero para pré-definir a configuração do cluster. Eles podem ser aplicados para lançar novos clusters, ou os modelos também podem ser exportados de clusters existentes em execução.

As configurações de um cluster existente podem ser salvas como um modelo RKE. Isso cria um novo modelo e vincula as configurações do cluster ao modelo, de modo que o cluster só pode ser atualizado se o modelo for atualizado, e o cluster é atualizado para usar uma versão mais recente do modelo. O novo modelo também pode ser usado para criar novos clusters.

Quando uma organização tem usuários básicos e avançados do Rancher, os administradores podem querer dar aos usuários avançados mais opções para a criação de clusters, enquanto restringem as opções para os usuários básicos.

Esses cenários de exemplo descrevem como uma organização poderia usar modelos para padronizar a criação de clusters.

Alguns dos cenários de exemplo incluem o seguinte:

Quando você cria um modelo RKE, ele está disponível na interface do Rancher na visualização de Gerenciamento de Cluster sob Modelos RKE. Ao criar um modelo, você se torna o proprietário do modelo, o que lhe dá permissão para revisar e compartilhar o modelo. Você pode compartilhar os modelos RKE com usuários ou grupos específicos, e também pode torná-los públicos.

Os administradores podem ativar a aplicação de modelos para exigir que os usuários sempre utilizem modelos RKE ao criar um cluster. Isso permite que os administradores garantam que o Rancher sempre provisiona clusters com configurações específicas.

As atualizações de modelos RKE são gerenciadas por meio de um sistema de revisões. Se você quiser alterar ou atualizar um modelo, deve criar uma nova revisão do modelo. Então, um cluster que foi criado com a versão anterior do modelo pode fazer upgrade para a nova revisão do modelo.

Em um modelo RKE, as configurações podem ser restritas ao que o proprietário do modelo escolher, ou podem estar abertas para o usuário final selecionar o valor. A diferença é indicada pelo botão Permitir Sobrescrita do Usuário sobre cada configuração na interface do Rancher quando o modelo é criado.

Para as configurações que não podem ser sobrescritas, o usuário final não poderá editá-las diretamente. Para que um usuário tenha diferentes opções dessas configurações, um proprietário de modelo RKE precisaria criar uma nova revisão do modelo RKE, o que permitiria ao usuário atualizar e alterar essa opção.

Os documentos nesta seção explicam os detalhes da gestão de modelos RKE:

Um exemplo de arquivo de configuração YAML para um template é fornecido como referência.

Você pode criar um cluster a partir de um template que você criou, ou de um template que foi compartilhado com você.

Se o proprietário do template RKE criar uma nova revisão do template, você pode fazer upgrade do seu cluster para essa revisão.

Templates RKE podem ser criados do zero para pré-definir a configuração do cluster. Eles podem ser aplicados para lançar novos clusters, ou os templates também podem ser exportados de clusters existentes em execução.

Você pode salvar a configuração de um cluster existente como um RKE template. Assim, as configurações do cluster só podem ser alteradas se o template for atualizado.

Os templates RKE são projetados para padronizar as configurações do Kubernetes e do Rancher. Se você também quiser padronizar sua infraestrutura, uma opção é usar templates RKE em conjunto com outras ferramentas.

Outra opção é usar templates de cluster, que incluem opções de configuração de pool de nós, mas não impõem a configuração.

Se você definir um template RKE como um arquivo YAML, pode modificar este exemplo de YAML de template RKE. O YAML no template RKE usa a mesma personalização que o Rancher usa ao criar um cluster RKE, mas como o YAML está localizado dentro do contexto de um cluster provisionado pelo Rancher, você precisará aninhar a personalização do template RKE sob a diretiva rancher_kubernetes_engine_config no YAML.

A documentação do RKE também possui arquivos anotados cluster.yml que você pode usar como referência.

Para orientações sobre as opções disponíveis, consulte a documentação do RKE sobre configuração de cluster.