Skip to content

Commit e3dee23

Browse files
[pt-br] Update docs/concepts/overview/working-with-objects/namespaces (#51288)
* update `website/content/pt-br/docs/concepts/overview/working-with-objects/namespaces.md` Signed-off-by: saldanha <[email protected]> * Update content/pt-br/docs/concepts/overview/working-with-objects/namespaces.md Co-authored-by: Mauren <[email protected]> * Update content/pt-br/docs/concepts/overview/working-with-objects/namespaces.md Co-authored-by: Mauren <[email protected]> * Update content/pt-br/docs/concepts/overview/working-with-objects/namespaces.md Signed-off-by: saldanha <[email protected]> --------- Signed-off-by: saldanha <[email protected]> Co-authored-by: Mauren <[email protected]>
1 parent 9b0e001 commit e3dee23

File tree

1 file changed

+33
-13
lines changed
  • content/pt-br/docs/concepts/overview/working-with-objects

1 file changed

+33
-13
lines changed

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

Lines changed: 33 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -20,13 +20,33 @@ Namespaces nos permitem dividir os recursos do cluster entre diferentes usuário
2020

2121
Não é necessário utilizar múltiplos namespaces para separar recursos levemente diferentes, como diferentes versões de um mesmo software: use {{< glossary_tooltip text="labels" term_id="label" >}} para distinguir recursos dentro de um mesmo namespace.
2222

23+
{{< note >}}
24+
Para clusters em produção, considere _não_ utilizar o namespace `default`. Em vez disso, crie e utilize outros namespaces.
25+
{{< /note >}}
26+
27+
## Namespaces Iniciais
28+
29+
O Kubernetes é inicializado com quatro namespaces:
30+
31+
`default`
32+
: O Kubernetes inclui esse namespace para que você possa começar a usar seu novo cluster sem precisar criar um namespace primeiro.
33+
34+
`kube-node-lease`
35+
: Este namespace contém os objetos de [Lease](/docs/concepts/architecture/leases/) associados com cada node. Node leases permitem que o kubelet envie [heartbeats](/docs/concepts/architecture/nodes/#node-heartbeats) para que a camada de gerenciamento detecte falhas nos nodes.
36+
37+
`kube-public`
38+
: Este namespace é criado automaticamente e é legível por _todos_ os clientes (incluindo clientes não autenticados). Este namespace é reservado principalmente para uso do cluster, no caso de alguns recursos que precisem ser visíveis e legíveis publicamente por todo o cluster. O aspecto público deste namespace é apenas uma convenção, não um requisito.
39+
40+
`kube-system`
41+
: O namespace para objetos criados pelo sistema Kubernetes
42+
2343
## Trabalhando com Namespaces
2444

2545
Criação e eliminação de namespaces estão descritas na
2646
[documentação de namespaces do guia de administradores](/docs/tasks/administer-cluster/namespaces).
2747

2848
{{< note >}}
29-
Evite criar namespaces com o prefixo `kube-`, já que este prefixo é reservado para namespaces do sistema Kubernetes.
49+
Evite criar namespaces com o prefixo `kube-`, já que este prefixo é reservado para namespaces do sistema Kubernetes.
3050
{{< /note >}}
3151

3252
### Visualizando namespaces
@@ -44,13 +64,6 @@ kube-public Active 1d
4464
kube-system Active 1d
4565
```
4666

47-
O Kubernetes é inicializado com quatro namespaces:
48-
49-
* `default` O namespace padrão para objetos sem namespace
50-
* `kube-system` O namespace para objetos criados pelo sistema Kubernetes
51-
* `kube-public` Este namespace é criado automaticamente e é legível por todos os usuários (incluindo usuários não autenticados). Este namespace é reservado principalmente para uso do cluster, no caso de alguns recursos que precisem ser visíveis e legíveis publicamente por todo o cluster. O aspecto público deste namespace é apenas uma convenção, não um requisito.
52-
* `kube-node-lease` Este namespace contém os objetos de [Lease](/docs/reference/kubernetes-api/cluster-resources/lease-v1/) associados com cada node. Node leases permitem que o kubelet envie [heartbeats](/docs/concepts/architecture/nodes/#heartbeats) para que a camada de gerenciamento detecte falhas nos nodes.
53-
5467
### Preparando o namespace para uma requisição
5568

5669
Para preparar o namespace para a requisição atual, utilize o parâmetro `--namespace`. Por exemplo:
@@ -77,9 +90,17 @@ Quando você cria um [Serviço](/docs/concepts/services-networking/service/), el
7790
Esta entrada possui o formato: `<service-name>.<namespace-name>.svc.cluster.local`, de forma que se um contêiner utilizar apenas `<service-name>` ele será resolvido para um serviço que é local ao namespace.
7891
Isso é útil para utilizar a mesma configuração em vários namespaces, por exemplo em Desenvolvimento, `Staging` e Produção. Se você quiser acessar múltiplos namespaces, precisará utilizar um _Fully Qualified Domain Name_ (FQDN).
7992

93+
Nomes de namespaces devem ser válidos conforme a [RFC 1123 para rótulos DNS](/docs/concepts/overview/working-with-objects/names/#dns-label-names).
94+
95+
{{< warning >}}
96+
Ao criar namespaces com o mesmo nome de [domínios de topo públicos (TLDs)](https://data.iana.org/TLD/tlds-alpha-by-domain.txt), os Services dentro desses namespaces podem ter nomes DNS curtos que colidem com registros DNS públicos. Com isso, cargas de trabalho de qualquer namespace que realizem consultas DNS sem um [ponto final (trailing dot)](https://datatracker.ietf.org/doc/html/rfc1034#page-8) podem ser redirecionadas para esses serviços, tendo precedência sobre o DNS público.
97+
98+
Para mitigar esse risco, limite a criação de namespaces apenas a usuários confiáveis. Se necessário, você também pode configurar controles de segurança de terceiros, como [admission webhooks](/docs/reference/access-authn-authz/extensible-admission-controllers/), para bloquear a criação de namespaces com nomes que coincidam com [TLDs públicos](https://data.iana.org/TLD/tlds-alpha-by-domain.txt).
99+
{{< /warning >}}
100+
80101
## Nem todos os objetos pertencem a algum Namespace
81102

82-
A maior parte dos recursos Kubernetes (como Pods, Services, controladores de replicação e outros) pertencem a algum namespace. Entretanto, recursos de namespaces não pertencem a nenhum namespace. Além deles, recursos de baixo nível, como [nodes](/docs/concepts/architecture/nodes/) e persistentVolumes, também não pertencem a nenhum namespace.
103+
A maior parte dos recursos Kubernetes (como Pods, Services, controladores de replicação e outros) pertencem a algum namespace. Entretanto, recursos de namespaces não pertencem a nenhum namespace. Além deles, recursos de baixo nível, como [nodes](/docs/concepts/architecture/nodes/) e [persistentVolumes](/docs/concepts/storage/persistent-volumes/), também não pertencem a nenhum namespace.
83104

84105
Para visualizar quais recursos Kubernetes pertencem ou não a algum namespace, utilize:
85106

@@ -93,11 +114,10 @@ kubectl api-resources --namespaced=false
93114

94115
## Rotulamento Automático
95116

96-
{{< feature-state state="beta" for_k8s_version="1.21" >}}
117+
{{< feature-state for_k8s_version="1.22" state="stable" >}}
97118

98-
A camada de gerenciamento Kubernetes configura um {{< glossary_tooltip text="label" term_id="label" >}} imutável `kubernetes.io/metadata.name` em todos os namespaces se a
99-
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
100-
`NamespaceDefaultLabelName` estiver habilitada. O valor do label é o nome do namespace.
119+
A camada de gerenciamento Kubernetes configura um {{< glossary_tooltip text="label" term_id="label" >}} imutável `kubernetes.io/metadata.name` em todos os namespaces.
120+
O valor do label é o nome do namespace.
101121

102122
## {{% heading "whatsnext" %}}
103123

0 commit comments

Comments
 (0)