Partilhar via

Usar o Driver CSI do Azure Managed Lustre com o Serviço Kubernetes do Azure

  • Artigo

Neste artigo, você aprenderá a planejar, instalar e usar o Azure Managed Lustre no Serviço Kubernetes do Azure (AKS) com o driver de interface de suporte de contêiner do Azure Managed Lustre Kubernetes (driver CSI do Azure Managed Lustre).

Sobre o driver CSI do Azure Managed Lustre para AKS

O driver CSI (Managed Lustre Container Support Interface) do Azure para AKS permite que você acesse o armazenamento do Azure Managed Lustre como volumes de armazenamento persistentes de contêineres Kubernetes implantados no Serviço Kubernetes do Azure (AKS).

Versões compatíveis do Kubernetes

O driver CSI do Azure Managed Lustre para AKS é compatível com o Serviço Kubernetes do Azure (AKS). Outras instalações do Kubernetes não são suportadas no momento.

AKS Kubernetes versões 1.21 e posteriores são suportadas. Isso inclui todas as versões atualmente disponíveis ao criar um novo cluster AKS.

Importante

O driver CSI do Azure Managed Lustre atualmente só funciona com o Ubuntu Linux OS SKU para pools de nós do AKS.

Versões compatíveis do Lustre

O driver CSI do Azure Managed Lustre para AKS é compatível com o Azure Managed Lustre. Outras instalações do Lustre não são suportadas no momento.

As versões 0.1.10 e posteriores do driver do Azure Managed Lustre CSI são suportadas com a versão atual do serviço Azure Managed Lustre.

Pré-requisitos

Planeje sua implantação do AKS

Há várias opções ao implantar o Serviço Kubernetes do Azure que afetam a operação entre o AKS e o Azure Managed Lustre.

Determinar o tipo de rede a utilizar com o AKS

Há dois tipos de rede que são compatíveis com o Ubuntu Linux OS SKU, kubenet e o driver Azure Container Network Interface (CNI). Ambas as opções funcionam com o driver CSI do Azure Managed Lustre para AKS, mas têm requisitos diferentes que precisam ser compreendidos ao configurar a rede virtual e o AKS. Consulte Conceitos de rede para aplicativos no Serviço Kubernetes do Azure (AKS) para obter mais informações sobre como determinar a seleção adequada.

Determinar a arquitetura de rede para interconectividade do AKS e do Azure Managed Lustre

O Azure Managed Lustre opera dentro de uma rede virtual privada, seu Kubernetes deve ter conectividade de rede com a rede virtual do Azure Managed Lustre. Há duas maneiras comuns de configurar a rede entre o Azure Managed Lustre e o AKS.

  • Instale o AKS na sua própria Rede Virtual e crie um emparelhamento de rede virtual com a Rede Virtual Azure Managed Lustre.
  • Use a opção Traga sua própria rede no AKS para instalar o AKS em uma nova sub-rede na Rede Virtual Azure Managed Lustre.

Nota

Não é recomendável instalar o AKS na mesma sub-rede do Azure Managed Lustre.

Emparelhamento de redes virtuais AKS e Azure Managed Lustre

A opção de emparelhar duas redes virtuais diferentes tem a vantagem de separar a gestão das várias redes para diferentes funções privilegiadas. O emparelhamento também pode fornecer flexibilidade adicional, pois pode ser feito em assinaturas ou regiões do Azure. O emparelhamento de rede virtual exigirá coordenação entre as duas redes para evitar a escolha de espaços de rede IP conflitantes.

Diagrama mostrando duas VNets, uma para o Azure Managed Lustre e outra para AKS, com uma seta de emparelhamento de VNet conectando-as.

Instalando o AKS em uma sub-rede na rede virtual do Azure Managed Lustre

A opção de instalar o cluster AKS na rede virtual Azure Managed Lustre com o recurso Bring Your Own Network no AKS pode ser vantajosa onde você deseja cenários em que a rede é gerenciada singularmente. Uma sub-rede adicional dimensionada para atender aos seus requisitos de rede AKS precisará ser criada na rede virtual do Azure Managed Lustre.

Não há separação de privilégios para o gerenciamento de rede ao provisionar o AKS na Rede Azure Managed Lustre e a entidade de serviço AKS precisará de privilégios na rede virtual do Azure Managed Lustre.

Diagrama mostrando a VNet do Azure Managed Lustre com duas sub-redes, uma para o sistema de arquivos Lustre e outra para AKS.

Descrição geral da configuração

Para habilitar o Azure Managed Lustre CSI Driver for Kubernetes, execute estas etapas:

  1. Criar um sistema de arquivos do Azure Managed Lustre

  2. Criar um cluster AKS Kubernetes

  3. Criar emparelhamento de rede virtual

  4. Instale o driver CSI do Azure Managed Lustre para Kubernetes.

  5. Crie e configure um volume persistente.

  6. Verifique a instalação usando opcionalmente um pod echo para confirmar que o driver está funcionando.

As seções a seguir descrevem cada tarefa com mais detalhes.

Criar um sistema de arquivos do Azure Managed Lustre

Se você ainda não criou seu cluster de sistema de arquivos do Azure Managed Lustre, crie o cluster agora. Para obter instruções, consulte Criar um sistema de arquivos do Azure Managed Lustre no portal do Azure. Atualmente, o driver só pode ser usado com um sistema de arquivos existente do Azure Managed Lustre.

Criar um cluster do AKS

Se você ainda não criou seu cluster AKS, crie uma implantação de cluster. Consulte Implantar um cluster do Serviço Kubernetes do Azure (AKS).

Criar emparelhamento de rede virtual

Nota

Ignore esta etapa de emparelhamento de rede se você instalou o AKS em uma sub-rede na rede virtual do Azure Managed Lustre.

A rede virtual AKS é criada em um grupo de recursos separado do grupo de recursos do cluster AKS. Você pode encontrar o nome desse grupo de recursos acessando seu cluster AKS no Portal do Azure, escolhendo a folha Propriedades e localizando o grupo de recursos Infraestrutura . Este grupo de recursos contém a rede virtual que precisa ser emparelhada com a rede virtual do Azure Managed Lustre. Ele corresponde ao padrão MC_<aks-rg-name>_<aks-cluster-name>_<region>.

Consulte o Emparelhamento de Rede Virtual para emparelhar a rede virtual AKS com a sua rede virtual Azure Manages Lustre.

Gorjeta

Devido à nomenclatura dos MC_ grupos de recursos e redes virtuais, os nomes das redes podem ser semelhantes ou iguais em várias implantações do AKS. Ao configurar o peering, preste muita atenção que você está escolhendo as redes AKS que você pretende escolher.

Conectar-se ao cluster AKS

Conecte-se ao cluster do Serviço Kubernetes do Azure seguindo estas etapas:

  1. Abra uma sessão de terminal com acesso às ferramentas da CLI do Azure e inicie sessão na sua conta do Azure.

    az login

  2. Inicie sessão no portal do Azure.

  3. Encontre o seu cluster AKS. Selecione a folha Visão geral e, em seguida, selecione o botão Conectar e copie o comando para Baixar credenciais de cluster.

  4. Na sessão do terminal, cole o comando para baixar as credenciais. Será um comando semelhante a:

    az aks get-credentials --subscription <AKS_subscription_id> --resource_group <AKS_resource_group_name> --name <name_of_AKS>

  5. Instale o kubectl se ele não estiver presente em seu ambiente.

    az aks install-cli

  6. Verifique se o contexto atual é o cluster AKS que você acabou de instalar as credenciais e se você pode se conectar a ele:

    kubectl config current-context
kubectl get deployments --all-namespaces=true

Instale o driver CSI

Para instalar o driver CSI, execute o seguinte comando:

curl -skSL https://raw.githubusercontent.com/kubernetes-sigs/azurelustre-csi-driver/main/deploy/install-driver.sh | bash

Para obter exemplos de comando de instalação local, consulte Instalar o driver CSI do Azure Lustre em um cluster Kubernetes.

Criar e configurar um volume persistente

Para criar um volume persistente para um sistema de arquivos existente do Azure Managed Lustre, execute estas etapas:

  1. Copie os seguintes arquivos de configuração da pasta /docs/examples/ no repositório azurelustre-csi-driver . Se você clonou o repositório quando instalou o driver CSI, já tem cópias locais disponíveis.

    • storageclass_existing_lustre.yaml
    • pvc_storageclass.yaml

    Se não quiser clonar todo o repositório, você pode baixar cada arquivo individualmente. Abra cada um dos links a seguir, copie o conteúdo do arquivo e cole o conteúdo em um arquivo local com o mesmo nome de arquivo.

  2. No arquivo storageclass_existing_lustre.yaml, atualize o nome interno do cluster Lustre e o endereço IP do MSG.

    Screenshot do ficheiro storageclass_existing_lustre.yaml com valores para substituir realçados.

    Ambas as configurações são exibidas no portal do Azure, na página Conexão de cliente do seu sistema de arquivos Azure Lustre.

    Captura de ecrã da página Ligação de Cliente do portal do Azure. O endereço IP MGS e o nome

    Faça estas atualizações:

    • Substitua EXISTING_LUSTRE_FS_NAME pelo nome interno atribuído pelo sistema do cluster Lustre em seu sistema de arquivos do Azure Managed Lustre. O nome interno é geralmente lustrefs. O nome interno não é o nome que você deu ao sistema de arquivos quando o criou.

      O comando sugerido mount inclui o nome realçado na cadeia de caracteres de endereço a seguir.

      Captura de tela de uma cadeia de caracteres de endereço de exemplo na página Conexão do cliente. O nome interno do cluster Lustre é realçado.

    • Substitua EXISTING_LUSTRE_IP_ADDRESS pelo endereço IP MSG.

  3. Para criar a classe de armazenamento e a declaração de volume persistente, execute o seguinte kubectl comando:

    kubectl create -f storageclass_existing_lustre.yaml
kubectl create -f pvc_storageclass.yaml

Verifique a instalação

Se você quiser verificar sua instalação, você pode opcionalmente usar um pod de eco para confirmar que o driver está funcionando.

Para exibir carimbos de data/hora no console durante as gravações, execute os seguintes comandos:

  1. Adicione o seguinte código ao pod de eco:

    while true; do echo $(date) >> /mnt/lustre/outfile; tail -1 /mnt/lustre/outfile; sleep 1; done

  2. Para exibir carimbos de data/hora no console durante as gravações, execute o seguinte kubectl comando:

    `kubectl logs -f lustre-echo-date`

Próximos passos