docker*, x11docker, kdocker: add pt_BR translation (#10507)

* btrfs-restore: Add pt_BR translation

* btrfs-version: Add pt_BR translation

* btrfs-scrub: Add pt_BR translation

* mkfs.btrfs: Add pt_BR translation

* fix: remove trailing whitespaces and surround example by new line

* Update pages.pt_BR/linux/btrfs-restore.md

Co-authored-by: Waldir Pimenta <waldyrious@gmail.com>

* Update pages.pt_BR/linux/btrfs-restore.md

Co-authored-by: Waldir Pimenta <waldyrious@gmail.com>

* Update pages.pt_BR/linux/btrfs-restore.md

Co-authored-by: Waldir Pimenta <waldyrious@gmail.com>

* fix: put beginning verbs in infinitive

* docker*, x11docker, kdocker: add pt_BR translation

---------

Co-authored-by: Waldir Pimenta <waldyrious@gmail.com>

pages.pt_BR/common/docker-commit.md

@@ -0,0 +1,32 @@
+# docker commit
+
+> Criar uma nova imagem a partir das alterações em um contêiner.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/commit/>.
+
+- Criar uma imagem a partir de um contêiner específico:
+
+`docker commit {{contêiner}} {{imagem}}:{{tag}}`
+
+- Aplicar uma instrução `CMD` do Dockerfile à imagem criada:
+
+`docker commit --change="CMD {{comando}}" {{contêiner}} {{imagem}}:{{tag}}`
+
+- Aplicar uma instrução `ENV` do Dockerfile à imagem criada:
+
+`docker commit --change="ENV {{nome}}={{valor}}" {{contêiner}} {{imagem}}:{{tag}}`
+
+- Criar uma imagem com um autor específico nos metadados:
+
+`docker commit --author="{{autor}}" {{contêiner}} {{imagem}}:{{tag}}`
+
+- Criar uma imagem com um comentário específico nos metadados:
+
+`docker commit --message="{{comentário}}" {{contêiner}} {{imagem}}:{{tag}}`
+
+- Criar uma imagem sem pausar o contêiner durante o commit:
+
+`docker commit --pause={{false}} {{contêiner}} {{imagem}}:{{tag}}`
+
+- Exibir ajuda:
+
+`docker commit --help`

pages.pt_BR/common/docker-container.md

@@ -0,0 +1,36 @@
+# docker container
+
+> Gerenciar contêineres Docker.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/container/>.
+
+- Listar os contêineres Docker em execução:
+
+`docker container ls`
+
+- Iniciar um ou mais contêineres parados:
+
+`docker container start {{nome_do_contêiner1}} {{nome_do_contêiner2}}`
+
+- Encerrar um ou mais contêineres em execução:
+
+`docker container kill {{nome_do_contêiner}}`
+
+- Parar um ou mais contêineres em execução:
+
+`docker container stop {{nome_do_contêiner}}`
+
+- Pausar todos os processos em um ou mais contêineres:
+
+`docker container pause {{nome_do_contêiner}}`
+
+- Exibir informações detalhadas sobre um ou mais contêineres:
+
+`docker container inspect {{nome_do_contêiner}}`
+
+- Exportar o sistema de arquivos de um contêiner como um arquivo tar:
+
+`docker container export {{nome_do_contêiner}}`
+
+- Criar uma nova imagem a partir das alterações em um contêiner:
+
+`docker container commit {{nome_do_contêiner}}`

pages.pt_BR/common/docker-exec.md

@@ -0,0 +1,28 @@
+# docker exec
+
+> Executar um comando em um contêiner Docker em execução.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/exec/>.
+
+- Entrar em uma sessão de shell interativa em um contêiner em execução:
+
+`docker exec --interactive --tty {{nome_do_contêiner}} {{/bin/bash}}`
+
+- Executar um comando em segundo plano (detached) em um contêiner em execução:
+
+`docker exec --detach {{nome_do_contêiner}} {{comando}}`
+
+- Selecionar o diretório de trabalho para a execução de um determinado comando:
+
+`docker exec --interactive --tty --workdir {{caminho/para/diretório}} {{nome_do_contêiner}} {{comando}}`
+
+- Executar um comando em segundo plano em um contêiner existente, mas manter o `stdin` aberto:
+
+`docker exec --interactive --detach {{nome_do_contêiner}} {{comando}}`
+
+- Definir uma variável de ambiente em uma sessão Bash em execução:
+
+`docker exec --interactive --tty --env {{nome_da_variável}}={{valor}} {{nome_do_contêiner}} {{/bin/bash}}`
+
+- Executar um comando como um usuário específico:
+
+`docker exec --user {{usuário}} {{nome_do_contêiner}} {{comando}}`

pages.pt_BR/common/docker-image.md

@@ -0,0 +1,21 @@
+# docker image
+
+> Gerenciar imagens do Docker.
+> Veja também `docker build`, `docker import` e `docker pull`.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/image/>.
+
+- Listar imagens Docker locais:
+
+`docker image ls`
+
+- Excluir imagens Docker locais não utilizadas:
+
+`docker image prune`
+
+- Excluir todas as imagens não utilizadas (não apenas aquelas sem uma tag):
+
+`docker image prune --all`
+
+- Mostrar o histórico de uma imagem Docker local:
+
+`docker image history {{imagem}}`

pages.pt_BR/common/docker-inspect.md

@@ -0,0 +1,32 @@
+# docker inspect
+
+> Retorna informações de baixo nível sobre objetos do Docker.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/inspect/>.
+
+- Exibir ajuda:
+
+`docker inspect`
+
+- Exibir informações sobre um contêiner, imagem ou volume usando um nome ou ID:
+
+`docker inspect {{contêiner|imagem|ID}}`
+
+- Exibir o endereço IP de um contêiner:
+
+`docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' {{contêiner}}`
+
+- Exibir o caminho para o arquivo de log do contêiner:
+
+`docker inspect --format='{{.LogPath}}' {{contêiner}}`
+
+- Exibir o nome da imagem do contêiner:
+
+`docker inspect --format='{{.Config.Image}}' {{contêiner}}`
+
+- Exibir as informações de configuração como JSON:
+
+`docker inspect --format='{{json .Config}}' {{contêiner}}`
+
+- Exibir todas as portas vinculadas:
+
+`docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' {{contêiner}}`

pages.pt_BR/common/docker-load.md

@@ -0,0 +1,16 @@
+# docker load
+
+> Carregar imagens do Docker a partir de arquivos ou `stdin`.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/load/>.
+
+- Carregar uma imagem do Docker a partir do `stdin`:
+
+`docker load < {{caminho/para/arquivo_imagem.tar}}`
+
+- Carregar uma imagem do Docker a partir de um arquivo específico:
+
+`docker load --input {{caminho/para/arquivo_imagem.tar}}`
+
+- Carregar uma imagem do Docker a partir de um arquivo específico no modo silencioso:
+
+`docker load --quiet --input {{caminho/para/arquivo_imagem.tar}}`

pages.pt_BR/common/docker-login.md

@@ -0,0 +1,20 @@
+# docker login
+
+> Fazer login em um registro do Docker.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/login/>.
+
+- Fazer login interativamente em um registro:
+
+`docker login`
+
+- Fazer login em um registro com um nome de usuário específico (será solicitada a senha):
+
+`docker login --username {{nome_de_usuário}}`
+
+- Fazer login em um registro com nome de usuário e senha:
+
+`docker login --username {{nome_de_usuário}} --password {{senha}} {{servidor}}`
+
+- Fazer login em um registro com a senha vinda do `stdin`:
+
+`echo "{{senha}}" | docker login --username {{nome_de_usuário}} --password-stdin`

pages.pt_BR/common/docker-machine.md

@@ -0,0 +1,28 @@
+# docker-machine
+
+> Criar e gerenciar máquinas que executam o Docker.
+> Mais informações: <https://docs.docker.com/machine/reference/>.
+
+- Listar as máquinas Docker em execução no momento:
+
+`docker-machine ls`
+
+- Criar uma nova máquina Docker com um nome específico:
+
+`docker-machine create {{nome}}`
+
+- Obter o status de uma máquina:
+
+`docker-machine status {{nome}}`
+
+- Iniciar uma máquina:
+
+`docker-machine start {{nome}}`
+
+- Parar uma máquina:
+
+`docker-machine stop {{nome}}`
+
+- Inspecionar informações sobre uma máquina:
+
+`docker-machine inspect {{nome}}`

pages.pt_BR/common/docker-network.md

@@ -0,0 +1,32 @@
+# docker network
+
+> Criar e gerenciar redes do Docker.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/network/>.
+
+- Listar todas as redes disponíveis e configuradas no daemon do Docker:
+
+`docker network ls`
+
+- Criar uma rede definida pelo usuário:
+
+`docker network create --driver {{nome_do_driver}} {{nome_da_rede}}`
+
+- Exibir informações detalhadas de uma lista separada por espaços de redes:
+
+`docker network inspect {{nome_da_rede}}`
+
+- Conectar um contêiner a uma rede usando um nome ou ID:
+
+`docker network connect {{nome_da_rede}} {{nome_do_contêiner|ID}}`
+
+- Desconectar um contêiner de uma rede:
+
+`docker network disconnect {{nome_da_rede}} {{nome_do_contêiner|ID}}`
+
+- Remover todas as redes não utilizadas (que não são referenciadas por nenhum contêiner):
+
+`docker network prune`
+
+- Remover uma lista separada por espaços de redes não utilizadas:
+
+`docker network rm {{nome_da_rede}}`

pages.pt_BR/common/docker-pull.md

@@ -0,0 +1,24 @@
+# docker pull
+
+> Baixar imagens do Docker de um registro.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/pull/>.
+
+- Baixar uma imagem específica do Docker:
+
+`docker pull {{imagem}}:{{tag}}`
+
+- Baixar uma imagem específica do Docker no modo silencioso:
+
+`docker pull --quiet {{imagem}}:{{tag}}`
+
+- Baixar todas as tags de uma imagem específica do Docker:
+
+`docker pull --all-tags {{imagem}}`
+
+- Baixar imagens do Docker para uma plataforma específica, por exemplo, linux/amd64:
+
+`docker pull --platform {{linux/amd64}} {{imagem}}:{{tag}}`
+
+- Exibir ajuda:
+
+`docker pull --help`

pages.pt_BR/common/docker-save.md

@@ -0,0 +1,20 @@
+# docker save
+
+> Exportar uma ou mais imagens do Docker para um arquivo de arquivamento.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/save/>.
+
+- Salvar uma imagem redirecionando `stdout` para um arquivo tar:
+
+`docker save {{imagem}}:{{tag}} > {{caminho/para/arquivo.tar}}`
+
+- Salvar uma imagem em um arquivo tar:
+
+`docker save --output {{caminho/para/arquivo.tar}} {{imagem}}:{{tag}}`
+
+- Salvar todas as tags da imagem:
+
+`docker save --output {{caminho/para/arquivo.tar}} {{nome_da_imagem}}`
+
+- Selecionar tags específicas de uma imagem para salvar:
+
+`docker save --output {{caminho/para/arquivo.tar}} {{nome_da_imagem:tag1 nome_da_imagem:tag2 ...}}`

pages.pt_BR/common/docker-secret.md

@@ -0,0 +1,24 @@
+# docker secret
+
+> Gerenciar segredos do Docker swarm.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/secret/>.
+
+- Criar um novo segredo a partir de `stdin`:
+
+`{{comando}} | docker secret create {{nome_do_segredo}} -`
+
+- Criar um novo segredo a partir de um arquivo:
+
+`docker secret create {{nome_do_segredo}} {{caminho/para/arquivo}}`
+
+- Listar todos os segredos:
+
+`docker secret ls`
+
+- Exibir informações detalhadas sobre um ou vários segredos em um formato amigável ao usuário:
+
+`docker secret inspect --pretty {{nome_do_segredo1 nome_do_segredo2 ...}}`
+
+- Remover um ou mais segredos:
+
+`docker secret rm {{nome_do_segredo1 nome_do_segredo2 ...}}`

pages.pt_BR/common/docker-service.md

@@ -0,0 +1,28 @@
+# docker service
+
+> Gerenciar os serviços em um daemon do Docker.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/service/>.
+
+- Listar os serviços em um daemon do Docker:
+
+`docker service ls`
+
+- Criar um novo serviço:
+
+`docker service create --name {{nome_do_serviço}} {{imagem}}:{{tag}}`
+
+- Exibir informações detalhadas de uma lista separada por espaços de serviços:
+
+`docker service inspect {{nome_do_serviço|ID}}`
+
+- Listar as tarefas de uma lista separada por espaços de serviços:
+
+`docker service ps {{nome_do_serviço|ID}}`
+
+- Escalar para um número específico de réplicas para uma lista separada por espaços de serviços:
+
+`docker service scale {{nome_do_serviço}}={{quantidade_de_réplicas}}`
+
+- Remover uma lista separada por espaços de serviços:
+
+`docker service rm {{nome_do_serviço|ID}}`

pages.pt_BR/common/docker-slim.md

@@ -0,0 +1,24 @@
+# docker-slim
+
+> Analisar e otimizar imagens Docker.
+> Mais informações: <https://github.com/docker-slim/docker-slim>.
+
+- Iniciar o DockerSlim no modo interativo:
+
+`docker-slim`
+
+- Analisar as camadas do Docker a partir de uma imagem específica:
+
+`docker-slim xray --target {{imagem:tag}}`
+
+- Verificar um Dockerfile:
+
+`docker-slim lint --target {{caminho/para/Dockerfile}}`
+
+- Analisar e gerar uma imagem Docker otimizada:
+
+`docker-slim build {{imagem:tag}}`
+
+- Exibir ajuda para um subcomando:
+
+`docker-slim {{subcomando}} --help`

pages.pt_BR/common/docker-swarm.md

@@ -0,0 +1,32 @@
+# docker swarm
+
+> Uma ferramenta de orquestração de contêineres.
+> Mais informações: <https://docs.docker.com/engine/swarm/>.
+
+- Inicializar um cluster do Swarm:
+
+`docker swarm init`
+
+- Exibir o token para ingressar como gerenciador ou trabalhador:
+
+`docker swarm join-token {{worker|manager}}`
+
+- Ingressar um novo nó ao cluster:
+
+`docker swarm join --token {{token}} {{url_do_nó_gerenciador:2377}}`
+
+- Remover um trabalhador do Swarm (executado dentro do nó trabalhador):
+
+`docker swarm leave`
+
+- Exibir o certificado CA atual no formato PEM:
+
+`docker swarm ca`
+
+- Rotacionar o certificado CA atual e exibir o novo certificado:
+
+`docker swarm ca --rotate`
+
+- Alterar o período de validade dos certificados dos nós:
+
+`docker swarm update --cert-expiry {{horas}}h{{minutos}}m{{segundos}}s`

pages.pt_BR/common/docker-system.md

@@ -0,0 +1,36 @@
+# docker system
+
+> Gerenciar dados do Docker e exibir informações do sistema em todo o sistema.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/system/>.
+
+- Mostrar ajuda:
+
+`docker system`
+
+- Mostrar o uso de disco do Docker:
+
+`docker system df`
+
+- Mostrar informações detalhadas sobre o uso de disco:
+
+`docker system df --verbose`
+
+- Remover dados não utilizados:
+
+`docker system prune`
+
+- Remover dados não utilizados criados há mais de um período específico no passado:
+
+`docker system prune --filter="until={{horas}}h{{minutos}}m"`
+
+- Exibir eventos em tempo real do daemon do Docker:
+
+`docker system events`
+
+- Exibir eventos em tempo real de contêineres transmitidos como JSON Lines válidos:
+
+`docker system events --filter 'type=container' --format '{{json .}}'`
+
+- Exibir informações em todo o sistema:
+
+`docker system info`

pages.pt_BR/common/docker-tag.md

@@ -0,0 +1,16 @@
+# docker tag
+
+> Atribuir tags a imagens Docker existentes.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/tag/>.
+
+- Atribuir um nome e tag a um ID de imagem específico:
+
+`docker tag {{id}} {{nome}}:{{tag}}`
+
+- Atribuir uma tag a uma imagem específica:
+
+`docker tag {{imagem}}:{{tag_atual}} {{imagem}}:{{nova_tag}}`
+
+- Exibir ajuda:
+
+`docker tag`

pages.pt_BR/common/docker-update.md

@@ -0,0 +1,29 @@
+# docker update
+
+> Atualizar a configuração de contêineres Docker.
+> Este comando não é suportado para contêineres Windows.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/update/>.
+
+- Atualizar a política de reinicialização a ser aplicada quando um contêiner específico for encerrado:
+
+`docker update --restart={{always|no|on-failure|unless-stopped}} {{nome_do_contêiner}}`
+
+- Atualizar a política para reiniciar até três vezes um contêiner específico quando ele for encerrado com status de saída diferente de zero:
+
+`docker update --restart=on-failure:3 {{nome_do_contêiner}}`
+
+- Atualizar o número de CPUs disponíveis para um contêiner específico:
+
+`docker update --cpus {{quantidade}} {{nome_do_contêiner}}`
+
+- Atualizar o limite de memória em [M]egabytes para um contêiner específico:
+
+`docker update --memory {{limite}}M {{nome_do_contêiner}}`
+
+- Atualizar o número máximo de IDs de processos permitidos dentro de um contêiner específico (use `-1` para ilimitado):
+
+`docker update --pids-limit {{quantidade}} {{nome_do_contêiner}}`
+
+- Atualizar a quantidade de memória em [M]egabytes que um contêiner específico pode trocar para o disco (use `-1` para ilimitado):
+
+`docker update --memory-swap {{limite}}M {{nome_do_contêiner}}`

pages.pt_BR/common/docker-volume.md

@@ -0,0 +1,36 @@
+# docker volume
+
+> Gerenciar volumes do Docker.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/volume/>.
+
+- Criar um volume:
+
+`docker volume create {{nome_do_volume}}`
+
+- Criar um volume com um rótulo específico:
+
+`docker volume create --label {{rótulo}} {{nome_do_volume}}`
+
+- Criar um volume `tmpfs` com tamanho de 100 MiB e uid 1000:
+
+`docker volume create --opt {{type}}={{tmpfs}} --opt {{device}}={{tmpfs}} --opt {{o}}={{size=100m,uid=1000}} {{nome_do_volume}}`
+
+- Listar todos os volumes:
+
+`docker volume ls`
+
+- Remover um volume:
+
+`docker volume rm {{nome_do_volume}}`
+
+- Exibir informações sobre um volume:
+
+`docker volume inspect {{nome_do_volume}}`
+
+- Remover todos os volumes locais não utilizados:
+
+`docker volume prune`
+
+- Exibir ajuda para um subcomando:
+
+`docker volume {{subcomando}} --help`

pages.pt_BR/common/x11docker.md

@@ -0,0 +1,25 @@
+# x11docker
+
+> Executar aplicativos de GUI e interfaces de desktop seguramente em contêineres do Docker.
+> Veja também `xephyr`.
+> Mais informações: <https://github.com/mviereck/x11docker>.
+
+- Iniciar o VLC em um contêiner:
+
+`x11docker --pulseaudio --share={{$HOME/Videos}} {{jess/vlc}}`
+
+- Iniciar o Xfce em uma janela:
+
+`x11docker --desktop {{x11docker/xfce}}`
+
+- Iniciar o GNOME em uma janela:
+
+`x11docker --desktop --gpu --init={{systemd}} {{x11docker/gnome}}`
+
+- Iniciar o KDE Plasma em uma janela:
+
+`x11docker --desktop --gpu --init={{systemd}} {{x11docker/kde-plasma}}`
+
+- Exibir ajuda:
+
+`x11docker --help`

pages.pt_BR/linux/dockerd.md

@@ -0,0 +1,24 @@
+# dockerd
+
+> Um processo persistente para iniciar e gerenciar contêineres Docker.
+> Mais informações: <https://docs.docker.com/engine/reference/commandline/dockerd/>.
+
+- Executar o daemon do Docker:
+
+`dockerd`
+
+- Executar o daemon do Docker e configurá-lo para escutar em sockets específicos (UNIX e TCP):
+
+`dockerd --host unix://{{caminho/para/tmp.sock}} --host tcp://{{ip}}`
+
+- Executar com um arquivo PID específico para o daemon:
+
+`dockerd --pidfile {{caminho/para/arquivo_pid}}`
+
+- Executar no modo de depuração:
+
+`dockerd --debug`
+
+- Executar e definir um nível de log específico:
+
+`dockerd --log-level={{debug|info|warn|error|fatal}}`

pages.pt_BR/linux/kdocker.md

@@ -0,0 +1,28 @@
+# kdocker
+
+> Ancorar facilmente aplicativos à bandeja do sistema.
+> Mais informações: <https://github.com/user-none/KDocker>.
+
+- Exibir um cursor para enviar uma janela para a bandeja do sistema ao pressionar o botão esquerdo do mouse (pressione qualquer outro botão do mouse para cancelar):
+
+`kdocker`
+
+- Abrir um aplicativo e enviá-lo para a bandeja do sistema:
+
+`kdocker {{aplicativo}}`
+
+- Enviar a janela com foco para a bandeja do sistema:
+
+`kdocker -f`
+
+- Exibir um cursor para enviar uma janela para a bandeja do sistema com um ícone personalizado ao pressionar o botão esquerdo do mouse:
+
+`kdocker -i {{/caminho/para/ícone}}`
+
+- Abrir um aplicativo, enviá-lo para a bandeja do sistema e, se perder o foco, minimizá-lo:
+
+`kdocker -l {{aplicativo}}`
+
+- Exibir a versão:
+
+`kdocker --version`