O yq está nos repositórios oficiais do Ubuntu?

Não — yq não está empacotado nos arquivos oficiais do Ubuntu. Este repositório é atualmente a única fonte apt, oferecendo yq 4.53.3.

Como instalo o yq mais recente no Ubuntu?

Adicione o repositório deb.griffo.io uma única vez com as instruções acima e execute: sudo apt install yq. Novos lançamentos chegam pelo sudo apt upgrade normal.

Os pacotes são assinados e como são construídos?

Cada pacote é assinado com a chave GPG do repositório (EA0F721D231FDD3A0A17B9AC7808B4DD62C41256) e construído a partir de lançamentos upstream em repositórios públicos do GitHub que qualquer pessoa pode inspecionar.

Quais versões do Ubuntu são suportadas?

Ubuntu 22.04 Jammy, 24.04 Noble, 25.10 Questing e 26.04 Resolute.

Instalar yq 4.53.3 no Ubuntu via apt (sempre atualizado)

Fonte	Versão
deb.griffo.io	4.53.3 ✅
Ubuntu oficial	🚫 não empacotado

← Voltar ao início

📌 Instalando em uma versão específica? Ubuntu 22.04 (jammy) · Ubuntu 24.04 (noble) · Ubuntu 25.10 (questing) · Ubuntu 26.04 (resolute)

O que é o yq?

O yq é um processador de linha de comando leve e portátil para dados estruturados — arquivos YAML, JSON, XML, CSV, TOML e properties — escrito em Go por Mike Farah. Ele usa sintaxe no estilo do jq, então tudo o que você sabe do jq se transfere diretamente: consulte, transforme, mescle e edite arquivos no local, em scripts e pipelines, com um único binário sem dependências.

⚠️ Qual yq é este? Este é o mikefarah/yq (v4.x, Go) — o usado na maioria dos exemplos de CI e documentações. Não é o wrapper de jq yq baseado em python encontrado em alguns arquivos; este pacote o substitui de forma limpa, e nenhum python ou jq é necessário.

            🚀 Sempre à frente dos repositórios oficiais: Debian e Ubuntu congelam as versões dos pacotes a cada lançamento — este repositório publica novas versões upstream normalmente em poucas horas. Um simples apt upgrade mantém você sempre na versão mais recente.
        

⚡ Principais Recursos do yq

🔄 Seis Formatos

YAML, JSON, XML, CSV/TSV, TOML e properties — leia um, produza outro: yq -o=json '.' config.yaml converte em um único passo.

🧠 Sintaxe no Estilo do jq

Caminhos, pipes, funções e operadores familiares. Se você sabe escrever um filtro jq, já sabe usar o yq em YAML.

✏️ Edição no Local

yq -i '.spec.replicas = 3' deploy.yaml — edições via script em manifestos do Kubernetes, configurações de CI e arquivos Compose, com comentários preservados.

📦 Zero Dependências

Um único binário estático em Go. Sem runtime, sem bibliotecas, sem python — ideal para contêineres mínimos e runners de CI.

🔀 Merge e Âncoras

Faz merge profundo de múltiplos arquivos, resolve âncoras e aliases de YAML, lida com fluxos de múltiplos documentos — os casos difíceis de YAML feitos do jeito certo.

📖 Página de Manual Incluída

Este pacote traz a página de manual completa junto com o binário — man yq funciona offline, seguindo as convenções do Debian.

🏆 Por que instalar com o apt?

Amigável a frotas: fixe um repositório nas suas imagens base e cada servidor, contêiner e runner de CI recebe o mesmo yq atual
Sem curl-para-bin: um repositório assinado com GPG em vez de baixar binários manualmente para /usr/local/bin
O yq certo: garante a semântica do mikefarah/yq v4 em todo lugar — sem surpresas do wrapper em python em algumas máquinas
Atualizações automáticas: novos lançamentos upstream chegam com o seu apt upgrade de sempre
Multi-arquitetura: amd64, arm64, armhf, ppc64el, s390x e riscv64

📦 Instalação a partir do deb.griffo.io

Passo 1: Adicionar repositório

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt update
                

install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update
                

Passo 2: Instalar o yq

sudo apt install -y yq

apt install -y yq

🚀 Primeira execução

yq '.services | keys' docker-compose.yml     # query
yq -i '.image.tag = "1.2.3"' values.yaml     # edit in place
yq -o=json '.' config.yaml                   # YAML -> JSON
        

📦 Repositório de construção de pacotes

Os pacotes do Debian são construídos e mantidos automaticamente neste repositório do GitHub:

📂 yq-debian - Compilações de lançamento mais recente

🔗 Pacotes relacionados

Também disponíveis no deb.griffo.io:

k9s - TUI para Kubernetes — combina com o yq para lidar com manifestos
lazydocker - TUI para Docker para os arquivos Compose que você acabou de editar
just - Um executor de comandos para envolver seus one-liners de yq

            🎯 Perfeito para: Engenheiros de DevOps editando manifestos do Kubernetes e values do Helm, pipelines de CI/CD transformando configurações, sysadmins criando scripts contra APIs YAML/JSON, e qualquer pessoa que queira a ergonomia do jq para todos os formatos de configuração.
        

💝 Apoie Este Projeto

Se este repositório economiza seu tempo e esforço, considere apoiá-lo!

⭐ Dê uma estrela no GitHub 🐦 Compartilhar no Twitter

📑 Instalar a última versão do yq no Ubuntu