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

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. Use este tutorial para instalar a versão de produção mais recente do Armazenamento de Contêineres do Azure em um cluster do AKS (Serviço de Kubernetes do Azure), seja criando um novo cluster ou habilitando o serviço em uma implantação existente.

Se você preferir a versão de software livre do Armazenamento de Contêineres do Azure, visite o repositório local-csi-driver para obter instruções de instalação alternativas.

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.77.0 ou posterior) da CLI do Azure. Consulte Como instalar a CLI do Azure. Não use o Azure Cloud Shell porque az upgrade não está disponível no Cloud Shell. Execute os comandos neste artigo com privilégios administrativos. Algumas extensões da CLI do Azure, como aks-preview, podem entrar em conflito com os sinalizadores de comando necessários. Desabilite-os se encontrar problemas.

• Você precisa do cliente de linha de comando do Kubernetes. kubectl Você pode instalá-lo localmente executando o az aks install-cli comando.

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

• Entre no Azure usando o comando az login .

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 são executados no Azure se você não especificar 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. Se você estiver habilitando o Armazenamento de Contêineres do Azure em um cluster do AKS existente, use o grupo de recursos que já hospeda o cluster.

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

Se o grupo de recursos for criado com êxito, você verá uma saída semelhante a este exemplo:

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

Verifique se o tipo de VM do cluster atende aos critérios de instalação

Siga estas diretrizes ao escolher um tipo de máquina virtual para os nós de cluster.

• Escolha um SKU de máquina virtual que dê suporte a discos de dados NVMe locais, por exemplo, VMs otimizadas para armazenamento ou VMs aceleradas por GPU.
• Escolha o tipo de sistema operacional para as VMs nos pools de nós como sistema operacional Linux. No momento, não há suporte para o sistema operacional Windows.
• Quanto aos clusters existentes, verifique se os pools de nós já usam uma VM SKU com suporte antes de habilitar o Armazenamento de Contêineres do Azure.

Instalar o Armazenamento de Contêineres do Azure no cluster do AKS

Escolha o cenário que corresponde ao seu ambiente.

Opção 1: criar um novo cluster do AKS com o Armazenamento de Contêineres do Azure habilitado

Execute o comando a seguir para criar um novo cluster do AKS e instalar o Armazenamento de Contêineres do Azure. Substitua <cluster-name> e <resource-group> pelos seus próprios valores e especifique qual tipo de VM você deseja usar.

az aks create -n <cluster-name> -g <resource-group> --node-vm-size Standard_L8s_v3 --enable-azure-container-storage --generate-ssh-keys

A implantação leva de 5 a 10 minutos. Quando ele for concluído, você terá um cluster do AKS com o Armazenamento de Contêineres do Azure instalado e os componentes do tipo de armazenamento NVMe local implantados.

Opção 2: Habilitar o Armazenamento de Contêineres do Azure em um cluster do AKS existente

Execute o comando a seguir para habilitar o Armazenamento de Contêineres do Azure em um cluster do AKS existente. Substitua <cluster-name> e <resource-group> pelos seus próprios valores.

az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage

A implantação leva de 5 a 10 minutos. Quando ele for concluído, o cluster AKS de destino terá o Armazenamento de Contêineres do Azure instalado e os componentes do tipo de armazenamento NVMe local implantados.

Conectar-se ao cluster e verificar o status

Após a instalação, configure kubectl para se conectar ao cluster e verifique se os nós estão prontos.

1. Baixe as credenciais do cluster e configure a CLI do Kubernetes para usá-las. Por padrão, as credenciais são armazenadas em ~/.kube/config. Forneça um caminho diferente usando o --file argumento, se necessário.

   az aks get-credentials --resource-group <resource-group> --name <cluster-name>
   

2. Verifique a conexão listando os nós do cluster.

   kubectl get nodes
   

3. Verifique se todos os nós relatam um status de Ready, semelhante à saída a seguir:

   NAME                                STATUS   ROLES   AGE   VERSION
   aks-nodepool1-34832848-vmss000000   Ready    agent   80m   v1.32.6
   aks-nodepool1-34832848-vmss000001   Ready    agent   80m   v1.32.6
   aks-nodepool1-34832848-vmss000002   Ready    agent   80m   v1.32.6
   

Próxima etapa

• Usar o Armazenamento de Contêineres do Azure com NVMe local
• Visão geral da implantação de um banco de dados PostgreSQL altamente disponível no AKS (Serviço de Kubernetes do Azure)