Criar um Cluster
- 🖥️ Console
- >_ CLI
Na página de Kubernetes, clique no botão para Criar Cluster.
-
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.
-
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.
-
É necessário escolher a região de hospedagem convenientemente.
-
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.
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 demin_replicas
emax_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 flavorcloud-k8s.gp1.small
.name
: Nome do node pool.replicas
: Numero de réplicas do pool.tags
: Tags associadas ao node pool.taints
: A opçãotaints
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
.