Tutorial - Usar serviços PaaS com um cluster do Serviço Kubernetes do Azure (AKS)

Com o Kubernetes, você pode usar serviços PaaS, como o Azure Service Bus, para desenvolver e executar seus aplicativos.

Neste tutorial, vais criar um namespace e uma fila do Barramento de Serviço do Azure para testar a tua aplicação. Sabe como:

Crie um namespace e uma fila no Barramento de Serviço do Azure.
Atualize o ficheiro Manifest do Kubernetes para utilizar a fila do Barramento de Serviço do Azure.
Teste o aplicativo atualizado fazendo um pedido.

Antes de começar

Em tutoriais anteriores, você empacotou um aplicativo em uma imagem de contêiner, carregou a imagem no Registro de Contêiner do Azure, criou um cluster Kubernetes e implantou um aplicativo. Para concluir este tutorial, precisa do ficheiro de manifesto previamente criado do Kubernetes aks-store-quickstart.yaml. Este download de arquivo foi incluído com o código-fonte do aplicativo em um tutorial anterior. Certifique-se de clonar o repositório e alterar os diretórios para o repositório clonado. Se você não concluiu essas etapas e quer acompanhar, comece com o Tutorial 1 - Preparar a inscrição para o AKS.

Este tutorial cria recursos faturáveis do Azure Service Bus. Para completar estes passos, use uma identidade que possa criar e gerir recursos do Service Bus e atualizar cargas de trabalho do AKS no seu grupo de recursos, como Contribuidor ou Proprietário.

Este tutorial requer a instalação do desktop AKS.

Criar variáveis de ambiente

Use a CLI do Azure para criar as seguintes variáveis de ambiente para usar nos comandos deste tutorial:
```
LOC_NAME=westus2
RAND=$RANDOM
RG_NAME=myResourceGroup
AKS_NAME=myAKSCluster
SB_NS=sb-store-demo-$RAND
```

Crie as seguintes variáveis de ambiente para usar para os comandos neste tutorial:

$LOC_NAME="westus2"
$rand=New-Object System.Random
$RAND=$rand.Next()
$RG_NAME="myResourceGroup"
$AKS_NAME="myAKSCluster"
$SB_NS="sb-store-demo-$RAND"

Criar namespace e fila do Barramento de Serviço do Azure

Em tutoriais anteriores, você usou um contêiner RabbitMQ para armazenar pedidos enviados pelo order-service. Neste tutorial, você usa um namespace do Barramento de Serviço do Azure para fornecer um contêiner de escopo para os recursos do Barramento de Serviço dentro do aplicativo. Você também usa uma fila de barramento do Serviço do Azure para enviar e receber mensagens entre os componentes do aplicativo. Para obter mais informações sobre o Barramento de Serviço do Azure, consulte Criar um namespace e fila do Barramento de Serviço do Azure.

Neste fluxo, order-service envia mensagens para a orders fila usando a sender regra de autorização e a chave que cria nesta secção.

Utilize a CLI do Azure para criar as seguintes variáveis de ambiente a utilizar nos comandos deste tutorial.

Crie um namespace Azure Service Bus usando o az servicebus namespace create comando.
```
az servicebus namespace create --name $SB_NS --resource-group $RG_NAME --location $LOC_NAME
```
Continue quando o comando for concluído com sucesso e devolve os detalhes do namespace.

Crie uma fila do Barramento de Serviço do Azure usando o az servicebus queue create comando.

az servicebus queue create --name orders --resource-group $RG_NAME --namespace-name $SB_NS

Verifique se a fila existe antes de continuar:

az servicebus queue show --name orders --resource-group $RG_NAME --namespace-name $SB_NS --query name -o tsv

Crie uma regra de autorização do Barramento de Serviço do Azure usando o az servicebus queue authorization-rule create comando.

az servicebus queue authorization-rule create \
    --name sender \
    --namespace-name $SB_NS \
    --resource-group $RG_NAME \
    --queue-name orders \
    --rights Send

Obtenha as credenciais do Barramento de Serviço do Azure para uso posterior usando os az servicebus namespace show comandos e az servicebus queue authorization-rule keys list .
```
az servicebus namespace show --name $SB_NS --resource-group $RG_NAME --query name -o tsv
az servicebus queue authorization-rule keys list --namespace-name $SB_NS --resource-group $RG_NAME --queue-name orders --name sender --query primaryKey -o tsv
```
Guarde estes valores para a etapa de atualização do manifesto:
- <REPLACE_WITH_YOUR_ACR_NAME>: o teu nome do Azure Container Registry de tutoriais anteriores.
- <REPLACE_WITH_YOUR_SB_NS_HOSTNAME>: $SB_NS.servicebus.windows.net.
- <REPLACE_WITH_YOUR_SB_SENDER_PASSWORD>: o primaryKey valor da saída do comando.

Crie um namespace do Barramento de Serviço do Azure usando o comando az servicebus namespace create.
```
az servicebus namespace create --name $SB_NS --resource-group $RG_NAME --location $LOC_NAME
```
Continue quando o comando terminar com sucesso e devolver os detalhes do namespace.

Crie uma fila do Barramento de Serviço do Azure usando o az servicebus queue create comando.

az servicebus queue create --name orders --resource-group $RG_NAME --namespace-name $SB_NS

Verifique se a fila existe antes de continuar.

az servicebus queue show --name orders --resource-group $RG_NAME --namespace-name $SB_NS --query name -o tsv

Crie uma regra de autorização do Barramento de Serviço do Azure usando o az servicebus queue authorization-rule create comando.

az servicebus queue authorization-rule create \
    --name sender \
    --namespace-name $SB_NS \
    --resource-group $RG_NAME \
    --queue-name orders \
    --rights Send

Obtenha as credenciais do Barramento de Serviço do Azure para uso posterior usando os az servicebus namespace show comandos e az servicebus queue authorization-rule keys list .
```
az servicebus namespace show --name $SB_NS --resource-group $RG_NAME --query name -o tsv
az servicebus queue authorization-rule keys list --namespace-name $SB_NS --resource-group $RG_NAME --queue-name orders --name sender --query primaryKey -o tsv
```
Guarde estes valores para a etapa de atualização do manifesto:
- <REPLACE_WITH_YOUR_ACR_NAME>: o teu nome do Azure Container Registry de tutoriais anteriores.
- <REPLACE_WITH_YOUR_SB_NS_HOSTNAME>: $SB_NS.servicebus.windows.net.
- <REPLACE_WITH_YOUR_SB_SENDER_PASSWORD>: o primaryKey valor do resultado do comando.

Crie um namespace do Barramento de Serviço do Azure usando o New-AzServiceBusNamespace cmdlet.
```
New-AzServiceBusNamespace -Name $SB_NS -ResourceGroupName $RG_NAME -Location $LOC_NAME
```
Continue quando o comando for concluído com sucesso e devolve os detalhes do namespace.

Crie uma fila do Barramento de Serviço do Azure usando o cmdlet New-AzServiceBusQueue.

New-AzServiceBusQueue -Name orders -ResourceGroupName $RG_NAME -NamespaceName $SB_NS

Verifique se a fila existe antes de continuar:

(Get-AzServiceBusQueue -Name orders -ResourceGroupName $RG_NAME -NamespaceName $SB_NS).Name

Crie uma regra de autorização no Azure Service Bus utilizando o cmdlet New-AzServiceBusAuthorizationRule.

New-AzServiceBusAuthorizationRule `
    -Name sender `
    -NamespaceName $SB_NS `
    -ResourceGroupName $RG_NAME `
    -QueueName orders `
    -Rights Send

Obtenha as credenciais do Barramento de Serviço do Azure para uso futuro usando os cmdlets Get-AzServiceBusNamespace e Get-AzServiceBusKey.
```
(Get-AzServiceBusNamespace -Name $SB_NS -ResourceGroupName $RG_NAME).Name 
(Get-AzServiceBusKey -NamespaceName $SB_NS -ResourceGroupName $RG_NAME -Name sender -QueueName orders).PrimaryKey
```
Guarde estes valores para a etapa de atualização do manifesto:
- <REPLACE_WITH_YOUR_ACR_NAME>: o teu nome do Azure Container Registry de tutoriais anteriores.
- <REPLACE_WITH_YOUR_SB_NS_HOSTNAME>: $SB_NS.servicebus.windows.net.
- <REPLACE_WITH_YOUR_SB_SENDER_PASSWORD>: o valor de PrimaryKey da saída do comando.

Atualizar arquivo de manifesto do Kubernetes

Vai a Projetos no desktop do AKS e seleciona aquele que criaste no tutorial anterior, my-dev-frontend.
Selecione o separador Recursos e depois selecione Cargas de trabalho>Implementação: order-service.
Selecione o editor.

Remova as secções existentes rabbitmq StatefulSet, ConfigMap e Service. Substitua a secção de Implementação existente order-service pelo seguinte conteúdo. Copiar e colar o conteúdo:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: order-service
spec:
  replicas: 1
  selector:
    matchLabels:
      app: order-service
  template:
    metadata:
      labels:
        app: order-service
    spec:
      nodeSelector:
        "kubernetes.io/os": linux
      containers:
      - name: order-service
        image: <REPLACE_WITH_YOUR_ACR_NAME>.azurecr.io/aks-store-demo/order-service:latest
        ports:
        - containerPort: 3000
        env:
        - name: ORDER_QUEUE_HOSTNAME
          value: "<REPLACE_WITH_YOUR_SB_NS_HOSTNAME>" # Example: sb-store-demo-123456.servicebus.windows.net
        - name: ORDER_QUEUE_PORT
          value: "5671"
        - name: ORDER_QUEUE_TRANSPORT
          value: "tls"
        - name: ORDER_QUEUE_USERNAME
          value: "sender"
        - name: ORDER_QUEUE_PASSWORD
          value: "<REPLACE_WITH_YOUR_SB_SENDER_PASSWORD>"
        - name: ORDER_QUEUE_NAME
          value: "orders"
        - name: FASTIFY_ADDRESS
          value: "0.0.0.0"
        resources:
          requests:
            cpu: 1m
            memory: 50Mi
          limits:
            cpu: 75m
            memory: 128Mi
        startupProbe:
          httpGet:
            path: /health
            port: 3000
          failureThreshold: 5
          initialDelaySeconds: 20
          periodSeconds: 10
        readinessProbe:
          httpGet:
            path: /health
            port: 3000
          failureThreshold: 3
          initialDelaySeconds: 3
          periodSeconds: 5
        livenessProbe:
          httpGet:
            path: /health
            port: 3000
          failureThreshold: 5
          initialDelaySeconds: 3
          periodSeconds: 3

Captura de ecrã que mostra usar o editor para atualizar a implementação YAML.

Nota

Adicionar diretamente informação sensível, como chaves de API, aos ficheiros de manifesto do Kubernetes não é seguro e pode ser acidentalmente incluída em repositórios de código. Este exemplo adiciona-o por uma questão de simplicidade. Para cargas de trabalho de produção, use a Identidade Gerida para autenticar com o Barramento de Serviço do Azure ou armazenar os seus segredos no Cofre das Chaves do Azure.

Mantenha a atualização selecionando Guardar e Aplicar.
Verifique se a implementação atualizada order-service atinge um estado saudável na vista de carga de trabalho antes de continuar.

Configure kubectl para se conectar ao cluster usando o comando az aks get-credentials.
```
az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
```
Abra o aks-store-quickstart.yaml ficheiro num editor de texto.
Remova as secções existentes rabbitmq StatefulSet, ConfigMap e Service. Substitua a secção de Implementação existente order-service pelo seguinte conteúdo:

Substitua os marcadores de posição no YAML pelos valores que guardou anteriormente antes de aplicar o manifest.

  apiVersion: apps/v1
  kind: Deployment
  metadata:
    name: order-service
  spec:
    replicas: 1
    selector:
      matchLabels:
        app: order-service
    template:
      metadata:
        labels:
          app: order-service
      spec:
        nodeSelector:
          "kubernetes.io/os": linux
        containers:
        - name: order-service
          image: <REPLACE_WITH_YOUR_ACR_NAME>.azurecr.io/aks-store-demo/order-service:latest
          ports:
          - containerPort: 3000
          env:
          - name: ORDER_QUEUE_HOSTNAME
            value: "<REPLACE_WITH_YOUR_SB_NS_HOSTNAME>" # Example: sb-store-demo-123456.servicebus.windows.net
          - name: ORDER_QUEUE_USERNAME
            value: "sender"
          - name: ORDER_QUEUE_PASSWORD
            value: "<REPLACE_WITH_YOUR_SB_SENDER_PASSWORD>"
          - name: ORDER_QUEUE_NAME
            value: "orders"
          - name: FASTIFY_ADDRESS
            value: "0.0.0.0"
          resources:
            requests:
              cpu: 1m
              memory: 50Mi
            limits:
              cpu: 75m
              memory: 128Mi
          startupProbe:
            httpGet:
              path: /health
              port: 3000
            failureThreshold: 5
            initialDelaySeconds: 20
            periodSeconds: 10
          readinessProbe:
            httpGet:
              path: /health
              port: 3000
            failureThreshold: 3
            initialDelaySeconds: 3
            periodSeconds: 5
          livenessProbe:
            httpGet:
              path: /health
              port: 3000
            failureThreshold: 5
            initialDelaySeconds: 3
            periodSeconds: 3

Nota

Adicionar diretamente informações confidenciais, como chaves de API, aos seus arquivos de manifesto do Kubernetes não é seguro e pode ser acidentalmente confirmado em repositórios de código. Nós o adicionamos aqui para simplificar. Para cargas de trabalho de produção, use a Identidade Gerida para autenticar com o Barramento de Serviço do Azure ou armazenar os seus segredos no Cofre das Chaves do Azure.

Salve e feche o arquivo atualizado aks-store-quickstart.yaml .

Configure kubectl para ligar-se ao seu cluster usando Import-AzAksCredential cmdlet.
```
Import-AzAksCredential -ResourceGroupName myResourceGroup -Name myAKSCluster
```
Abra o aks-store-quickstart.yaml ficheiro num editor de texto.
Remover as secções existentes rabbitmq de Implantação e Serviço e substituir a secção existente order-service de Implementação pelo seguinte conteúdo:

Substitua os marcadores de posição no YAML pelos valores que guardou anteriormente antes de aplicar o manifest.

  apiVersion: apps/v1
  kind: Deployment
  metadata:
    name: order-service
  spec:
    replicas: 1
    selector:
      matchLabels:
        app: order-service
    template:
      metadata:
        labels:
          app: order-service
      spec:
        nodeSelector:
          "kubernetes.io/os": linux
        containers:
        - name: order-service
          image: <REPLACE_WITH_YOUR_ACR_NAME>.azurecr.io/aks-store-demo/order-service:latest
          ports:
          - containerPort: 3000
          env:
          - name: ORDER_QUEUE_HOSTNAME
            value: "<REPLACE_WITH_YOUR_SB_NS_HOSTNAME>" # Example: sb-store-demo-123456.servicebus.windows.net
          - name: ORDER_QUEUE_USERNAME
            value: "sender"
          - name: ORDER_QUEUE_PASSWORD
            value: "<REPLACE_WITH_YOUR_SB_SENDER_PASSWORD>"
          - name: ORDER_QUEUE_NAME
            value: "orders"
          - name: FASTIFY_ADDRESS
            value: "0.0.0.0"
          resources:
            requests:
              cpu: 1m
              memory: 50Mi
            limits:
              cpu: 75m
              memory: 128Mi

Nota

Salve e feche o arquivo atualizado aks-store-quickstart.yaml .

Implementar a aplicação atualizada

Implemente a aplicação atualizada usando o kubectl apply comando.

kubectl apply -f aks-store-quickstart.yaml

A saída de exemplo a seguir mostra os recursos atualizados com êxito:

deployment.apps/order-service configured
service/order-service unchanged
deployment.apps/product-service unchanged
service/product-service unchanged
deployment.apps/store-front configured
service/store-front unchanged

Verifica se a implementação atualizada está a funcionar.
```
kubectl get pods
```

Continue quando os pods de aplicação estiverem em estado Running.

Testar a aplicação

Fazer uma encomenda de amostras

AKS Desktop

Obtenha o endereço IP público indo a Resource>Network>Service: store-front>External IP.

Captura de ecrã que mostra obter o endereço IP externo.

Linha de comandos

Obtenha o endereço IP externo do store-front serviço usando o kubectl get service comando.
```
kubectl get service store-front
```
Se EXTERNAL-IP for <pending>, espere um minuto e execute novamente o comando até que apareça um endereço IP público.
Navegue até o endereço IP externo do serviço store-front usando o http://<external-ip> no seu navegador.
Faça um pedido escolhendo um produto e selecionando Adicionar ao carrinho.
Selecione Carrinho para ver a sua encomenda e, em seguida, selecione Finalizar Compra.

Exibir o pedido na fila do Barramento de Serviço do Azure

Navegue até o portal do Azure e abra o namespace do Barramento de Serviço do Azure que criou anteriormente.
Em Entidades, selecione Filas e, em seguida, selecione a fila de pedidos.
Na fila de pedidos , selecione Service Bus Explorer.
Selecione Ver desde o início para ver a encomenda que enviou.

Próximos passos

Neste tutorial, você usou o Barramento de Serviço do Azure para atualizar e testar o aplicativo de exemplo. Aprendeu a:

Crie um namespace e uma fila no Barramento de Serviço do Azure.
Atualize o ficheiro Manifest do Kubernetes para utilizar a fila do Barramento de Serviço do Azure.
Teste o aplicativo atualizado fazendo um pedido.

No próximo tutorial, você aprenderá como dimensionar um aplicativo no AKS.

Aplicações de escala no AKS

Comentários

Esta página foi útil?

Last updated on 2026-07-02

Tutorial - Usar serviços PaaS com um cluster do Serviço Kubernetes do Azure (AKS)

Antes de começar

Criar variáveis de ambiente

Criar namespace e fila do Barramento de Serviço do Azure

Atualizar arquivo de manifesto do Kubernetes

Implementar a aplicação atualizada

Testar a aplicação

Fazer uma encomenda de amostras

AKS Desktop

Linha de comandos

Exibir o pedido na fila do Barramento de Serviço do Azure

Próximos passos

Comentários

Recursos adicionais