Blog Name

Middleman deploy via Git from Docker

2021-08-19T04:17:00+00:00

This blog was built with Middleman and deploy to GitHub Pages.

I’m using the middleman-deploy gem to deploy via Git.

Last year I decided to use docker to develop and running this blog and one of the problems I had at that moment it was to make the deploy works from the docker container.

And that’s what this post is about.

I’m using ruby:2.7.1-alpine3.12 as docker base image.

Before I added docker to this project the dependencies were installed locally and since I have Git already setup it was enough to run the middleman deploy command from the root of the project to deploy to GitHub Pages.

It worked because the middleman-deploy gem had access to these two files:

  ~/.gitconfig
  ~/.ssh/id_rsa

But now all the dependencies live inside of the docker container so we need to setup Git inside of the container.

The middleman-deploy gem makes automatics commits in the deploy process and the commits are make with the user that is in the ~/.gitconfig file.

To deploy, the middleman-deploy gem pushes the files generates in the build process to GitHub and it uses the ~/.ssh/id_rsa file to authenticate over SSH.

We need to ensure that the Docker container has access to the two files mentioned above.

We’ll use docker-compose to make easier our setup.

Docker implements secrets to manage sensitive data like our ssh key. Docker can read secrets either from its own database (e.g. secrets made with docker secret create) or from a file.

For the ~/.gitconfig file we’re going to stored it as a volume and for the ~/.ssh/id_rsa file we’ll use secrets.

docker-compose.yml

version: "3.7"

services:
  web:
    build: .
    volumes:
      - .:/usr/src/app
      - ~/.gitconfig:/root/.gitconfig # Include our .gitconfig file into the container

secrets:
  host_ssh_key: # The name to identify the secret
    file: ~/.ssh/id_rsa # The file to create as secret

The location of the mount point within the container is /run/secrets/<secret_name> but we know that the id_rsa file must be inside of the ~/.ssh directory.

So the last step is update the Dockerfile to create the ~/.ssh directory and make a symbolic link for the id_rsa file.

Docker

RUN mkdir ~/.ssh && ln -s /run/secrets/host_ssh_key ~/.ssh/id_rsa

With everything setup we can now deploy to GitHub Pages from a Docker container.

  # Generate the docker image
  docker-compose build

  # Start the web service
  docker-compose up -d

  # Deploy from Docker container
  docker-compose exec web middleman deploy

Dockerfile:

FROM ruby:2.7.1-alpine3.12

RUN apk add --update --no-cache \
  build-base \
  tzdata \
  git \
  openssh \
  yarn

RUN mkdir ~/.ssh && ln -s /run/secrets/host_ssh_key ~/.ssh/id_rsa

WORKDIR ./usr/src/app

COPY Gemfile* ./

RUN bundle install

COPY yarn* ./

RUN yarn install

COPY . .

EXPOSE 4567

CMD ["bundle", "exec", "middleman", "s", "--bind-address", "0.0.0.0"]

docker-compose.yml:

version: "3.7"

services:
  web:
    build: .
    volumes:
      - .:/usr/src/app
      - ~/.gitconfig:/root/.gitconfig
    ports:
      - 4567:4567
    secrets:
      - host_ssh_key

secrets:
  host_ssh_key:
    file: ~/.ssh/id_rsa

Instalar y personalizar tmux

2016-01-11T00:49:00+00:00

Tmux es una terminal multiplexora del sistema BSD. Permite tener diferentes sesiones y cambiar fácilmente entre varios programas en una terminal.

Instalar Tmux

Se usará el manejador de paquetes pacman, este va a depender del sistema que uses.

sudo pacman -S tmux

Una vez terminada la instalación, se procede a iniciar tmux

tmux new -s prueba

La opción -s es para asignarle un nombre a la sesión. Se vera algo así:

Personalizar Tmux

Para ello se hace uso de tmux-powerline, se crea el directorio donde se clonará el proyecto.

mkdir ~/.tmux-powerline && cd ~/.tmux-powerline
git clone https://github.com/erikw/tmux-powerline.git

También se necesita instalar las fuentes que requiere tmux-powerline, se debe clonar el proyecto y ejecutar el archivo install.sh para su instalación se usará el directorio /opt/fonst se puede usar otro directorio.

cd /opt/fonts
git clone https://github.com/powerline/fonts.git
cd fonts && ./install.sh

tmux-powerline viene con varios temas los cuales están bajo el directorio ~/.tmux-powerline/tmux-powerline/themes/

Si también quieres crear tu propio tema, solo tienes que agregarlo bajo ese directorio, por ejemplo yo creé el tema lesm.sh

Ahora solo toca decirle a tmux-powerline que use el tema correcto, eso se hace editando el archivo ~/.tmux-powerline/tmux-powerline/config/defaults.sh

Se edita la línea:

export TMUX_POWERLINE_THEME_DEFAULT="default"

El tema por defecto se llama default hay que cambiarlo por el nuevo tema en este caso lesm.

export TMUX_POWERLINE_THEME_DEFAULT="lesm"

El último paso es crear el archivo de configuración para tmux

vim ~/.tmux.conf

Agregar las siguientes líneas:

# Barra inferior Powerline
set-option -g status on
set-option -g status-interval 2
set-option -g status-utf8 on
set-option -g status-justify 'left'
# set-option -g status-fg colour231
set-option -g status-bg colour31
set-option -g status-right-length 75
set-option -g status-right "#(~/.tmux-powerline/tmux-powerline/powerline.sh right)"
set-option -g status-left-length 30
set -g status-left '#[fg=colour234,bg=colour31] #[fg=colour16,bg=colour254,bold]
Sesión:  Luis-Silva  #[fg=colour254,bg=colour234,nobold] '
set -g window-status-current-format '#[fg=colour234,bg=colour31] #[fg=colour117,bg=colour31] #I
#[fg=colour231,bold] #W#[fg=colour231,bold] #(uptime | cut -f 4-5 -d " " | cut -f 1 -d ",")
hrs#[fg=colour57,bold] «\(¬_¬)/»'

Mi archivo de configuración para tmux

Iniciar tmux

tmux new -s version-personalizada

Ahora tmux se mostrará de la siguiente manera:

Instalar ruby con rvm

2016-01-08T19:12:00+00:00

Ruby Version Manager (RVM) es una herramienta de línea de comandos que permite instalar diferentes versiones de ruby fácilmente.

Antes de empezar a instalar rvm, si se usa zsh se debe modificar el archivo ~/.zshrc de lo contrario mostrará un mensaje de error.

Antes:

export PATH="/usr/local/bin:/usr/bin:/bin:/..."

Después:

export PATH="$PATH:/usr/local/bin:/usr/bin:/..."

Instalar rvm

Para ello se usa curl

curl -sSL https://get.rvm.io | bash -s stable

Al final se verá un mensaje que pide modificar el archivo ~/.bash_profile.

Agregar la línea siguiente al final del archivo. [[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm" # Load RVM into a shell session *as a function*

Quedando así:

#
# ~/.bash_profile
#

[[ -f ~/.bashrc ]] && . ~/.bashrc

[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm" # Load RVM into a shell session *as a function*

Para que la consola actual reconozca el comando rvm, hay que ejecutar la siguiente línea o cerrar la consola y abrir una nueva.

source ~/.bash_profile

Con esto ya esta instalado rvm, se puede verificar ejecutando el comando:

rvm -v

Instalar ruby

Se ejecuta:

source ~/.rvm/scripts/rvm

Instalar ruby usando rvm permite tener diferentes versiones, sin tener conflicto entre ellas.

rvm install ruby-2.2.3

Como usar rvm

Al tener instalado ruby usando rvm, se puede tener una configuración específica por proyecto, por ejemplo:

mkdir proyecto_uno && cd proyecto_uno
echo '2.2.3' > .ruby-version
echo 'proyecto_uno' > .ruby-gemset

Ahora si tiene un proyecto que está con ruby-2.2.2.

rvm install ruby-2.2.2
mkdir proyecto_dos && cd proyecto_dos
echo '2.2.2' > .ruby-version
echo 'proyecto_dos' > .ruby-gemset

Al momento de entrar al directorio del proyecto, se cargará la versión de ruby que está en el archivo .ruby-version y el .ruby-gemset del proyecto, de está manera resulta más fácil llevar el control de los proyectos con diferentes versiones de ruby, al igual que con las gemas, debido a que cada .ruby-gemset es independiente del otro, de manera que cada proyecto tiene sus propias gemas, cuando se trabaja con rails.

Instalar nodejs con nvm

2016-01-08T16:46:00+00:00

Node Version Manager (nvm), permite instalar diferentes versiones de nodejs sin tener conflicto entre ellas.

Instalación de nvm

Con curl se descarga el archivo de instalación y se ejecuta.

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.30.1/install.sh | bash

O con wget

wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.30.1/install.sh | bash

Para que la consola actual reconozca el comando nvm, hay que ejecutar la siguiente línea o cerrar la consola y abrir una nueva.

source ~/.profile

Con esto ya esta instalado nvm, se puede verificar ejecutando el comando:

nvm --version

Instalación de nodejs

Para instalar la versión estable de nodejs.

nvm install stable

Para instalar una versión en específica de nodejs.

nvm install 5.5

El comando nvm list, muesta las versiones de nodejs que están instaladas.

Para cambiar de versión de nodejs.

nvm use 5.3.0

El cambio solo tendrá efecto en la consola activa, para hacerlo permanente se tiene que asignar como la versión por defecto, para ellos se usa la opción default seguido de la versión.

Asignar una versión de nodejs por defecto.

nvm alias default 5.3.0

Instalar y personalizar conky

2016-01-07T22:00:00+00:00

Conky es un monitor del sistema, con el cual se puede monitorear muchas variables, está licenciado bajo GPL y funciona en Linux y BSD.

Instalar Conky

Se usará el manejador de paquetes pacman, este va a depender del sistema que uses.

sudo pacman -S conky

Para iniciar conky solo basta con ejecutar el comando:

conky

La interfaz que muestra no se ve muy amigable :( como se ve en la imagen, la ventaja que se tiene es que conky es muy configurable.

Personalizar Conky

Conky tiene unas variables para poder personalizarlo ampliamente, aquí unos link donde se muestran las variables que se pueden usar.

1.- Variables 2.- Más variables

Actualmente así es como se mira conky en mi computadora.

Solo se necesita crear el archivo y agregar está configuración.

configuración de conky

vim ~/.conkyrc

Puedes personalizar conky a tu manera.

Iniciar conky después de 10 segundos

En esta nueva versión de Chakra Fermi tuve un pequeño problema. Al agregar conky a las aplicaciones iniciadas automáticamente, conky desaparece :( después de pasar la pantalla de login.

Para solucionar esto creé un pequeño script:

script para iniciar conky

Y en lugar de agregar a conky a las aplicaciones iniciadas automáticamente se agrega el script el cual ejecuta a conky después de 10 segundos de haber iniciado el sistema.

El script se puede crear en:

sudo vim /opt/start_conky.sh

O directamente en:

sudo vim /usr/bin/start_conky.sh

Al script se le tiene que dar permisos de ejecución.

sudo chmod +x /opt/start_conky.sh

Reiniciar entorno gráfico Xorg, ctrl + alt + backSpace

2016-01-07T03:00:00+00:00

Activar el “reinicio” del entorno gráfico suele ser bastante útil, ningún sistema es perfecto, así que no podemos dar por hecho que la distro no llegará a colgarse.

Más cuando se lleva varios días sin apagar la computadora, y sabemos que para los usuarios de KDE es un entorno pesado así que para evitar presionar el botón de apagado. Se puede activar el “reinicio” del entorno gráfico (Xorg), con la combinación de teclas.

ctrl + alt + backspace

De está manera terminará la sesión del entorno gráfico y mostrará la ventana del login para volver a iniciar una sesión, esto es mucho más rápido que reiniciar el sistema.

¿Cómo hacerlo?

Se tiene que agregar la opción:

Option "XkbOptions" "terminate:ctrl_alt_bksp"

Al archivo 00-keyboard.conf la siguiente configuración aplica para la distro Chakra Fermi en otras distros el archivo es 10-keyboard.conf de hecho en la versión Chakra Euler venía de esa manera.

El archivo se encuentra dentro del directorio:

/etc/X11/xorg.conf.d

Editamos el archivo agregando la línea previamente mencionada.

sudo vim /etc/X11/xorg.conf.d/00-keyboard.conf

Quedando el archivo de la siguiente manera.

Ahora solo queda reiniciar el sistema para poder ejecutar la siguiente combinación de teclas y ver que funcione.

ctrl + alt + backspace

Aveces también utilizo la combinación de teclas:

ctrl + alt + F3

Para logearme sin entorno gráfico y hacer un reinicio, o matar el proceso por el cual se ha colgado la distro, esta opción es muy útil cuando se sabe que programa causo que el sistema se quedo colgado, ya que aveces se tiene abierto otros programas, documentos etc. Y volver abrir todo es mucho tiempo. :-(

La combinación para regresar al entorno gráfico es:

ctrl + alt + F7

Ya que al hacer

ctrl + alt + backspace

Se perderá todo y se tendrá que volver abrir los archivos o programas en los cuales se esta trabajando.