Skip to content

Commit a0d277f

Browse files
[pt-br] Add /tasks/debug/debug-application/debug-running-pod.md
1 parent af9502b commit a0d277f

File tree

1 file changed

+21
-23
lines changed

1 file changed

+21
-23
lines changed

content/pt-br/docs/tasks/debug/debug-application/debug-running-pod.md

Lines changed: 21 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -344,8 +344,7 @@ kubectl logs --previous ${POD_NAME} ${CONTAINER_NAME}
344344

345345
## Depuração com execução dentro do contêiner {#container-exec}
346346

347-
Se a {{< glossary_tooltip text="imagem do contêiner" term_id="image" >}} incluir ferramentas de depuração,
348-
como é o caso de imagens baseadas nos sistemas operacionais Linux e Windows, você pode executar comandos dentro de um contêiner específico usando `kubectl exec`:
347+
Se a {{< glossary_tooltip text="imagem do contêiner" term_id="image" >}} incluir ferramentas de depuração, como é o caso de imagens baseadas nos sistemas operacionais Linux e Windows, você pode executar comandos dentro de um contêiner específico usando `kubectl exec`:
349348

350349
```shell
351350
kubectl exec ${POD_NAME} -c ${CONTAINER_NAME} -- ${CMD} ${ARG1} ${ARG2} ... ${ARGN}
@@ -373,8 +372,8 @@ Para mais detalhes, veja [Obter um Shell em um Contêiner em Execução](/docs/t
373372

374373
{{< feature-state state="stable" for_k8s_version="v1.25" >}}
375374

376-
{{< glossary_tooltip text="Contêineres efêmeros" term_id="ephemeral-container" >}} são úteis para uma solução de problemas
377-
interativa quando `kubectl exec` não é suficiente, como no caso de um contêiner que falhou ou uma imagem de contêiner
375+
{{< glossary_tooltip text="Contêineres efêmeros" term_id="ephemeral-container" >}} são úteis para uma solução de problemas
376+
interativa quando `kubectl exec` não é suficiente, como no caso de um contêiner que falhou ou uma imagem de contêiner
378377
que não inclui ferramentas de depuração, como ocorre com [imagens distroless](https://github.com/GoogleContainerTools/distroless).
379378

380379
### Exemplo de depuração usando contêineres efêmeros {#ephemeral-container-example}
@@ -415,8 +414,7 @@ Este comando adiciona um novo contêiner `busybox` e o anexa. O parâmetro `--ta
415414
Ele é necessário aqui porque `kubectl run` não habilita o [compartilhamento do namespace de processo](/docs/tasks/configure-pod-container/share-process-namespace/) no Pod que ele cria.
416415

417416
{{< note >}}
418-
O parâmetro `--target` deve ser suportado pelo {{< glossary_tooltip
419-
text="Agente de execução do Contêiner" term_id="container-runtime" >}}. Quando não for suportado, o Contêiner Efêmero pode não ser iniciado ou pode ser iniciado com um namespace de processo isolado, de modo que `ps` não revelará processos em outros contêineres.
417+
O parâmetro `--target` deve ser suportado pelo {{< glossary_tooltip text="Agente de execução do Contêiner" term_id="container-runtime" >}}. Quando não for suportado, o Contêiner Efêmero pode não ser iniciado ou pode ser iniciado com um namespace de processo isolado, de modo que `ps` não revelará processos em outros contêineres.
420418
{{< /note >}}
421419

422420
Você pode visualizar o estado do contêiner efêmero recém-criado usando `kubectl describe`:
@@ -459,11 +457,11 @@ modificados para facilitar a depuração.
459457

460458
### Copiando um Pod enquanto adiciona um novo contêiner
461459

462-
Adicionar um novo contêiner pode ser útil quando sua aplicação está em execução,
463-
mas não se comporta como esperado e você deseja adicionar ferramentas adicionais
460+
Adicionar um novo contêiner pode ser útil quando sua aplicação está em execução,
461+
mas não se comporta como esperado e você deseja adicionar ferramentas adicionais
464462
de depuração ao Pod.
465463

466-
Por exemplo, talvez as imagens do contêiner da sua aplicação sejam baseadas em `busybox`, mas você precise de ferramentas de depuração que não estão incluídas no `busybox`.
464+
Por exemplo, talvez as imagens do contêiner da sua aplicação sejam baseadas em `busybox`, mas você precise de ferramentas de depuração que não estão incluídas no `busybox`.
467465
Você pode simular esse cenário usando `kubectl run`:
468466

469467
```shell
@@ -485,8 +483,8 @@ root@myapp-debug:/#
485483
{{< note >}}
486484
* `kubectl debug` gera automaticamente um nome para o contêiner caso você não escolha um usando a opção `--container`.
487485
* A opção `-i` faz com que `kubectl debug` anexe ao novo contêiner por padrão.
488-
Você pode impedir isso especificando `--attach=false`. Se sua sessão for desconectada, você pode se reconectar usando `kubectl attach`.
489-
* A opção `--share-processes` permite que os contêineres deste Pod visualizem processos
486+
Você pode impedir isso especificando `--attach=false`. Se sua sessão for desconectada, você pode se reconectar usando `kubectl attach`.
487+
* A opção `--share-processes` permite que os contêineres deste Pod visualizem processos
490488
de outros contêineres no mesmo Pod. Para mais informações sobre como isso funciona, veja [Compartilhar o Namespace de Processos entre Contêineres em um Pod](/docs/tasks/configure-pod-container/share-process-namespace/).
491489
{{< /note >}}
492490

@@ -565,7 +563,7 @@ Agora use `kubectl debug` para criar uma cópia e alterar a imagem do contêiner
565563
kubectl debug myapp --copy-to=myapp-debug --set-image=*=ubuntu
566564
```
567565

568-
A sintaxe de `--set-image` usa o mesmo formato `container_name=image` que `kubectl set image`.
566+
A sintaxe de `--set-image` usa o mesmo formato `container_name=image` que `kubectl set image`.
569567
`*=ubuntu` significa alterar a imagem de todos os contêineres para `ubuntu`.
570568

571569
Não se esqueça de limpar o Pod de depuração quando terminar de usá-lo:
@@ -576,7 +574,7 @@ kubectl delete pod myapp myapp-debug
576574

577575
## Depuração via shell no Nó {#node-shell-session}
578576

579-
Se nenhuma dessas abordagens funcionar, você pode identificar o Nó onde o Pod está sendo executado e criar um Pod nesse Nó.
577+
Se nenhuma dessas abordagens funcionar, você pode identificar o Nó onde o Pod está sendo executado e criar um Pod nesse Nó.
580578
Para criar um shell interativo em um Nó usando `kubectl debug`, execute:
581579

582580
```shell
@@ -593,8 +591,8 @@ Ao criar uma sessão de depuração em um Nó, tenha em mente que:
593591

594592
* `kubectl debug` gera automaticamente o nome do novo Pod com base no nome do Nó.
595593
* O sistema de arquivos raiz do Nó será montado em `/host`.
596-
* O contêiner é executado nos namespaces de IPC, Rede e PID do host,
597-
embora o Pod não seja privilegiado, então a leitura de algumas informações de
594+
* O contêiner é executado nos namespaces de IPC, Rede e PID do host,
595+
embora o Pod não seja privilegiado, então a leitura de algumas informações de
598596
processos pode falhar, e `chroot /host` pode não funcionar.
599597
* Se você precisar de um Pod privilegiado, crie-o manualmente ou use a opção `--profile=sysadmin`.
600598

@@ -606,13 +604,13 @@ kubectl delete pod node-debugger-mynode-pdx84
606604

607605
## Depuração de um Pod ou Nó aplicando um perfil {#debugging-profiles}
608606

609-
Ao usar `kubectl debug` para depurar um Nó por meio de um Pod de depuração, um Pod por meio de um Contêiner Efêmero ou um Pod copiado, você pode aplicar um perfil a eles.
610-
Ao aplicar um perfil, propriedades específicas, como [securityContext](/docs/tasks/configure-pod-container/security-context/), são definidas, permitindo a adaptação a diferentes cenários.
607+
Ao usar `kubectl debug` para depurar um Nó por meio de um Pod de depuração, um Pod por meio de um Contêiner Efêmero ou um Pod copiado, você pode aplicar um perfil a eles.
608+
Ao aplicar um perfil, propriedades específicas, como [securityContext](/docs/tasks/configure-pod-container/security-context/), são definidas, permitindo a adaptação a diferentes cenários.
611609
Existem dois tipos de perfis: perfil estático e perfil personalizado.
612610

613611
### Aplicando um Perfil Estático {#static-profile}
614612

615-
Um perfil estático é um conjunto de propriedades predefinidas que podem ser aplicadas usando a opção `--profile`.
613+
Um perfil estático é um conjunto de propriedades predefinidas que podem ser aplicadas usando a opção `--profile`.
616614
Os perfis disponíveis são os seguintes:
617615

618616
| Profile | Description |
@@ -626,12 +624,12 @@ Os perfis disponíveis são os seguintes:
626624

627625

628626
{{< note >}}
629-
Se você não especificar `--profile`, o perfil `legacy` será usado por padrão, mas há planos para sua descontinuação em um futuro próximo.
627+
Se você não especificar `--profile`, o perfil `legacy` será usado por padrão, mas há planos para sua descontinuação em um futuro próximo.
630628
Portanto, é recomendável usar outros perfis, como `general`.
631629
{{< /note >}}
632630

633631

634-
Suponha que você crie um Pod e queira depurá-lo.
632+
Suponha que você crie um Pod e queira depurá-lo.
635633
Primeiro, crie um Pod chamado `myapp` como exemplo:
636634

637635
```shell
@@ -688,12 +686,12 @@ kubectl delete pod myapp
688686

689687
{{< feature-state for_k8s_version="v1.32" state="stable" >}}
690688

691-
Você pode definir uma especificação parcial de contêiner para depuração como um perfil personalizado,
689+
Você pode definir uma especificação parcial de contêiner para depuração como um perfil personalizado,
692690
em formato YAML ou JSON, e aplicá-lo usando a opção `--custom`.
693691

694692
{{< note >}}
695-
O perfil personalizado suporta apenas a modificação da especificação do contêiner,
696-
mas não permite alterações nos campos `name`, `image`, `command`, `lifecycle` e `volumeDevices` da especificação do contêiner.
693+
O perfil personalizado suporta apenas a modificação da especificação do contêiner,
694+
mas não permite alterações nos campos `name`, `image`, `command`, `lifecycle` e `volumeDevices` da especificação do contêiner.
697695
Ele também não suporta a modificação da especificação do Pod.
698696
{{< /note >}}
699697

0 commit comments

Comments
 (0)