Criar um Cluster

🖥️ Console

👣 Inicio > Menu > Kubernetes

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

1. Escolha um nome único para o seu Cluster. O nome do Cluster digitado será validado e caso o nome desejado não esteja mais disponível, não será permitido criar o Cluster.

2. Escolha a versão de Kubernetes deseja:

   • É recomendado a escolha da versão da mais recente;
   • Todas as versões suportadas serão exibidas abaixo.

3. É necessário escolher a região de hospedagem convenientemente.

4. Escolha um nome único para o primeiro node pool do Cluster. O nome do node pool digitado será validado e caso o nome desejado não esteja mais disponível, não será permitido criar o Cluster.

>_ CLI

Visão Geral

O comando mgc kubernetes cluster create é utilizado para criar um novo cluster Kubernetes com diversas configurações personalizáveis. O comando oferece opções para configurar o acesso à rede, pools de nós, versões do Kubernetes e outros parâmetros do cluster.

Sintaxe do Comando

mgc kubernetes cluster create [flags]

Exemplos

Exemplo Básico

mgc kubernetes cluster create --allowed-cidrs='["192.168.1.0/24","10.0.0.0/16"]' --description="Este é um cluster exemplo." --enabled-bastion=false --enabled-server-group=false --name="cluster-exemplo" --node-pools='[{"auto_scale":{"max_replicas":5,"min_replicas":2},"flavor":"cloud-k8s.gp1.small","name":"nodepool-exemplo","replicas":3,"tags":["tag-valor1"],"taints":[{"effect":"NoSchedule","key":"exemplo-key","value":"valor1"}]}]' --param.version="v1.30.2"

Flags

Flag	Tipo	Descrição	Exemplo de Uso
--allowed-cidrs	array(string)	Lista de blocos CIDR permitidos para acesso ao servidor da API.	--allowed-cidrs='["192.168.1.0/24","10.0.0.0/16"]'
--cli.list-links	enum[string]	Define o formato de saída dos links do comando. Pode ser "json", "table" ou "yaml".	--cli.list-links=json
--description	string	Descrição breve do cluster Kubernetes.	--description="Este é um cluster exemplo."
--enabled-bastion	boolean (Descontinuado)	Flag descontinuada que não tem efeito atualmente. Era utilizada para habilitar o uso de um host bastion para acesso seguro ao cluster.	--enabled-bastion=false
--enabled-server-group	boolean	Habilita o uso de um grupo de servidores com política de anti-afinity durante a criação do cluster e seus pools de nós.	--enabled-server-group=true
-h, --help		Exibe informações de ajuda sobre o comando create.	--help
--name	string	Nome do cluster Kubernetes. O nome deve ser único dentro de um namespace e seguir as regras de formatação.	--name="cluster-exemplo"
--node-pools	array(object)	Define os pools de nós do cluster Kubernetes.	--node-pools='[{"flavor":"cloud-k8s.gp1.small","name":"nodepool-exemplo","replicas":3}]'
--param.version	string	Versão do Kubernetes a ser utilizada no cluster, no formato "vX.Y.Z".	--param.version="v1.30.2"
-v, --version		Exibe a versão do comando create.	--version

Exemplos de Configuração de Node Pool

A opção --node-pools permite definir a configuração dos pools de nós dentro do cluster. Abaixo estão exemplos em formato JSON:

Exemplo sem Autoscale

[{
  "flavor": "cloud-k8s.gp1.small",
  "name": "nodepool-exemplo",
  "replicas": 3,
  "tags": ["tag-valor1"],
  "taints": [{
    "effect": "NoSchedule",
    "key": "exemplo-key",
    "value": "valor1"
  }]
}]

Exemplo com Autoscale

[{
  "auto_scale": {
    "max_replicas": 5,
    "min_replicas": 2
  },
  "flavor": "cloud-k8s.gp1.small",
  "name": "nodepool-exemplo",
  "replicas": 3,
  "tags": ["tag-valor1"],
  "taints": [{
    "effect": "NoSchedule",
    "key": "exemplo-key",
    "value": "valor1"
  }]
}]

• auto_scale: Quando o autoscale está habilitado, o Kubernetes ajusta automaticamente o número de réplicas entre os valores de min_replicas e max_replicas. No exemplo acima, o número de réplicas pode variar entre 2 e 5.
• flavor: Define o tipe da instância. No exemplo acima, foi usado o flavor cloud-k8s.gp1.small.
• name: Nome do node pool.
• replicas: Numero de réplicas do pool.
• tags: Tags associadas ao node pool.
• taints: A opção taints permite restringir quais pods podem ser agendados em um determinado nó, com base nas configurações de taint definidas.

Notas Importantes

• Número mínimo de réplicas: O valor mínimo de réplicas (replicas) e (min_replicas) pode ser 0, permitindo que o node pool seja reduzido a zero réplicas, caso necessário.

Para uma configuração detalhada use a flag --node-pools=help.