Desplegando tu blog Octopress en GitHub Pages

Jan 24, 2013 · 3 min read
code
octopress

En mi último post vimos cómo crear un blog de páginas estáticas con Octopress, configurarlo, crear posts y páginas y ver los cambios en local. Ya tienes montado tu blog, y ahora tienes que desplegarlo en algún sitio para que el mundo lo vea. Para esto, vamos a usar GitHub Pages, con el que se integra al 100% y encima es completamente gratuito, sin mencionar la fiabilidad del servicio ;)

Configurando GitHub

Lo primero que tienes que hacer es acceder a tu cuenta de GitHub y crear un nuevo repositorio con el siguiente nombre:
    tu_nombre_de_usuario.github.com

La manera que tiene GitHub Pages de funcionar es la siguiente. Usa la master branch como directorio público de tu servidor web sirviendo los ficheros del repositiorio que creaste antes, y donde se encuentran el contenido estático generado. Tienes que trabajar desde la source branch y commitear el contenido generado a la master branch, para que los cambios puedan contemplarse. No te preocupes, hay una instrucción desde tu consola, que se encarga de configurar esto. Entra en ella, y desde el directorio raíz de tu blog ejecuta:

    $ rake setup_github_pages

A continuación deberás introducir otra vez el la url de tu repositorio, pero recuerda introducirla usando el siguiente formato:

    git@github.com:tu_nombre_de_usuario/tu_nombre_de_usuario.github.com.git

Ya tenemos nuestro "hosting" configurado :) Para desplegar los cambios, solo tienes que generar el blog, y desplegarlo:

    $ rake generate
    $ rake deploy

Y en pocos segundos ya puedes ver tu blog accediendo a http://tu_nombre_de_usuario.github.com

Como último detalle, no te olvides commitear los cambios a tu source branch:

$ git add .
$ git commit -am 'Commit inicial'
$ git push origin source

Usando un dominio personalizado

Para terminar de personalizarlo del todo, puedes usar un nombre de dominio personalizado para que apunte a tu nuevo blog. Lo primero que tienes que hacer, es crear un fichero con el nombre CNAME dentro del directorio source con el nombre de tu dominio:
    $ echo 'nombre_de_tu_dominio.com' >> source/CNAME

No te olvides de volver a generar otra vez todo y desplegarlo:

$ rake generate
$ rake deploy
$ git add .
$ git commit -am 'CNAME creado para dominio personalizado'
$ git push origin source

A continuación tienes que crear un registro A en el DNS de tu dominio que apunte a la siguiente dirección IP de GitHub Pages:

207.97.227.245

Y trás las horas que tarde en refrescar el DNS, ya podremos acceder a nuestro blog desde nombre_de_tu_dominio.com, yeah!

Espero no haberme dejado nada importante en el tintero, de todas formas si algo de esto no te funciona, siempre puedes mirar la documentación del propio Octopress y la de GitHub Pages. Happy blogging!