Compartilhar via

Tutorial: Instalar o Armazenamento de Contêineres do Azure para uso com o Serviço de Kubernetes do Azure

  • Artigo

O Armazenamento de Contêineres do Azure é um serviço de gerenciamento de volume, implantação e orquestração baseado em nuvem criado nativamente para contêineres. Neste tutorial, você criará um cluster do Serviço de Kubernetes do Azure (AKS) e instalará a versão de produção mais recente do Armazenamento de Contêineres do Azure no cluster. Se já tiver um cluster AKS implantado, recomendamos a instalação do Armazenamento de Contêiner do Azure utilizando esse Início Rápido em vez de seguir os passos manuais nesse tutorial.

Importante

O Armazenamento de Contêineres do Azure agora está em disponibilidade geral (GA) a partir da versão 1.1.0. A versão em GA é recomendada para cargas de trabalho de produção.

  • Criar um grupo de recursos
  • Escolha uma opção de armazenamento de dados e um tipo de VM
  • Criar um cluster AKS
  • Conectar-se ao cluster
  • Rotular o pool de nós
  • Atribuir a função de Operador de Armazenamento de Contêiner do Azure à identidade gerida pela AKS
  • Instalar o Armazenamento de Contêiner do Azure

Pré-requisitos

  • Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

  • Este artigo requer a versão mais recente (2.35.0 ou posterior) da CLI do Azure. Consulte Como instalar a CLI do Azure. Se você estiver usando o ambiente Bash no Azure Cloud Shell, a versão mais recente já estará instalada. Se você planeja executar os comandos localmente em vez de no Azure Cloud Shell, certifique-se de executá-los com privilégios administrativos. Para obter mais informações, confira Introdução ao Azure Cloud Shell.

  • Você precisará do cliente de linha de comando do Kubernetes, kubectl. Ele já está instalado se você estiver usando o Azure Cloud Shell ou se você puder instalá-lo localmente executando o comando az aks install-cli.

  • Verifique se a região de destino tem suporte nas regiões do Armazenamento de Contêineres do Azure.

Introdução

  • Anote sua ID de assinatura do Azure. Se você quiser usar o Azure Elastic SAN como armazenamento de dados, precisará de uma função de Proprietário do Armazenamento de Contêiner do Azure ou da função Colaborador do Armazenamento de Contêiner do Azure atribuída à assinatura do Azure. O acesso no nível do proprietário permite que você instale a extensão de Armazenamento de Contêiner do Azure, permite acesso aos recursos de armazenamento e dá permissão para configurar o recurso Azure Elastic SAN. O acesso no nível de Colaborador permite que você instale a extensão e permita acesso aos recursos de armazenamento dela. Se você estiver planejando usar o Azure Disks ou o Disco Efêmero como armazenamento de dados, não precisará de permissões especiais em sua assinatura.

  • Inicie o Azure Cloud Shell, ou, se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login.

  • Se você estiver usando o Azure Cloud Shell, poderá ser solicitado a montar o armazenamento. Selecione a assinatura do Azure em que deseja criar a conta de armazenamento e selecione Criar.

Instale as extensões necessárias

Adicione ou atualize para a versão mais recente de k8s-extension executando o comando a seguir.

az extension add --upgrade --name k8s-extension

Definir o contexto da assinatura

Defina o contexto da sua assinatura do Azure usando o comando az account set. É possível exibir as IDs de assinatura de todas as assinaturas às quais você tem acesso executando o comando az account list --output table. Lembre-se de substituir <subscription-id> por sua ID de assinatura.

az account set --subscription <subscription-id>

Criar um grupo de recursos

Um grupo de recursos do Azure é um grupo lógico que contém os recursos do Azure que você pretende gerenciar como um grupo. Ao criar um grupo de recursos, você é solicitado a especificar um local. Essa localização é:

  • A localização de armazenamento dos metadados do grupo de recursos.
  • Onde seus recursos serão executados no Azure caso você não especifique outra região durante a criação de recursos.

Crie um grupo de recursos usando o comando az group create. Substitua <resource-group-name> pelo nome do grupo de recursos que você gostaria de criar e substitua <location> pela região do Azure, como lesteeua, lesteeua2, lesteeua3 ou oestedaeuropa.

az group create --name <resource-group-name> --location <location>

Se o grupo de recursos foi criado com sucesso, você verá uma saída semelhante a esta:

{
  "id": "/subscriptions/<guid>/resourceGroups/myContainerStorageRG",
  "location": "eastus",
  "managedBy": null,
  "name": "myContainerStorageRG",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null
}

Escolha uma opção de armazenamento de dados e um tipo de máquina virtual

Antes de criar o cluster, você deve entender qual opção de armazenamento de back-end você escolherá para criar o pool de armazenamento. Isso ocorre porque diferentes serviços de armazenamento funcionam melhor com diferentes tipos de máquina virtual (VM) como nós de cluster, de modo que você implantará o cluster antes de criar o pool de armazenamento.

Opções de armazenamento de dados

  • Azure Elastic SAN: O Azure Elastic SAN é uma boa opção para bancos de dados de uso geral, serviços de mensagens e streaming, ambientes de CD/CI e outras cargas de trabalho de camada 1/2. O armazenamento é provisionado sob demanda por volume criado e instantâneo do volume. Vários clusters podem acessar uma única SAN simultaneamente; no entanto, volumes persistentes só podem ser anexados por um consumidor de cada vez.

  • Discos do Azure: os discos do Azure são adequados para bancos de dados como MySQL, MongoDB e PostgreSQL. O armazenamento é provisionado de acordo com o tamanho do pool de armazenamento do contêiner de destino e o tamanho máximo do volume.

  • Disco Efêmero: essa opção usa unidades de SSD temporário ou de NVMe local nos nós do AKS e é extremamente sensível à latência (latência baixa de sub-ms), por isso é melhor para aplicativos sem requisitos de durabilidade de dados ou com suporte interno à replicação de dados, como o Cassandra. O AKS descobre o armazenamento efêmero disponível nos nós do AKS e adquire as unidades para a implantação do volume.

Consumo de recursos

O Armazenamento de Contêineres do Azure requer determinados recursos de nó para executar componentes para o serviço. Com base na seleção de tipo de pool de armazenamento, que você especificará ao instalar o Armazenamento de Contêineres do Azure, esses são os recursos que serão consumidos:

Tipo de pool de armazenamento Núcleos de CPU RAM
Azure Elastic SAN  Nenhum Nenhum
Discos do Azure 1 1 GiB
Disco Efêmero – Temp SSD 1 1 GiB
Disco Efêmero - NVMe local (camada padrão) 25% dos núcleos (a camada de desempenho pode ser atualizada)* 1 GiB

Os recursos consumidos são por nó e serão consumidos para cada nó no pool de nós em que o Armazenamento de Contêineres do Azure será instalado. Se os nós não tiverem recursos suficientes, o Armazenamento de Contêineres do Azure não será executado. O Kubernetes tentará automaticamente inicializar esses pods com falha, portanto, se os recursos forem liberados, esses pods poderão ser inicializados novamente.

*Em um pool de armazenamento do tipo Disco Efêmero - NVMe Local com o nível de desempenho padrão, se você estiver usando vários tipos de SKU de VM para seus nós do cluster, os 25% dos núcleos de CPU consumidos se aplicam ao menor SKU utilizado. Por exemplo, se você estiver usando uma combinação de tipos de VM de 8 núcleos e 16 núcleos, o consumo de recursos será de dois núcleos. Você pode atualizar a camada de desempenho para usar uma porcentagem maior de núcleos e obter mais IOPS.

Verifique se o tipo de VM do cluster atende aos critérios a seguir

Para usar o Armazenamento de Contêineres do Azure, você precisará de um pool de nós de pelo menos três VMs Linux. Cada VM deve ter no mínimo quatro CPUs virtuais (vCPUs). O Armazenamento de Contêineres do Azure consumirá um núcleo para o processamento de E/S em cada VM em que a extensão for implantada.

Siga essas diretrizes ao escolher um tipo de VM para os nós de cluster. Você deve escolher um tipo de VM que dê suporte ao armazenamento premium do Azure.

Criar um novo cluster do AKS e instalar o Armazenamento de Contêineres do Azure

Se você já tiver um cluster do AKS implantado, siga as instruções de instalação neste Início Rápido.

Execute o comando a seguir para criar um novo cluster do AKS, instalar o Armazenamento de Contêineres do Azure e criar um pool de armazenamento. Substitua <cluster-name> e <resource-group> especifique qual tipo de VM você deseja usar. Substitua <storage-pool-type> por azureDisk, ephemeralDisk ou elasticSan. Se você selecionar ephemeralDisk, também deverá especificar --storage-pool-option e os valores podem ser NVMe ou Temp.

A execução desse comando habilitará o Armazenamento de Contêineres do Azure no pool de nós do sistema* com três VMs do Linux. Se você estiver especificando o NVMe local para o tipo de pool de armazenamento, certifique-se de definir a contagem de nós para 4 ou mais, ou o comando falhará ao ser executado.

Por padrão, o pool de nós do sistema é nomeado nodepool1. Se você quiser habilitar o Armazenamento de Contêineres do Azure em outros pools de nós, consulte Instalar o Armazenamento de Contêineres do Azure em pools de nós específicos. Se você quiser especificar parâmetros de pool de armazenamento adicionais com este comando, consulte essa tabela.

*Se houver pools de nós existentes com o rótulo acstor.azure.com/io-engine:acstor, o Armazenamento de Contêineres do Azure instalará os componentes do plano de dados por padrão. Caso contrário, os usuários têm a opção de passar o pool de nós preferencial para acstor através da CLI do Azure. Se o cluster tiver apenas o pool de nós do sistema, ele será rotulado e usado para o Armazenamento de Contêineres do Azure por padrão. É importante observar que apenas os componentes do plano de dados serão restritos ao pool de nós rotulado. Os componentes do painel de controle do Armazenamento de Contêineres do Azure não estão limitados aos nós rotulados e podem ser instalados no pool de nós do sistema também.

az aks create -n <cluster-name> -g <resource-group> --node-vm-size Standard_D4s_v3 --node-count 3 --enable-azure-container-storage <storage-pool-type> --generate-ssh-keys

A implantação levará de 10 a 15 minutos. Quando ele for concluído, você terá um cluster do AKS com o Armazenamento de Contêineres do Azure instalado, os componentes do tipo de pool de armazenamento escolhido habilitados e um pool de armazenamento padrão. Se você quiser habilitar tipos de pool de armazenamento adicionais para criar pools de armazenamento adicionais, consulte Habilitar tipos de pool de armazenamento adicionais.

Importante

Se você especificou Azure Elastic SAN como armazenamento de apoio para seu pool de armazenamento e não tem atribuída à assinatura do Azure a função de Proprietário de Armazenamento de Contêiner do Azure ou Colaborador de Armazenamento de Contêiner do Azure, a instalação do Armazenamento de Contêiner do Azure falhará e um pool de armazenamento não será criado. Se você tentar habilitar o Azure Elastic SAN como um tipo adicional de pool de armazenamento sem qualquer uma dessas funções, sua instalação anterior e pools de armazenamento permanecerão inalterados e um pool de armazenamento Elastic SAN não será criado.

Exibir pools de armazenamento disponíveis

Para obter a lista de pools de armazenamento disponíveis, execute o seguinte comando:

kubectl get sp -n acstor

Para verificar o status de um pool de armazenamento, execute o seguinte comando:

kubectl describe sp <storage-pool-name> -n acstor

Se o valor Message não for disserStoragePool is ready, o pool de armazenamento ainda estará criando ou encontrando um problema. Consulte Solucionar problemas do Armazenamento de Contêineres do Azure.

Próxima etapa

Selecione o link para o tipo de armazenamento de apoio que você selecionou e siga as instruções para criar volumes.