add [pt-br] /content/pt-br/docs/concepts/overview/working-with-objects/kubernetes-objects.md (#35646)

* add [pt-br] translation to kubernetes-objects.md
Co-authored-by: lorranyoliveira<[email protected]>

* [pt-br] fix erros in the document: kubernetes-objects.md
Co-authored-by: lorranyoliveira<[email protected]>

* [pt-br] fix erros in the document: kubernetes-objects.md

Author: fernandes-natanael

content/pt-br/docs/concepts/overview/working-with-objects/kubernetes-objects.md

@@ -0,0 +1,82 @@
+---
+title: Entendendo os objetos do Kubernetes
+content_type: concept
+weight: 10
+card:
+ name: concepts
+ weight: 40
+---
+<!-- overview -->
+Esta página explica como os objetos do Kubernetes são representados na API do Kubernetes e como você pode expressá-los no formato `.yaml`.
+
+<!-- body -->
+## Entendendo os objetos do Kubernetes  {#kubernetes-objects}
+
+*Os objetos do Kubernetes* são entidades persistentes no Kubernetes. Kubernetes utiliza estas entidades para representar o estado do cluster. Especificamente, eles podem descrever:
+
+* Quais aplicativos estão sendo executados (e em quais nós).
+* Os recursos disponíveis para esses aplicativos
+* As políticas acerca de como esses aplicativos se comportam, como políticas de reinicialização e tolerâncias a falhas.
+
+Um objeto do Kubernetes é um “registro de intenção”-uma vez criado o objeto, o sistema do Kubernetes trabalha constantemente para garantir que este objeto existe. Ao criar um objeto, você está efetivamente falando para o sistema do Kubernetes como você quer que a carga do seu cluster seja. Este é o *estado desejado* do seu cluster.
+
+Para trabalhar com objetos do Kubernetes seja para criar, modificar ou deletar eles, você precisará usar a [API do Kubernetes](/docs/concepts/overview/kubernetes-api/). Quando você usa a interface de linha de comando do  `kubectl`, por exemplo, o CLI faz as chamadas necessárias na API do Kubernetes para você. Você também pode usar a API do Kubernetes diretamente no seu próprio programa usando uma das [Bibliotecas](/docs/reference/using-api/client-libraries/). 
+
+### Especificação e status do objeto
+
+Quase todos os objetos do Kubernetes incluem dois campos de objetos aninhados que governam a configuração do objeto: a *`especificação`* do objeto e o *`status`* do objeto. Para objetos que têm especificação, você tem que definir isso quando você cria o objeto, fornecendo uma descrição das características que você quer que o recurso tenha: o seu _estado desejado_.
+
+O `status` descreve o _estado atual_ do objeto, fornecido e atualizado pelo Kubernetes e seus componentes. A {{< glossary_tooltip text="camada de gerenciamento" term_id="control-plane" >}} do Kubernetes gerêncai continuamente e ativamente o real estado para corresponder ao estado desejado que você forneceu.
+
+Por exemplo, no Kubernetes, o {{< glossary_tooltip text="Deployment" term_id="deployment" >}} é um objeto que pode representar uma aplicação executando no seu cluster. Quando você cria o Deployment, você pode alterar a `especificação`para definir que você quer três réplicas da aplicação em execução simultânea. O Kubernetes lê as especificações do Deployment e inicia três instâncias do seu aplicativo desejado, atualizando o status  para corresponder às suas especificações. Se uma dessas instâncias falhar (um status mudar), o Kubernetes responde as diferenças entre as especificações e o status fazendo uma correção-neste caso, iniciando uma instância de substituição.
+
+Para mais informações sobre especificações do objeto, status e metadados, veja [Kubernetes API Conventions](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md).
+ 
+### Descrevendo um objeto Kubernetes
+
+Quando se cria um objeto do Kubernetes, deve-se fornecer a especificação do objeto que descreve seu estado desejado, bem como algumas informações básicas sobre o objeto (como um nome, por exemplo). Quando utiliza a API Kubernetes para criar o objeto (diretamente ou via `kubectl`), essa solicitação de API deve incluir essa informação como JSON no corpo da solicitação. **Na maioria das vezes, você fornece as informações ao comando `kubectl` em um arquivo .yaml**. O comando`kubectl` converte a informação para JSON ao fazer a requisição para a API.
+
+Aqui está um exemplo de arquivo `.yaml` que mostra os campos necessários e as especificações de objeto para uma implatação Kubernetes:
+
+{{< codenew file="application/deployment.yaml" >}}
+
+Uma maneira de criar um Deployment usando um arquivo `.yaml` como o representado acima é usar o comando [`kubectl apply`](/docs/reference/generated/kubectl/kubectl-commands#apply
+) na interface de linha de comando `kubectl`, passando o arquivo `.yaml` como argumento. Aqui está um exemplo:
+
+```shell
+kubectl apply -f https://k8s.io/examples/application/deployment.yaml
+```
+
+A saída será similar a esta:
+
+```
+deployment.apps/nginx-deployment created
+```
+
+### Campos obrigatórios
+
+No arquivo `.yaml` para o objeto Kubernetes que pretende criar, você precisará definir valores para os seguintes campos:
+
+* `apiVersion` - Qual a versão de API do objeto que será usado no Kubernetes para criar esse objeto.
+* `kind` - Qual tipo de objeto pretende criar.
+* `metadata` - Dados que ajudam a identificar de forma única o objeto, incluindo uma string `nome`, `UID` e um `namespace`.
+* `spec` - Que estado deseja para o objeto.
+
+O formato preciso do objeto `spec` é diferente para cada objeto Kubernetes, e contém campos aninhados específicos para aquele objeto. A documentação de [referência da API do Kubernetes](/docs/reference/kubernetes-api/) pode ajudar a encontrar o formato de especificação para todos os objetos que você pode criar usando Kubernetes. 
+
+Por exemplo, veja o campo de [`spec` field](/docs/reference/kubernetes-api/workload-resources/pod-v1/#PodSpec) para a referência Pod API.
+Para cada Pod, o campo `.spec` especifica o pod e seu estado desejado (como o nome da imagem do contêiner para cada recipiente dentro daquela cápsula).
+Outro exemplo de especificação de um objeto é o 
+[campo `spec` ](/docs/reference/kubernetes-api/workload-resources/stateful-set-v1/#StatefulSetSpec).
+Para o StatefulSet, o campo `.spec` especifica o StatefulSet e seu estado desejado.
+Dentro do `.spec` de um StatefulSet está um [template](/docs/concepts/workloads/pods/#pod-templates)
+para objetos de Pod. Esse modelo descreve os Pods que o controlador StatefulSet criará para 
+satisfazer a especificação do StatefulSet. Diferentes tipos de objetos também podem ter diferentes 
+`.status`; novamente, as páginas de referência API detalham a estrutura daquele campo `.status`,
+e seu conteúdo para cada tipo diferente de objeto.
+
+## {{% heading "whatsnext" %}} 
+
+Aprenda sobre os mais importantes objetos básicos Kubernetes, como o [Pod](/docs/concepts/workloads/pods).
+Aprenda sobre as [controladoras](/docs/concepts/architecture/controller/) do Kubernetes.
+[Usando a API Kubernetes](/docs/reference/using-api) explica mais alguns conceitos da API.

content/pt-br/examples/application/deployment.yaml

@@ -0,0 +1,19 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: nginx-deployment
+spec:
+  selector:
+    matchLabels:
+      app: nginx
+  replicas: 2 # diz ao deployment para executar 2 pods que correspondam ao modelo
+  template:
+    metadata:
+      labels:
+        app: nginx
+    spec:
+      containers:
+      - name: nginx
+        image: nginx:1.14.2
+        ports:
+        - containerPort: 80