O Ubuntu 26.04 já está em disponibilidade geral nos runners hospedados do GitHub Actions para x64 e arm64. O ponto de atenção agora é o rótulo ubuntu-latest: o GitHub anunciou que ele deixará de apontar para Ubuntu 24.04 e migrará gradualmente para Ubuntu 26.04 entre 19 de outubro e 19 de novembro de 2026. Quem usa ubuntu-latest deve validar o workflow antes dessa janela, porque ferramentas pré-instaladas, versões de runtimes e pacotes do sistema mudam entre as imagens.
O que muda na migração para Ubuntu 26.04
Para usar a nova imagem de forma explícita, o GitHub orienta definir runs-on: ubuntu-26.04 em jobs x64 ou runs-on: ubuntu-26.04-arm em jobs arm64. Durante a migração de ubuntu-latest, o mesmo arquivo de workflow poderá executar em Ubuntu 24.04 ou Ubuntu 26.04 conforme o rollout avançar. Por isso, o comportamento observado em uma execução isolada não deve ser usado como prova de que todos os jobs já migraram.
Se a equipe ainda não estiver pronta para a troca, é possível fixar temporariamente runs-on: ubuntu-24.04. Esse pin evita que o job acompanhe automaticamente a mudança de ubuntu-latest, mas também transfere para a equipe a responsabilidade de planejar a atualização depois.
Como conferir qual runner executou um job
A forma mais confiável de verificar a imagem usada por uma execução é abrir os logs do job no GitHub Actions e expandir Set up job. Dentro dessa etapa, a seção Runner Image mostra a versão da imagem e oferece o link Included Software correspondente ao runner exato que processou aquele job.
Essa verificação é mais precisa do que consultar apenas a lista atual do repositório actions/runner-images, porque as imagens hospedadas são atualizadas regularmente e o rollout de uma nova versão leva alguns dias. O próprio repositório recomenda usar o log de Set up job quando é necessário saber a versão efetiva de uma execução específica.
Como testar antes da troca de ubuntu-latest
O teste mais direto é executar o mesmo conjunto de jobs com ubuntu-26.04 antes de 19 de outubro. Em workflows importantes, vale manter por um período uma execução comparativa entre ubuntu-24.04 e ubuntu-26.04, por exemplo com uma matrix de sistema operacional, para localizar diferenças sem depender do rollout de ubuntu-latest.
Na comparação, não olhe apenas para o status final. Verifique etapas de instalação, compilação, testes, empacotamento, geração de artefatos e publicação. Uma migração pode continuar verde e ainda assim produzir um binário diferente, selecionar outra versão de compilador ou resolver dependências de forma diferente.
Quais dependências merecem revisão
O Ubuntu 26.04 traz um conjunto diferente de software pré-instalado. A lista publicada para a imagem inclui versões mais novas de runtimes, compiladores e gerenciadores de pacotes do que a imagem Ubuntu 24.04. Como essas imagens são atualizadas ao longo do tempo, a comparação deve ser feita com o Included Software da execução real e, quando necessário, com os arquivos de software das imagens 24.04 e 26.04 no repositório oficial.
- Runtimes: confira Node.js, Python, Ruby, Java, .NET e outras linguagens usadas diretamente ou por ferramentas auxiliares.
- Compiladores e toolchains: valide GCC, Clang, CMake, Make, linker e bibliotecas nativas quando o projeto compila código ou extensões.
- Gerenciadores de pacotes: mudanças em npm, pip, Homebrew, Helm, vcpkg e outros podem alterar resolução, formato de lockfile ou comportamento de instalação.
- Pacotes do sistema: não presuma que uma biblioteca APT presente na imagem anterior continua instalada ou com o mesmo nome e versão.
- Containers e ferramentas de infraestrutura: revise Docker, Buildx, CLIs de nuvem e ferramentas usadas em build, deploy e testes de integração.
- Navegadores e drivers: pipelines de testes end-to-end podem ser afetados por versões diferentes de Chrome, Chromium, Firefox ou drivers.
Como reduzir dependência da imagem pré-instalada
Quanto mais o workflow depende implicitamente do conteúdo do runner, maior o risco de uma atualização de imagem alterar o resultado. Para componentes críticos, prefira instalar ou selecionar versões de forma explícita com as actions oficiais de setup, arquivos de lock e comandos de instalação reproduzíveis.
Também é útil registrar versões no próprio job durante a fase de migração. Comandos simples que imprimem a versão do runtime, compilador, gerenciador de pacotes e ferramenta de build tornam a comparação entre execuções muito mais objetiva. Essa evidência ajuda a separar uma falha causada pelo sistema operacional de uma alteração feita no código ou nas dependências do projeto.
Checklist prático para a migração
- Localize workflows que usam ubuntu-latest.
- Execute os jobs críticos com ubuntu-26.04 antes de 19 de outubro de 2026.
- Abra Set up job e registre a versão da imagem e o link Included Software.
- Compare instalação, build, testes, artefatos e etapas de deploy entre Ubuntu 24.04 e 26.04.
- Fixe versões de runtimes e ferramentas que não podem variar entre execuções.
- Se houver incompatibilidade não resolvida, use temporariamente ubuntu-24.04 enquanto corrige o workflow.
- Depois da correção, volte a testar em ubuntu-26.04 antes de depender novamente de ubuntu-latest.
O que fazer se o workflow quebrar
Se uma execução falhar durante ou depois da migração, confirme primeiro qual imagem realmente executou o job. Depois compare o Included Software e as versões registradas no log com uma execução anterior bem-sucedida. Se o problema estiver ligado ao Ubuntu 26.04, fixar temporariamente Ubuntu 24.04 pode restaurar a previsibilidade enquanto a dependência incompatível é atualizada.
O objetivo não é manter o pin para sempre. A migração anunciada indica que Ubuntu 26.04 passará a ser a base de ubuntu-latest, então o caminho sustentável é remover suposições sobre software pré-instalado, tornar versões críticas explícitas e validar o pipeline na nova imagem antes do rollout.
