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.

Instalando SUSE Rancher Prime em um Cluster do Google Kubernetes Engine

Nesta seção, você aprenderá como instalar o Rancher usando o Google Kubernetes Engine.

Se você já tem um cluster Kubernetes GKE, pule para a etapa sobre instalar um ingress. Em seguida, instale o gráfico Helm do Rancher seguindo as instruções nesta página.

Pré-requisitos

  • Você precisará de uma conta do Google.

  • Você precisará de uma conta de faturamento do Google Cloud. Você pode gerenciar suas contas de faturamento na nuvem usando o Google Cloud Console. Para mais informações sobre o Cloud Console, visite Guia geral para o console.

  • Você precisará de uma cota de nuvem para pelo menos um endereço IP em uso e pelo menos 2 CPUs. Para mais detalhes sobre os requisitos de hardware para o servidor Rancher, consulte esta seção.

1. Ative a API do Kubernetes Engine

Siga os seguintes passos para ativar a API do Kubernetes Engine:

  1. Visite a Página do Kubernetes Engine no Google Cloud Console.

  2. Crie ou selecione um projeto.

  3. Abra o projeto e ative a API do Kubernetes Engine para o projeto. Aguarde a ativação da API e dos serviços relacionados. Isso pode levar alguns minutos.

  4. Certifique-se de que a cobrança está ativada para seu projeto na nuvem. Para informações sobre como ativar a cobrança para seu projeto, consulte a documentação do Google Cloud.

2. Abra o Cloud Shell

O Cloud Shell é um ambiente de shell para gerenciar recursos hospedados no Google Cloud. O Cloud Shell vem pré-instalado com a ferramenta de linha de comando gcloud e a ferramenta de linha de comando kubectl. A ferramenta gcloud fornece a interface de linha de comando principal para o Google Cloud, e kubectl fornece a interface de linha de comando principal para executar comandos contra clusters Kubernetes.

As seções a seguir descrevem como iniciar o Cloud Shell a partir do Google Cloud Console ou da sua estação de trabalho local.

Cloud Shell

Para iniciar o shell a partir do Google Cloud Console,, vá para o canto superior direito do console e clique no botão do terminal. Ao passar o mouse sobre o botão, ele é rotulado como Ativar Cloud Shell.

Shell Local

Para instalar gcloud e kubectl, execute as seguintes etapas:

  1. Instale o Cloud SDK seguindo estas etapas. O Cloud SDK inclui a ferramenta de linha de comando gcloud. As etapas variam com base no seu sistema operacional.

  2. Após instalar o Cloud SDK, instale a ferramenta de linha de comando kubectl executando o seguinte comando:

     gcloud components install kubectl

    Em uma etapa posterior, kubectl será configurado para usar o novo cluster GKE.

  3. Instale o Helm 3 se ainda não estiver instalado.

  4. Ative o suporte experimental do Helm para imagens OCI com a variável HELM_EXPERIMENTAL_OCI. Adicione a seguinte linha a ~/.bashrc (ou ~/.bash_profile no macOS, ou onde quer que seu shell armazene variáveis de ambiente):

     export HELM_EXPERIMENTAL_OCI=1

  5. Execute o seguinte comando para carregar seu arquivo .bashrc atualizado:

     source ~/.bashrc

    Se você estiver usando macOS, use este comando:

     source ~/.bash_profile

3. Configure o gcloud CLI

Configure as configurações padrão do gcloud usando um dos seguintes métodos:

  • Usando gcloud init, se você quiser ser guiado na configuração de padrões.

  • Usando gcloud config, para definir individualmente seu ID de projeto, zona e região.

  • Usando gcloud init

  • Usando gcloud config

  1. Execute gcloud init e siga as instruções:

      gcloud init

    Se você estiver usando SSH em um servidor remoto, use a flag --console-only para evitar que o comando inicie um navegador:

      gcloud init --console-only

  2. Siga as instruções para autorizar o gcloud a usar sua conta do Google Cloud e selecione o novo projeto que você criou.

4. Confirme que o gcloud está configurado corretamente

Execute:

gcloud config list

A saída deve se assemelhar ao seguinte:

[compute]
region = us-west1 # Your chosen region
zone = us-west1-b # Your chosen zone
[core]
account = <Your email>
disable_usage_reporting = True
project = <Your project ID>

Your active configuration is: [default]

5. Crie um Cluster GKE

O seguinte comando cria um cluster de três nós.

Substitua cluster-name pelo nome do seu novo cluster.

Ao escolher uma versão do Kubernetes, certifique-se de consultar primeiro a matriz de suporte para encontrar a versão mais alta do Kubernetes que foi validada para a sua versão do Rancher.

Para criar com sucesso um cluster GKE com o Rancher, seu GKE deve estar no modo Padrão. O GKE tem dois modos de operação ao criar um cluster Kubernetes, Modo Autopilot e Modo Padrão. A configuração do cluster para o modo Autopilot tem restrições na edição do namespace kube-system. No entanto, o Rancher precisa criar recursos no namespace kube-system durante a instalação. Como resultado, você não poderá instalar o Rancher em um cluster GKE criado no modo Autopilot. Para mais informações sobre a diferença entre o modo Autopilot do GKE e o modo Padrão, visite Compare GKE Autopilot e Padrão.

gcloud container clusters create cluster-name --num-nodes=3 --cluster-version=<VERSION>

6. Obtenha Credenciais de Autenticação

Após criar seu cluster, você precisa obter credenciais de autenticação para interagir com o cluster:

gcloud container clusters get-credentials cluster-name

Este comando configura kubectl para usar o cluster que você criou.

7. Instalar um Ingress

O cluster precisa de um Ingress para que o Rancher possa ser acessado de fora do cluster. Instalar um Ingress requer a alocação de um endereço IP público. Certifique-se de ter cota suficiente, caso contrário, não será possível atribuir o endereço IP. Os limites para endereços IP públicos são aplicáveis em nível regional por assinatura. Você pode usar um controlador de ingress gerenciado fornecido pelo GCP ou um controlador de ingress de terceiros como o Traefik.

Não é recomendado instalar um controlador de ingress de terceiros, como o Traefik, se um controlador de ingress gerenciado já estiver sendo usado.

Ingress-NGINX EOL: O controlador ingress-nginx da comunidade atinge o fim do serviço (EOL) em março de 2026. Esta página usa o Traefik, que é o caminho de migração recomendado para ambientes Rancher.

O Traefik inclui um provedor nativo do Ingress NGINX. Isso permite que você migre do NGINX sem reescrever seus objetos de Ingress existentes, pois o Traefik interpretará automaticamente as anotações nginx.ingress.kubernetes.io. Se você estiver atualizando um cluster que já está usando ingress-nginx, siga este guia para mais informações.

Para instalar o Traefik, recomendamos fortemente usar o aplicativo Traefik na Coleção de aplicativos Rancher Prime. Verifique a documentação para integrar com o Rancher Manager.

8. Obter IP do Balanceador de Carga

Para obter o endereço do balanceador de carga, execute:

kubectl get service traefik --namespace=traefik

O resultado deve ser semelhante ao seguinte:

NAME                       TYPE           CLUSTER-IP     EXTERNAL-IP                                                              PORT(S)
 AGE
traefik  LoadBalancer   10.0.116.18    40.31.180.83   80:31229/TCP,443:31050/TCP 27m

Salve o EXTERNAL-IP.

9. Configurar o DNS

O tráfego externo para o servidor Rancher precisará ser direcionado ao balanceador de carga que você criou.

Configure um DNS para apontar para o IP externo que você salvou. Este DNS será usado como a URL do servidor Rancher.

Existem muitas maneiras válidas de configurar o DNS. Para ajuda, consulte a documentação do Google Cloud sobre gerenciamento de registros DNS.

10. Instale o Helm chart do Rancher

Em seguida, instale o Helm chart do Rancher seguindo as instruções na esta página. As instruções do Helm são as mesmas para instalar o Rancher em qualquer distribuição Kubernetes.

Use o nome de DNS da etapa anterior como a URL do servidor Rancher ao instalar o Rancher. Ele pode ser passado como uma opção do Helm. Por exemplo, se o nome de DNS for rancher.my.org, você pode executar o comando de instalação do Helm com a opção --set hostname=rancher.my.org.

Ao instalar o Rancher nesta configuração, você também precisará definir o nome do controlador de ingress que será usado com o recurso de ingress do Rancher:

--set ingress.ingressClassName=traefik

Consulte aqui para o comando de instalação do Helm para a opção de certificado escolhida.

No Rancher v2.7.5, se você pretende usar o ingress padrão do GKE em seu cluster sem habilitar o modo de cluster nativo de VPC, você precisa definir a seguinte flag:

--set service.type=NodePort

Isso é necessário devido a problemas de compatibilidade entre esta configuração e o ClusterIP, o tipo padrão para cattle-system/rancher.