podman, podman-*: add pt_BR translation (#10504)

* 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

* podman, podman-*: add pt_BR translation

* fix: typos

* Update pages.pt_BR/common/podman-ps.md

* Update podman-ps.md

---------

Co-authored-by: Waldir Pimenta <waldyrious@gmail.com>
Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

pages.pt_BR/common/podman-build.md

@@ -0,0 +1,25 @@
+# podman build
+
+> Ferramenta sem daemon para criar imagens de contêiner.
+> O Podman fornece uma linha de comando comparável ao Docker-CLI. Simplificando: `alias docker=podman`.
+> Mais informações: <https://docs.podman.io/en/latest/markdown/podman-build.1.html>.
+
+- Criar uma imagem usando um `Dockerfile` ou `Containerfile` no diretório especificado:
+
+`podman build {{caminho/para/diretório}}`
+
+- Criar uma imagem com uma tag especificada:
+
+`podman build --tag {{nome_da_imagem:versão}} {{caminho/para/diretório}}`
+
+- Criar uma imagem a partir de um arquivo não padrão:
+
+`podman build --file {{Containerfile.diferente}} .`
+
+- Criar uma imagem sem usar nenhuma imagem em cache previamente:
+
+`podman build --no-cache {{caminho/para/diretório}}`
+
+- Criar uma imagem suprimindo todas as saídas:
+
+`podman build --quiet {{caminho/para/diretório}}`

pages.pt_BR/common/podman-compose.md

@@ -0,0 +1,36 @@
+# podman-compose
+
+> Executar e gerenciar definição de contêineres Compose Specification.
+> Mais informações: <https://github.com/containers/podman-compose>.
+
+- Listar todos os contêineres em execução:
+
+`podman-compose ps`
+
+- Criar e iniciar todos os contêineres em segundo plano usando um arquivo `docker-compose.yml` local:
+
+`podman-compose up -d`
+
+- Iniciar todos os contêineres, fazendo o build se necessário:
+
+`podman-compose up --build`
+
+- Iniciar todos os contêineres usando um arquivo de composição alternativo:
+
+`podman-compose {{caminho/para/arquivo}} up`
+
+- Parar todos os contêineres em execução:
+
+`podman-compose stop`
+
+- Remover todos os contêineres, redes e volumes:
+
+`podman-compose down --volumes`
+
+- Acompanhar logs de um contêiner (omitir todos os nomes de contêineres):
+
+`podman-compose logs --follow {{nome_do_contêiner}}`
+
+- Executar um comando único em um serviço sem mapear portas:
+
+`podman-compose run {{nome_do_serviço}} {{comando}}`

pages.pt_BR/common/podman-image.md

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

pages.pt_BR/common/podman-images.md

@@ -0,0 +1,24 @@
+# podman images
+
+> Gerenciar imagens do Podman.
+> Mais informações: <https://docs.podman.io/en/latest/markdown/podman-images.1.html>.
+
+- Listar todas as imagens do Podman:
+
+`podman images`
+
+- Listar todas as imagens do Podman, incluindo intermediárias:
+
+`podman images --all`
+
+- Listar a saída no modo silencioso (apenas IDs numéricos):
+
+`podman images --quiet`
+
+- Listar todas as imagens do Podman que não são utilizadas por nenhum contêiner:
+
+`podman images --filter dangling=true`
+
+- Listar imagens que contenham uma substring em seus nomes:
+
+`podman images "{{*imagem|imagem*}}"`

pages.pt_BR/common/podman-machine.md

@@ -0,0 +1,33 @@
+# podman machine
+
+> Criar e gerenciar máquinas virtuais executando o Podman.
+> Incluído com a versão 4 ou superior do Podman.
+> Mais informações: <https://docs.podman.io/en/latest/markdown/podman-machine.1.html>.
+
+- Listar as máquinas existentes:
+
+`podman machine ls`
+
+- Criar uma nova máquina padrão:
+
+`podman machine init`
+
+- Criar uma nova máquina com um nome específico:
+
+`podman machine init {{nome}}`
+
+- Criar uma nova máquina com recursos diferentes:
+
+`podman machine init --cpus={{4}} --memory={{4096}} --disk-size={{50}}`
+
+- Iniciar ou parar uma máquina:
+
+`podman machine {{start|stop}} {{nome}}`
+
+- Conectar-se a uma máquina em execução via SSH:
+
+`podman machine ssh {{nome}}`
+
+- Inspecionar informações sobre uma máquina:
+
+`podman machine inspect {{nome}}`

pages.pt_BR/common/podman-ps.md

@@ -0,0 +1,36 @@
+# podman ps
+
+> Listar contêineres do Podman.
+> Mais informações: <https://docs.podman.io/en/latest/markdown/podman-ps.1.html>.
+
+- Listar contêineres do Podman em execução atualmente:
+
+`podman ps`
+
+- Listar todos os contêineres do Podman (em execução e parados):
+
+`podman ps --all`
+
+- Mostrar o contêiner mais recente criado (inclui todos os estados):
+
+`podman ps --latest`
+
+- Filtrar contêineres que contenham uma substring em seus nomes:
+
+`podman ps --filter "name={{nome}}"`
+
+- Filtrar contêineres que compartilhem uma determinada imagem como ancestral:
+
+`podman ps --filter "ancestor={{imagem}}:{{tag}}"`
+
+- Filtrar contêineres pelo código de status de saída:
+
+`podman ps --all --filter "exited={{código}}"`
+
+- Filtrar contêineres pelo status (criado, em execução, removendo, pausado, encerrado e morto):
+
+`podman ps --filter "status={{status}}"`
+
+- Filtrar contêineres que montam um volume específico ou têm um volume montado em um caminho específico:
+
+`podman ps --filter "volume={{caminho/para/diretório}}" --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Mounts}}"`

pages.pt_BR/common/podman-rmi.md

@@ -0,0 +1,20 @@
+# podman rmi
+
+> Remover uma ou mais imagens do Podman.
+> Mais informações: <https://docs.podman.io/en/latest/markdown/podman-rmi.1.html>.
+
+- Remover uma ou mais imagens pelo nome delas:
+
+`podman rmi {{imagem:tag}} {{imagem2:tag}} {{...}}`
+
+- Remover uma imagem forçadamente:
+
+`podman rmi --force {{imagem}}`
+
+- Remover uma imagem sem excluir os pais não marcados:
+
+`podman rmi --no-prune {{imagem}}`
+
+- Exibir ajuda:
+
+`podman rmi`

pages.pt_BR/common/podman-run.md

@@ -0,0 +1,36 @@
+# podman run
+
+> Executar um comando em um novo contêiner Podman.
+> Mais informações: <https://docs.podman.io/en/latest/markdown/podman-run.1.html>.
+
+- Executar um comando em um novo contêiner a partir de uma imagem marcada:
+
+`podman run {{imagem:tag}} {{comando}}`
+
+- Executar um comando em um novo contêiner em segundo plano e exibir o ID:
+
+`podman run --detach {{imagem:tag}} {{comando}}`
+
+- Executar um comando em um contêiner temporário no modo interativo e pseudo-TTY:
+
+`podman run --rm --interactive --tty {{imagem:tag}} {{comando}}`
+
+- Executar um comando em um novo contêiner com variáveis de ambiente passadas:
+
+`podman run --env '{{variável}}={{valor}}' --env {{variável}} {{imagem:tag}} {{comando}}`
+
+- Executar um comando em um novo contêiner com volumes montados por bind:
+
+`podman run --volume {{/caminho/para/caminho_no_host}}:{{/caminho/para/caminho_no_contêiner}} {{imagem:tag}} {{comando}}`
+
+- Executar um comando em um novo contêiner com portas publicadas:
+
+`podman run --publish {{porta_no_host}}:{{porta_no_contêiner}} {{imagem:tag}} {{comando}}`
+
+- Executar um comando em um novo contêiner sobrescrevendo o ponto de entrada (entrypoint) da imagem:
+
+`podman run --entrypoint {{comando}} {{imagem:tag}}`
+
+- Executar um comando em um novo contêiner conectando-o a uma rede:
+
+`podman run --network {{rede}} {{imagem:tag}}`

pages.pt_BR/common/podman.md

@@ -0,0 +1,37 @@
+# podman
+
+> Ferramenta de gerenciamento simples para pods, contêineres e imagens.
+> O Podman fornece uma linha de comando comparável ao Docker-CLI. Simplificando: `alias docker=podman`.
+> Mais informações: <https://github.com/containers/podman/blob/main/commands-demo.md>.
+
+- Listar todos os contêineres (em execução e parados):
+
+`podman ps --all`
+
+- Criar um contêiner a partir de uma imagem, com um nome personalizado:
+
+`podman run --name {{nome_do_contêiner}} {{imagem}}`
+
+- Iniciar ou parar um contêiner existente:
+
+`podman {{start|stop}} {{nome_do_contêiner}}`
+
+- Baixar uma imagem de um registro (por padrão, Docker Hub):
+
+`podman pull {{imagem}}`
+
+- Exibir a lista de imagens já baixadas:
+
+`podman images`
+
+- Abrir um shell dentro de um contêiner que já está em execução:
+
+`podman exec --interactive --tty {{nome_do_contêiner}} {{sh}}`
+
+- Remover um contêiner parado:
+
+`podman rm {{nome_do_contêiner}}`
+
+- Exibir os logs de um ou mais contêineres e acompanhar a saída do log:
+
+`podman logs --follow {{nome_do_contêiner}} {{id_do_contêiner}}`