Melakukan penyebaran offline dari kluster big data SQL Server

Penting

Add-on Kluster Big Data Microsoft SQL Server 2019 akan dihentikan. Dukungan untuk Kluster Big Data SQL Server 2019 akan berakhir pada 28 Februari 2025. Untuk informasi selengkapnya, lihat Opsi big data di platform Microsoft SQL Server.

Artikel ini menjelaskan cara melakukan penyebaran offline Kluster Big Data SQL Server 2019. Kluster big data harus memiliki akses ke repositori Docker untuk menarik gambar kontainer. Penginstalan offline adalah salah satu tempat gambar yang diperlukan ditempatkan ke dalam repositori Docker privat. Repositori privat tersebut kemudian digunakan sebagai sumber gambar untuk penyebaran baru.

Prasyarat

Peringatan

Parameter imagePullPolicy diperlukan untuk diatur seperti "Always" dalam file control.json profil penyebaran.

Memuat gambar ke dalam repositori privat

Langkah-langkah berikut menjelaskan cara menarik gambar kontainer kluster big data dari repositori Microsoft lalu mendorongnya ke repositori privat Anda.

Tip

Langkah-langkah berikut menjelaskan prosesnya. Namun, untuk menyederhanakan tugas, Anda dapat menggunakan skrip otomatis alih-alih menjalankan perintah ini secara manual.

  1. Tarik gambar kontainer kluster big data dengan mengulangi perintah berikut. Ganti <SOURCE_IMAGE_NAME> dengan setiap nama gambar. Ganti <SOURCE_DOCKER_TAG> dengan tag untuk rilis kluster big data, seperti 2019-CU12-ubuntu-20.04.

    docker pull mcr.microsoft.com/mssql/bdc/<SOURCE_IMAGE_NAME>:<SOURCE_DOCKER_TAG>
    
  2. Masuk ke registri Docker privat target.

    docker login <TARGET_DOCKER_REGISTRY> -u <TARGET_DOCKER_USERNAME> -p <TARGET_DOCKER_PASSWORD>
    
  3. Tandai gambar lokal dengan perintah berikut untuk setiap gambar:

    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. Dorong gambar lokal ke repositori Docker privat:

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

Peringatan

Jangan ubah gambar kluster big data setelah didorong ke repositori privat Anda. Melakukan penyebaran dengan gambar yang dimodifikasi akan menghasilkan penyiapan kluster big data yang tidak didukung.

Gambar kontainer kluster big data

Gambar kontainer kluster big data berikut diperlukan untuk penginstalan 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

Skrip otomatis

Anda dapat menggunakan skrip python otomatis yang akan secara otomatis menarik semua gambar kontainer yang diperlukan dan mendorongnya ke repositori privat.

Catatan

Python adalah prasyarat untuk menggunakan skrip. Untuk informasi selengkapnya tentang cara menginstal Python, lihat dokumentasi Python.

  1. Dari bash atau PowerShell, unduh skrip dengan 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. Kemudian jalankan skrip dengan salah satu perintah berikut:

    Windows:

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

    Linux:

    sudo python push-bdc-images-to-custom-private-repo.py
    
  3. Ikuti perintah untuk memasukkan repositori Microsoft dan informasi repositori privat Anda. Setelah skrip selesai, semua gambar yang diperlukan harus terletak di repositori privat Anda.

  4. Ikuti instruksi di sini untuk mempelajari cara menyesuaikan control.json file konfigurasi penyebaran untuk menggunakan registri dan repositori kontainer Anda. Perhatikan bahwa Anda harus mengatur DOCKER_USERNAME variabel lingkungan dan DOCKER_PASSWORD sebelum penyebaran untuk mengaktifkan akses ke repositori privat Anda.

Menginstal alat secara offline

Penyebaran kluster big data memerlukan beberapa alat, termasuk Python, Azure Data CLI (azdata), dan kubectl. Gunakan langkah-langkah berikut untuk menginstal alat ini di server offline.

Instal python offline

  1. Pada komputer dengan akses internet, unduh salah satu file terkompresi berikut yang berisi Python:

    Sistem operasi Unduh
    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. Salin file terkompresi ke komputer target dan ekstrak ke folder pilihan Anda.

  3. Hanya untuk Windows, jalankan installLocalPythonPackages.bat dari folder tersebut dan lewati jalur lengkap ke folder yang sama dengan parameter.

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

Menginstal azdata offline

  1. Pada komputer dengan akses internet dan Python, jalankan perintah berikut untuk mengunduh semua paket Azure Data CLI (azdata) ke folder saat ini.

    pip download -r https://aka.ms/azdata
    
  2. Salin paket yang diunduh dan requirements.txt file ke komputer target.

  3. Jalankan perintah berikut pada komputer target, tentukan folder tempat Anda menyalin file sebelumnya.

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

Menginstal kubectl offline

Untuk menginstal kubectl ke komputer offline, gunakan langkah-langkah berikut.

  1. Gunakan curl untuk mengunduh kubectl ke folder pilihan Anda. Untuk informasi selengkapnya, lihat Menginstal biner kubectl menggunakan curl.

  2. Salin folder ke komputer target.

Menyebarkan dari repositori privat

Untuk menyebarkan dari repositori privat, gunakan langkah-langkah yang dijelaskan dalam panduan penyebaran, tetapi gunakan file konfigurasi penyebaran kustom yang menentukan informasi repositori Docker privat Anda. Perintah Azure Data CLI (azdata) berikut menunjukkan cara mengubah pengaturan Docker dalam file konfigurasi penyebaran kustom bernama 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>"

Penyebaran meminta nama pengguna dan kata sandi docker, atau Anda dapat menentukannya dalam DOCKER_USERNAME variabel lingkungan dan DOCKER_PASSWORD .

Langkah berikutnya

Untuk informasi selengkapnya tentang penyebaran kluster big data, lihat Cara menyebarkan SQL Server Kluster Big Data di Kubernetes.