sql-server-samples/samples/features/sql-big-data-cluster/deployment/private-aks/README.md

Deploy BDC in private AKS cluster with User-defined Route (UDR)

This repository contains the scripts that you can use to deploy a BDC cluster in Azure Kubernetes Service (AKS) private cluster with advanced networking ( CNI ).

This repository contains 3 bash scripts :

• deploy-private-aks.sh : You can use it to deploy private AKS cluster with private endpoint, it fits the use case that you need to deploy BDC with a private endpoint with AKS private cluster.
• deploy-private-aks-udr.sh : You can use it to deploy private AKS cluster with private endpoint, it fits the use case that you need to deploy BDC with a private endpoint with AKS private cluster and limit egress traffic with UDR ( User-defined Routes ).
• deploy-bdc.sh : You can use it to deploy Big Data Clusters ( BDC ) in private deployment mode on private AKS cluster with or without User-defined routes based on your project requirements.

Prerequisites

You can run those scripts on the following client envionrment with Linux OS or WSL/WSL2.

The following table lists common big data cluster tools and how to install them:

Tool	Required	Description	Installation
python	Yes	Python is an interpreted, object-oriented, high-level programming language with dynamic semantics. Many parts of big data clusters for SQL Server use python.	Install python
azdata	Yes	Command-line tool for installing and managing a big data cluster.	Install
kubectl1	Yes	Command-line tool for monitoring the underlying Kubernetes cluster (More info).	Windows | Linux
Azure Data Studio	Yes	Cross-platform graphical tool for querying SQL Server.	Install
Data Virtualization extension	Yes	Extension for Azure Data Studio that provides a Data Virtualization wizard.	Install
Azure CLI2	For AKS	Modern command-line interface for managing Azure services. Used with AKS big data cluster deployments (More info).	Install
mssql-cli	Optional	Modern command-line interface for querying SQL Server (More info).	Windows | Linux
sqlcmd	For some scripts	Legacy command-line tool for querying SQL Server (More info). You might need to install the Microsoft ODBC Driver 11 for SQL Server before installing the SQLCMD package.	Windows | Linux
curl 3	For some scripts	Command-line tool for transferring data with URLs.	Windows | Linux: install curl package
oc	Required for Red Hat OpenShift and Azure Redhat OpenShift deployments.	oc is the Open Shift command line interface (CLI).	Installing the CLI

Instructions

deploy-private-aks.sh

1. Download the script on the location that you are planning to use for the deployment

curl --output setup-bdc.sh https://raw.githubusercontent.com/microsoft/sql-server-samples/master/samples/features/sql-big-data-cluster/deployment/private-aks/scripts/deploy-private-aks.sh

2. Make the script executable

chmod +x deploy-private-aks.sh

3. Run the script (make sure you are running with sudo)

sudo ./deploy-private-aks.sh

deploy-private-aks-udr.sh

1. Download the script on the location that you are planning to use for the deployment

curl --output setup-bdc.sh https://raw.githubusercontent.com/microsoft/sql-server-samples/master/samples/features/sql-big-data-cluster/deployment/private-aks/scripts/deploy-private-aks-udr.sh

2. Make the script executable

chmod +x deploy-private-aks-udr.sh

3. Run the script (make sure you are running with sudo)

sudo ./deploy-private-aks-udr.sh

deploy-bdc.sh

1. Download the script on the location that you are planning to use for the deployment

curl --output setup-bdc.sh https://raw.githubusercontent.com/microsoft/sql-server-samples/master/samples/features/sql-big-data-cluster/deployment/private-aks/scripts/deploy-bdc.sh

2. Make the script executable

chmod +x deploy-bdc.sh

3. Run the script (make sure you are running with sudo)

sudo ./deploy-bdc.sh