Solucionar problemas do Kubernetes em Clusters de Big Data do SQL Server

Aplica-se a: SQL Server 2019 (15.x)

Este artigo descreve vários comandos úteis do Kubernetes que você pode usar para monitorar e solucionar problemas de Clusters de Big Data do SQL Server 2019. Ele mostra como exibir detalhes de um pod ou outros artefatos do Kubernetes que estão localizados no cluster de Big Data. Este artigo também aborda tarefas comuns, como copiar arquivos bidirecionalmente em um contêiner que executa um dos serviços de cluster de Big Data do SQL Server.

Obter o status de pods

Use o comando kubectl get pods para obter o status de pods no cluster para todos os namespaces ou o namespace do cluster de Big Data. As seções a seguir mostram exemplos de ambos.

Mostrar o status de todos os pods no cluster do Kubernetes

Execute o comando a seguir para obter todos os pods e os status, incluindo os pods que fazem parte do namespace no qual os pods de clusters de Big Data do SQL Server são criados:

kubectl get pods --all-namespaces

Mostrar o status de todos os pods no cluster de Big Data do SQL Server

Use o parâmetro -n para especificar um namespace específico. Observe que os pods de clusters de Big Data do SQL Server são criados em um namespace criado no momento de inicialização do cluster com base no nome do cluster especificado no arquivo de configuração de implantação. O nome padrão, mssql-cluster, é usado aqui.

kubectl get pods -n mssql-cluster

Você deverá ver uma saída semelhante à seguinte lista para um cluster de Big Data em execução:

PS C:\> kubectl get pods -n mssql-cluster
NAME              READY   STATUS    RESTARTS   AGE
appproxy-f2qqt    2/2     Running   0          110m
compute-0-0       3/3     Running   0          110m
control-zlncl     4/4     Running   0          118m
data-0-0          3/3     Running   0          110m
data-0-1          3/3     Running   0          110m
gateway-0         2/2     Running   0          109m
logsdb-0          1/1     Running   0          112m
logsui-jtdnv      1/1     Running   0          112m
master-0          7/7     Running   0          110m
metricsdb-0       1/1     Running   0          112m
metricsdc-shv2f   1/1     Running   0          112m
metricsui-9bcj7   1/1     Running   0          112m
mgmtproxy-x6gcs   2/2     Running   0          112m
nmnode-0-0        1/1     Running   0          110m
storage-0-0       7/7     Running   0          110m
storage-0-1       7/7     Running   0          110m

Obter detalhes do pod

Execute o comando a seguir para obter uma descrição detalhada de um pod específico na saída de formato JSON. Ele inclui detalhes, como o nó atual do Kubernetes no qual o pod é colocado, os contêineres em execução no pod e a imagem usada para inicializar os contêineres. Ele também mostra outros detalhes, como rótulos, status e declarações de volumes persistentes associados ao pod.

kubectl describe pod  <pod_name> -n <namespace_name>

O seguinte exemplo mostra os detalhes do pod master-0 em um cluster de Big Data chamado mssql-cluster:

kubectl describe pod  master-0 -n mssql-cluster

Caso ocorram erros, às vezes, você poderá ver o erro nos eventos recentes do pod.

Obter os logs do pod

Você poderá recuperar os logs para contêineres em execução em um pod. O seguinte comando recupera os logs de todos os contêineres em execução no pod chamado master-0 e os gera em um arquivo chamado master-0-pod-logs.txt:

kubectl logs master-0 --all-containers=true -n mssql-cluster > master-0-pod-logs.txt

Obter o status de serviços

Execute o comando a seguir para obter detalhes dos serviços de clusters de Big Data. Esses detalhes incluem o tipo e os IPs associados aos respectivos serviços e às respectivas portas. Observe que os serviços de clusters de Big Data do SQL Server são criados em um namespace criado no momento de inicialização do cluster com base no nome do cluster especificado no arquivo de configuração de implantação.

kubectl get svc -n <namespace_name>

O seguinte exemplo mostra o status dos serviços em um cluster de Big Data chamado mssql-cluster:

kubectl get svc -n mssql-cluster

Os seguintes serviços dão suporte a conexões externas com o cluster de Big Data:

¹ A partir do SQL Server 2019 (15.x) CU 5, quando você implanta um novo cluster com a autenticação básica, todos os pontos de extremidade, incluindo o gateway, usam AZDATA_USERNAME e AZDATA_PASSWORD. Os pontos de extremidade em clusters que são atualizados para CU 5 continuam usando root como o nome de usuário para se conectar ao ponto de extremidade do gateway. Essa alteração não se aplica às implantações que usam a autenticação do Active Directory. Confira Credenciais para acessar serviços por meio do ponto de extremidade do gateway nas notas sobre a versão.

Obter detalhes do serviço

Execute este comando para obter uma descrição detalhada de um serviço na saída de formato JSON. Ele incluirá detalhes como rótulos, seletores, IP, IP externo (se o serviço for do tipo LoadBalancer), porta etc.

kubectl describe service <service_name> -n <namespace_name>

O seguinte exemplo recupera detalhes do serviço master-svc-external:

kubectl describe service master-svc-external -n mssql-cluster

Copiar arquivos

Caso precise copiar arquivos do contêiner para o computador local, use o comando kubectl cp com a seguinte sintaxe:

kubectl cp <pod_name>:<source_file_path> -c <container_name> -n <namespace_name> <target_local_file_path>

Da mesma forma, use kubectl cp para copiar arquivos do computador local para um contêiner específico.

kubectl cp <source_local_file_path> <pod_name>:<target_container_path> -c <container_name>  -n <namespace_name>

Copiar arquivos de um contêiner

O seguinte exemplo copia os arquivos de log de SQL Server do contêiner para o caminho ~/temp/sqlserverlogs no computador local (neste exemplo, o computador local é um cliente Linux):

kubectl cp master-0:/var/opt/mssql/log -c mssql-server -n mssql-cluster ~/tmp/sqlserverlogs

Copiar arquivos para o contêiner

O exemplo a seguir copia o arquivo AdventureWorks2022 do computador local para o contêiner da instância mestra do SQL Server (mssql-server) no pod master-0. O arquivo é copiado para o diretório /tmp no contêiner.

kubectl cp ~/Downloads/AdventureWorks2022.bak master-0:/tmp -c mssql-server -n mssql-cluster

Forçar a exclusão de um pod

Não é recomendável forçar a exclusão de um pod. Porém, para testar a disponibilidade, a resiliência ou a persistência de dados, você pode excluir um pod para simular uma falha de pod com o comando kubectl delete pods.

kubectl delete pods <pod_name> -n <namespace_name> --grace-period=0 --force

O seguinte exemplo exclui o pod do pool de armazenamento, storage-0-0:

kubectl delete pods storage-0-0 -n mssql-cluster --grace-period=0 --force

Obter o IP do pod

Para fins de solução de problemas, talvez seja necessário obter o IP do nó em que um pod está sendo executado. Para obter o endereço IP, use o comando kubectl get pods com a seguinte sintaxe:

kubectl get pods <pod_name> -o yaml -n <namespace_name> | grep hostIP

O seguinte exemplo obtém o endereço IP do nó em que o pod master-0 está em execução:

kubectl get pods master-0 -o yaml -n mssql-cluster | grep hostIP

Painel do Kubernetes

Inicie o painel do Kubernetes para obter mais informações sobre o cluster. As seções a seguir explicam como iniciar o painel do Kubernetes no AKS e do Kubernetes inicializado usando o kubeadm.

Iniciar o painel quando o cluster estiver em execução no AKS

Para iniciar a execução do painel do Kubernetes:

az aks browse --resource-group <azure_resource_group> --name <aks_cluster_name>

Ao iniciar o painel no navegador, você poderá obter avisos de permissão devido ao RBAC estar habilitado por padrão em clusters do AKS. Além disso, a conta de serviço usada pelo painel não tem permissões suficientes para acessar todos os recursos (por exemplo, pods são proibidos: O usuário "system:serviceaccount:kube-system:kubernetes-dashboard" não pode listar os pods no namespace "padrão" ). Execute o seguinte comando para conceder as permissões necessárias ao kubernetes-dashboard e, em seguida, reinicie o painel:

kubectl create clusterrolebinding kubernetes-dashboard -n kube-system --clusterrole=cluster-admin --serviceaccount=kube-system:kubernetes-dashboard

Iniciar o dashboard quando o cluster do Kubernetes for inicializado usando o kubeadm

Para obter instruções detalhadas sobre como implantar e configurar o painel no cluster do Kubernetes, confira a documentação do Kubernetes. Para iniciar o painel do Kubernetes, execute este comando:

kubectl proxy

Próximas etapas

Para obter mais informações sobre clusters de Big Data, confira O que são Clusters de Big Data do SQL Server.