{"id":62391,"date":"2023-08-21T10:12:35","date_gmt":"2023-08-21T13:12:35","guid":{"rendered":"https:\/\/kinqsta.com\/pt\/?p=62391&preview=true&preview_id=62391"},"modified":"2023-08-29T09:40:55","modified_gmt":"2023-08-29T12:40:55","slug":"como-configurar-pipeline-ci-cd","status":"publish","type":"post","link":"https:\/\/kinqsta.com\/pt\/blog\/como-configurar-pipeline-ci-cd\/","title":{"rendered":"Como Criar um Pipeline CI\/CD com GitHub Actions e a API da Kinsta"},"content":{"rendered":"

No mundo acelerado do desenvolvimento web<\/a>, a integra\u00e7\u00e3o cont\u00ednua e a implanta\u00e7\u00e3o cont\u00ednua (CI\/CD<\/a>) tornaram-se pr\u00e1ticas indispens\u00e1veis para o fornecimento eficiente de software de alta qualidade. A CI\/CD permite que os desenvolvedores automatizem o processo de cria\u00e7\u00e3o, teste e implanta\u00e7\u00e3o de altera\u00e7\u00f5es de c\u00f3digo, reduzindo o risco de erro humano e permitindo itera\u00e7\u00f5es mais r\u00e1pidas.<\/p>\n

Este artigo explica a import\u00e2ncia da CI\/CD, como criar um pipeline CI e como configurar a implanta\u00e7\u00e3o cont\u00ednua em seu pipeline CI com a API da Kinsta<\/a> de forma program\u00e1tica – tudo com o GitHub Actions em seu reposit\u00f3rio GitHub<\/a>.<\/p>\n

<\/div><\/kinsta-auto-toc>\n

Por que usar CI\/CD?<\/h2>\n

A plataforma de Hospedagem de Aplicativos<\/a> da Kinsta sempre ofereceu uma op\u00e7\u00e3o para implanta\u00e7\u00e3o autom\u00e1tica, acionada sempre que h\u00e1 uma altera\u00e7\u00e3o em uma branch espec\u00edfica no seu reposit\u00f3rio Git hospedado. No entanto, isso pode n\u00e3o ser ideal para grandes projetos com v\u00e1rios membros da equipe. Muitos desenvolvedores<\/a> tendem a evitar a ativa\u00e7\u00e3o da implanta\u00e7\u00e3o autom\u00e1tica por uma variedade de raz\u00f5es.<\/p>\n

Um dos motivos \u00e9 que, em um ambiente colaborativo onde v\u00e1rios desenvolvedores est\u00e3o trabalhando no mesmo projeto, implanta\u00e7\u00f5es autom\u00e1ticas acionadas por uma altera\u00e7\u00e3o no reposit\u00f3rio por parte de um desenvolvedor podem levar a instabilidade e problemas imprevistos. Sem testes e valida\u00e7\u00e3o adequados, at\u00e9 mesmo uma pequena altera\u00e7\u00e3o no c\u00f3digo poderia interromper o site de produ\u00e7\u00e3o, causando potencialmente tempo de inatividade e experi\u00eancias negativas para os usu\u00e1rios.<\/p>\n

\u00c9 nesse ponto que um pipeline CI\/CD entra em a\u00e7\u00e3o. Ao criar um fluxo de CI\/CD job cuidadosamente orquestrado, os desenvolvedores podem garantir que as altera\u00e7\u00f5es de c\u00f3digo passem por testes e valida\u00e7\u00e3o antes de serem implantadas no site ativo. H\u00e1 muitas ferramentas dispon\u00edveis para implementar a CI\/CD no desenvolvimento de software; usaremos o GitHub Actions<\/a> neste tutorial.<\/p>\n

O que \u00e9 GitHub Actions?<\/h2>\n

O GitHub Actions \u00e9 uma poderosa ferramenta de automa\u00e7\u00e3o fornecida pelo GitHub. Ele oferece aos desenvolvedores a capacidade de automatizar v\u00e1rias tarefas, processos e fluxos de trabalho em seus projetos de desenvolvimento de software. Ele se integra aos reposit\u00f3rios do GitHub, tornando f\u00e1cil de usar.<\/p>\n

Com o GitHub Actions e a API da Kinsta<\/a>, voc\u00ea pode definir fluxos de trabalho personalizados que atendam aos requisitos do seu projeto. Voc\u00ea pode configurar um pipeline\u00a0 CI que testa seu aplicativo e aciona a implanta\u00e7\u00e3o na Kinsta.<\/p>\n

Primeiros passos com o GitHub Actions<\/h2>\n

O GitHub Actions opera com base no conceito de fluxos de trabalho, que s\u00e3o conjuntos de tarefas automatizadas acionadas por eventos espec\u00edficos ou programadas em intervalos regulares. Esses eventos podem incluir push de c\u00f3digo, pull requests, cria\u00e7\u00e3o de problemas e muito mais. Quando um desses eventos ocorre, o GitHub Actions executa automaticamente um fluxo de trabalho associado, executando uma s\u00e9rie de etapas predefinidas.<\/p>\n

Cada etapa do fluxo de trabalho representa uma a\u00e7\u00e3o espec\u00edfica, como a cria\u00e7\u00e3o do c\u00f3digo, a execu\u00e7\u00e3o de testes, a implanta\u00e7\u00e3o ou o envio de notifica\u00e7\u00f5es. Vamos criar um fluxo de trabalho com tr\u00eas tarefas:<\/p>\n

    \n
  1. Verificar a sintaxe com o ESLint<\/li>\n
  2. Executar testes<\/li>\n
  3. Reimplantar o aplicativo<\/li>\n<\/ol>\n

    Etapa 1: Configure o seu reposit\u00f3rio GitHub<\/h3>\n

    Para come\u00e7ar a usar o GitHub Actions, voc\u00ea precisa de um reposit\u00f3rio GitHub.<\/p>\n

    Aqui, estamos usando este reposit\u00f3rio do GitHub<\/a>, desenvolvido para o tutorial Como criar e implantar um aplicativo clone do ChatGPT com React e API OpenAI<\/a>.<\/p>\n

    Sinta-se \u00e0 vontade para usar o reposit\u00f3rio voc\u00ea mesmo, navegando at\u00e9 ele no GitHub e selecionando: Use this template<\/strong>\u00a0> Create<\/span> a new<\/span> repository.<\/span><\/strong><\/p>\n

    Nesse aplicativo React, s\u00e3o criados testes de unidade para testar cada componente. O ESLint tamb\u00e9m \u00e9 usado para refor\u00e7ar a sintaxe perfeita e a formata\u00e7\u00e3o do c\u00f3digo. O pipeline CI bloquear\u00e1 uma implanta\u00e7\u00e3o se um pull request ou c\u00f3digo mesclado enviado para o reposit\u00f3rio falhar nos testes de fluxo de trabalho.<\/p>\n

    Etapa 2: crie um arquivo de fluxo de trabalho<\/h3>\n

    Defina seu fluxo de trabalho criando um arquivo YAML no diret\u00f3rio .github\/workflows<\/strong> do seu reposit\u00f3rio. Esse diret\u00f3rio deve estar no n\u00edvel raiz do seu reposit\u00f3rio. A conven\u00e7\u00e3o de nomenclatura para arquivos de fluxo de trabalho \u00e9 name-of-the-workflow.yml<\/strong>.<\/p>\n

      \n
    1. Em seu reposit\u00f3rio, crie um diret\u00f3rio .github<\/strong>.<\/li>\n
    2. Dentro do diret\u00f3rio .github<\/strong>, crie um novo diret\u00f3rio chamado workflows<\/strong>.<\/li>\n
    3. Dentro do diret\u00f3rio de fluxos de trabalho, crie um novo arquivo com um nome como build-test-deploy.yml<\/strong>.<\/li>\n<\/ol>\n

      Etapa 3: Escreva o fluxo de CI\/CD job<\/h3>\n

      Agora que voc\u00ea criou o arquivo de fluxo de trabalho, defina um fluxo de trabalho com as etapas necess\u00e1rias para verificar a sintaxe com o ESLint, executar testes e implantar o aplicativo.<\/p>\n

      Crie evento CI<\/h4>\n

      Ao criar um pipeline CI, a primeira etapa \u00e9 dar um nome ao fluxo de trabalho e, em seguida, definir o evento que acionaria o fluxo de trabalho. Neste exemplo, dois eventos (pull request e push) para a branch principal.<\/p>\n

      name: Build, Test, and Deploy\n\non:\n  push:\n    branches: \"main\"\n  pull_request:\n    branches: \"main\"<\/code><\/pre>\n
      Se quiser agendar tarefas recorrentes<\/span> (CRON<\/span> jobs<\/span>) para tarefas espec\u00edficas, voc\u00ea poder\u00e1 adicion\u00e1-los ao fluxo de trabalho. Por exemplo, voc\u00ea pode querer executar determinadas tarefas como backups de banco de dados, limpeza de dados ou outras tarefas de manuten\u00e7\u00e3o peri\u00f3dica.<\/p>\n
      Aqui est\u00e1 um exemplo de como voc\u00ea pode adicionar um Cron jobs ao fluxo de trabalho:<\/p>\n
      on:\n  # Existing event triggers for push and pull_request\n\n  # Add a schedule for CRON jobs\n  schedule:\n    - cron: \"0 0 * * *\"<\/code><\/pre>\n
      O exemplo acima acionar\u00e1 o fluxo de trabalho todos os dias \u00e0 meia-noite (hor\u00e1rio UTC), j\u00e1 que a programa\u00e7\u00e3o do cron est\u00e1 definida como 0 0 * * *<\/code>. Voc\u00ea pode personalizar a programa\u00e7\u00e3o do cron para atender \u00e0s suas necessidades espec\u00edficas.<\/p>\n
      Como outro exemplo, suponha que voc\u00ea queira programar o fluxo de CI\/CD job para ser executado todas as segundas-feiras \u00e0s 8h. Podemos configurar um Cron job usando o evento schedule<\/code>:<\/p>\n
      name: Build, Test, and Deploy\n\non:\n  push:\n    branches: \"main\"\n  pull_request:\n    branches: \"main\"\n\n  # Schedule the workflow to run every Monday at 8 a.m. (UTC time)\n  schedule:\n    - cron: \"0 8 * * 1\"\n\njobs:\n # Add jobs<\/code><\/pre>\n
      A sintaxe de agendamento usada no evento schedule<\/code> para fluxos de trabalho do GitHub Actions \u00e9 baseada na sintaxe cron do UNIX. Ela permite que voc\u00ea defina hor\u00e1rios ou intervalos espec\u00edficos para que o seu fluxo de trabalho seja executado automaticamente. A sintaxe consiste em cinco campos que representam diferentes aspectos do cronograma. Cada campo \u00e9 separado por um espa\u00e7o. O formato geral da sintaxe do cronograma \u00e9 o seguinte:<\/p>\n
      * * * * *\n\u252c \u252c \u252c \u252c \u252c\n\u2502 \u2502 \u2502 \u2502 \u2502\n\u2502 \u2502 \u2502 \u2502 \u2514\u2500 Day of the week (0 - 7) (Sunday to Saturday, where both 0 and 7 represent Sunday)\n\u2502 \u2502 \u2502 \u2514\u2500\u2500\u2500 Month (1 - 12)\n\u2502 \u2502 \u2514\u2500\u2500\u2500\u2500\u2500 Day of the month (1 - 31)\n\u2502 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500 Hour (0 - 23)\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 Minute (0 - 59)<\/code><\/pre>\n
      Agora, vamos detalhar cada campo:<\/p>\n