O Que É stdout? O Fluxo de Saída Padrão
stdout (saída padrão) é o fluxo padrão no qual um programa escreve seus resultados normais, geralmente o terminal ou, no CI, o log do job.
Quando um comando imprime um resultado, ele normalmente o escreve em stdout. Esse fluxo é o que você vê no seu terminal e o que aparece nos logs de CI. Manter a saída normal em stdout, separada dos erros em stderr, é o que permite enviar por pipe, capturar e filtrar a saída do programa de forma limpa.
O que é stdout
stdout é o file descriptor 1, o canal para a saída ordinária de um programa. echo, printf e a maioria das ferramentas enviam seus resultados para cá por padrão.
Redirecionando stdout
Você pode enviar stdout para um arquivo com > (sobrescrever) ou >> (anexar). Por exemplo, node build.js > build.log captura a saída normal em um arquivo em vez do terminal.
Por que separar de stderr
- stdout carrega resultados; stderr carrega diagnósticos e erros.
- Você pode enviar stdout por pipe para outra ferramenta sem erros sujando os dados.
- CI pode colorir ou dobrar logs de forma diferente com base no fluxo.
Enviando stdout por pipe
Um pipe conecta o stdout de um programa ao stdin do próximo: ls | wc -l. Manter dados limpos em stdout é o que torna os pipelines compostáveis.
stdout em CI
CI captura stdout no log do job, então tudo que você imprime se torna parte do registro do build. Ferramentas que emitem resultados legíveis por máquina em stdout podem ser analisadas por steps posteriores, que é como relatórios fluem por um pipeline.
Logs em runners gerenciados
A Latchkey transmite stdout para o log do job ao vivo para que você possa acompanhar um build enquanto ele roda. Escrever stdout claro e bem estruturado torna a depuração de uma execução com falha muito mais rápida.
Principais conclusões
- stdout é o fluxo de saída padrão, file descriptor 1.
- Resultados normais vão para stdout; ele pode ser redirecionado ou enviado por pipe.
- CI captura stdout como o log do job, então é seu principal registro de depuração.