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

O Armazenamento de Contêineres do Azure é um serviço de gerenciamento, implantação e orquestração de volumes 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êiner do Azure em um cluster do Serviço Kubernetes do Azure (AKS), quer você esteja criando um novo cluster ou habilitando o serviço em uma implantação existente.

Se preferir a versão de código aberto 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 não tiver uma subscrição 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. Certifique-se de executar 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. Desative-os caso encontre problemas.

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

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

• Entre no Azure usando o comando az login .

Instale a extensão necessária

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

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

Definir contexto de subscrição

Defina seu contexto de assinatura do Azure usando o az account set comando. Pode ver os IDs de subscrição de todas as subscrições a que tem acesso executando o az account list --output table comando. Lembre-se de substituir <subscription-id> pelo seu 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 seus recursos do Azure que você deseja gerenciar como um grupo. Ao criar um grupo de recursos, você será solicitado a especificar um local. Esta localização é:

• O local 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 az group create comando. Substitua <resource-group-name> pelo nome do grupo de recursos que você deseja criar e substitua <location> por uma região do Azure como eastus, westus2, westus3 ou westeurope. Se você estiver habilitando o Armazenamento de Contêiner do Azure em um cluster 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 do cluster.

• Escolha uma SKU de máquina virtual que suporte discos de dados NVMe locais, por exemplo, VMs otimizadas para armazenamento ou VMs aceleradas por GPU.
• Escolha Linux como o tipo de sistema operativo para as VMs nos conjuntos de nós. O sistema operacional Windows não é suportado no momento.
• Para clusters existentes, certifique-se de que os pools de nós já usam uma SKU de VM com suporte antes de habilitar o Armazenamento de Contêiner do Azure.

Instale o Azure Container Storage no seu cluster AKS

Escolha o cenário que corresponde ao seu ambiente.

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

Execute o seguinte comando para criar um novo cluster AKS e instalar o Armazenamento de Contêineres do Azure. Substitua <cluster-name> e <resource-group> por 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 AKS com o Armazenamento de Contêiner do Azure instalado e os componentes para o tipo de armazenamento NVMe local implantados.

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

Execute o seguinte comando para habilitar o Armazenamento de Contêiner do Azure em um cluster 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 for concluído, o cluster AKS de destino terá o Armazenamento de Contêineres do Azure instalado e os componentes para o 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 no ~/.kube/config. Forneça um caminho diferente usando o argumento, --file 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 apresentam um estado de Ready, semelhante à seguinte saída:

   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óximo passo

• Use Azure Container Storage com NVMe local
• Visão geral da implantação de um banco de dados PostgreSQL altamente disponível no Serviço Kubernetes do Azure (AKS)