Skip to content

Commit 491d404

Browse files
stormqueen1990stormqueen1990
authored
[pt-br] Add setup-tools/kubeadm/kubeadm-join.md (#38153)
* [pt-br] Add setup-tools/kubeadm/kubeadm-join.md * Add Brazilian Portuguese translation for docs/reference/setup-tools/kubeadm/kubeadm-join.md. * Add Brazilian Portuguese translation for docs/reference/setup-tools/kubeadm/generated/kubeadm_join.md. * Changes from code review.
1 parent 83a387a commit 491d404

File tree

2 files changed

+623
-0
lines changed

2 files changed

+623
-0
lines changed

‎content/pt-br/docs/reference/setup-tools/kubeadm/generated/kubeadm_join.md

Lines changed: 274 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,274 @@
1+
<!--
2+
The file is auto-generated from the Go source code of the component using a generic
3+
[generator](https://github.com/kubernetes-sigs/reference-docs/). To learn how
4+
to generate the reference documentation, please read
5+
[Contributing to the reference documentation](/docs/contribute/generate-ref-docs/).
6+
To update the reference content, please follow the
7+
[Contributing upstream](/docs/contribute/generate-ref-docs/contribute-upstream/)
8+
guide. You can file document formatting bugs against the
9+
[reference-docs](https://github.com/kubernetes-sigs/reference-docs/) project.
10+
-->
11+
12+
13+
Rode este comando em qualquer máquina que você deseje adicionar a um cluster
14+
existente
15+
16+
### Sinopse
17+
18+
19+
20+
Ao associar um novo nó a um cluster inicializado com kubeadm, temos que
21+
estabelecer a confiança bidirecional. Este processo é dividido entre a descoberta
22+
(em que o nó estabelece a confiança na camada de gerenciamento do Kubernetes) e
23+
a inicialização TLS (em que a camada de gerenciamento do Kubernetes estabelece a
24+
confiança no nó).
25+
26+
Existem duas principais formas de descoberta. A primeira delas é o uso de um
27+
token compartilhado, juntamente com o endereço IP do servidor da API. A segunda
28+
é o fornecimento de um arquivo - um subconjunto do arquivo kubeconfig padrão. O
29+
arquivo de descoberta/kubeconfig suporta autenticação por token, plugins de
30+
autenticação do client-go ("exec"), "tokenFile" e "authProvider". Este arquivo
31+
pode ser um arquivo local ou um arquivo baixado através de uma URL HTTPS. Os
32+
formatos são `kubeadm join --discovery-token abcdef.1234567890abcdef 1.2.3.4:6443`,
33+
`kubeadm join --discovery-file caminho/para/arquivo.conf`, ou
34+
`kubeadm join --discovery-file https://endereco/arquivo.conf`. Somente um formato
35+
pode ser utilizado. Se os dados para a descoberta são carregados de uma URL,
36+
o protocolo HTTPS deve ser utilizado. Neste caso, o conjunto de CAs instalado no
37+
host é utilizado para verificar a conexão.
38+
39+
Se você utilizou um token compartilhado para descoberta, você deve também passar
40+
a opção `--discovery-token-ca-cert-hash` para validar a chave pública da
41+
autoridade de certificação raiz (CA) apresentada pela camada de gerenciamento do
42+
Kubernetes. O valor desta opção é especificado no formato
43+
"&lt;tipo-de-hash&gt;:&lt;valor-codificado-em-hexadecimal&gt;", onde o tipo de
44+
hash suportado é "sha256". O hash é calculado a partir dos bytes do objeto
45+
Subject Public Key Info (SPKI), como especificado pela RFC7469. Este valor fica
46+
disponível na saída do comando `kubeadm init` ou pode ser calculado utilizando
47+
ferramentas padronizadas. A opção `--discovery-token-ca-cert-hash` pode ser
48+
especificada múltiplas vezes para permitir informar mais que uma chave pública.
49+
50+
Se você não puder obter o _hash_ da chave pública da autoridade de certificação
51+
de antemão, você pode passar a opção `--discovery-token-unsafe-skip-ca-verification`
52+
para desabilitar esta verificação. Esta opção enfraquece o modelo de segurança
53+
do kubeadm, já que outros nós podem potencialmente personificar a camada de
54+
gerenciamento do Kubernetes.
55+
56+
O mecanismo de inicialização TLS também é conduzido por um token compartilhado.
57+
Este token é utilizado para temporariamente autenticar-se com a camada de
58+
gerenciamento do Kubernetes para enviar uma requisição de assinatura de
59+
certificado (CSR) para um par de chaves criado localmente. Por padrão, o kubeadm
60+
irá configurar a camada de gerenciamento do Kubernetes para automaticamente
61+
aprovar estas requisições de assinatura. O token é enviado através da opção
62+
`--tls-bootstrap-token abcdef.1234567890abcdef`.
63+
64+
Frequentemente, o mesmo token é utilizado para ambas as partes. Neste caso, a
65+
opção `--token` pode ser utilizada ao invés de especificar cada token
66+
individualmente.
67+
68+
O comando `join [api-server-endpoint]` executa as seguintes fases:
69+
```
70+
preflight Executa as verificações pré-execução
71+
control-plane-prepare Prepara a máquina para servir um nó da camada de gerenciamento
72+
/download-certs [EXPERIMENTAL] Baixa certificados compartilhados entre nós da camada de gerenciamento do Secret kubeadm-certs
73+
/certs Gera os certificados para os novos componentes da camada de gerenciamento
74+
/kubeconfig Gera o arquivo kubeconfig para os novos componentes da camada de gerenciamento
75+
/control-plane Gera os manifestos para os novos componentes da camada de gerenciamento
76+
kubelet-start Escreve as configurações do kubelet, os certificados, e (re)inicia o kubelet
77+
control-plane-join Associa uma máquina como uma instância da camada de gerenciamento
78+
/etcd Adiciona como um novo membro do etcd local
79+
/update-status Registra o novo nó da camada de gerenciamento no objeto ClusterStatus mantido no ConfigMap kubeadm-config (DESCONTINUADO)
80+
/mark-control-plane Marca um nó como nó da camada de gerenciamento
81+
```
82+
83+
```
84+
kubeadm join [api-server-endpoint] [flags]
85+
```
86+
87+
### Opções
88+
89+
<table style="width: 100%; table-layout: fixed;">
90+
<colgroup>
91+
<col span="1" style="width: 10px;" />
92+
<col span="1" />
93+
</colgroup>
94+
<tbody>
95+
96+
<tr>
97+
<td colspan="2">--apiserver-advertise-address string</td>
98+
</tr>
99+
<tr>
100+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
101+
Se o nó hospedar uma nova instância da camada de gerenciamento, este é o endereço IP que servidor da API irá anunciar que
102+
está aguardando conexões. Quando não especificado, a interface de rede padrão é utilizada.
103+
</p></td>
104+
</tr>
105+
106+
<tr>
107+
<td colspan="2">--apiserver-bind-port int32&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Default: 6443</td>
108+
</tr>
109+
<tr>
110+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
111+
Se o nó hospedar uma nova instância da camada de gerenciamento, a porta que o servidor da API deve conectar-se.
112+
</p></td>
113+
</tr>
114+
115+
<tr>
116+
<td colspan="2">--certificate-key string</td>
117+
</tr>
118+
<tr>
119+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
120+
Chave utilizada para decriptar as credenciais do certificado enviadas pelo comando init.
121+
</p></td>
122+
</tr>
123+
124+
<tr>
125+
<td colspan="2">--config string</td>
126+
</tr>
127+
<tr>
128+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
129+
Caminho para um arquivo de configuração do kubeadm.
130+
</p></td>
131+
</tr>
132+
133+
<tr>
134+
<td colspan="2">--control-plane</td>
135+
</tr>
136+
<tr>
137+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
138+
Cria uma nova instância da camada de gerenciamento neste nó.
139+
</p></td>
140+
</tr>
141+
142+
<tr>
143+
<td colspan="2">--cri-socket string</td>
144+
</tr>
145+
<tr>
146+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
147+
Caminho para o soquete CRI conectar-se. Se vazio, o kubeadm tentará autodetectar este valor; utilize esta opção somente se você possui mais que um CRI instalado ou se você possui um soquete CRI fora do padrão.</p></td>
148+
</tr>
149+
150+
<tr>
151+
<td colspan="2">--discovery-file string</td>
152+
</tr>
153+
<tr>
154+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
155+
Para descoberta baseada em arquivo, um caminho de arquivo ou uma URL de onde a informação do cluster deve ser carregada.
156+
</p></td>
157+
</tr>
158+
159+
<tr>
160+
<td colspan="2">--discovery-token string</td>
161+
</tr>
162+
<tr>
163+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
164+
Para descoberta baseada em token, o token utilizado para validar a informação do cluster obtida do servidor da API.
165+
</p></td>
166+
</tr>
167+
168+
<tr>
169+
<td colspan="2">--discovery-token-ca-cert-hash strings</td>
170+
</tr>
171+
<tr>
172+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
173+
Para descoberta baseada em token, verifica que a chave pública do CA raiz corresponde a este <i>hash</i>
174+
(formato: &quot;&lt;tipo&gt;:&lt;valor&gt;&quot;).
175+
</p></td>
176+
</tr>
177+
178+
<tr>
179+
<td colspan="2">--discovery-token-unsafe-skip-ca-verification</td>
180+
</tr>
181+
<tr>
182+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
183+
Para descoberta baseada em token, permite associar-se ao cluster sem fixação da
184+
autoridade de certificação (opção --discovery-token-ca-cert-hash).
185+
</p></td>
186+
</tr>
187+
188+
<tr>
189+
<td colspan="2">--dry-run</td>
190+
</tr>
191+
<tr>
192+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
193+
Não aplica as modificações; apenas imprime as alterações que seriam efetuadas.
194+
</p></td>
195+
</tr>
196+
197+
<tr>
198+
<td colspan="2">-h, --help</td>
199+
</tr>
200+
<tr>
201+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>ajuda para join</p></td>
202+
</tr>
203+
204+
<tr>
205+
<td colspan="2">--ignore-preflight-errors strings</td>
206+
</tr>
207+
<tr>
208+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>Uma lista de verificações para as quais erros serão exibidos como avisos. Exemplos: 'IsPrivilegedUser,Swap'. O valor 'all' ignora erros de todas as verificações.</p></td>
209+
</tr>
210+
211+
<tr>
212+
<td colspan="2">--node-name string</td>
213+
</tr>
214+
<tr>
215+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>Especifica o nome do nó.</p></td>
216+
</tr>
217+
218+
<tr>
219+
<td colspan="2">--patches string</td>
220+
</tr>
221+
<tr>
222+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>Caminho para um diretório contendo arquivos nomeados no padrão "target[suffix][+patchtype].extension". Por exemplo, "kube-apiserver0+merge.yaml" ou somente "etcd.json". "target" pode ser um dos seguintes valores: "kube-apiserver", "kube-controller-manager", "kube-scheduler", "etcd". "patchtype" pode ser "strategic", "merge" ou "json" e corresponde aos formatos de patch suportados pelo kubectl. O valor padrão para "patchtype" é "strategic". "extension" deve ser "json" ou "yaml". "suffix" é uma string opcional utilizada para determinar quais patches são aplicados primeiro em ordem alfanumérica.</p></td>
223+
</tr>
224+
225+
<tr>
226+
<td colspan="2">--skip-phases strings</td>
227+
</tr>
228+
<tr>
229+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>Lista de fases a serem ignoradas.</p></td>
230+
</tr>
231+
232+
<tr>
233+
<td colspan="2">--tls-bootstrap-token string</td>
234+
</tr>
235+
<tr>
236+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
237+
Especifica o token a ser utilizado para autenticar temporariamente com a camada de gerenciamento do Kubernetes durante
238+
o processo de associação do nó ao cluster.
239+
</p></td>
240+
</tr>
241+
242+
<tr>
243+
<td colspan="2">--token string</td>
244+
</tr>
245+
<tr>
246+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>
247+
Utiliza este token em ambas as opções discovery-token e tls-bootstrap-token quando tais valores não são informados.
248+
</p></td>
249+
</tr>
250+
251+
</tbody>
252+
</table>
253+
254+
255+
256+
### Opções herdadas dos comandos superiores
257+
258+
<table style="width: 100%; table-layout: fixed;">
259+
<colgroup>
260+
<col span="1" style="width: 10px;" />
261+
<col span="1" />
262+
</colgroup>
263+
<tbody>
264+
265+
<tr>
266+
<td colspan="2">--rootfs string</td>
267+
</tr>
268+
<tr>
269+
<td></td><td style="line-height: 130%; word-wrap: break-word;"><p>[EXPERIMENTAL] O caminho para o sistema de arquivos raiz 'real' do host.
270+
</p></td>
271+
</tr>
272+
273+
</tbody>
274+
</table>

0 commit comments

Comments
 (0)