Como Funciona a Integração Contínua com Laravel?

Como Funciona a Integração Contínua com Laravel?

A integração contínua (CI) visa automatizar a execução de testes e validações no teu projeto Laravel sempre que há mudanças no código. Talvez já tenhas sentido a dor de quebrar algo ao integrar um novo recurso e encontrar o problema tarde demais. A CI ajuda a apanhar esses erros cedo.

Assim, perguntas como "Porque é que algo que funcionava parou de funcionar?" tornam-se menos frequentes. Vamos explorar como podes implementar estas práticas no teu projeto Laravel usando GitHub Actions ou GitLab CI.

O Que é CI/CD?

CI/CD representa Integração Contínua/Entregas Contínuas. É uma prática de engenharia de software que automatiza as etapas do ciclo de vida de desenvolvimento, como testes, builds, e deployments.

Benefícios Práticos

• Deteção Precoce de Erros: Captura bugs rapidamente.
• Automação de Tarefas Repetitivas: Mais tempo para código de qualidade.
• Feedback Rápido: Saber rapidamente se uma alteração quebrou algo.

GitHub Actions ou GitLab CI: Quais as Diferenças?

GitHub Actions e GitLab CI são dois dos serviços mais usados para configurar pipelines CI/CD. Escolher entre eles depende do teu contexto e necessidades específicas.

Como Configurar GitHub Actions para Laravel?

Vamos ver como podes configurar um pipeline simples para um projeto Laravel usando GitHub Actions.

Passo a Passo

1. Criação do Workflow: Dentro do teu repositório Laravel, cria o seguinte ficheiro:

   name: Laravel CI
   
   on: [push, pull_request]
   
   jobs:
     build:
   
       runs-on: ubuntu-latest
   
       steps:
       - uses: actions/checkout@v2
       - name: Setup PHP, with composer and extensions
         uses: shivammathur/setup-php@v2
         with:
           php-version: '8.0'
           extensions: mbstring, xml
   
       - name: Install dependencies
         run: composer install
   
       - name: Run tests
         run: php artisan test
   

2. Testar: Faz um push para o repositório e verifica se o workflow é executado adequadamente.

Como Configurar GitLab CI para Laravel?

Se estás a usar GitLab, aqui tens um exemplo de configuração que podes usar.

Exemplo de GitLab CI Configuração

stages:
  - test

variables:
  MYSQL_DATABASE: 'testdb'
  MYSQL_ROOT_PASSWORD: 'root'

test:
  stage: test
  services:
    - mysql:latest
  before_script:
    - apt-get update && apt-get install -y zlib1g-dev libzip-dev unzip
    - docker-php-ext-install zip
    - cp .env.ci .env
    - composer install
  script:
    - php artisan test
  after_script:
    - echo "Testes concluidos."

Qual a Melhor Opção para Ti?

Considerações Práticas

• Ecossistema Atual: Se já usas GitHub, a transição pode ser mais suave com Actions.
• Complexidade do Projeto: Projetos com pipelines complexas podem beneficiar do mais amplo conjunto de funcionalidades do GitLab CI.
• Custo: Se os minutos gratuitos forem um fator, considera como o custo escala com o uso.

FAQ

1. Posso usar ambos os serviços simultaneamente? Sim, mas mantém a simplicidade a não ser que tenhas uma razão clara para usar ambos.

2. Quão difícil é migrar de GitHub Actions para GitLab CI? Não é muito difícil, mas poderá exigir ajustes na configuração YML.

3. Os runners do GitLab oferecem mais controle? Sim, podes configurar runners personalizados para mais flexibilidade.

4. Qual a principal vantagem do GitHub Actions? A sua integração nativa com o ecossistema GitHub.

5. GitHub Actions suporta integração com ferramentas externas? Sim, há uma grande variedade de Actions no marketplace que suportam integrações.

6. Que variáveis de ambiente devo confiar? GitHub e GitLab oferecem variáveis de ambiente seguras e úteis para configurações sensíveis.

7. É necessário usar Docker com GitLab CI? É opcional, mas pode simplificar o setup do ambiente.

8. Os dois serviços suportam branch protection? Sim, podes configurar regras para garantir que apenas código validado é integrado.

Conclusão

A integração contínua (CI) visa automatizar a execução de testes e validações no teu projeto Laravel sempre que há mudanças no código. Talvez já tenhas sentido a dor de quebrar algo ao integrar um novo recurso e encontrar o problema tarde demais. A CI ajuda a apanhar esses erros cedo.