Skip to main content

Esta versão do GitHub Enterprise Server será descontinuada em 2026-08-25. Não há suporte para versões descontinuadas. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos no GitHub Enterprise Server, consulte Overview do processo de atualização. Para obter ajuda com a atualização, entre em contato com o GitHub Enterprise Support.

Implantando seu site automaticamente

Automatize sua implantação de código com GitHub Actions e GitHub Pages publique atualizações em um site dinâmico a cada push para o branch principal.

Sua funcionalidade foi incorporada, então agora você pode compartilhá-la. Neste tutorial, você configurará a implantação automática para que cada envio para main publique seu projeto de software em um site em produção.

Observação

A URL do seu site GitHub Pages depende de qual versão de GitHub você usa.

  • Em GitHub.com, seu site foi publicado em YOUR-USERNAME.github.io/REPOSITORY.
  • Se você usar GitHub com residência de dados no GHE.com, seu site será publicado em pages.SUBDOMAIN.ghe.com/YOUR-USERNAME/REPOSITORY, em que SUBDOMAIN é o subdomínio da sua empresa.
  • Em GitHub Enterprise Server, seu site é publicado em pages.HOSTNAME/YOUR-USERNAME/REPOSITORY, em que HOSTNAME é o nome do host da sua instância GitHub Enterprise Server.

Pré-requisitos

Habilitando o GitHub Pages

Configure GitHub Pages para hospedar seu site e use GitHub Actions para compilá-lo e publicá-lo.

  1. No GitHub, navegue até o repositório stargazers-log.
  2. No nome do repositório, clique em Configurações.
  3. Na barra lateral, na seção "Código e automação", clique em Páginas.
  4. Em "Compilação e implantação", na lista suspensa Origem, selecione GitHub Actions.

Deixe as outras configurações em seus padrões. Em seguida, você criará seu próprio fluxo de trabalho para criar e implantar seu site automaticamente.

Criando um fluxo de trabalho de implantação

Um fluxo de trabalho é um conjunto de etapas automatizadas que GitHub Actions executa para você. Adicione um que cria e implanta seu site sempre que você faz push para main.

  1. No repositório, crie um arquivo chamado .github/workflows/deploy.yml.

    1. Na página principal do repositório stargazers-log acima da lista de arquivos, clique e clique em Criar novo arquivo.
    2. No campo de nome do arquivo, digite .github/workflows/deploy.yml.
  2. Adicione o conteúdo do fluxo de trabalho a seguir.

    YAML
    name: Deploy to GitHub Pages
    
    on:
      push:
        branches:
          - main
    
    permissions:
      contents: read
      pages: write
      id-token: write
    
    jobs:
      deploy:
        runs-on: ubuntu-latest
        environment:
          name: github-pages
          url: ${{ steps.deployment.outputs.page_url }}
        steps:
          - name: Checkout
            uses: actions/checkout@v6
          - name: Setup Pages
            uses: actions/configure-pages@v5
          - name: Upload artifact
            uses: actions/upload-pages-artifact@v2
            with:
              path: '.'
          - name: Deploy to GitHub Pages
            id: deployment
            uses: actions/deploy-pages@v2
    
  3. Confirme o arquivo diretamente no main branch.

Noções básicas sobre o fluxo de trabalho

Cada parte do fluxo de trabalho tem um trabalho a ser feito:

  • on instrui GitHub Actions a executar o fluxo de trabalho a cada push para main.
  • permissions conceda ao fluxo de trabalho o acesso necessário para publicar em GitHub Pages.
  • environment conecta a tarefa ao seu site GitHub Pages e expõe a URL publicada como ${{ steps.deployment.outputs.page_url }}.
  • steps confira seu código, prepare GitHub Pages, carregue seus arquivos como um artefato e implante-os em seu site dinâmico.

Visualizando seu site ao vivo

Depois de confirmar o fluxo de trabalho, GitHub Actions execute-o automaticamente.

  1. No repositório, clique na guia Ações para ver a execução do fluxo de trabalho.
  2. Clique na execução do fluxo de trabalho mais recente para ver um resumo dos detalhes do trabalho.
  3. Quando a execução estiver concluída, abra seu site publicado em https://pages.HOSTNAME/YOUR-USERNAME/stargazers-log/. Substitua YOUR-USERNAME pelo seu nome de usuário e substitua HOSTNAME pelo seu GitHub Enterprise Servernome do host.
    • Por exemplo, se o nome de usuário da sua conta GitHub for octocat, seu site estará em https://pages.HOSTNAME/octocat/stargazers-log/.

De agora em diante, a cada push para main, seu site é reimplantado com suas alterações mais recentes.

O que você criou

Nesta série, você criou um projeto de software completo e praticou o GitHub fluxo de trabalho:

StageO que você aprendeu
Criando seu projeto de softwareRepositórios, arquivos README
Planejando seu trabalhoProblemas, projetos (quadros de projeto)
Conectando-se localmente
GitHub DesktopClonagem
Gravando e armazenando códigoBranches, commits, solicitações de pull, Copilot
Revisão de alteraçõesAnálises de solicitação de pull, Copilot
Implantação automática
GitHub Actions, GitHub Pages

Próximas Etapas 

  • Amplie seu entendimento sobre Git e GitHub. Para obter mais informações, consulte Recursos de aprendizagem do Git e do GitHub.
  • Explore o Bate-papo do Copilot para aprender mais rápido e receber ajuda enquanto programa. Para obter mais informações, consulte Sobre GitHub Copilot Chat na GitHub Enterprise Cloud documentação.
  • Vá mais fundo com a IA e saiba como os agentes podem agir como um parceiro prático de codificação, transformando ideias em pequenas etapas acionáveis, gerando exemplos e tratando trabalho repetitivo. Para obter mais informações, consulte Conceitos para agentes de GitHub Copilot na GitHub Enterprise Cloud documentação.
  • Saiba mais sobre como automatizar seus projetos de software com GitHub Actions fluxos de trabalho. Para obter mais informações, consulte Noções básicas sobre GitHub Actions.
  • Adicione um domínio personalizado ou explore mais maneiras de publicar seu site com GitHub Pages. Para obter mais informações, consulte Introdução ao GitHub Pages.