# O Que É uma Runner Image de CI (ou AMI)?

> Uma runner image é o template de disco pré-construído a partir do qual um runner de CI inicializa, com o OS e as ferramentas já instaladas. Aprenda como images e AMIs padronizam o CI.

Source: https://latchkey.dev/pt/learn/ci-cd-concepts/what-is-a-ci-runner-image  
Updated: 2026-06-25

Uma runner image é o template pré-construído a partir do qual um runner inicializa - um OS mais um conjunto selecionado de ferramentas e SDKs já instalados, para que os jobs não tenham que instalá-los do zero toda vez.

Seja chamada de image, de AMI (na AWS) ou de template de VM, a ideia é a mesma: um snapshot de uma máquina pronta para trabalhar. O conteúdo dessa image determina em grande parte o quão rápido e o quão consistente é o seu CI.

## O que há na image

Uma runner image embute o sistema operacional, runtimes e SDKs de linguagens comuns, ferramentas de build e o próprio agente do runner. Quando um runner é lançado, ele inicializa essa image e fica imediatamente pronto para pegar um job - sem provisionamento demorado da toolchain base a cada execução.

## Por que pré-embutir importa

- Velocidade: as ferramentas estão presentes na inicialização, então os jobs pulam as instalações de ferramentas base.
- Consistência: cada runner parte da mesma baseline idêntica e conhecida.
- Reprodutibilidade: fixar uma versão da image fixa a toolchain para todos os jobs.

## AMI especificamente

Na AWS, a image é uma AMI (Amazon Machine Image) - o template de disco a partir do qual uma instância EC2 é lançada. Uma frota de runners self-hosted ou gerenciada normalmente constrói uma AMI personalizada com exatamente as ferramentas que seus jobs precisam, para que cada instância suba pré-carregada em vez de instalar tudo na inicialização.

## As trocas

Uma image mais rica inicializa pronta para mais jobs, mas é maior e precisa ser reconstruída e republicada sempre que as ferramentas embutidas mudam. Uma image mais enxuta é menor e mais fácil de manter, mas força os jobs a instalar mais em tempo de execução. O equilíbrio é incluir o que a maioria dos jobs precisa, deixando ferramentas raras e pesadas para instalação por job ou para cache.

## FAQ

### What is What is a CI runner image (or AMI)??

Whether it is called an image, an AMI (on AWS), or a VM template, it is the same idea: a snapshot of a ready-to-work machine. The contents of that image largely determine how fast and how consistent your CI is.

### What is in the image?

A runner image bakes in the operating system, common language runtimes and SDKs, build tools, and the runner agent itself. When a runner launches, it boots this image and is immediately ready to pick up a job - no lengthy provisioning of the base toolchain per run.

### AMI specifically?

On AWS, the image is an AMI (Amazon Machine Image) - the disk template an EC2 instance launches from. A self-hosted or managed runner fleet typically builds a custom AMI with exactly the tools its jobs need, so each instance comes up pre-loaded rather than installing everything at boot.

### The trade-offs?

A richer image boots ready for more jobs but is larger and must be rebuilt and re-published whenever the baked tools change. A leaner image is smaller and easier to maintain but forces jobs to install more at runtime. The balance is including what most jobs need while leaving rare, heavy tools to per-job install or caching.

---

Latchkey runs CI/CD that repairs its own failures. Agent entry points: https://latchkey.dev/agent.txt, https://latchkey.dev/openapi.json, https://latchkey.dev/llms.txt