Skip to main content
NetApp Automation
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Cloud Volumes ONTAP para Azure - Burst para a nuvem

Colaboradores

este artigo oferece suporte à solução de automação do NetApp Cloud Volumes ONTAP para Azure, que está disponível para clientes da NetApp no Catálogo de automação da BlueXP .

A solução de automação do Cloud Volumes ONTAP para Azure automatiza a implantação em contêiner do Cloud Volumes ONTAP para Azure usando o Terraform, permitindo que você implante o Cloud Volumes ONTAP para Azure rapidamente, sem qualquer intervenção manual.

Antes de começar
  • Você deve baixar a "Cloud Volumes ONTAP Azure - Burst para a nuvem" solução de automação por meio da IU da Web do BlueXP . A solução é embalada CVO-Azure-Burst-To-Cloud.zip como .

  • Você deve instalar uma VM Linux na mesma rede que o Cloud Volumes ONTAP.

  • Depois de instalar a VM Linux, você deve seguir as etapas desta solução para instalar as dependências necessárias.

Passo 1: Instale o Docker e o Docker Compose

Instale o Docker

As etapas a seguir usam o software de distribuição Debian Linux Ubuntu 20,04 como exemplo. Os comandos que você executa dependem do software de distribuição Linux que você está usando. Consulte a documentação específica do software de distribuição Linux para sua configuração.

Passos
  1. Instale o Docker executando os sudo seguintes comandos:

    sudo apt-get update
    sudo apt-get install apt-transport-https cacertificates curl gnupg-agent software-properties-common curl -fsSL https://download.docker.com/linux/ubuntu/gpg |
    sudo apt-key add -
    sudo add-apt-repository “deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable”
    sudo apt-get update
    sudo apt-get install dockerce docker-ce-cli containerd.io
  2. Verifique a instalação:

    docker –version
  3. Verifique se um grupo chamado "docker" foi criado em seu sistema Linux. Se necessário, crie o grupo:

    sudo groupadd docker
  4. Adicione o usuário que precisa acessar o Docker ao grupo:

    sudo usermod -aG docker $(whoami)
  5. As alterações são aplicadas depois de terminar sessão e voltar a iniciar sessão no terminal. Alternativamente, você pode aplicar as alterações imediatamente:

    newgrp docker

Instale o Docker Compose

Passos
  1. Instale o Docker Compose executando os seguintes sudo comandos:

    sudo curl -L “https://github.com/docker/compose/releases/download/1.29.2/dockercompose-(𝑢𝑛𝑎𝑚𝑒 − 𝑠)−(uname -m)” -o /usr/local/bin/docker-compose
    sudo chmod +x /usr/local/bin/docker-compose
  2. Verifique a instalação:

    docker-compose –version

Passo 2: Prepare a imagem do Docker

Passos
  1. Copie a CVO-Azure-Burst-To-Cloud.zip pasta para a VM Linux que você deseja usar para implantar o Cloud Volumes ONTAP:

    scp -i ~/<private-key>.pem -r CVO-Azure-Burst-To-Cloud.zip <azureuser>@<IP_ADDRESS_OF_VM>:<LOCATION_TO_BE_COPIED>
    • private-key.pem é o seu arquivo de chave privada para login sem uma senha.

    • azureuser É o nome de usuário da VM.

    • IP_ADDRESS_OF_VM É o endereço IP da VM.

    • LOCATION_TO_BE_COPIED é o local onde a pasta será copiada.

  2. Extraia a CVO-Azure-Burst-To-Cloud.zip pasta. Você pode extrair a pasta no diretório atual ou em um local personalizado.

    Para extrair a pasta no diretório atual, execute:

    unzip CVO-Azure-Burst-To-Cloud.zip

    Para extrair a pasta em um local personalizado, execute:

    unzip CVO-Azure-Burst-To-Cloud.zip -d ~/<your_folder_name>
  3. Depois de extrair o conteúdo, navegue até CVO_Azure_Deployment a pasta e execute o seguinte comando para visualizar os arquivos:

     ls -la

    Você deve ver uma lista de arquivos, semelhante ao seguinte exemplo:

    drwxr-xr-x@ 11 user1 staff 352 May 5 13:56 .
    drwxr-xr-x@ 5 user1 staff 160 May 5 14:24 ..
    -rw-r--r--@ 1 user1 staff 324 May 5 13:18 .env
    -rw-r--r--@ 1 user1 staff 1449 May 5 13:18 Dockerfile
    -rw-r--r--@ 1 user1 staff 35149 May 5 13:18 LICENSE
    -rw-r--r--@ 1 user1 staff 13356 May 5 14:26 README.md
    -rw-r--r-- 1  user1 staff 354318151 May 5 13:51 cvo_azure_flexcache_ubuntu_image_latest
    drwxr-xr-x@ 4 user1 staff 128 May 5 13:18 cvo_azure_variables
    -rw-r--r--@ 1 user1 staff 996 May 5 13:18 docker-compose-deploy.yml
    -rw-r--r--@ 1 user1 staff 1041 May 5 13:18 docker-compose-destroy.yml
    -rw-r--r--@ 1 user1 staff 4771 May 5 13:18 sp_role.json
  4. Localize o cvo_azure_flexcache_ubuntu_image_latest.tar.gz arquivo. Isso contém a imagem Docker necessária para implantar o Cloud Volumes ONTAP para Azure.

  5. Descomprimir o ficheiro:

    docker load -i cvo_azure_flexcache_ubuntu_image_latest.tar.gz
  6. Aguarde alguns minutos para que a imagem do Docker seja carregada e, em seguida, valide que a imagem do Docker foi carregada com sucesso:

    docker images

    Você deve ver uma imagem Docker chamada cvo_azure_flexcache_ubuntu_image_latest com a latest tag, como mostrado no exemplo a seguir:

    REPOSITORY TAG IMAGE ID CREATED SIZE
    cvo_azure_flexcache_ubuntu_image latest 18db15a4d59c 2 weeks ago 1.14GB

Passo 3: Criar arquivos variáveis de ambiente

Neste estágio, você deve criar dois arquivos variáveis de ambiente. Um arquivo é para autenticação de APIs do Azure Resource Manager usando credenciais principais de serviço. O segundo arquivo é para definir variáveis de ambiente para permitir que os módulos do BlueXP  Terraform localizem e autentiquem APIs do Azure.

Passos
  1. Crie um responsável de serviço.

    Antes de criar os arquivos variáveis de ambiente, você deve criar um princípio de serviço seguindo as etapas em "Crie um diretor de serviço e aplicativo do Azure ative Directory que possa acessar recursos".

  2. Atribua a função Colaborador ao responsável de serviço recém-criado.

  3. Crie uma função personalizada.

    1. Localize o sp_role.json arquivo e verifique as permissões necessárias nas ações listadas.

    2. Insira essas permissões e anexe a função personalizada ao responsável de serviço recém-criado.

  4. Navegue até certificados e segredos e selecione segredo de novo cliente para criar o segredo do cliente.

    Quando você cria o segredo do cliente, você deve Registrar os detalhes da coluna valor porque você não será capaz de ver esse valor novamente. Você também deve Registrar as seguintes informações:

    • ID do cliente

    • ID da subscrição

    • ID do inquilino

      Você precisará dessas informações para criar as variáveis de ambiente. Você pode encontrar informações de ID de cliente e ID de locatário na seção Visão geral da IU do Serviço Principal.

  5. Crie os arquivos de ambiente.

    1. Crie o azureauth.env arquivo no seguinte local:

      path/to/env-file/azureauth.env

      1. Adicione o seguinte conteúdo ao arquivo:

        A Sony Computer Entertainment Europe é uma das nossas principais empresas de tecnologia de ponta

      O formato deve ser exatamente como mostrado acima, sem espaços entre a chave e o valor.

    2. Crie o credentials.env arquivo no seguinte local:

      path/to/env-file/credentials.env

      1. Adicione o seguinte conteúdo ao arquivo:

        AZURE_CLIENT_ID_ID_AZURE_CLIENT_SECRET_ID_AZURE_CLIENT_ID

    O formato deve ser exatamente como mostrado acima, sem espaços entre a chave e o valor.

  6. Adicione os caminhos de arquivo absolutos ao .env arquivo.

    Insira o caminho absoluto para o azureauth.env arquivo de ambiente no .env arquivo que corresponde à AZURE_RM_CREDS variável de ambiente.

    AZURE_RM_CREDS=path/to/env-file/azureauth.env

    Insira o caminho absoluto para o credentials.env arquivo de ambiente no .env arquivo que corresponde à BLUEXP_TF_AZURE_CREDS variável de ambiente.

    BLUEXP_TF_AZURE_CREDS=path/to/env-file/credentials.env

Passo 4: Adicione licenças Cloud Volumes ONTAP ao BlueXP  ou inscreva-se no BlueXP 

Você pode adicionar licenças do Cloud Volumes ONTAP ao BlueXP  ou assinar o NetApp BlueXP  no Azure Marketplace.

Passos
  1. No portal do Azure, navegue até SaaS e selecione Subscribe to NetApp BlueXP .

  2. Selecione o plano Cloud Manager (por Cap PYGO por hora, WORM e serviços de dados).

    Você pode usar o mesmo grupo de recursos que o Cloud Volumes ONTAP ou um grupo de recursos diferente.

  3. Configure o portal BlueXP  para importar a assinatura SaaS para o BlueXP .

    Você pode configurar isso diretamente no portal do Azure navegando até Detalhes do produto e do plano e selecionando a opção Configurar conta agora.

    Você será redirecionado para o portal do BlueXP  para confirmar a configuração.

  4. Confirme a configuração no portal do BlueXP  selecionando Salvar.

Passo 5: Crie um volume externo

Você deve criar um volume externo para manter os arquivos de estado do Terraform e outros arquivos importantes persistentes. Você deve garantir que os arquivos estejam disponíveis para o Terraform para executar o fluxo de trabalho e as implantações.

Passos
  1. Criar um volume externo fora do Docker Compose:

    docker volume create « volume_name »

    Exemplo:

    docker volume create cvo_azure_volume_dst
  2. Use uma das seguintes opções:

    1. Adicione um caminho de volume externo ao .env arquivo de ambiente.

      Você deve seguir o formato exato mostrado abaixo.

      Formato:

      PERSISTENT_VOL=path/to/external/volume:/cvo_azure

      Exemplo:
      PERSISTENT_VOL=cvo_azure_volume_dst:/cvo_azure

    2. Adicionar compartilhamentos NFS como volume externo.

      Certifique-se de que o contentor Docker possa se comunicar com os compartilhamentos NFS e que as permissões corretas, como leitura/gravação, estejam configuradas.

      1. Adicione o caminho de compartilhamentos NFS como caminho para o volume externo no arquivo Docker Compose, como mostrado abaixo: Formato:

        PERSISTENT_VOL=path/to/nfs/volume:/cvo_azure

    Exemplo:
    PERSISTENT_VOL=nfs/mnt/document:/cvo_azure

  3. Navegue até cvo_azure_variables a pasta.

    Você deve ver os seguintes arquivos variáveis na pasta:

    terraform.tfvars

    variables.tf

  4. Altere os valores dentro do terraform.tfvars arquivo de acordo com suas necessidades.

    Você deve ler a documentação de suporte específica ao modificar qualquer um dos valores de variável no terraform.tfvars arquivo. Os valores podem variar dependendo da região, zonas de disponibilidade e outros fatores suportados pelo Cloud Volumes ONTAP para Azure. Isso inclui licenças, tamanho de disco e tamanho de VM para nós únicos e pares de alta disponibilidade (HA).

    Todas as variáveis de suporte para os módulos Connector e Cloud Volumes ONTAP Terraform já estão definidas no variables.tf arquivo. Você deve consultar os nomes das variáveis no variables.tf arquivo antes de adicionar ao terraform.tfvars arquivo.

  5. Dependendo dos seus requisitos, pode ativar ou desativar o FlexCache e o FlexClone definindo as seguintes opções para true ou false.

    Os exemplos a seguir habilitam o FlexCache e o FlexClone:

    • is_flexcache_required = true

    • is_flexclone_required = true

  6. Se necessário, você pode recuperar o valor da variável Terraform az_service_principal_object_id no Serviço do Azure ative Directory:

    1. Navegue até Enterprise Applications –> All Applications (aplicações empresariais) e selecione o nome do Service Principal que criou anteriormente.

    2. Copie o ID do objeto e insira o valor da variável Terraform:

      az_service_principal_object_id

Etapa 6: Implante o Cloud Volumes ONTAP para Azure

Siga as etapas a seguir para implantar o Cloud Volumes ONTAP para Azure.

Passos
  1. Na pasta raiz, execute o seguinte comando para acionar a implantação:

    docker-compose up -d

    Dois contêineres são acionados, o primeiro contêiner implanta o Cloud Volumes ONTAP e o segundo contêiner envia dados de telemetria para o AutoSupport.

    O segundo recipiente aguarda até que o primeiro recipiente conclua todas as etapas com êxito.

  2. Monitore o progresso do processo de implantação usando os arquivos de log:

    docker-compose logs -f

    Este comando fornece saída em tempo real e captura os dados nos seguintes arquivos de log:

    deployment.log

    telemetry_asup.log

    Você pode alterar o nome desses arquivos de log editando o .env arquivo usando as seguintes variáveis de ambiente:

    DEPLOYMENT_LOGS

    TELEMETRY_ASUP_LOGS

    Os exemplos a seguir mostram como alterar os nomes dos arquivos de log:

    DEPLOYMENT_LOGS=<your_deployment_log_filename>.log

    TELEMETRY_ASUP_LOGS=<your_telemetry_asup_log_filename>.log

Depois de terminar

Você pode usar as etapas a seguir para remover o ambiente temporário e limpar itens criados durante o processo de implantação.

Passos
  1. Se você implantou o FlexCache, defina a seguinte opção no terraform.tfvars arquivo, isso limpa os volumes do FlexCache e remove o ambiente temporário criado anteriormente.

    flexcache_operation = "destroy"

    Observação As opções possíveis são deploy e destroy.
  2. Se você implantou o FlexClone, defina a seguinte opção no terraform.tfvars arquivo, isso limpa os volumes do FlexClone e remove o ambiente temporário criado anteriormente.

    flexclone_operation = "destroy"

    Observação As opções possíveis são deploy e destroy.