CI/CD com GitHub Actions

Cada envio deve ser testado, verificado quanto a problemas de estilo, analisado estaticamente e — quando estiver aprovado no ramo principal — transformado em uma imagem e implantado. O GitHub Actions executa esse pipeline em executores gerenciados, acionado por eventos do repositório.

Você criará um fluxo de trabalho que executa o PHPUnit em um serviço MySQL real, armazena o Composer em cache, executa o PHPStan, compila uma imagem do Docker e faz a implantação.

Um fluxo de trabalho fica em .github/workflows/*.yml. Ele tem gatilhos on:, um ou mais jobs:, e cada tarefa tem steps:. As tarefas são executadas em executores isolados e em paralelo, a menos que estejam vinculadas por needs:.

shivammathur/setup-php é a forma padrão de instalar uma versão específica do PHP com as extensões e ferramentas escolhidas (Composer, PHPStan etc.) no executor — muito mais rápido do que compilar uma imagem apenas para testar.

Baixar novamente as dependências a cada execução desperdiça minutos. Armazene o diretório do Composer em cache usando como chave o hash de composer.lock, para que o cache só seja invalidado quando as dependências mudarem.

As tarefas podem iniciar contêineres de serviço — um MySQL ou Redis real que o executor pode acessar em 127.0.0.1. Adicione uma verificação de integridade por meio de options para que as etapas não sejam executadas antes de o banco de dados estar pronto.

Com as dependências instaladas e o MySQL em execução, execute o PHPUnit. Aponte o DSN dos testes para 127.0.0.1:3306. Gere a cobertura e, opcionalmente, faça a compilação falhar se ela ficar abaixo de um limite.

As bibliotecas devem passar em várias versões do PHP. Uma strategy.matrix distribui a tarefa em execuções paralelas, uma por combinação, com ${{ matrix.php }} interpolado nas etapas.

As implantações precisam de um identificador de imagem único e rastreável. O SHA do commit é a escolha convencional. Este trecho mostra a lógica de derivação do identificador que você expressaria no fluxo de trabalho — transformando uma referência e um SHA em um identificador de registro.

No ramo principal, compile a imagem do Docker com docker/build-push-action, usando o BuildKit e o cache do GitHub Actions. Primeiro, autentique-se no registro com um token secreto; nunca codifique credenciais diretamente.

Armazene as credenciais nos segredos do repositório ou do ambiente, referenciados como ${{ secrets.NAME }} — eles são ocultados nos registros. Para implantações na nuvem, prefira o OIDC: o executor obtém um token de curta duração da AWS/GCP por meio de permissions: id-token: write, para que nenhuma chave de longa duração fique no repositório.

Condicione as implantações de produção a um environment do GitHub, opcionalmente com revisores obrigatórios. A etapa de implantação então aciona sua atualização — atualizando uma implantação do Kubernetes, um serviço do ECS ou conectando-se por SSH para baixar a nova imagem.

Você criou um pipeline de integração contínua e entrega contínua em GitHub Actions: acionado por envios/PR, setup-php com extensões, Composer armazenado em cache com chave baseada no arquivo de bloqueio, um contêiner de serviço MySQL com verificação de integridade, PHPUnit + PHPStan, uma matriz de versões e, em seguida, uma compilação e um envio apenas no ramo principal, com cache do GHA e uma implantação autenticada por OIDC e condicionada ao ambiente.

Princípios: use hashes do arquivo de bloqueio para o cache, controle os serviços prontos com verificações de integridade, identifique as imagens pelo SHA e prefira OIDC a chaves armazenadas.