Exercício – Implantar um aplicativo no seu cluster do Serviço de Kubernetes do Azure

• 10 minutos

Neste exercício, implante o site da sua empresa como um aplicativo de teste no AKS (Serviço de Kubernetes do Azure). O site é estático, com uma pilha de tecnologia subjacente composta por HTML, CSS e JavaScript. Ele não recebe tantas solicitações quanto os outros serviços e nos proporciona uma forma segura de testar as opções de implantação.

Criar um manifesto de implantação

Você cria um arquivo de manifesto de implantação para implantar seu aplicativo. O arquivo de manifesto permite que você defina o tipo de recurso que deseja implantar e todos os detalhes associados à carga de trabalho.

O Kubernetes agrupa os contêineres em estruturas lógicas chamadas pods, que não têm inteligência. As implantações adicionam a inteligência ausente para criar o seu aplicativo. Vamos criar um arquivo de implantação.

1. Entre no Azure Cloud Shell.

   Azure Cloud Shell

2. No Cloud Shell, crie um arquivo de manifesto para a implantação do Kubernetes chamado deployment.yaml usando o editor integrado.

   touch deployment.yaml
   

3. Abra o editor integrado no Cloud Shell inserindo code .

4. Abra o arquivo deployment.yaml e adicione a seguinte seção de código do YAML.

   # deployment.yaml
   apiVersion: apps/v1 # The API resource where this workload resides
   kind: Deployment # The kind of workload we're creating
   metadata:
     name: contoso-website # This will be the name of the deployment
   

   Nesse código, você adicionou as duas primeiras chaves para informar ao Kubernetes o apiVersion e o kind do manifesto que você está criando. O name é o nome da implantação. Use-o para identificar e consultar as informações da implantação quando usar o kubectl.

   Dica

   Para obter mais informações sobre o apiVersion e quais valores colocar nessa chave, consulte a documentação oficial do Kubernetes. O link está localizado no final deste módulo.

5. Uma implantação encapsula um pod. Você usa uma definição de modelo para definir as informações do pod dentro do arquivo de manifesto. O modelo é colocado no arquivo de manifesto na seção de especificação da implantação.

   Atualize o arquivo deployment.yaml para que ele corresponda ao seguinte YAML.

   # deployment.yaml
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: contoso-website
   spec:
     template: # This is the template of the pod inside the deployment
       metadata: # Metadata for the pod
         labels:
           app: contoso-website
   

   Os pods não usam os mesmos nomes que as implantações. O nome do pod é uma combinação do nome da implantação com uma ID aleatória adicionada ao final.

   Observe o uso da chave labels. A chave labels é adicionada para permitir que as implantações encontrem e agrupem os pods.

6. Um pod encapsula um ou mais contêineres. Todos os pods têm uma seção de especificação que permite a definição de contêineres dentro do pod em questão.

   Atualize o arquivo deployment.yaml para que ele corresponda ao YAML a seguir.

   # deployment.yaml
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: contoso-website
   spec:
     template: # This is the template of the pod inside the deployment
       metadata:
         labels:
           app: contoso-website
       spec:
         containers: # Here we define all containers
           - name: contoso-website
   

   A chave containers é uma matriz de especificações de contêiner, pois um pod pode ter um ou mais contêineres. A especificação define uma image, um name, os resources, as ports e outras informações importantes sobre o contêiner.

   Todos os pods em execução seguem o nome contoso-website-<UUID>, em que a UUID é uma ID gerada para identificar todos os recursos de maneira exclusiva.

7. É uma boa prática definir uma quantidade mínima e máxima de recursos que o aplicativo tem permissão para usar no cluster. A chave resources é usada para especificar essas informações.

   Atualize o arquivo deployment.yaml para que ele corresponda ao seguinte YAML.

   # deployment.yaml
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: contoso-website
   spec:
     template: # This is the template of the pod inside the deployment
       metadata:
         labels:
           app: contoso-website
       spec:
         containers:
           - image: mcr.microsoft.com/mslearn/samples/contoso-website
             name: contoso-website
             resources:
               requests: # Minimum amount of resources requested
                 cpu: 100m
                 memory: 128Mi
               limits: # Maximum amount of resources requested
                 cpu: 250m
                 memory: 256Mi
   

   Observe como a seção de recursos permite que você especifique a quantidade mínima de recursos como uma solicitação e o valor máximo do recurso como um limite.

8. A última etapa é definir as portas que são expostas externamente por esse contêiner por meio da chave ports. A chave ports é uma matriz de objetos, o que significa que um contêiner em um pod pode expor várias portas com vários nomes.

   Atualize o arquivo deployment.yaml para que ele corresponda ao YAML a seguir.

   # deployment.yaml
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: contoso-website
   spec:
     template: # This is the template of the pod inside the deployment
       metadata:
         labels:
           app: contoso-website
       spec:
         nodeSelector:
           kubernetes.io/os: linux
         containers:
           - image: mcr.microsoft.com/mslearn/samples/contoso-website
             name: contoso-website
             resources:
               requests:
                 cpu: 100m
                 memory: 128Mi
               limits:
                 cpu: 250m
                 memory: 256Mi
             ports:
               - containerPort: 80 # This container exposes port 80
                 name: http # We named that port "http" so we can refer to it later
   

   Observe como a porta é nomeada usando a chave name. A nomeação de portas permite que você altere a porta exposta sem alterar os arquivos que referenciam essa porta.

9. Por fim, adicione uma seção de seletor para definir as cargas de trabalho gerenciadas pela implantação. A chave selector é colocada dentro da seção de especificação de implantação do arquivo de manifesto. Use a chave matchLabels para listar os rótulos de todos os pods gerenciados pela implantação.

   Atualize o arquivo deployment.yaml para que ele corresponda ao YAML a seguir.

   # deployment.yaml
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: contoso-website
   spec:
     selector: # Define the wrapping strategy
       matchLabels: # Match all pods with the defined labels
         app: contoso-website # Labels follow the `name: value` template
     template: # This is the template of the pod inside the deployment
       metadata:
         labels:
           app: contoso-website
       spec:
         nodeSelector:
           kubernetes.io/os: linux
         containers:
           - image: mcr.microsoft.com/mslearn/samples/contoso-website
             name: contoso-website
             resources:
               requests:
                 cpu: 100m
                 memory: 128Mi
               limits:
                 cpu: 250m
                 memory: 256Mi
             ports:
               - containerPort: 80
                 name: http
   

   Observação

   Em um cluster do AKS que tem vários pools de nós (Linux e Windows), o arquivo de manifesto de implantação listado anteriormente também define um nodeSelector para instruir o cluster do AKS a executar o pod do aplicativo de exemplo em um nó que possa executar contêineres do Linux.

   Os nós do Linux não podem executar contêineres do Windows e vice-versa.

10. Salve o arquivo de manifesto e feche o editor.

Aplicar o manifesto

1. No Cloud Shell, execute o comando kubectl apply para enviar o manifesto de implantação ao cluster.

   kubectl apply -f ./deployment.yaml
   

   O comando vai gerar um resultado semelhante ao exemplo a seguir.

   deployment.apps/contoso-website created
   

2. Execute o comando kubectl get deploy para verificar se a implantação foi bem-sucedida.

   kubectl get deploy contoso-website
   

   O comando vai gerar uma tabela semelhante ao exemplo a seguir.

   NAME              READY   UP-TO-DATE   AVAILABLE   AGE
   contoso-website   0/1     1            0           16s
   

3. Execute o comando kubectl get pods para verificar se o pod está em execução.

   kubectl get pods
   

   O comando vai gerar uma tabela semelhante ao exemplo a seguir.

   NAME                               READY   STATUS    RESTARTS   AGE
   contoso-website-7c58c5f699-r79mv   1/1     Running   0          63s