> ## Documentation Index
> Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar a integração contínua com um repositório GitHub usando as Ações do GitHub

> Configure a integração contínua com um repositório GitHub usando as Ações do GitHub.

'LATAM BR (PT) Setting up continuous integration with a GitHub repository using GitHub Actions';

'Configure a integração contínua com um repositório GitHub usando as Ações do GitHub.';

Como parte do seu fluxo de trabalho de [desenvolvimento](https://developers.hubspot.com/pt/docs/cms/guides/creating-an-efficient-development-workflow), você pode preferir manter o código-fonte da sua versão de produção como referência no controle de versão. Isso é especialmente útil se você faz parte de uma equipe de desenvolvimento, pois pode acompanhar as alterações e revertê-las rapidamente, se necessário.

Usando as [Ações do GitHub](https://github.com/features/actions), você pode configurar uma integração contínua com um repositório do GitHub. Este guia explica o processo de integração e pressupõe que você esteja familiarizado com:

* [Como usar o Git](https://docs.github.com/en/get-started/using-git) e o GitHub
* Criação de sites usando a [CLI do HubSpot](https://developers.hubspot.com/pt/docs/cms/guides/getting-started-with-local-development)

Abaixo, saiba como configurar a integração usando a ação do GitHub Implantar para o HubSpot CMS (recomendado) ou manualmente.

## Enviar arquivos locais para o GitHub

Antes de fazer a integração do GitHub, primeiro você precisará reunir seus arquivos localmente.

* Se você tiver um ativo CMS existente no HubSpot, como um tema ou conjunto de modelos, poderá buscá-lo executando o comando [fetch](https://developers.hubspot.com/pt/docs/cms/developer-reference/local-development-cli#fetch) da seguinte maneira: `hs fetch <HubSpot_src> <local_dest>`. Como alternativa, você pode baixar todos os arquivos no [sistema de arquivos do desenvolvedor](/cms/start-building/introduction/overview#developer-file-system) da conta executando `hs fetch /`.
* Para criar um novo projeto local, é recomendado começar com o [boilerplate de temas do CMS](https://developers.hubspot.com/pt/docs/cms/building-blocks/themes/hubspot-cms-boilerplate). Se você nunca usou um modelo de tema do CMS, confira o [guia de início rápido](https://developers.hubspot.com/pt/docs/cms/guides/getting-started). Se você já instalou a CLI da HubSpot e configurou seu ambiente local, poderá criar um novo tema local a partir do boilerplate executando `hs create website-theme <new-theme-name>`. Você precisará enviar seus arquivos para o HubSpot com o comando [hs upload](https://developers.hubspot.com/pt/docs/cms/developer-reference/local-development-cli#upload).

Com o código disponível localmente, você o [adicionará a um repositório GitHub](https://docs.github.com/en/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github). Depois de adicionar seus arquivos ao GitHub, siga para a próxima etapa para instalar a Ação do GitHub criada pelo HubSpot (recomendado) ou [configure a Ação manualmente](#manually-configure-the-action).

## Usar a ação do GitHub Implantar para o HubSpot CMS (recomendado)

Para agilizar o processo, a HubSpot criou uma Ação do GitHub que você pode instalar no seu projeto GitHub para executar a implantação automática das alterações de uma ramificação na sua conta de produção da HubSpot.

<CTA id="e0132707-395d-4617-bd9d-0b21c8b129d5" external={true} label="Install automatic CMS deploy GitHub action" />

## Criar e mesclar uma solicitação pull com o principal

* Agora que seus segredos, fluxos de trabalho e scripts estão no repositório GitHub, crie uma solicitação pull e mescle-a com a principal.
* Depois de mesclar a solicitação pull, vá para **Ações**. Sua Ação de implantação deve ser executada, o que implantará o código na sua conta da HubSpot.

## Bloquear seu ativo no gerenciador de design

Agora que o código-fonte está no GitHub, você deve bloquear o ativo no HubSpot para evitar que as edições sejam feitas lá. Isso garante que as alterações somente ocorram por meio da ação de implantação.

Para bloquear os ativos no gerenciador de design:

* Na sua conta da HubSpot, acesse **Marketing** > **Arquivos e modelos** > **Ferramentas de design**.
* Localize a pasta do ativo na barra lateral esquerda, clique **com o botão direito do mouse** e selecione **Bloquear pasta**.

![design-manager-lock-folder](https://www.hubspot.com/hubfs/Knowledge_Base_2021/Developer/design-manager-lock-folder.png)
