Executar uma implantação offline de um cluster de Big Data do SQL Server

Este artigo descreve como executar uma implantação offline de um Clusters de Big Data do SQL Server 2019. Os clusters de Big Data devem ter acesso a um repositório do Docker do qual efetuar pull de imagens de contêiner. Uma instalação offline é aquela em que as imagens necessárias são colocadas em um repositório privado do Docker. Esse repositório privado é então usado como a origem da imagem para uma nova implantação.

Prerequisites

• Mecanismo do Docker em qualquer distribuição do Linux com suporte ou Docker para Mac/Windows. Valide a versão do mecanismo em relação às configurações testadas nas notas de versão dos Clusters de Big Data do SQL Server. Para obter mais informações, consulte Instalar o Docker.

Carregar imagens em um repositório privado

As etapas a seguir descrevem como baixar as imagens de contêiner do cluster de Big Data do repositório da Microsoft e, em seguida, enviá-las para seu repositório privado.

1. Puxe as imagens de contêiner do cluster de big data repetindo o comando a seguir. Substitua <SOURCE_IMAGE_NAME> por cada nome de imagem. Substitua <SOURCE_DOCKER_TAG> pela marca para a versão do cluster de Big Data, como 2019-CU12-ubuntu-20.04.

   docker pull mcr.microsoft.com/mssql/bdc/<SOURCE_IMAGE_NAME>:<SOURCE_DOCKER_TAG>
   

2. Faça logon no registro privado de destino do Docker.

   docker login <TARGET_DOCKER_REGISTRY> -u <TARGET_DOCKER_USERNAME> -p <TARGET_DOCKER_PASSWORD>
   

3. Marque as imagens locais com o seguinte comando para cada imagem:

   docker tag mcr.microsoft.com/mssql/bdc/<SOURCE_IMAGE_NAME>:<SOURCE_DOCKER_TAG> <TARGET_DOCKER_REGISTRY>/<TARGET_DOCKER_REPOSITORY>/<SOURCE_IMAGE_NAME>:<TARGET_DOCKER_TAG>
   

4. Envie por push as imagens locais para o repositório privado do Docker:

   docker push <TARGET_DOCKER_REGISTRY>/<TARGET_DOCKER_REPOSITORY>/<SOURCE_IMAGE_NAME>:<TARGET_DOCKER_TAG>
   

Imagens de contêineres em clusters de Big Data

As seguintes imagens de contêiner de cluster de Big Data são necessárias para uma instalação offline:

• mssql-app-service-proxy
• mssql-control-watchdog
• mssql-controller
• mssql-dns
• mssql-hadoop
• mssql-mleap-serving-runtime
• mssql-mlserver-py-runtime
• mssql-mlserver-r-runtime
• mssql-monitor-collectd
• mssql-monitor-elasticsearch
• mssql-monitor-fluentbit
• mssql-monitor-grafana
• mssql-monitor-influxdb
• mssql-monitor-kibana
• mssql-monitor-telegraf
• mssql-security-knox
• mssql-security-support
• mssql-server-controller
• mssql-server-data
• mssql-ha-operator
• mssql-ha-supervisor
• mssql-service-proxy
• mssql-ssis-app-runtime

Automated script

Você pode usar um script python automatizado que extrairá automaticamente todas as imagens de contêiner necessárias e as enviará por push para um repositório privado.

1. No Bash ou no PowerShell, baixe o script com curl:

   curl -o push-bdc-images-to-custom-private-repo.py "https://raw.githubusercontent.com/Microsoft/sql-server-samples/master/samples/features/sql-big-data-cluster/deployment/offline/push-bdc-images-to-custom-private-repo.py"
   

2. Em seguida, execute o script com um dos seguintes comandos:

   Windows:

   python push-bdc-images-to-custom-private-repo.py
   

   Linux:

   sudo python push-bdc-images-to-custom-private-repo.py
   

3. Siga os prompts para inserir o repositório da Microsoft e as informações do repositório privado. Depois que o script for concluído, todas as imagens necessárias deverão estar localizadas em seu repositório privado.

4. Siga as instruções aqui para saber como personalizar o control.json arquivo de configuração de implantação para usar o registro de contêiner e o repositório. Note que você deve definir as variáveis de ambiente DOCKER_USERNAME e DOCKER_PASSWORD antes da implantação para habilitar o acesso ao seu repositório privado.

Instalar ferramentas offline

As implantações de cluster de Big Data exigem várias ferramentas, incluindo Python, CLI de Dados do Azure (azdata) e kubectl. Use as etapas a seguir para instalar essas ferramentas em um servidor offline.

Instalar o Python offline

1. Em um computador com acesso à Internet, baixe um dos seguintes arquivos compactados que contêm o Python:

   Operating system	Download
   Windows	https://go.microsoft.com/fwlink/?linkid=2074021
   Linux	https://go.microsoft.com/fwlink/?linkid=2065975
   OSX	https://go.microsoft.com/fwlink/?linkid=2065976

2. Copie o arquivo compactado para o computador de destino e extraia-o em uma pasta de sua escolha.

3. Somente para o Windows, execute installLocalPythonPackages.bat nessa pasta e passe o caminho completo para a mesma pasta como um parâmetro.

   installLocalPythonPackages.bat "C:\python-3.6.6-win-x64-0.0.1-offline\0.0.1"
   

Instalar azdata offline

1. Em um computador com acesso à Internet e Python, execute o comando a seguir para baixar todos os pacotes da CLI de Dados do Azure (azdata) para a pasta atual.

   pip download -r https://aka.ms/azdata
   

2. Copie os pacotes baixados e o requirements.txt arquivo para o computador de destino.

3. Execute o comando a seguir no computador de destino, especificando a pasta na qual você copiou os arquivos anteriores.

   pip install --no-index --find-links <path-to-packages> -r <path-to-requirements.txt>
   

Instalar o kubectl offline

Para instalar o kubectl em um computador offline, use as etapas a seguir.

1. Use curl para baixar kubectl em uma pasta de sua escolha. Para obter mais informações, consulte Instalar o binário kubectl usando curl.

2. Copie a pasta para o computador de destino.

Implantar a partir de repositório privado

Para implantar a partir do repositório privado, use as etapas descritas no guia de implantação, mas use um arquivo de configuração de implantação personalizado que especifica as informações do repositório privado do Docker. Os seguintes comandos da CLI de Dados do Azure (azdata) demonstram como alterar as configurações do Docker em um arquivo de configuração de implantação personalizado chamado control.json:

azdata bdc config replace --config-file custom/control.json --json-values "$.spec.docker.repository=<your-docker-repository>"
azdata bdc config replace --config-file custom/control.json --json-values "$.spec.docker.registry=<your-docker-registry>"
azdata bdc config replace --config-file custom/control.json --json-values "$.spec.docker.imageTag=<your-docker-image-tag>"

A implantação solicita o nome de usuário e a senha do Docker, ou você pode especificá-los nas variáveis de ambiente DOCKER_USERNAME e DOCKER_PASSWORD.

Next steps

Para obter mais informações sobre implantações de cluster de Big Data, consulte Como implantar clusters de Big Data do SQL Server no Kubernetes.