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<lolo.souza80@yahoo.com> * [pt-br] fix erros in the document: kubernetes-objects.md Co-authored-by: lorranyoliveira<lolo.souza80@yahoo.com> * [pt-br] fix erros in the document: kubernetes-objects.mdpull/36242/head
Natanael Filho
GitHub
parent
6ac4428c33
commit
4a2a68aaaf
|
|
@ -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.
|
||||
|
|
@ -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
|
||||
Loading…
Reference in New Issue