/ COMPUTER SCIENCE, JEKYLL / 1 min read

Configurando Jekyll en GitLab Pages

GitLab Pages es un servicio para crear y alojar websites gratis para tus proyectos, donde es posible utilizar generadores de sitios estáticos, como Jekyll, Middleman, Hexo, Hugo, etc. y conectarlo con un dominio.

Para cargar un proyecto Jekyll nuevo o existente con GitLabs Pages vamos a comenzar desde un proyecto Jekyll local:

  • Instalar Jekyll.
  • Usar jekyll new para crear un nuevo Proyecto Jekyll.
  • Agregar el archivo .gitlab-ci.yml a la raíz del proyecto.
  • Push el repositorio con los cambios a GitLab.

GitLab CI

La clave de GitLab Pages es el archivo .gitlab-ci.yml, algo que le otorga un control absoluto sobre el proceso de compilación. Puedes ver la creación del sitio web en vivo siguiendo los rastros del job de CI.

En simple forma el archivo .gitlab-ci.yml se ve así:

image: ruby:2.3

variables:
  JEKYLL_ENV: production

pages:
  script:
  - bundle install
  - bundle exec jekyll build -d public
  artifacts:
    paths:
    - public
  only:
  - master

Recuerda que debes esperar a que el sitio se construya antes de que puedas ver sus cambios. Puedes rastrear la compilación en la pestaña Pipelines.

Visita tu sitio!

Abre el navegador y visita https://username.gitlab.io/projectname o https://username.gitlab.io dependiendo si es una página de proyecto o página de usuario.

eleazar

Eleazar Resendez

A software engineer — for the last 3 years focused on Laravel framework. Reliable, responsible, serious with a strong entrepreneurial can-Do mentality and the goal of making a huge positive impact on this world.

Read More