Observação: no momento, não há suporte para os executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.
Introdução
O CircleCI e GitHub Actions permitem criar fluxos de trabalho que criam, testam, publicam, lançam e implementam código automaticamente. O CircleCI e o GitHub Actions compartilham algumas semelhanças em termos de configuração do fluxo de trabalho:
- Os arquivos de configuração do fluxo de trabalho são gravados no YAML e armazenados no repositório.
- Os fluxos de trabalho incluem um ou mais trabalhos.
- Os trabalhos incluem uma ou mais etapas ou comandos individuais.
- É possível reutilizar e compartilhar novamente etapas ou tarefas com a comunidade.
Para obter mais informações, confira "Conceitos básicos do GitHub Actions".
Principais diferenças
Ao fazer a migração do CircleCI, considere as seguintes diferenças:
- O paralelismo do teste automático do CircleCI agrupa automaticamente os testes de acordo com regras especificadas pelo usuário ou com informações históricas de temporização. Esta funcionalidade não foi criada em GitHub Actions.
- As ações que são executadas em contêineres Docker são sensíveis a problemas de permissões, uma vez que os contêineres têm um mapeamento diferente de usuários. Você pode evitar muitos desses problemas não usando a instrução
USER
no Dockerfile. Para obter mais informações sobre o sistema de arquivos do Docker em executores hospedados no GitHub Enterprise Server, confira "Sobre executores hospedados no GitHub".
Migrar fluxos de trabalhos e trabalhos
O CircleCI define workflows
no arquivo config.yml, que permite configurar mais de um fluxo de trabalho. O GitHub Enterprise Server exige um arquivo de fluxo de trabalho por fluxo de trabalho e, consequentemente, não exige que você declare os workflows
. Será necessário criar um arquivo de fluxo de trabalho para cada fluxo de trabalho configurado em config.yml.
Tanto o CircleCI quanto o GitHub Actions configuram jobs
no arquivo de configuração usando uma sintaxe similar. Se você configurar qualquer dependência entre trabalhos usando requires
no seu fluxo de trabalho do CircleCI, poderá usar a sintaxe needs
equivalente do GitHub Actions. Para obter mais informações, confira "Sintaxe de fluxo de trabalho do GitHub Actions".
Migrar orbes para ações
Tanto o CircleCI quanto o GitHub Actions fornecem um mecanismo para reutilizar e compartilhar tarefas em um fluxo de trabalho. O CircleCI usa um conceito chamado orbs, escrito em YAML, para fornecer tarefas que as pessoas podem reutilizar em um fluxo de trabalho. O GitHub Actions tem componentes potentes, reutilizáveis e flexíveis denominados ações, que você cria com arquivos JavaScript ou imagens Docker. Você pode criar ações gravando códigos personalizados que interajam com o seu repositório da maneira que você quiser, inclusive fazendo integrações com as APIs do GitHub Enterprise Server e qualquer API de terceiros disponível publicamente. Por exemplo, uma ação pode publicar módulos npm, enviar alertas de SMS quando problemas urgentes surgirem ou implantar o código pronto para produção. Para obter mais informações, confira "Como criar ações".
O CircleCI pode reutilizar partes dos fluxos de trabalho com âncoras e aliases YAML. O GitHub Actions é compatível com a necessidade mais comum de reutilização usando matrizes. Para obter mais informações sobre matrizes, confira "Usando uma matriz em seus trabalhos".
Usar imagens do Docker
Tanto o CircleCI quanto o GitHub Actions suportam executar etapas dentro de uma imagem do Docker.
O CircleCI fornece um conjunto de imagens pré-construídas com dependências comuns. Essas imagens têm o USER
definido como circleci
, o que faz com que as permissões entrem em conflito com o GitHub Actions.
Recomendamos que você se afaste das imagens pré-criadas do CircleCI, ao migrar para GitHub Actions. Em muitos casos, você pode usar ações para instalar as dependências adicionais de que você precisa.
Para obter mais informações sobre o sistema de arquivos Docker, confira "Sobre executores hospedados no GitHub."
Para obter mais informações sobre as ferramentas e os pacotes disponíveis em imagens do executor hospedadas no GitHub, confira "Especificações para executores hospedados no GitHub".
Usar variáveis e segredos
O CircleCI e o GitHub Actions suportam configurações das variáveis de ambiente no arquivo de configuração e criação de segredos usando o CircleCI ou a interface de usuário do GitHub Enterprise Server.
Para obter mais informações, confira "Como usar variáveis de ambiente" e "Como criar e usar segredos criptografados".
Cache
O CircleCI e o GitHub Actions fornecem um método para armazenar arquivos de cache no arquivo de configuração manualmente.
O cache de GitHub Actions só está disponível em repositórios hospedados em GitHub.com ou GitHub Enterprise Server 3.5 e posteriores. Para obter mais informações, confira "Como armazenar dependências em cache para acelerar os fluxos de trabalho".
GitHub Actions não tem o equivalente ao Docker Layer Caching (DLC) do CircleCI.
Dados persistentes entre trabalhos
Tanto a CircleCI quanto a GitHub Actions fornecem mecanismos para persistir dados entre trabalhos.
Abaixo está um exemplo no CircleCI e na sintaxe de configuração do GitHub Actions.
CircleCI | GitHub Actions |
---|---|
|
|
Para obter mais informações, confira "Como persistir dados de fluxo de trabalho usando artefatos".
Usar bancos de dados e contêineres de serviço
Ambos os sistemas permitem que você inclua contêineres adicionais para bases de dados, memorização ou outras dependências.
No CircleCI, a primeira imagem listada no config.yaml é a imagem principal primária usada para executar comandos. O GitHub Actions usa seções explícitas: use container
para o contêiner primário e liste os contêineres adicionais em services
.
Abaixo está um exemplo no CircleCI e na sintaxe de configuração do GitHub Actions.
CircleCI | GitHub Actions |
---|---|
|
|
Para obter mais informações, confira "Sobre os contêineres de serviço".
Exemplo completo
Abaixo, há um exemplo concreto. O lado esquerdo mostra o config.yml real do CircleCI para o repositório thoughtbot/administrator. O lado direito mostra o equivalente GitHub Actions.
CircleCI | GitHub Actions |
---|---|
|
|