Tutorial: Conectar o AKS ao Azure OpenAI

Este tutorial mostra como conectar seus aplicativos Azure Kubernetes Service (AKS) a Azure OpenAI usando o Service Connector com autenticação de identidade de carga de trabalho. Em seguida, você estabelece e testa suas conexões sem credenciais implantando um aplicativo Python de exemplo que se comunica com o Azure OpenAI.

Neste tutorial, você:

Crie um cluster do AKS e um recurso Azure OpenAI usando o modelo GPT-4.
Configure o Service Connector para estabelecer a conexão com a identidade da carga de trabalho.
Clone um aplicativo de exemplo.
Crie e envie imagens de contêiner por push para Azure Container Registry.
Implante o aplicativo no AKS e verifique a conexão.
Limpe os recursos.

Pré-requisitos

Uma conta Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- Use o ambiente bash em Azure Cloud Shell. Para obter mais informações, consulte Get iniciado com Azure Cloud Shell.
- Se você preferir executar comandos de referência da CLI localmente, instalar o Azure CLI. Se você estiver executando em Windows ou macOS, considere executar Azure CLI em um contêiner do Docker. Para obter mais informações, consulte Como executar o Azure CLI em um contêiner do Docker.
  - Se você estiver usando uma instalação local, entre no Azure CLI usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para obter outras opções de entrada, consulte Authenticate para Azure usando Azure CLI.
  - Quando for solicitado, instale a extensão Azure CLI no primeiro uso. Para obter mais informações sobre extensões, consulte Use e gerencie extensões com o Azure CLI.
  - Execute o comando az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.
Instale o Dockere kubectl para gerenciar as imagens do contêiner e os recursos do Kubernetes.
Conhecimento básico de contêineres e AKS. Comece a partir da preparação de um aplicativo para o AKS.
Permissões de acesso para criar recursos Azure OpenAI e implantar modelos.

Criar recursos do Azure OpenAI e do AKS

Inicie este tutorial criando vários recursos de Azure.

Crie um grupo de recursos para este tutorial.

az group create \
    --name MyResourceGroup \
    --location eastus

Crie um cluster do AKS com o comando a seguir ou consulte o Guia de início rápido do AKS. Neste tutorial, criamos a conexão de serviço e a definição do pod e implantamos o aplicativo de exemplo nesse cluster.
```
az aks create \
    --resource-group MyResourceGroup \
    --name MyAKSCluster \
    --enable-managed-identity \
    --node-count 1 \
    --generate-ssh-keys
```

Conecte-se ao cluster usando o comando az aks get-credentials.

az aks get-credentials \
    --resource-group MyResourceGroup \
    --name MyAKSCluster

Crie um recurso Azure OpenAI usando o comando az cognitiveservices account create. Opcionalmente, consulte este tutorial para obter mais instruções. Azure OpenAI é o serviço de destino ao qual o cluster do AKS se conecta.

az cognitiveservices account create \
    --resource-group MyResourceGroup \
    --name MyOpenAI \
    --location eastus \
    --kind OpenAI \
    --sku s0 \
    --custom-domain myopenai \
    --subscription <SubscriptionID>

Implante um modelo com o az cognitiveservices deployment create comando. O modelo é usado no aplicativo de exemplo para testar a conexão.

az cognitiveservices account deployment create \
    --resource-group MyResourceGroup \
    --name MyOpenAI \
    --deployment-name MyModel \
    --model-name gpt-4 \
    --model-version 0613 \
    --model-format OpenAI \
    --sku-name "Standard" \
    --capacity 1

Para armazenar o aplicativo de exemplo em contêineres, crie um ACR (Azure Container Registry). Use o az acr create comando ou consulte este tutorial.
```
az acr create \
    --resource-group MyResourceGroup \
    --name myregistry \
    --sku Standard
```
Habilite o pull anônimo usando o comando az acr update para que o cluster do AKS possa consumir as imagens no registro.
```
az acr update \
    --resource-group MyResourceGroup \
    --name myregistry \
    --anonymous-pull-enabled
```
Crie uma identidade gerenciada atribuída pelo usuário com o az identity create comando ou referindo-se a este tutorial. Quando a conexão é criada, a identidade gerenciada atribuída pelo usuário é usada para habilitar a identidade da carga de trabalho para cargas de trabalho do AKS.
```
az identity create \
    --resource-group MyResourceGroup \
    --name MyIdentity
```

Criar uma conexão de serviço do AKS para Azure OpenAI

Crie uma conexão de serviço entre um cluster do AKS e Azure OpenAI no portal do Azure ou no Azure CLI.

Portal
Azure CLI

Consulte o início rápido da conexão de serviço do AKS para obter instruções para criar uma conexão e preencher as configurações referentes aos exemplos na tabela a seguir. Deixe todas as outras configurações com os valores padrão delas.

Guia Básico:

Configuração	Valor de exemplo	Descrição
Namespace do Kubernetes	padrão	O namespace do Kubernetes.
Tipo de serviço	Serviço OpenAI	O tipo de serviço de destino.
Nome da conexão	openai_conn	Use o nome da conexão fornecido pelo Conector de Serviço ou escolha um nome de conexão próprio.
Subscription	Minha assinatura	A assinatura Azure que contém o recurso Azure OpenAI.
OpenAI	MyOpenAI	O recurso do Azure OpenAI ao qual você deseja se conectar.
Tipo de cliente	Python	A linguagem de programação ou a estrutura para a configuração de conexão.

Guia Autenticação:

Configuração de Autenticação	Valor de exemplo	Descrição
Tipo de autenticação	Identidade da Carga de Trabalho	O método de autenticação para conectar o aplicativo ao Azure OpenAI. A identidade da carga de trabalho é recomendada para segurança aprimorada. Métodos alternativos incluem cadeia de conexão e principal de serviço e requerem considerações sobre o gerenciamento de credenciais.
Subscription	Minha assinatura	A assinatura que contém a identidade gerenciada atribuída pelo usuário.
Identidade gerenciada atribuída ao usuário	MyIdentity	A identidade gerenciada atribuída pelo usuário que habilita a autenticação de identidade de carga de trabalho para o cluster do AKS.

Depois que a conexão for criada, você poderá ver os detalhes no painel Conector de Serviço.

Crie uma conexão de serviço do AKS para o recurso Azure OpenAI executando o comando az aks connection create cognitiveservices no Azure CLI.

az aks connection create cognitiveservices \
   --workload-identity <user-identity-resource-id>

Quando você usa o comando anterior, o Service Connector solicita que você especifique passo a passo: o grupo de recursos do AKS, o nome do cluster do AKS, o grupo de recursos de serviço de destino, o nome da conta de serviço cognitivo e a ID do recurso de identidade atribuída pelo usuário.

Como alternativa, você pode fornecer o comando completo diretamente:

az aks connection create cognitiveservices \
   --workload-identity <user-identity-resource-id> \
   --resource-group <aks-cluster-resource-group> \
   --name <aks-cluster-name> \
   --target-resource-group <target-cognitive-services-resource-group> \
   --account <target-cognitive-services-account>

Observação

Este tutorial usa a identidade da carga de trabalho para segurança aprimorada. Para cenários de desenvolvimento, você também pode usar a autenticação da string de conexão ao omitir o parâmetro --workload-identity e usar --secret.

Clonar um aplicativo de exemplo Python

Clone o repositório de exemplo:

git clone https://github.com/Azure-Samples/serviceconnector-aks-samples.git

Vá para a pasta de exemplo do repositório para Azure OpenAI:

cd serviceconnector-aks-samples/azure-openai-workload-identity

Substitua o espaço reservado <MyModel> no arquivo app.py pelo nome do modelo que implantamos.

Compilar e enviar imagens de contêiner por push para Azure Container Registry

Compile e efetue push das imagens para o registro de contêiner usando o comando az acr build da CLI do Azure.
```
az acr build --registry myregistry --image sc-demo-openai-identity:latest ./
```
Exiba as imagens no registro do contêiner usando o comando az acr repository list.
```
az acr repository list --name myregistry --output table
```

Implantar e testar a conexão do AKS com o Azure OpenAI

Substitua os espaços reservados no arquivo pod.yaml na pasta azure-openai-workload-identity.
- Substitua <YourContainerImage> pelo nome da imagem que você criou anteriormente. Por exemplo, <myregistry>.azurecr.io/<sc-demo-openai-identity>:<latest>.
- Substitua <ServiceAccountCreatedByServiceConnector> pelo nome da conta de serviço. Ele pode ser encontrado no portal Azure, no painel Service Connector.
- Substitua <SecretCreatedByServiceConnector> pelo nome do segredo. Ele pode ser encontrado no portal Azure, no painel Service Connector.
Implante o pod no cluster com o comando kubectl apply, que cria um pod chamado sc-demo-openai-identity no namespace padrão do cluster do AKS. Instale kubectl localmente usando o az aks install-cli comando se ele não estiver instalado.
```
kubectl apply -f pod.yaml
```
Verifique se a implantação foi bem-sucedida exibindo o pod com kubectl.
```
kubectl get pod/sc-demo-openai-identity
```
Verifique se a conexão é estabelecida exibindo os logs com kubectl.
```
kubectl logs pod/sc-demo-openai-identity
```

Limpar os recursos

Se você não precisar mais dos recursos criados neste tutorial, limpe-os excluindo o grupo de recursos.

az group delete \
    --resource-group MyResourceGroup

Comentários

Esta página foi útil?

Last updated on 2026-03-11