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

Este tutorial requer a CLI do Azure versão 2.34.1 ou posterior. Executar az --version para localizar a versão. Se precisar de instalar ou atualizar, veja Install Azure CLI (Instalar o Azure CLI).

Este tutorial requer o Azure PowerShell versão 5.9.0 ou posterior. Executar Get-InstalledModule -Name Az para localizar a versão. Se precisar de instalar ou atualizar, veja Install Azure PowerShell(Instalar o Azure PowerShell).

• Crie as seguintes variáveis de ambiente para usar para os comandos neste 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"
  

1. 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
   

2. 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
   

3. 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
   

4. 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
   

1. 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
   

2. 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
   

3. 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
   

4. 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
   

1. Configure kubectl para se conectar ao cluster usando o comando az aks get-credentials.

   az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
   

2. Abra o aks-store-quickstart.yaml ficheiro num editor de texto.

3. Remova as seções StatefulSet, ConfigMap e Service existentes rabbitmq e substitua a seção Deployment existente order-service pelo seguinte 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
   

   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.

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

1. Configure kubectl para ligar-se ao seu cluster usando Import-AzAksCredential cmdlet.

   Import-AzAksCredential -ResourceGroupName myResourceGroup -Name myAKSCluster
   

2. Abra o aks-store-quickstart.yaml ficheiro num editor de texto.

3. Remova as seções Implantação, ConfigMap e Serviço existentes rabbitmq e substitua a seção Implantação existente order-service pelo seguinte 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
   

   Nota

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

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