|
| 1 | +--- |
| 2 | +title: Executar uma Aplicação Sem Estado com um Deployment |
| 3 | +min-kubernetes-server-version: v1.9 |
| 4 | +content_type: tutorial |
| 5 | +weight: 10 |
| 6 | +--- |
| 7 | + |
| 8 | +<!-- overview --> |
| 9 | + |
| 10 | +Esta página mostra como executar uma aplicação usando um objeto Deployment do Kubernetes. |
| 11 | + |
| 12 | +## {{% heading "objectives" %}} |
| 13 | + |
| 14 | +- Criar uma instalação do nginx com um Deployment. |
| 15 | +- Usar o kubectl para listar informações sobre o Deployment. |
| 16 | +- Atualizar o Deployment. |
| 17 | + |
| 18 | +## {{% heading "prerequisites" %}} |
| 19 | + |
| 20 | +{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} |
| 21 | + |
| 22 | +<!-- lessoncontent --> |
| 23 | + |
| 24 | +## Criando e explorando uma instalação do nginx com um Deployment |
| 25 | + |
| 26 | +Você pode executar uma aplicação criando um objeto Deployment do Kubernetes, e pode descrever um Deployment em um arquivo YAML. Por exemplo, este arquivo YAML descreve um Deployment que executa a imagem do contêiner nginx:1.14.2: |
| 27 | + |
| 28 | +{{% code_sample file="application/deployment.yaml" %}} |
| 29 | + |
| 30 | +1. Crie um Deployment com base no arquivo YAML: |
| 31 | + |
| 32 | + ```shell |
| 33 | + kubectl apply -f https://k8s.io/examples/application/deployment.yaml |
| 34 | + ``` |
| 35 | + |
| 36 | +1. Exiba informações sobre o Deployment: |
| 37 | + |
| 38 | + ```shell |
| 39 | + kubectl describe deployment nginx-deployment |
| 40 | + ``` |
| 41 | + |
| 42 | + A saída é semelhante a esta: |
| 43 | + |
| 44 | + ``` |
| 45 | + Name: nginx-deployment |
| 46 | + Namespace: default |
| 47 | + CreationTimestamp: Tue, 30 Aug 2016 18:11:37 -0700 |
| 48 | + Labels: app=nginx |
| 49 | + Annotations: deployment.kubernetes.io/revision=1 |
| 50 | + Selector: app=nginx |
| 51 | + Replicas: 2 desired | 2 updated | 2 total | 2 available | 0 unavailable |
| 52 | + StrategyType: RollingUpdate |
| 53 | + MinReadySeconds: 0 |
| 54 | + RollingUpdateStrategy: 1 max unavailable, 1 max surge |
| 55 | + Pod Template: |
| 56 | + Labels: app=nginx |
| 57 | + Containers: |
| 58 | + nginx: |
| 59 | + Image: nginx:1.14.2 |
| 60 | + Port: 80/TCP |
| 61 | + Environment: <none> |
| 62 | + Mounts: <none> |
| 63 | + Volumes: <none> |
| 64 | + Conditions: |
| 65 | + Type Status Reason |
| 66 | + ---- ------ ------ |
| 67 | + Available True MinimumReplicasAvailable |
| 68 | + Progressing True NewReplicaSetAvailable |
| 69 | + OldReplicaSets: <none> |
| 70 | + NewReplicaSet: nginx-deployment-1771418926 (2/2 replicas created) |
| 71 | + No events. |
| 72 | + ``` |
| 73 | + |
| 74 | +1. Liste os Pods criados pelo Deployment: |
| 75 | + |
| 76 | + ```shell |
| 77 | + kubectl get pods -l app=nginx |
| 78 | + ``` |
| 79 | + |
| 80 | + A saída é semelhante a esta: |
| 81 | + |
| 82 | + ``` |
| 83 | + NAME READY STATUS RESTARTS AGE |
| 84 | + nginx-deployment-1771418926-7o5ns 1/1 Running 0 16h |
| 85 | + nginx-deployment-1771418926-r18az 1/1 Running 0 16h |
| 86 | + ``` |
| 87 | + |
| 88 | +1. Exiba informações sobre um Pod: |
| 89 | + |
| 90 | + ```shell |
| 91 | + kubectl describe pod <pod-name> |
| 92 | + ``` |
| 93 | + |
| 94 | + onde `<pod-name>` é o nome de um dos seus Pods. |
| 95 | + |
| 96 | +## Atualizando o Deployment |
| 97 | + |
| 98 | +Você pode atualizar o Deployment aplicando um novo arquivo YAML. Este arquivo YAML especifica que o Deployment deve ser atualizado para usar o nginx:1.16.1. |
| 99 | + |
| 100 | +{{% code_sample file="application/deployment-update.yaml" %}} |
| 101 | + |
| 102 | +1. Aplique o novo arquivo YAML: |
| 103 | + |
| 104 | + ```shell |
| 105 | + kubectl apply -f https://k8s.io/examples/application/deployment-update.yaml |
| 106 | + ``` |
| 107 | + |
| 108 | +1. Observe o Deployment criar Pods com novos nomes e excluir os Pods antigos: |
| 109 | + |
| 110 | + ```shell |
| 111 | + kubectl get pods -l app=nginx |
| 112 | + ``` |
| 113 | + |
| 114 | +## Escalonando a aplicação aumentando a contagem de réplicas |
| 115 | + |
| 116 | +Você pode aumentar o número de Pods no seu Deployment aplicando um novo arquivo YAML. Este arquivo YAML define `replicas` como 4, o que especifica que o Deployment deve ter quatro Pods: |
| 117 | + |
| 118 | +{{% code_sample file="application/deployment-scale.yaml" %}} |
| 119 | + |
| 120 | +1. Aplique o novo arquivo YAML: |
| 121 | + |
| 122 | + ```shell |
| 123 | + kubectl apply -f https://k8s.io/examples/application/deployment-scale.yaml |
| 124 | + ``` |
| 125 | + |
| 126 | +1. Verifique que o Deployment possui quatro Pods: |
| 127 | + |
| 128 | + ```shell |
| 129 | + kubectl get pods -l app=nginx |
| 130 | + ``` |
| 131 | + |
| 132 | + A saída é semelhante a esta: |
| 133 | + |
| 134 | + ``` |
| 135 | + NAME READY STATUS RESTARTS AGE |
| 136 | + nginx-deployment-148880595-4zdqq 1/1 Running 0 25s |
| 137 | + nginx-deployment-148880595-6zgi1 1/1 Running 0 25s |
| 138 | + nginx-deployment-148880595-fxcez 1/1 Running 0 2m |
| 139 | + nginx-deployment-148880595-rwovn 1/1 Running 0 2m |
| 140 | + ``` |
| 141 | + |
| 142 | +## Excluindo um Deployment |
| 143 | + |
| 144 | +Exclua o Deployment pelo nome: |
| 145 | + |
| 146 | +```shell |
| 147 | +kubectl delete deployment nginx-deployment |
| 148 | +``` |
| 149 | + |
| 150 | +## Controladores de Replicação -- a Forma Antiga |
| 151 | + |
| 152 | +A forma preferida de criar uma aplicação replicada é usar um Deployment, que por sua vez utiliza um ReplicaSet. Antes do Deployment e do ReplicaSet serem adicionados ao Kubernetes, aplicações replicadas eram configuradas usando um [Controlador de Replicação (ReplicationController)](/docs/concepts/workloads/controllers/replicationcontroller/). |
| 153 | + |
| 154 | +## {{% heading "whatsnext" %}} |
| 155 | + |
| 156 | +- Saiba mais sobre [objeto Deployment](/docs/concepts/workloads/controllers/deployment/). |
0 commit comments