Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Hover over a link to another article to get more details. If you have ideas for how we can improve this page, let us know in the discussion.

Configurar uma fonte de publicação para o site do GitHub Pages

Você pode configurar seu site do GitHub Pages para ser publicado quando alterações são enviadas por push a um branch específico ou pode escrever um fluxo de trabalho do GitHub Actions para publicar seu site.

Quem pode usar esse recurso

People with admin or maintainer permissions for a repository can configure a publishing source for a GitHub Pages site.

GitHub Pages está disponível em repositórios públicos com GitHub Free e GitHub Free para organizações, e em repositórios públicos e privados com GitHub Pro, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server.

Sobre as fontes de publicação

Você pode publicar seu site quando as alterações são enviadas por push para um branch específico ou você pode escrever um fluxo de trabalho do GitHub Actions para publicar seu site. Para usar o GitHub Actions como uma fonte de publicação de GitHub Pages, um administrador do site precisa habilitar o GitHub Actions para sua instância do GitHub Enterprise Server. Para obter mais informações, confira "Habilitar GitHub Actions para o GitHub Enterprise Server".

Se você não precisar de nenhum controle sobre o processo de build do seu site, recomendamos que você publique seu site quando as alterações forem enviadas por push para um branch específico. Você pode especificar qual branch e pasta usar como fonte de publicação. O branch de origem pode ser qualquer branch em seu repositório, e a pasta de origem pode ser a raiz do repositório (/) no branch de origem ou uma pasta /docs no branch de origem. Sempre que as alterações forem enviadas por push para o branch de origem, as alterações na pasta de origem serão publicadas em seu site do GitHub Pages.

Se você deseja usar um processo de build diferente do Jekyll ou não quer que um branch dedicado mantenha seus arquivos estáticos compilados, recomendamos que você escreva um fluxo de trabalho do GitHub Actions para publicar seu site. GitHub Enterprise Server oferece fluxos de trabalho iniciais para cenários comuns de publicação para ajudar vocâ a escrever seu fluxo de trabalho.

Aviso: se o administrador do site tiver habilitado Páginas Públicas, sites GitHub Pages estarão disponíveis publicamente na Internet, mesmo que o repositório do site seja privado ou interno. Se você tiver dados confidenciais no repositório do seu site, poderá removê-los antes de publicá-los. Para obter mais informações, confira "Configurar o GitHub Pages para a sua empresa" e "Sobre repositórios."

Fazer publicação de um branch

  1. Verifique se o branch que você deseja usar como fonte de publicação já existe no repositório.

  2. Em GitHub Enterprise Server, acesse o repositório do seu site. 1. Abaixo do nome do repositório, clique em Configurações. Caso não consiga ver a guia suspensa "Configurações", selecione o menu suspenso e clique em Configurações.

    Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja escuro.

  3. Na seção "Código e automação" da barra lateral, clique em Pages.

  4. Em "Build e implantação", em "Fonte", selecione Fazer implantação de um branch.

  5. Em "Build e implantação", em "Branch", use o menu suspenso Nenhum ou Branch e selecione uma fonte de publicação.

    Captura de tela do menu suspenso para selecionar uma fonte de publicação

  6. Opcionalmente, use o menu suspenso para selecionar uma pasta para sua fonte de publicação.

    Captura de tela do menu suspenso para selecionar uma pasta para a fonte de publicação

  7. Clique em Save (Salvar).

    Captura de tela do botão usado para salvar as alterações nas configurações da fonte de publicação

Solução de problemas de publicação de um branch

Observação: se você estiver publicando de um branch e seu site não tiver sido publicado automaticamente, verifique se alguém com permissões de administrador e um endereço de email verificado efetuou push para a fonte de publicação.

Se você escolher a pasta docs em qualquer branch como a origem de publicação e, depois, remover a pasta /docs desse branch no repositório, seu site não será compilado e você receberá uma mensagem de erro de build de página para uma pasta /docs ausente. Para obter mais informações, confira "Solucionar problemas de erros de criação do Jekyll para sites do GitHub Pages".

Fazer publicação com um fluxo de trabalho personalizado de GitHub Actions

Observação: a publicação do seu site do GitHub Pages com um fluxo de trabalho de GitHub Actions personalizado está em versão beta e sujeita a alteração.

Para configurar seu site para publicar com GitHub Actions:

  1. Em GitHub Enterprise Server, acesse o repositório do seu site. 1. Abaixo do nome do repositório, clique em Configurações. Caso não consiga ver a guia suspensa "Configurações", selecione o menu suspenso e clique em Configurações.

    Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja escuro.

  2. Na seção "Código e automação" da barra lateral, clique em Pages.

  3. Em "Build e implantação", em "Origem", selecione GitHub Actions .

  4. GitHub Enterprise Server sugerirá vários fluxos de trabalho iniciais. Se você já tiver um fluxo de trabalho para publicar seu site, poderá ignorar esta etapa. Caso contrário, escolha uma das opções para criar um fluxo de trabalho de GitHub Actions. Para obter mais informações sobre como criar seu fluxo de trabalho personalizado, confira "Como criar um fluxo de trabalho personalizado de GitHub Actions para publicar seu site."

    GitHub Pages não associa um fluxo de trabalho específico às configurações de GitHub Pages. No entanto, as configurações de GitHub Pages serão vinculadas à execução de fluxo de trabalho que implantou seu site mais recentemente.

Criar um fluxo de trabalho de GitHub Actions para publicar seu site

Para mais informações sobre GitHub Actions, confira "Documentação do GitHub Actions".

Quando você configurar seu site para ser publicado com GitHub Actions, GitHub Enterprise Server vai sugerir fluxos de trabalho iniciais para cenários de publicação comuns. O fluxo geral de um fluxo de trabalho é:

  1. Dispare sempre que houver um push para o branch padrão do repositório ou sempre que o fluxo de trabalho for executado manualmente na guia “Ações”.
  2. Usar a ação actions/checkout para conferir o conteúdo do repositório.
  3. Se exigido pelo seu site, crie arquivos de site estáticos.
  4. Usar a ação actions/upload-pages-artifact para carregar os arquivos estáticos como um artefato.
  5. Se o fluxo de trabalho foi disparado por um push para o branch padrão, use a ação actions/deploy-pages para implantar o artefato. Essa etapa será ignorada se o fluxo de trabalho tiver sido disparado por uma solicitação de pull.

Os fluxos de trabalho iniciais usam um ambiente de implantação chamado github-pages. Se o repositório ainda não incluir um ambiente chamado github-pages, o ambiente será criado automaticamente. Recomendamos que você adicione uma regra de proteção de ambiente para que apenas o branch padrão possa ser implantado nesse ambiente. Para obter mais informações, confira "Sobre ambientes".

Solucionar problemas da publicação com um fluxo de trabalho personalizado de GitHub Actions

Para obter informações sobre como solucionar problemas do seu fluxo de trabalho de GitHub Actions, confira "Sobre monitoramento e solução de problemas".