#20: 🛰 Publicando a nossa aplicação no Github Pages
Para fazer o deploy das suas alterações para o GitHub Pages, nós usaremos o pacote angular-cli-ghpages: https://github.com/angular-schule/angular-cli-ghpages.
Para realizamos esse processo, temos alguns requisitos:
Você precisa ter um usuário no GitHub;
Você precisa criar um repositório para o seu projeto;
Você precisa fazer um commit de todas as alterações do projeto;
Você precisa instalar o angular-cli-ghpages.
Criando um usuário no GitHub
Se você já possui um usuário no GitHub, pode pular esse passo. Para criar um usuário, acesse https://github.com/. Preencha o formulário de cadastro e certifique-se de validar seu endereço de e-mail.
Criar um repositório de seu APP
Depois de fazer o login no GitHub, clique no botão Start a project
, e dê o nome do repositório de ng-girls-todo
ou qualquer outro que desejar.
Dica O GitHub Pages é case sensitive. Nesse caso, é melhor utilizar letras minúsculas para nomear o repositório.
Conectando seu repositório
Faça um commit de todas as suas alterações executando o seguinte comando na pasta do seu projeto:
Execute este comando para conectar seu código ao repositório, certificando-se de substituir o {YOUR_USERNAME} e o {YOUR_REPO} com o seu usuário do GitHub e o nome do repositório:
Fazendo deploy para o GitHub Pages
Primeiro, instale o angular-cli-ghpages:
Então execute o comando:
💡 ./[your-repo-name]
é um placeholder para o nome do seu repositório no GitHub. Sendo assim, caso o seu projeto esteja em https://github.com/myname/ng-girls
, o valor será --base-href="./ng-girls"
. Em outros sistemas operacionais, também pode ser "/ng-girls/".
Seu app estará disponível em https://[your-GH-username].github.io/[repo-name]/
Para mais informações, veja https://github.com/angular-schule/angular-cli-ghpages.
Problemas conhecidos
Tela branca (e erro 404 no DevTools do Browser)
Se o deploy ocorreu com sucesso, mas apareceu uma tela branca no browser, provavelmente foram utilizadas letras maiúsculas no nome do seu repositório. Tente criar um novo, contendo apenas letras minúsculas. Depois, remova a conexão antiga no seu ambiente local:
Crie a conexão com o novo repositório:
Faça um novo build:
Problemas no Windows
Em algumas máquinas (windows) você pode se deparar com um erro como esse:
Tente debugá-lo com angular-cli-ghpages -S
. Você pode obter o seguinte problema:
Nesse caso, execute estes passos:
Crie um Personal Access Token através deste link: https://github.com/settings/tokens
Execute o comando a seguir, informando o token, repositório, username e e-mail:
Last updated