Skip to main content

surge.sh

Esse cara é muito top.

É um site para hospedarmos as documentações estáticas geradas por exemplo pelo docusaurus.

Ele funciona 100% por linha de comando.

Para instalar:

npm i -g surge

Para publicar a sua doc, naturalmente você tem que ter dado o npm run build nela:

npm run build

Aí vem a MÁGICA:

# Ver comandos
surge --help

# Logar ou criar uma conta (é o mesmo comando)
surge login

Basta digitar o seu email e uma senha

# Para publicar

Só digitar apenas surge, então:

surge

# Especificar aonde está o seus arquivos estáticos (.html)
# Exemplo: /home/farnetani/aprendizado/docusaurus/my-doc/build
# Digitar o subdomínio que você deseja, exemplo: farnetani.surge.sh

Mágina feita, basta acessar o site da sua doc online agora: https://farnetani.surge.sh

Supondo que você não queira mais deixar online esse projeto:

surge teardown

Supondo que você atualizou algo, é só repetir o comando:

surge

Caso queira fazer isso de forma a não ter que ficar digitando no modo de prompt:

surge --project build --domain seusubdominio.surge.sh

Dica para automatizar

No meu caso, como estou usando o docusaurus, eu editei o package.json e adicionei um script chamado publicar conforme abaixo:

"publicar": "docusaurus build && surge --project build --domain seusubdominio.surge.sh"

Aí para eu publicar eu só rodo sempre:

npm run publicar

Domínio Próprio

Caso queira utilizar domínio próprio, segue o link abaixo explicando como fazer:

Link: como usar domínio próprio

Passo a Passo

Add a new CNAME record to your domain.
Set the hostnames @ and www to:
na-west1.surge.sh

Caso não aceite por nome, usar o IP = 45.55.110.124

Additionally, setting the hostname * to na-west1.surge.sh will allow you to deploy to custom subdomains on your domain as well.

Para deploy

surge path/to/my-project my-custom-domain.com

Salvando o nosso custom domain

É só criar um arquivo no diretório ROOT do nosso projeto com o nome CNAME e dentro dele jogar o seu domínio.

Link: usando domínio próprio

Simplificando para não ter que ficar digitando o domínio