# Migrando do Jenkins para o GitHub Actions GitHub Actions e Jenkins compartilham várias semelhanças, o que torna a migração para GitHub Actions relativamente simples. ## Introdução O Jenkins e GitHub Actions ambos permitem criar fluxos de trabalho que criam, testam, publicam, liberam e implantam código automaticamente. Jenkins e GitHub Actions compartilham algumas semelhanças na configuração do fluxo de trabalho: * O Jenkins cria fluxos de trabalho usando *Pipelines Declarativos*, que são semelhantes aos GitHub Actions arquivos de fluxo de trabalho. * O Jenkins usa *estágios* para executar uma coleção de etapas, enquanto GitHub Actions usa trabalhos para agrupar uma ou mais etapas ou comandos individuais. * Jenkins e GitHub Actions oferecem suporte a compilações baseadas em contêineres. Para saber mais, confira [Criando uma ação de contêiner do Docker](/pt/actions/tutorials/use-containerized-services/create-a-docker-container-action). * É possível reutilizar e compartilhar novamente etapas ou tarefas com a comunidade. Para saber mais, confira [Noções básicas sobre GitHub Actions](/pt/actions/get-started/understand-github-actions). ## Principais diferenças * O Jenkins tem dois tipos de sintaxe para a criação de pipelines: Declarative Pipeline e Scripted Pipeline. GitHub Actions usa YAML para criar fluxos de trabalho e arquivos de configuração. Para saber mais, confira [Sintaxe de fluxo de trabalho para o GitHub Actions](/pt/actions/reference/workflows-and-actions/workflow-syntax). * As implementações do Jenkins são tipicamente auto-hospedadas, com usuários mantendo os servidores em seus próprios centros de dados. GitHub Actions oferece uma abordagem de nuvem híbrida hospedando seus próprios corredores que você pode usar para executar trabalhos, ao mesmo tempo em que dá suporte a corredores auto-hospedados. Para saber mais, confira [Executores auto-hospedados](/pt/actions/concepts/runners/self-hosted-runners). ## Comparar recursos ### Distribuir suas criações O Jenkins permite que se envie criações para um único agente de criação, ou você pode distribuí-las entre vários agentes. Você também pode classificar esses agentes de acordo com vários atributos, como, por exemplo, tipos de sistema operacional. Da mesma forma, GitHub Actions pode enviar trabalhos para executores hospedados no GitHub ou auto-hospedados, e pode usar rótulos para classificar os executores de acordo com vários atributos. Para saber mais, confira [Noções básicas sobre GitHub Actions](/pt/actions/get-started/understand-github-actions#runners) e [Executores auto-hospedados](/pt/actions/concepts/runners/self-hosted-runners). ### Usar seções para organizar pipelines O Jenkins divide seus Declarative Pipelines em múltiplas seções. Da mesma forma, GitHub Actions organiza seus fluxos de trabalho em seções separadas. A tabela a seguir compara as seções do Jenkins com o GitHub Actions fluxo de trabalho. | Diretivas do Jenkins | GitHub Actions | | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`agent`](https://jenkins.io/doc/book/pipeline/syntax/#agent) | [`jobs..runs-on`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idruns-on)
[`jobs..container`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idcontainer) | | [`post`](https://jenkins.io/doc/book/pipeline/syntax/#post) | Nenhum | | [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#stages) | [`jobs`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobs) | | [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idsteps) | ## Uso de diretivas O Jenkins usa diretivas para gerenciar os *Pipelines Declarativos*. Essas diretivas definem as características do seu fluxo de trabalho e como ele será executado. A tabela a seguir demonstra como essas diretivas correspondem a conceitos em GitHub Actions. | Diretivas do Jenkins | GitHub Actions | | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`environment`](https://jenkins.io/doc/book/pipeline/syntax/#environment) | [`jobs..env`](/pt/actions/reference/workflows-and-actions/workflow-syntax#env)
[`jobs..steps[*].env`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstepsenv) | | [`options`](https://jenkins.io/doc/book/pipeline/syntax/#options) | [`jobs..strategy`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategy)
[`jobs..strategy.fail-fast`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategyfail-fast)
[`jobs..timeout-minutes`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idtimeout-minutes) | | [`parameters`](https://jenkins.io/doc/book/pipeline/syntax/#options) | [`inputs`](/pt/actions/reference/workflows-and-actions/metadata-syntax#inputs)
[`outputs`](/pt/actions/reference/workflows-and-actions/metadata-syntax#outputs-for-docker-container-and-javascript-actions) | | [`triggers`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`on`](/pt/actions/reference/workflows-and-actions/workflow-syntax#on)
[`on..types`](/pt/actions/reference/workflows-and-actions/workflow-syntax#onevent_nametypes)
[on.\.\](/pt/actions/reference/workflows-and-actions/workflow-syntax#onpushbranchestagsbranches-ignoretags-ignore)
[on.\.\](/pt/actions/reference/workflows-and-actions/workflow-syntax#onpull_requestpull_request_targetbranchesbranches-ignore)
[on.\.paths](/pt/actions/reference/workflows-and-actions/workflow-syntax#onpushpull_requestpull_request_targetpathspaths-ignore) | | [`triggers { upstreamprojects() }`](https://jenkins.io/doc/book/pipeline/syntax/#triggers) | [`jobs..needs`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idneeds) | | [Sintaxe cron do Jenkins](https://jenkins.io/doc/book/pipeline/syntax/#cron-syntax) | [`on.schedule`](/pt/actions/reference/workflows-and-actions/workflow-syntax#onschedule) | | [`stage`](https://jenkins.io/doc/book/pipeline/syntax/#stage) | [`jobs.`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_id)
[`jobs..name`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idname) | | [`tools`](https://jenkins.io/doc/book/pipeline/syntax/#tools) | | | [Especificações para GitHubrunners hospedados](/pt/actions/concepts/runners/github-hosted-runners#preinstalled-software-for-github-owned-images) | | | [`input`](https://jenkins.io/doc/book/pipeline/syntax/#input) | [`inputs`](/pt/actions/reference/workflows-and-actions/metadata-syntax#inputs) | | [`when`](https://jenkins.io/doc/book/pipeline/syntax/#when) | [`jobs..if`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idif) | ## Usar estágios sequenciais ### Processamento paralelo do trabalho Jenkins pode executar o `stages` e `steps` em paralelo. GitHub Actions executa trabalhos em paralelo e também pode executar etapas simultaneamente em um trabalho usando a sintaxe de nível de etapa. Para obter mais informações, consulte [Sintaxe de fluxo de trabalho para o GitHub Actions](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstepsbackground). | Jenkins em paralelo | GitHub Actions | | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | [`parallel`](https://jenkins.io/doc/book/pipeline/syntax/#parallel) | [`jobs..strategy.max-parallel`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idstrategymax-parallel) | ### Matriz Tanto GitHub Actions quanto Jenkins permitem que você use uma matriz para definir várias combinações do sistema. | Jenkins | GitHub Actions | | ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`axis`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-axes) | [`strategy/matrix`](/pt/actions/how-tos/write-workflows/choose-what-workflows-do/run-job-variations#about-matrix-strategies)
[`context`](/pt/actions/reference/workflows-and-actions/contexts) | | [`stages`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | [`steps-context`](/pt/actions/reference/workflows-and-actions/contexts#steps-context) | | [`excludes`](https://jenkins.io/doc/book/pipeline/syntax/#matrix-stages) | Nenhum | ### Usar passos para executar tarefas O Jenkins agrupa as `steps` em `stages`. Cada uma dessas etapas pode ser um script, função ou comando, entre outros. Da mesma forma, GitHub Actions usa `jobs` para executar grupos específicos de `steps`. | Jenkins | GitHub Actions | | ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | [`steps`](https://jenkins.io/doc/book/pipeline/syntax/#steps) | [`jobs..steps`](/pt/actions/reference/workflows-and-actions/workflow-syntax#jobsjob_idsteps) | ## Exemplos de tarefas comuns ### Como agendar um pipeline para ser executado com o `cron` #### Pipeline do Jenkins com `cron` ```yaml pipeline { agent any triggers { cron('H/15 * * * 1-5') } } ``` #### GitHub Actions fluxo de trabalho com `cron` ```yaml on: schedule: - cron: '*/15 * * * 1-5' ``` Para obter mais informações sobre eventos `schedule` e a sintaxe cron aceita, consulte [Eventos que disparam fluxos de trabalho](/pt/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule). ### Configurar variáveis de ambiente em um pipeline #### Pipeline do Jenkins com uma variável de ambiente ```yaml pipeline { agent any environment { MAVEN_PATH = '/usr/local/maven' } } ``` #### GitHub Actions fluxo de trabalho com uma variável de ambiente ```yaml jobs: maven-build: env: MAVEN_PATH: '/usr/local/maven' ``` ### Criar projetos projetos de upstream #### Pipeline do Jenkins baseado em um projeto upstream ```yaml pipeline { triggers { upstream( upstreamProjects: 'job1,job2', threshold: hudson.model.Result.SUCCESS ) } } ``` #### GitHub Actions fluxo de trabalho criado a partir de um projeto de origem ```yaml jobs: job1: job2: needs: job1 job3: needs: [job1, job2] ``` ### Criar com vários sistemas operacionais #### Pipeline do Jenkins baseado em vários sistemas operacionais ```yaml pipeline { agent none stages { stage('Run Tests') { matrix { axes { axis { name: 'PLATFORM' values: 'macos', 'linux' } } agent { label "${PLATFORM}" } stages { stage('test') { tools { nodejs "node-20" } steps { dir("scripts/myapp") { sh(script: "npm install -g bats") sh(script: "bats tests") } } } } } } } } ``` #### GitHub Actions fluxo de trabalho criado com vários sistemas operacionais ```yaml name: demo-workflow on: push: jobs: test: runs-on: ${{ matrix.os }} strategy: fail-fast: false matrix: os: [macos-latest, ubuntu-latest] steps: - uses: actions/checkout@v6 - uses: actions/setup-node@v7 with: node-version: 20 - run: npm install -g bats - run: bats tests working-directory: ./scripts/myapp ```