From 4a2a68aaafad6f68f7249ef3892e4f62d9096221 Mon Sep 17 00:00:00 2001 From: Natanael Filho Date: Wed, 24 Aug 2022 11:20:04 -0300 Subject: [PATCH] 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 * [pt-br] fix erros in the document: kubernetes-objects.md Co-authored-by: lorranyoliveira * [pt-br] fix erros in the document: kubernetes-objects.md --- .../kubernetes-objects.md | 82 +++++++++++++++++++ .../examples/application/deployment.yaml | 19 +++++ 2 files changed, 101 insertions(+) create mode 100644 content/pt-br/docs/concepts/overview/working-with-objects/kubernetes-objects.md create mode 100644 content/pt-br/examples/application/deployment.yaml diff --git a/content/pt-br/docs/concepts/overview/working-with-objects/kubernetes-objects.md b/content/pt-br/docs/concepts/overview/working-with-objects/kubernetes-objects.md new file mode 100644 index 0000000000..f5420a3ef1 --- /dev/null +++ b/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 +--- + +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`. + + +## 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. diff --git a/content/pt-br/examples/application/deployment.yaml b/content/pt-br/examples/application/deployment.yaml new file mode 100644 index 0000000000..3c5f080ed1 --- /dev/null +++ b/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