Início Rápido

Pré-requisitos

• Ter uma conta criada na Magalu Cloud.
• Realizar o download e a configuração do MGC CLI.
• Instalar o kubectl.

Criar um Cluster

🖥️ Console

Na página do produto de Kubernetes, clique no botão Criar Cluster.

1. Escolha a versão de Kubernetes desejada.
2. Escolha um nome único para o seu Node Pool de acordo com as regras de nomenclatura.
3. Caso deseje, escolha a opção para utilizar máquinas virtuais com GPU.
4. Escolha o tipo de instância para o Node Pool.
5. Escolha a quantidade de Nodes para o Node Pool, sendo um número fixo ou com Autoscaling.
6. Escolha um nome único para o seu Cluster de acordo com as regras de nomenclatura.
7. Clique no botão Criar Cluster.

Aguarde até que o status do Cluster seja Criado.

>_ CLI

1. No seu terminal, use o comando mgc kubernetes cluster create para criar um Cluster. O comando abaixo cria um Cluster com um Node Pool de tamanho fixo, mas o parâmetro é opcional, Node Pools podem ser criados posteriormente. Utilize um nome de acordo com as regras de nomenclatura:

mgc kubernetes cluster create \
  --name meu-cluster \
  --node-pools '[{"flavor": "BV4-8-40", "name": "nodepool01", "replicas": 3}]'

id: d4fbcfe5-6255-4036-989a-9051fa1f158c
name: meu-cluster
status:
    message: preparing cluster creation
    state: Pending

Confira a documentação completa da MGC CLI aqui.

Listar Clusters

🖥️ Console

Na página do produto de Kubernetes é possível visualizar todos os Clusters.

Clique em um Cluster para mais informações.

>_ CLI

Para listar todos os Clusters associados à sua conta, utilize o comando abaixo:

mgc kubernetes cluster list

- cluster_ipv4_cidr: 192.168.0.0/16
  cni: calico
  created_at: "2025-11-18T13:53:54Z"
  description: ""
  id: 17027389-71ee-457f-827d-b69769cb086c
  machine_types_source: external
  name: meu-cluster
  platform:
      version: v3.0.0
  region: br-se1
  services_ipv4_cidr: 10.96.0.0/12
  status:
      message: modifying cluster
      state: Pending
  version: v1.32.3

Para informações detalhadas de um Cluster, utilize o comando mgc kubernetes cluster get <id> com o ID retornado do comando acima:

mgc kubernetes cluster get 17027389-71ee-457f-827d-b69769cb086c

allowed_cidrs: []
cluster_ipv4_cidr: 192.168.0.0/16
cni: calico
created_at: "2025-11-18T13:53:54Z"
description: ""
id: 17027389-71ee-457f-827d-b69769cb086c
machine_types_source: external
name: meu-cluster
node_pools:
- auto_scale:
      max_replicas: 3
      min_replicas: 3
  availability_zones:
  - c
  - b
  - a
  created_at: "2025-11-18T13:53:54Z"
  id: 4c6b4cf7-8931-4ed9-a81c-f0e4a2d84486
  instance_template:
      disk_size: 0
      disk_type: ""
      flavor:
          id: 1388cc6e-ab99-4fac-9d77-5e4f43d6b51e
          name: BV4-8-40
          ram: 8192
          size: 40
          vcpu: 4
      node_image: ""
  labels: null
  max_pods_per_node: 110
  name: nodepool01
  replicas: 3
  status:
      messages:
      - initializing nodepool nodes
      state: Pending
  zone: null
platform:
    version: v3.0.0
region: br-se1
services_ipv4_cidr: 10.96.0.0/12
status:
    message: modifying cluster
    state: Pending
version: v1.32.3

Aguarde até que o Cluster esteja com state: Running para acessá-lo.

info

O resultado do comando acima pode ser diferente para outras versões do produto Kubernetes.

Acessar o Cluster

Clusters Kubernetes geralmente são gerenciados pelo usuário ou por uma ferramenta de automação através de arquivos kubeconfig. Esse arquivo pode ser facilmente baixado pelas ferramentes de clientes da MGC.

Para esse guia, instale o kubectl, a CLI oficial do Kubernetes, para acessar o Cluster. Verifique que versão utilizada da CLI está próxima da versão do Kubernetes. Por exemplo, o kubectl v1.31 pode se comunicar com as versões v1.30, v1.31 e v1.32 do Kubernetes.

Baixando o Arquivo kubeconfig

🖥️ Console

1. Na página de listagem do produto de Kubernetes, selecione o Cluster desejado.
2. Clique em "Download" logo abaixo de "Arquivo de configuração".

>_ CLI

Para realizar o download do arquivo kubeconfig via CLI, utilize o comando abaixo com o ID do Cluster desejado:

mgc kubernetes cluster kubeconfig --cluster-id <id> --raw

Você também pode escrever o conteúdo diretamente em um arquivo:

mgc kubernetes cluster kubeconfig --cluster-id <id> --raw > meu-cluster.kubeconfig

Acessando o Cluster com kubectl

No terminal, exporte o caminho do arquivo na variável de ambiente KUBECONFIG:

export KUBECONFIG=/caminho/do/arquivo/meu-cluster.kubeconfig

Por último, teste o acesso:

kubectl get pod

No resources found in default namespace.

info

O certificado associado ao arquivo kubeconfig expira em um ano e é renovado automaticamente, sendo necessário realizar o download de um novo arquivo kubeconfig para garantir o acesso ao Cluster. Fique atento ao prazo de expiração para evitar interrupções no uso.

Excluir um Cluster

🖥️ Console

1. Na página do produto de Kubernetes, clique no ícone de gerenciamento do Cluster do canto direto e clique em "Excluir".
2. Confirme a exclusão do Cluster reescrevendo seu nome da tela seguinte.

>_ CLI

Utilize o comando abaixo para excluir um Cluster Kubernetes e selecione Yes:

mgc kubernetes cluster delete <id>

This action cannot be undone. Proceed? Yes
✅ Operation executed successfully

Atenção

warning

A ação de exclusão do Cluster irá excluir de maneira irrecuperável todos os recursos relacionados ao Cluster Kubernetes, incluindo Node Pools e qualquer carga produtiva. Esta ação é irreversível.

warning

O Load Balancer de Control Plane é excluído juntamente com o Cluster.

warning

Os Load Balancers de Serviço precisam ser excluídos manualmente após a remoção do Cluster, caso não sejam exlcuídos previamente.