ghpages
v0.3.0
Esta ação foi descontinuada. Agora há suporte "nativo" para publicação em páginas do GitHub usando uma ação oficial do GitHub do GitHub. É muito melhor do que esta abordagem.
Esta ação simplesmente permite implantar pastas arbitrárias de conteúdo estático do diretório de trabalho do seu fluxo de trabalho ( /github/workspace ) nas páginas do GitHub. Isso funciona fazendo com que sua instância de ação git push a pasta de ativos escolhida ( BUILD_DIR ) para a ramificação gh-pages do seu repositório GitHub para que a ramificação gh-pages seja atendida. Se você estiver executando esta ação dentro de uma organização ou repositório de usuário (chamado username/username.github.io ), ela será implantada no branch master .
Lembre-se de que você também pode precisar ajustar as configurações do seu repositório.
Como esta ação é implantada em ramificações separadas, "somente implantação", você não poderá usá-la se quiser implantar a partir de um subdiretório de repositório, como docs/ . Nesses casos, você realmente não precisa de uma ação do GitHub, porque você mesmo estaria comprometendo os artefatos de construção. Para obter detalhes, consulte a documentação das páginas do GitHub.
Já existem ótimas ações no GitHub para usar geradores de sites estáticos e depois implantar nas páginas do GitHub (para jekyll, jekyll, zola e certamente muitos mais por vir). Esta ação não é isso, embora eu tenha emprestado muito da ação git desses trabalhos.
Esta ação não construirá nada, apenas implantará.
Nenhum.
Nenhum.
A implantação nas páginas do GitHub acontece git push no branch gh-pages (ou master ). Para autorizar isso, a ação do GitHub precisa de um segredo. Por enquanto, de forma um tanto confusa, o GITHUB_TOKEN disponível para cada repositório é suficiente para enviar para gh-pages , mas não é suficiente para acionar a construção de uma página no GitHub, ou mesmo propagar o conteúdo para a rede de distribuição de conteúdo do GitHub.
Portanto, você precisa criar um Personal Access Token (PAT) personalizado , da mesma forma que faria para serviços externos (digamos, Travis). Este token deve ser criado com permissões repo para ser implantado nas páginas do Github. Em seguida, você deve colar esse token na interface do GitHub como um segredo sob o nome GH_PAT (configurações/segredos do repositório) e chamá-lo na ação como abaixo.
Pedi ao GitHub para agilizar esse processo. A discussão está documentada aqui.
Apenas BUILD_DIR , o diretório de construção relativo à raiz do seu repositório. Você também pode passar . se você deseja enviar a raiz do seu repositório.
name : Deployment
" on " :
- push
- pull_request
jobs :
deploy_ghpages :
runs-on : ubuntu-18.04
steps :
- uses : actions/checkout@v1
- run : echo $GITHUB_SHA >> public/index.html
- uses : maxheld83/[email protected]
env :
BUILD_DIR : public/
GH_PAT : ${{ secrets.GH_PAT }}
