Guia de início rápido: implantar um contêiner Linux do SQL Server no Kubernetes usando gráficos Helm

Aplica-se a:SQL Server em Linux

Este guia de início rápido leva você pelas etapas para implantar o SQL Server em contêineres Linux no Serviço Kubernetes do Azure (AKS) com gráficos Helm, a partir de uma máquina cliente Windows.

O AKS é um serviço Kubernetes gerenciado para implantar e gerenciar clusters de contêineres. O Helm é uma ferramenta de empacotamento de código aberto que ajuda você a instalar e gerenciar o ciclo de vida dos aplicativos Kubernetes.

Pré-requisitos

Uma assinatura do Azure. Se não tiver uma subscrição do Azure, pode criar uma conta gratuita.
Criar um cluster AKS.
Transfira e reveja o exemplo de gráfico Helm para obter este início rápido. O gráfico de exemplo contém muitas opções de configuração para personalizar sua implantação do SQL Server.

Instalar ferramentas de cliente

Na sua máquina cliente Windows, você precisa das seguintes ferramentas.

CLI do Azure para Windows.
Helm para Windows.

Se você preferir usar um sistema operacional cliente diferente, precisará selecionar os pacotes apropriados para essa plataforma.

Instalar kubectl usando o módulo Az PowerShell

Você usa kubectl para interagir com o cluster Kubernetes. Para obter mais informações, consulte az aks install-cli.

Para instalar o kubectl, execute o seguinte comando no prompt de comando do Windows:

az aks install-cli

Sugestão

Você pode adicionar kubectl à sua variável de ambiente local PATH , para que você não precise digitar o caminho completo a cada vez.

Conecte o kubectl ao cluster AKS

Você precisa mesclar o contexto do cluster AKS, para que os comandos kubectl ou helm sejam executados nesse cluster AKS específico.

Para mesclar, execute o comando conforme descrito no artigo Conectar ao cluster AKS :
```
az aks get-credentials --resource-group <resourcegroupname> --name <aks clustername>
```
Você verá a seguinte saída, onde <clustername> é o cluster fornecido e <username> é sua conta de usuário local do Windows:
```
Merged "<clustername>" as current context in C:\Users\<username>\.kube.config
```

Confirme se a fusão foi bem-sucedida executando kubectl get nodes. A saída deve mostrar os nós no contexto do seu cluster AKS.

NAME                    STATUS   ROLES   AGE    VERSION
<aks-node>-vmss000000   Ready    agent   141d   v1.16.13
<aks-node>-vmss000001   Ready    agent   141d   v1.16.13

Analise o gráfico Helm de exemplo

Agora você está pronto para implantar o SQL Server no cluster AKS por meio do gráfico Helm.

Este guia de início rápido fornece um exemplo de gráfico "as-is" amostra "as-is" Helm. A amostra é apenas para referência. Lembre-se de revisar o readme arquivo para entender os valores de configuração que correspondem aos seus requisitos de configuração.

Se pretender implantar o SQL Server no modo StatefulSet, que é o modo recomendado para implantações do SQL Server, pode consultar um exemplo de implementação de um gráfico Helm baseado em StatefulSet "as-is".

Faça o download do gráfico Helm de exemplo.
Alterne para o diretório onde você baixou o gráfico de exemplo e modifique o values.yaml arquivo, se necessário.

Implantar o SQL Server no cluster AKS

Implante o SQL Server usando o seguinte comando. O nome da implantação é personalizável, para que você possa alterar mssql-latest-deploy para qualquer coisa que desejar.

helm install mssql-latest-deploy . --set ACCEPT_EULA.value=Y --set MSSQL_PID.value=Developer

Quando implementar um contentor para SQL Server 2025 (17.x) ou uma versão posterior, utilize MSSQL_PID=DeveloperStandard a edição Standard Developer e MSSQL_PID=Developer a edição Enterprise Developer.

No exemplo anterior, o gráfico e seus arquivos estão no diretório atual, representado pelo ponto (.). Você pode especificar o caminho do gráfico, se preferir.

Se for bem-sucedido, você verá uma saída semelhante:

NAME: mssql-latest-deploy
LAST DEPLOYED: Wed Apr 06 21:36:19 2022
NAMESPACE: default
STATUS: deployed
REVISION: 1

Verificar a implantação do SQL Server

A implantação em um cluster Kubernetes pode levar alguns minutos. Para verificar se a implantação foi bem-sucedida, execute o seguinte comando:

kubectl get all

Se for bem-sucedido, você verá uma saída semelhante:

NAME                                      READY   STATUS    RESTARTS   AGE
pod/mssql-latest-deploy-7f8c7f5bc-9grmg   1/1     Running   0          2m56s

NAME                          TYPE           CLUSTER-IP     EXTERNAL-IP   PORT(S)          AGE
service/kubernetes            ClusterIP      10.0.0.1       <none>        443/TCP          141d
service/mssql-latest-deploy   LoadBalancer   10.0.247.220   20.40.0.145   1433:30780/TCP   2m56s

NAME                                  READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/mssql-latest-deploy   1/1     1            1           2m56s

NAME                                            DESIRED   CURRENT   READY   AGE
replicaset.apps/mssql-latest-deploy-7f8c7f5bc   1         1         1       2m56s

Conectar-se ao SQL Server em execução no AKS

Você pode se conectar a uma instância do SQL Server usando qualquer ferramenta de cliente familiar do SQL Server, como sqlcmd, SQL Server Management Studio (SSMS) ou a extensão MSSQL para Visual Studio Code.

Por exemplo, se você se conectar à instância do SQL Server usando o SSMS, poderá usar as seguintes configurações:

Nome do servidor: Use o External-IP endereço do mssql-latest-deploy serviço. Neste exemplo, é 20.40.0.145.
Autenticação: Selecione Autenticação do SQL Server na lista suspensa.
Iniciar sessão: Use sa, que é a conta de administrador do sistema.
Palavra-passe: A sa senha corresponde ao valor fornecido na MSSQL_SA_PASSWORD opção de configuração, no values.yaml arquivo do gráfico Helm.

Depois de se conectar, você pode expandir a instância do SQL Server no Pesquisador de Objetos.

Limpeza de recursos

Se você não vai continuar usando seu cluster AKS, lembre-se de excluir seu cluster.

Comentários

Esta página foi útil?

Last updated on 2025-11-19