Skip to content

Commit f5ca80d

Browse files
committed
adding request changes on translate
1 parent 7ede0d2 commit f5ca80d

File tree

1 file changed

+45
-45
lines changed

1 file changed

+45
-45
lines changed

content/pt-br/docs/concepts/cluster-administration/flow-control.md

Lines changed: 45 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,13 @@ min-kubernetes-server-version: v1.18
1111
Controlar o comportamento do servidor da API Kubernetes em uma situação de sobrecarga
1212
é uma tarefa chave para administradores de cluster. O {{< glossary_tooltip
1313
term_id="kube-apiserver" text="kube-apiserver" >}} tem alguns controles disponíveis
14-
(ou seja, as _flags_ `--max-requests-inflight` e `--max-mutating-requests-inflight`)
15-
para limitar a quantidade de trabalho pendente que será aceito,
14+
(ou seja, as _flags_ `--max-requests-inflight` e `--max-mutating-requests-inflight`)
15+
para limitar a quantidade de trabalho pendente que será aceito,
1616
evitando que uma grande quantidade de solicitações de entrada sobrecarreguem, e
1717
potencialmente travando o servidor da API, mas essas _flags_ não são suficientes para garantir
1818
que as solicitações mais importantes cheguem em um período de alto tráfego.
1919

20-
O recurso de prioridade e imparcialidade da API (APF) é uma alternativa que melhora
20+
O recurso de prioridade e imparcialidade da API (do inglês _API Priority and Fairness_, APF) é uma alternativa que melhora
2121
as limitações mencionadas acima. A APF classifica
2222
e isola os pedidos de uma forma mais refinada. Também introduz
2323
uma quantidade limitada de filas, para que nenhuma solicitação seja rejeitada nos casos
@@ -31,7 +31,7 @@ usam informantes e reagem a falhas de solicitações da API com exponencial
3131
back-off, e outros clientes que também funcionam desta forma.
3232

3333
{{< caution >}}
34-
Solicitações classificadas como "de longa duração" — principalmente relógios — não são
34+
Solicitações classificadas como "de longa duração" — principalmente _watches_ — não são
3535
sujeitas ao filtro da prioridade e imparcialidade da API. Isso também é verdade para
3636
a _flag_ `--max-requests-inflight` sem o recurso da APF ativado.
3737
{{< /caution >}}
@@ -40,14 +40,14 @@ a _flag_ `--max-requests-inflight` sem o recurso da APF ativado.
4040

4141
## Ativando/Desativando a prioridade e imparcialidade da API
4242

43-
O recurso de prioridade e imparcialidade da API é controlado por um portão de recurso
43+
O recurso de prioridade e imparcialidade da API é controlado por um feature gate
4444
e está habilitado por padrão. Veja [Portões de Recurso](/docs/reference/command-line-tools-reference/feature-gates/)
4545
para uma explicação geral dos portões de recursos e como habilitar e
4646
desativá-los. O nome da porta de recurso para APF é
4747
"APIPriorityAndFairness". Este recurso também envolve um {{<
4848
glossary_tooltip term_id="api-group" text="API Group" >}} com: (a) um
4949
Versão `v1alpha1`, desabilitada por padrão, e (b) `v1beta1` e
50-
Versões `v1beta2`, habilitadas por padrão. Você pode desativar o portão de recurso
50+
Versões `v1beta2`, habilitadas por padrão. Você pode desativar o feature gate
5151
e versões beta do grupo de APIs adicionando a seguinte
5252
_flag_ para sua invocação `kube-apiserver`:
5353

@@ -66,7 +66,7 @@ recurso de prioridade e imparcialidade da API, mesmo que outras _flags_ o tenha
6666

6767
## Conceitos
6868

69-
Existem vários recursos distintos envolvidos na APF.
69+
Existem vários recursos distintos envolvidos na APF.
7070
As solicitações recebidas são classificadas por atributos da solicitação usando
7171
_FlowSchemas_ e atribuídos a níveis de prioridade. Os níveis de prioridade adicionam um grau de
7272
isolamento mantendo limites de simultaneidade separados, para que as solicitações atribuídas
@@ -166,23 +166,23 @@ PriorityLevelConfiguration é maior do que o permitido por seu nível de simulta
166166
O campo `type` de sua especificação determina o que acontecerá com solicitações extras.
167167
Um tipo de 'Reject' significa que o excesso de tráfego será imediatamente rejeitado com
168168
um erro HTTP 429 (Too Many Requests). Um tipo de `Queue` significa que as solicitações
169-
acima do limite será enfileirado, com as técnicas de
169+
acima do limite será enfileirado, com as técnicas de
170170
_shuffle sharding_ e _fair queuing_ usadas
171171
para equilibrar o progresso entre os fluxos de solicitação.
172172

173173
A configuração de enfileiramento permite ajustar o algoritmo de _fair queuing_ para um
174174
nível de prioridade. Os detalhes do algoritmo podem ser lidos no
175175
[proposta de melhoria](#whats-next), mas resumindo:
176176

177-
* Aumentar as 'filas' reduz a taxa de colisões entre diferentes fluxos,
177+
- Aumentar as 'filas' reduz a taxa de colisões entre diferentes fluxos,
178178
o custo do aumento do uso de memória. Um valor de 1 aqui efetivamente desabilita a
179179
lógica de _fair queuing_, mas ainda permite que as solicitações sejam enfileiradas.
180180

181-
* Aumentar o `queueLengthLimit` permite que tráfegos maiores sejam
181+
- Aumentar o `queueLengthLimit` permite que tráfegos maiores sejam
182182
sustentados sem deixar de lado nenhum pedido, ao custo de aumento
183183
latência e uso de memória.
184184

185-
* Alterar `handSize` permite ajustar a probabilidade de colisões entre
185+
- Alterar `handSize` permite ajustar a probabilidade de colisões entre
186186
fluxos diferentes e a simultaneidade geral disponível para um único fluxo em um
187187
situação de sobrecarga.
188188

@@ -235,7 +235,7 @@ certifique-se de que dois FlowSchemas não tenham o mesmo `matchingPrecedence`.
235235
{{< /caution >}}
236236

237237
Um FlowSchema corresponde a uma determinada solicitação se pelo menos uma de suas `regras`
238-
são correspondidas. Uma regra corresponde se pelo menos um de seus `assuntos` *e* pelo menos
238+
são correspondidas. Uma regra corresponde se pelo menos um de seus `assuntos` _e_ pelo menos
239239
uma de suas `resourceRules` ou `nonResourceRules` (dependendo se a
240240
solicitação de entrada é para um recurso ou URL de não-recurso) corresponde à solicitação.
241241

@@ -262,18 +262,18 @@ obrigatória e sugerida.
262262
### Objetos de configuração obrigatórios
263263

264264
Os quatro objetos de configuração obrigatórios refletem no
265-
comportamento de guarda-corpo. Este é o comportamento que os servidores tinham antes
265+
comportamento do _guardrail_ embutido. Este é o comportamento que os servidores tinham antes
266266
desses objetos existirem e, quando esses objetos existem, suas especificações refletem
267267
esse comportamento. Os quatro objetos obrigatórios são os seguintes.
268268

269-
* O nível de prioridade obrigatório `exempt` é usado para solicitações que são
269+
- O nível de prioridade obrigatório `exempt` é usado para solicitações que são
270270
não sujeito a controle de fluxo: eles sempre serão despachados
271271
imediatamente. O FlowSchema obrigatório `exempt` classifica todos
272272
solicitações do grupo `system:masters` para este nível de prioridade.
273273
Você pode definir outros FlowSchemas que direcionam outras solicitações
274274
a este nível de prioridade, se apropriado.
275275

276-
* O nível de prioridade obrigatório `catch-all` é usado em combinação com
276+
- O nível de prioridade obrigatório `catch-all` é usado em combinação com
277277
o FlowSchema `catch-all` obrigatório para garantir que todas as solicitações
278278
recebam algum tipo de classificação. Normalmente você não deve confiar
279279
nesta configuração catch-all, e deve criar seu próprio FlowSchema catch-all
@@ -293,28 +293,28 @@ configuração funcionará melhor.
293293

294294
A configuração sugerida agrupa as solicitações em seis níveis de prioridade:
295295

296-
* O nível de prioridade `node-high` é para atualizações de integridade dos nós.
296+
- O nível de prioridade `node-high` é para atualizações de integridade dos nós.
297297

298-
* O nível de prioridade `system` é para solicitações não relacionadas à integridade do
298+
- O nível de prioridade `system` é para solicitações não relacionadas à integridade do
299299
grupo `system:nodes`, ou seja, Kubelets, que deve ser capaz de contatar
300300
o servidor de API para que as cargas de trabalho possam ser agendadas
301301
eles.
302302

303-
* O nível de prioridade `leader-election` é para solicitações de eleição de líder de
303+
- O nível de prioridade `leader-election` é para solicitações de eleição de líder de
304304
controladores embutidos (em particular, solicitações para `endpoints`, `configmaps`,
305305
ou `leases` vindo do `system:kube-controller-manager` ou
306-
usuários `system:kube-scheduler` e contas de serviço no namespace `kube-system`).
306+
usuários `system:kube-scheduler` e contas de serviço no namespace `kube-system`).
307307
Estes são importantes para isolar de outro tráfego porque as falhas
308308
na eleição do líder fazem com que seus controladores falhem e reiniciem, o que por sua vez
309309
causa tráfego mais caro à medida que os novos controladores sincronizam seus informantes.
310310

311-
* O nível de prioridade `workload-high` é para outras solicitações de controladores built-in.
311+
- O nível de prioridade `workload-high` é para outras solicitações de controladores built-in.
312312

313-
* O nível de prioridade `workload-low` é para solicitações de qualquer outra conta de serviço,
314-
que normalmente incluirá todas as solicitações de controladores em execução
313+
- O nível de prioridade `workload-low` é para solicitações de qualquer outra conta de serviço,
314+
que normalmente incluirá todas as solicitações de controladores em execução
315315
_Pods_.
316316

317-
* O nível de prioridade `global-default` trata de todos os outros tráfegos, por exemplo,
317+
- O nível de prioridade `global-default` trata de todos os outros tráfegos, por exemplo,
318318
comandos `kubectl` interativos executados por usuários não privilegiados.
319319

320320
Os FlowSchemas sugeridos servem para direcionar as solicitações para os
@@ -375,7 +375,7 @@ nem sugeridos, mas são anotados
375375

376376
## Isenção de simultaneidade da verificação de integridade
377377

378-
A configuração sugerida não dá nenhum tratamento especial à saúde
378+
A configuração sugerida não dá nenhum tratamento especial a checagem de saúde das requisições
379379
verifique solicitações em kube-apiservers de seus kubelets locais --- que
380380
tendem a usar a porta segura, mas não fornecem credenciais. Com o
381381
configuração sugerida, essas solicitações são atribuídas ao `global-default`
@@ -387,7 +387,7 @@ solicitações de limitação de taxa.
387387

388388
{{< caution >}}
389389
Fazer essa alteração também permite que qualquer parte hostil envie
390-
solicitações de verificação de integridade que correspondam a este FlowSchema, em qualquer volume.
390+
solicitações de verificação de integridade que correspondam a este FlowSchema, em qualquer volume.
391391
Se você tiver um filtro de tráfego da Web ou outro mecanismo de segurança externa semelhante
392392
para proteger o servidor de API do seu cluster do trafego geral de internet,
393393
você pode configurar regras para bloquear qualquer solicitação de verificação de integridade
@@ -429,27 +429,27 @@ exporta métricas adicionais. Monitorá-los pode ajudá-lo a determinar se a sua
429429
configuração está limitando indevidamente o tráfego importante, ou encontrar
430430
cargas de trabalho mal comportadas que podem estar prejudicando a integridade do sistema.
431431

432-
* `apiserver_flowcontrol_rejected_requests_total` é um vetor de contador
432+
- `apiserver_flowcontrol_rejected_requests_total` é um vetor de contador
433433
(cumulativo desde o início do servidor) de solicitações que foram rejeitadas,
434434
dividido pelos rótulos `flow_schema` (indicando aquele que
435435
correspondeu ao pedido), `priority_level` (indicando aquele para o qual
436436
a solicitação foi atribuída) e `reason`. A _label_ `reason` pode
437437
ter um dos seguintes valores:
438438

439-
* `queue-full`, indicando que muitos pedidos já foram enfileirados,
440-
* `concurrency-limit`, indicando que o
439+
- `queue-full`, indicando que muitos pedidos já foram enfileirados,
440+
- `concurrency-limit`, indicando que o
441441
PriorityLevelConfiguration está configurado para rejeitar em vez de
442442
enfileirar solicitações em excesso ou
443-
* `time-out`, indicando que a solicitação ainda estava na fila
443+
- `time-out`, indicando que a solicitação ainda estava na fila
444444
quando seu limite de tempo de fila expirou.
445445

446-
* `apiserver_flowcontrol_dispatched_requests_total` é um vetor contador
446+
- `apiserver_flowcontrol_dispatched_requests_total` é um vetor contador
447447
(cumulativo desde o início do servidor) de solicitações que começaram
448448
executando, dividido pelos rótulos `flow_schema` (indicando o
449449
um que corresponda à solicitação) e `priority_level` (indicando o
450450
aquele ao qual o pedido foi atribuído).
451451

452-
* `apiserver_current_inqueue_requests` é um vetor de medidor de
452+
- `apiserver_current_inqueue_requests` é um vetor de medidor de
453453
limites máximos do número de solicitações enfileiradas, agrupadas por uma
454454
_label_ chamado `request_kind` cujo valor é `mutating` ou `readOnly`.
455455
Essas marcas d'água altas descrevem o maior número visto em uma
@@ -458,14 +458,14 @@ cargas de trabalho mal comportadas que podem estar prejudicando a integridade do
458458
marca d'água alta da última janela de número de solicitações sendo ativamente
459459
servido.
460460

461-
* `apiserver_flowcontrol_read_vs_write_request_count_samples` é um
461+
- `apiserver_flowcontrol_read_vs_write_request_count_samples` é um
462462
vetor de histograma de observações do número atual de
463463
solicitações, divididas pelos rótulos `phase` (que assume o
464464
valores `waiting` e `executing`) e `request_kind` (que assume
465465
os valores `mutating` e `readOnly`). As observações são feitas
466466
periodicamente a uma taxa elevada.
467467

468-
* `apiserver_flowcontrol_read_vs_write_request_count_watermarks` é um
468+
- `apiserver_flowcontrol_read_vs_write_request_count_watermarks` é um
469469
vetor de histograma de marcas d'água altas ou baixas do número de
470470
solicitações divididas pelos rótulos `phase` (que assume o
471471
valores `waiting` e `executing`) e `request_kind` (que assume
@@ -475,27 +475,27 @@ cargas de trabalho mal comportadas que podem estar prejudicando a integridade do
475475
`apiserver_flowcontrol_read_vs_write_request_count_samples`. Esses
476476
marcas d'água mostram o intervalo de valores que ocorreram entre as amostras.
477477

478-
* `apiserver_flowcontrol_current_inqueue_requests` é um vetor de medidor
478+
- `apiserver_flowcontrol_current_inqueue_requests` é um vetor de medidor
479479
mantendo o número instantâneo de solicitações enfileiradas (não em execução),
480480
dividido pelos rótulos `priority_level` e `flow_schema`.
481481

482-
* `apiserver_flowcontrol_current_executing_requests` é um vetor de medidor
482+
- `apiserver_flowcontrol_current_executing_requests` é um vetor de medidor
483483
segurando o número instantâneo de execução (não esperando em uma
484484
queue), divididas pelos rótulos `priority_level` e
485485
`flow_schema`.
486486

487-
* `apiserver_flowcontrol_request_concurrency_in_use` é um vetor de medidor
487+
- `apiserver_flowcontrol_request_concurrency_in_use` é um vetor de medidor
488488
ocupando o número instantâneo de assentos ocupados, diferenciados pelas
489489
_labels_ `priority_level` e `flow_schema`.
490490

491-
* `apiserver_flowcontrol_priority_level_request_count_samples` é um
491+
- `apiserver_flowcontrol_priority_level_request_count_samples` é um
492492
vetor de histograma de observações do número atual de
493493
solicitações divididas pelas _labels_ `phase` (que assume o
494494
valores `waiting` e `executing`) e `priority_level`. Cada
495495
histograma obtém observações feitas periodicamente, até a última
496496
atividade do tipo relevante. As observações são feitas em nota alta.
497497

498-
* `apiserver_flowcontrol_priority_level_request_count_watermarks` é um
498+
- `apiserver_flowcontrol_priority_level_request_count_watermarks` é um
499499
vetor de histograma de marcas d'água altas ou baixas do número de
500500
solicitações divididas pelas _labels_ `phase` (que assume o
501501
valores `waiting` e `executing`) e `priority_level`; a _label_
@@ -505,7 +505,7 @@ cargas de trabalho mal comportadas que podem estar prejudicando a integridade do
505505
`apiserver_flowcontrol_priority_level_request_count_samples`. Esses
506506
marcas d'água mostram o intervalo de valores que ocorreram entre as amostras.
507507

508-
* `apiserver_flowcontrol_request_queue_length_after_enqueue` é um
508+
- `apiserver_flowcontrol_request_queue_length_after_enqueue` é um
509509
vetor de histograma de comprimentos de fila para as filas, dividido pelas
510510
_labels_ `priority_level` e `flow_schema`, conforme mostrado pelas
511511
solicitações enfileiradas. Cada solicitação enfileirada contribui com uma
@@ -522,11 +522,11 @@ cargas de trabalho mal comportadas que podem estar prejudicando a integridade do
522522
aumentar os compartilhamentos de simultaneidade desse PriorityLevelConfiguration.
523523
{{< /note >}}
524524

525-
* `apiserver_flowcontrol_request_concurrency_limit` é um vetor de medidor
525+
- `apiserver_flowcontrol_request_concurrency_limit` é um vetor de medidor
526526
mantendo o limite de simultaneidade calculado (com base no limite total de simultaneidade do servidor da API
527527
e na simultaneidade de PriorityLevelConfigurations share), divididos pela _label_ `priority_level`.
528528

529-
* `apiserver_flowcontrol_request_wait_duration_seconds` é um vetor de histograma
529+
- `apiserver_flowcontrol_request_wait_duration_seconds` é um vetor de histograma
530530
de quanto tempo as solicitações ficaram na fila, divididas pelas _labels_
531531
`flow_schema` (indicando qual corresponde à solicitação),
532532
`priority_level` (indicando aquele para o qual o pedido foi
@@ -540,7 +540,7 @@ cargas de trabalho mal comportadas que podem estar prejudicando a integridade do
540540
solicitações atribuídas a esse nível de prioridade.
541541
{{< /note >}}
542542

543-
* `apiserver_flowcontrol_request_execution_seconds` é um vetor de histograma
543+
- `apiserver_flowcontrol_request_execution_seconds` é um vetor de histograma
544544
de quanto tempo as solicitações levaram para realmente serem executadas, divididas pelas
545545
_labels_ `flow_schema` (indicando qual corresponde à solicitação)
546546
e `priority_level` (indicando aquele para o qual o pedido foi
@@ -604,7 +604,7 @@ serve os seguintes caminhos adicionais em suas portas HTTP[S].
604604
exempt, <none>, <none>, <none>, <none>, <none>,
605605
system, system-nodes, 12, 0, system:node:127.0.0.1, 2020-07-23T15:26:57.179170694Z,
606606
```
607-
607+
608608
Além das solicitações enfileiradas, a saída inclui uma linha fantasma
609609
para cada nível de prioridade isento de limitação.
610610

@@ -621,10 +621,10 @@ serve os seguintes caminhos adicionais em suas portas HTTP[S].
621621
system, system-nodes, 12, 0, system:node:127.0.0.1, 2020-07-23T15:31:03.583823404Z, system:node:127.0.0.1, create, /api/v1/namespaces/scaletest/configmaps,
622622
system, system-nodes, 12, 1, system:node:127.0.0.1, 2020-07-23T15:31:03.594555947Z, system:node:127.0.0.1, create, /api/v1/namespaces/scaletest/configmaps,
623623
```
624-
624+
625625
## {{% heading "whatsnext" %}}
626626

627-
Para obter informações básicas sobre detalhes de design para prioridade e justiça da API, consulte
627+
Para obter informações básicas sobre detalhes de design para prioridade e justiça da API, consulte
628628
a [proposta de aprimoramento](https://github.com/kubernetes/enhancements/tree/master/keps/sig-api-machinery/1040-priority-and-fairness).
629629
Você pode fazer sugestões e solicitações de recursos por meio do [SIG API Machinery](https://github.com/kubernetes/community/tree/master/sig-api-machinery)
630630
ou do [canal do slack](https://kubernetes.slack.com/messages/api-priority-and-fairness).

0 commit comments

Comments
 (0)