En esta guía se explica cómo crear y configurar una aplicación Rails con MongoDB, de tal manera que funcione como una JSON API, es decir, puro back end.

Una aplicación de este tipo se da muy bien para después conectarla con un cliente SPA (Single Page Application), digamos en AngularJS o para usarla desde una aplicación móvil (Ionic, ¿alguien?).

Se asume familiaridad con Rails, git y los códigos de estado HTTP.

Preliminares

Commit inicial

Para generar el proyecto y hacer el primer commit:

rails new json_api --skip-active-record
cd json_api
git init
git add .
git ci -m "Commit inicial."

La opción de –skip-active-record desactiva ActiveRecord porque usaremos MongoDB con Mongoid en lugar de una base de datos relacional como PostgreSQL o MySQL.

Configuración inicial

Agrega estas gemas a tu Gemfile:

group :development, :test do
  ...
  # Framework para pruebas
  gem 'minitest-rails'
  # Para generar objetos de prueba
  gem 'fabrication'
  # Para generar datos de prueba
  gem 'faker'
end
 
# Para usar MongoDB a través de Mongoid
gem 'mongoid'
# Para usar respond_with en los controladores
gem 'responders'
# Para usar ActiveModel#has_secure_password
gem 'bcrypt'

Después en la terminal:

bundle
rails g mongoid:config
rails g minitest:install

Con esto se instalan las gemas que hagan falta, después se generan los archivos de configuración para Mongoid y Minitest. No es necesario correr el generador para los responders.

Al ejecutar el generador de Minitest, te va a preguntar si debe sobreescribir el archivo test_helper.rb, contesta sí.

En el archivo config/mongoid.yml, quita el comentario de la línea que aparece a continuación y cambia el valor a false:

# raise_not_found_error: true
raise_not_found_error: false

No queremos que Mongoid levante una excepción toda vez que no encuentre un documento.

Es deseable tener más control sobre cuándo se lanza una excepción, de esta forma, cuando se busca un usuario para autenticación y no existe, en vez de un código de error 404 (Not Found) podemos mandar un 401 (Unauthorized).

Agrega este contenido al archivo config/application.rb:

config.generators do |g|
  # Framework de pruebas estilo BDD
  g.test_framework :minitest, spec: true, fixture: true, fixture_replacement: :fabrication
 
  # Estamos haciendo una API, no queremos assets, helpers, tampoco views
  g.assets false
  g.helper false
  g.template_engine nil
end
 
# Para manejar la presentación de errores 404 y 500 como JSON
config.exceptions_app = self.routes

En el archivo test/test_helper.rb, comenta las siguientes líneas:

# ActiveRecord::Migration.check_pending!
# fixtures :all

No tenemos disponible ActiveRecord, si no se comentan esas líneas al tratar de ejecutar las pruebas se lanzará una excepción.

En el archivo config/initializers/inflections.rb agrega:

ActiveSupport::Inflector.inflections( :en ) do |inflect|
  inflect.acronym 'API'
end

Esto permite que al generar los controladores se utilice API como nombre del módulo contenedor en lugar de Api.

Configuración de rutas y del controlador principal de la aplicación

En el archivo config/routes.rb agrega:

match '/404' => 'application#not_found', via: [:get, :post, :put, :patch, :delete]
match '/500' => 'application#exception', via: [:get, :post, :put, :patch, :delete]

Esto permite personalizar las respuestas de error cuando no se encuentra alguna ruta o cuando se tiene algún error en la aplicación.

Por defecto, en estos casos lo que se devuelve es HTML (y el código de estado HTTP adecuado), pero estamos interesados en siempre entregar JSON al cliente.

En el archivo app/controllers/application_controller.rb cambia :exception por :null_session y agrega:

protect_from_forgery with: :null_session
 
# Estos métodos se llaman desde las rutas
def not_found
  response = http_error( { status: '404', message: 'Not Found' } )
  render json: response, status: :not_found
end
 
def exception
  response = http_error( { status: '500', message: 'Internal Server Error' } )
  render json: response, status: :internal_server_error
end
 
 
private
# Método de utilería
def http_error( error )
  { error: { http: error } }
end

La línea de protect_from_forgery_with indica el tipo de protección que se utilizará como medida de prevención contra un ataque de tipo CSRF.

Cuando es :exception se lanza una excepción ante cualquier petición POST, PUT, PATCH o DELETE si no viene acompañada de un token especial que Rails normalmente inserta en las vistas. Siendo esta una aplicación que va a ser utilizada como API no cuenta con ellas.

De la documentación: ActionController::RequestForgeryProtection::ClassMethods

Turn on request forgery protection. Bear in mind that GET and HEAD requests are not checked.

Con :null_session se indica que no habrá estado del lado del servidor, por tanto, no existe una sesión que mantega el estado de conectado dentro del sistema. La autenticación se logra por medio de un token especial que se enviará desde el cliente en la cabecera de la petición. Más adelante veremos cómo.

Otros errores que sería bueno atrapar

Igual, en el archivo app/controllers/application_controller.rb agrega:

# Para cuando lancemos la excepción de documento no encontrado en MongoDB
rescue_from Mongoid::Errors::DocumentNotFound, with: :document_not_found
# Para cuando el tipo de contenido solicitado no sea application/json
rescue_from ActionController::UnknownFormat, with: :not_acceptable
# Para cuando hagan falta parámetros requeridos en algún modelo
rescue_from ActionController::ParameterMissing, with: :unprocessable_entity
 
def document_not_found
  response = http_error( { status: '404', message: 'Document Not Found' } )
  render json: response, status: :not_found
end
 
def not_acceptable
  response = http_error( { status: '406', message: 'Not Acceptable' } )
  render json: response, status: :not_acceptable
end
 
def unprocessable_entity
  response = http_error( { status: '422', message: 'Unprocessable Entity' } )
  render json: response, status: :unprocessable_entity
end
 
def unauthorized
  response = http_error( { status: '401', message: 'Unauthorized' } )
  render json: response, status: :unauthorized
end

Con la configuración inicial terminada, agrega los cambios al repo:

git add .
git ci -m "Configuración inicial."

Testing

TDD vs BDD

La diferencia entre los dos es el cómo te gusta pensar acerca del modelado de la aplicación.

El TDD utiliza el es (assert, afirma), el BDD usa el debe (must, debe). Básicamente es una cuestión de es vs debe ser.

Probemos primero con un poco de BDD

Genera tu primer controlador

rails g controller API::Users

Ejecuta y observa:

rake test

Edita test/controllers/api/users_controller_test.rb y cambia el test de ejemplo por:

it "#index debe ser exitoso" do
  get :index
  response.status.must_equal 200
end

Ejecuta y observa:

rake test

Edita config/routes.rb para agregar el recurso:

namespace :api do
  resources :users
end

Ejecuta y observa:

rake test

Edita app/controllers/api/users_controller.rb y agrega:

def index
  render json: {}
end

Ejecuta y observa:

rake test

:D

Esta fue una muestra de un proceso muy básico de BDD para un controlador.

Genera tu primer modelo

rails g model User name:string email:string password_digest:string

Ejecuta y observa:

rake test

Abre el archivo test/models/user_test.rb y verás:

require 'test_helper'
 
describe User do
  let( :user ) { User.new }
 
  it "must be valid" do
    user.must_be :valid?
  end
end

Si analizamos un poco la situación y contemplamos nuestro modelo User, veremos que el usuario forzosamente necesita al menos un correo. Así, un usuario recién creado debería ser inválido.

Cambia el único test que existe en ese archivo por este otro:

it 'no debe ser válido' do
  user.wont_be :valid?
end

Ejecuta y observa:

rake test

Abre el archivo app/models/user.rb y agrega:

validates :email, presence: true

Ejecuta y observa:

rake test

:D

Y esta fue una muestra de un proceso muy básico de BDD para un modelo.

A continuación veremos cómo se haría con TDD.

Probemos ahora con un poco de TDD

Para que las pruebas se generen al estilo TDD cambia spec a false:

g.test_framework :minitest, spec: false, fixture: false

Genera tu primer controlador

rails g controller API::Users

Ejecuta y observa:

rake test

Edita test/controllers/api/users_controller_test.rb y cambia el test de ejemplo por:

def test_index_action
  get :index
  assert_response :success
end

Nota: El nombre de los métodos debe comenzar necesariamente con test_ para que sean ejecutados durante el proceso de pruebas.

El método anterior es equivalente a este:

test 'index action' do
  get :index
  assert_response :success
end

Ejecuta y observa:

rake test

Edita config/routes.rb para agregar el recurso:

namespace :api do
  resources :users
end

Ejecuta y observa:

rake test

Edita app/controllers/api/users_controller.rb y agrega:

def index
  render json: {}
end

Ejecuta y observa:

rake test

:D

Esta fue una muestra de un proceso muy básico de TDD para un controlador.

Genera tu primer modelo

rails g model User name:string email:string password_digest:string

Ejecuta y observa:

rake test

Abre el archivo test/models/user_test.rb y verás:

require 'test_helper'
 
class UserTest < ActiveSupport::TestCase
 
  def user
    @user ||= User.new
  end
 
  def test_valid
    assert user.valid?
  end
 
end

Si analizamos un poco la situación y contemplamos nuestro modelo User, veremos que el usuario forzosamente necesita al menos un correo. Así, un usuario recién creado debería ser inválido.

Cambia el único test que existe en ese archivo por este otro:

def test_invalid
  assert_not user.valid?
end

Ejecuta y observa:

rake test

Abre el archivo app/models/user.rb y agrega:

validates :email, presence: true

Ejecuta y observa:

rake test

:D

Y esta fue una muestra de un proceso muy básico de TDD para un modelo.

En lo personal prefiero el BDD, siento que en ese estilo se expresa mejor la intención de lo que quieres programar.

Finalmente

Más adelante publicaré una guía acerca de cómo hacer pruebas de integración y cómo utilizar fabricators de manera efectiva en las pruebas de modelos y controladores.

Espero esta guía te sea útil.

Repositorio en github

lobo-tuerto/rails_json_api

Normalmente para levantar una aplicación Rails en producción, utilizamos este esquema:

  • Ubuntu como el Sistema Operativo de nuestro Servidor.
  • Unicorn como Servidor de Aplicaciones Rails.
  • Nginx como Servidor HTTP corriendo como un Front-End Reverse Proxy
  • Postgres como el manejador de nuestra Base de Datos.

En palabras más sencillas, Unicorn se encargará de interpretar todo nuestro código Ruby, Nginx de servir nuestro HTML, CSS, JS e imágenes y Postgres de leer y almacenar nuestra información. Todo esto vivirá en un servidor Ubuntu en la nube que operaremos desde la consola.

  1. Primero necesitas hacerte de un buen servidor e instalarle Ubuntu Server, recomiendo el servicio que da Linode porque el precio es muy accesible, nunca me ha fallado el servicio, son máquinas muy potentes y te dan control completo de tu servidor para instalar y desinstalar lo que tu quieras.
  2. Una vez que tengas tu servidor, necesitas instalarle Ruby, para ello puedes auxiliarte instalando rbenv con esta guía.
  3. Después instalale Nginx con estos comandos:
    sudo apt-get update
    sudo apt-get install nginx

    Por defecto Ubuntu lo activa, intenta visitar tu servidor desde un navegador, de esta forma:
    http://el_dominio_o_IP_de_tu_servidor

    Deberías ver una página como esta:
    nginx inicial

    Si no la ves, puedes iniciar Nginx manualmente desde tu servidor, los comandos para apagar, iniciar o reiniciar Nginx son lo siguientes:

    sudo service nginx stop
    sudo service nginx start
    sudo service nginx restart

    Para arrancarlo al iniciar Ubuntu ejecuta este comando:

    sudo update-rc.d nginx defaults

    En versiones recientes de Ubuntu te puede decir que ya existía el registro para iniciarlo automáticamente.

  4. Ahora instalaremos Unicorn:
    gem install unicorn

    ¡Así de fácil!

  5. Sube el código de tu aplicación al servidor. Puedes usar github, bitbucket o simplemente subir un zip si no tienes un manejador de versiones, normalmente subo mis aplicaciones Rails a un directorio apps en el home del usuario que vamos a usar para hacer los deploys, de esta forma:
    deployer@miservidor:~$ mkdir apps
    deployer@miservidor:~$ cd apps
    deployer@miservidor:~/apps$ pwd
    /home/deployer/apps/

    Para dejarlo así:

    /home/deployer/apps/mi_aplicacion
  6. Vamos a configurar un poco tu aplicación para producción:
    • Asegurate de agregar unicorn a tu Gemfile:
      gem 'unicorn'
    • Si usas Rails 4, asegurate de tener un valor en el archivo config/secrets.yml para el apartado de production, por ejemplo:
      # Do not keep production secrets in the repository,
      # instead read values from the environment.
      production:
        secret_key_base: b1329441746d18...4b14d78d744650450113242c

      La llave fue cortada a propósito, básate en las que trae tu aplicación para development y test; puedes sólo cambiarle un caracter a esas para que sea distinta la de producción.

    • Asegurate de tener configurada la Base de Datos para producción en tu archivo config/database.yml, utiliza el manejador de Base de Datos que más te agrade, por ejemplo:
      production:
        adapter: sqlite3   
        pool: 5
        timeout: 5000
        database: db/production.sqlite3
      Si en lugar de Sqlite deseas usar Postgres, basate en esta guia para instalarlo y configurarlo.
    • Instala las gemas necesarias para tu aplicación con el comando bundle
      bundle install --deployment --binstubs

      La opción binstubs genera los ejecutables en el directorio de tu aplicación ./bin para las gemas en el bundle, de esta forma cualquier herramienta como unicorn o cron asegura la versión de Ruby a usar y la versión de las gemas a usar.

    • Crea tu Base de Datos, ejecuta las migraciones y corre los seeds para el ambiente de producción:
      rake db:create RAILS_ENV=production
      rake db:migrate RAILS_ENV=production
      rake db:seed RAILS_ENV=production
    • rake db:create es solo necesario ejecutarlo una vez para crear la base de datos

    • Precompila los assets para que se compriman y optimicen:
      rake assets:precompile RAILS_ENV=production

    Nota: Si deseas saber en que manejador de base de datos estás trabajando, entra a la consola con rails c production y escribe la siguiente sentencia:

    ActiveRecord::Base.connection.adapter_name

    En mi caso salio lo siguiente:

     => "PostgreSQL"
    
  7. Ahora vamos a configurar unicorn dentro de tu aplicación, para esto necesitamos crear dos archivos:
    • El primer archivo se ubicará en la ruta config/unicorn_init.sh dentro de tu aplicación, y tendrá el siguiente código:
      #!/bin/sh
      ### BEGIN INIT INFO
      # Provides:          unicorn
      # Required-Start:    $remote_fs $syslog
      # Required-Stop:     $remote_fs $syslog
      # Default-Start:     2 3 4 5
      # Default-Stop:      0 1 6
      # Short-Description: Manage unicorn server
      # Description:       Start, stop, restart unicorn server for a specific application.
      ### END INIT INFO
      set -e
       
      # Feel free to change any of the following variables for your app:
      TIMEOUT=${TIMEOUT-60}
      APP_ROOT=/home/deployer/apps/mi_aplicacion
      PID=$APP_ROOT/tmp/pids/unicorn.pid
      CMD="cd $APP_ROOT; bundle exec unicorn -D -c $APP_ROOT/config/unicorn.rb -E production"
      AS_USER=deployer
      set -u
       
      OLD_PIN="$PID.oldbin"
       
      sig () {
        test -s "$PID" &amp;&amp; kill -$1 `cat $PID`
      }
       
      oldsig () {
        test -s $OLD_PIN &amp;&amp; kill -$1 `cat $OLD_PIN`
      }
       
      run () {
        if [ "$(id -un)" = "$AS_USER" ]; then
          eval $1
        else
          su -c "$1" - $AS_USER
        fi
      }
       
      case "$1" in
      start)
        sig 0 &amp;&amp; echo &gt;&amp;2 "Already running" &amp;&amp; exit 0
        run "$CMD"
        ;;
      stop)
        sig QUIT &amp;&amp; exit 0
        echo &gt;&amp;2 "Not running"
        ;;
      force-stop)
        sig TERM &amp;&amp; exit 0
        echo &gt;&amp;2 "Not running"
        ;;
      restart|reload)
        sig HUP &amp;&amp; echo reloaded OK &amp;&amp; exit 0
        echo &gt;&amp;2 "Couldn't reload, starting '$CMD' instead"
        run "$CMD"
        ;;
      upgrade)
        if sig USR2 &amp;&amp; sleep 2 &amp;&amp; sig 0 &amp;&amp; oldsig QUIT
        then
          n=$TIMEOUT
          while test -s $OLD_PIN &amp;&amp; test $n -ge 0
          do
            printf '.' &amp;&amp; sleep 1 &amp;&amp; n=$(( $n - 1 ))
          done
          echo
       
          if test $n -lt 0 &amp;&amp; test -s $OLD_PIN
          then
            echo &gt;&amp;2 "$OLD_PIN still exists after $TIMEOUT seconds"
            exit 1
          fi
          exit 0
        fi
        echo &gt;&amp;2 "Couldn't upgrade, starting '$CMD' instead"
        run "$CMD"
        ;;
      reopen-logs)
        sig USR1
        ;;
      *)
        echo &gt;&amp;2 "Usage: $0 &lt;start|stop|restart|upgrade|force-stop|reopen-logs&gt;"
        exit 1
        ;;
      esac

      Este archivo se encargará de apagar, encender y reiniciar un proceso de Unicorn para nuestra aplicación, asegúrate de personalizar la ruta que establece el valor de APP_ROOT con la ruta en la cual viva tu aplicación, y de poner tu usuario con el que accedes al servidor en la variable AS_USER.

      Debemos darle permiso de ejecución:

      chmod go+x unicorn_init.sh
    • El siguiente archivo se ubicará en config/unicorn.rb y tendrá la siguiente información:
      root = "/home/deployer/apps/mi_aplicacion"
      working_directory root
      pid "#{root}/tmp/pids/unicorn.pid"
      stderr_path "#{root}/log/unicorn.log"
      stdout_path "#{root}/log/unicorn.log"
       
      listen "/tmp/unicorn.miaplicacion.sock"
      worker_processes 2
      timeout 30

      Este archivo define los parámetros que le daremos a Unicorn como el timeout, el numero de workers, etcétera. También se define la ubicación del socket con el que se comunicará con Nginx. Asegúrate de personalizar el root y el listen según tu ambiente.

    • Crea el directorio pids dentro de la carpeta tmp de tu proyecto, porque lo va a necesitar Unicorn, ubicándote en la carpeta de tu aplicación, ejecuta este comando:
      mkdir tmp/pids

      Para que te cree este directorio:

      /home/deployer/apps/mi_aplicacion/tmp/pids/
    • Ahora vamos a crear un acceso directo del primer archivo que creamos para tener a la mano una ubicación desde donde levantar y apagar todos nuestros unicorns, primero nos movemos al siguiente directorio:
      cd /etc/init.d/

      Y creamos un acceso directo a nuestro archivo (puedes escoger el nombre que gustes para el acceso directo, yo tiendo a ponerles unicorn_elnombredelaapp para que sea fácil recordarlo):

      sudo ln -s /home/deployer/apps/mi_aplicacion/config/unicorn_init.sh unicorn_mi_aplicacion

      ¡Y ahora procedemos a levantar Unicorn!

      sudo /etc/init.d/unicorn_mi_aplicacion start

      Recuerda que puedes apagar y reiniciar Unicorn con los siguientes comandos:

      sudo /etc/init.d/unicorn_mi_aplicacion stop
      sudo /etc/init.d/unicorn_mi_aplicacion restart

      Cada que hagas cambios en tu código, deberás reiniciar Unicorn; si llegas a agregar alguna gema, es posible que restart no sea suficiente, sino que necesites darle stop y después start.

    • Para que se ejecute automáticamente cada que se reinicie el servidor, ejecutamos el siguiente comando:
      sudo update-rc.d /etc/init.d/unicorn_mi_aplicacion defaults
  8. Ahora vamos a realizar la conexión entre Nginx y Unicorn, primero nos movemos a nuestra carpeta de la aplicación:
    ~/apps/mi_aplicacion

    Y creamos el archivo config/nginx.conf con el siguiente contenido:

    upstream miapliacion {
      server unix:/tmp/unicorn.mi_aplicacion.sock fail_timeout=0;
    }
     
    server {
      listen 80;
      server_name www.miaplicacion.com miaplicacion.com;
      root /home/deployer/apps/mi_aplicacion/public;
     
      location ^~ /assets/ {
        gzip_static on;
        expires max;
        add_header Cache-Control public;
      }
     
      try_files $uri/index.html $uri @miaplicacion;
      location @miaplicacion {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_redirect off;
        proxy_pass http://miaplicacion;
      }
     
      error_page 500 502 503 504 /500.html;
      client_max_body_size 4G;
      keepalive_timeout 10;
    }

    Asegúrate de personalizar el valor de upstream, en el server_name poner los dominios o subdominios a los cuales quieres que responda tu aplicación, en root poner la ruta de la carpeta public de tu aplicación, y en el try_files location y proxy_pass escribir lo mismo que pusiste en upstream agregandole una arroba al inicio.

    Para que funcione tu dominio/subdominio debes apuntarlos primero a la IP de tu servidor; esto lo puedes hacer desde antes de hacer esta guía. Esto quiere decir que en este punto de la guía, al visitar tu dominio o subdominio, deberías ver la pantalla inicial de Nginx; sino, quiere decir que no has configurado dichos dominios con tu proveedor, esto se hace desde su panel de administración, por ejemplo en GoDaddy estableces los NameServers de Linode y en tu Linode agregas dichos dominios/subdominios para que al visitarlos desde tu navegador veas tu servidor.

    Muévete al directorio de los sitios disponibles de Nginx:

    cd /etc/nginx/sites-enabled/

    Crea un acceso directo como lo hicimos con unicorn:

    sudo ln -s /home/deployer/apps/mi_aplicacion/config/nginx.conf mi_aplicacion

    ¡Y reinicia Nginx!

    sudo service nginx restart

    ¡Ya deberías ver tu sitio online en ambiente productivo!

    Si te salen errores no olvides revisar los logs de producción en tu carpeta de la aplicación, los logs de unicorn igualmente dentro de tu carpeta, o los logs de nginx si te has equivocado en la configuración.

Recursos

How To Install Nginx On Ubuntu 14.04lts
How To Deploy Rails Apps Using Unicorn And Nginx On CentOS 6.5
How To Deploy with Rbenv

Hace poco tuve la necesidad de comprar un teclado USB para una laptop que tenía algunas teclas que no funcionaban.

Desafortunadamente, ningún mapeo se ajustaba por defecto a los dibujitos que tenía en mi teclado.

entradas

El más cercano era el de español de España, pero tenía los acentos invertidos (la tecla con la tilde normal la ponía invertida y viceversa).

Así que tuve que modificar el mapeo manualmente. Para esto se necesitan abrir los mapeos del español con permiso de administrador. Desde una terminal teclea:

cd /usr/share/X11/xkb/symbols/
sudo gedit es

En mi caso intercambié las entradas:

key <AD11> { [dead_grave, dead_circumflex, bracketleft, dead_abovering ] };
key <AC11> { [dead_acute, dead_diaeresis, braceleft, braceleft ] };

Dejándolas como:

key <AC11> { [dead_grave, dead_circumflex, bracketleft, dead_abovering ] };
key <AD11> { [dead_acute, dead_diaeresis, braceleft, braceleft ] };

Y lo mismo para las teclas que deseen cambiar. Después de guardar, hay que regenerar la configuración:

sudo dpkg-reconfigure xkb-data

Al lanzar la aplicación Entrada de Texto de Ubuntu ya deberían ver los cambios reflejados en el vistazo del teclado que aparece ahí.

Entrada De Texto

teclado

Después de cambiar todo lo necesario, para que los cambios se vieran en el editor de texto que ya tenía abierto, yo tuve que decirle a Ubuntu que cambiará el mapa de caracteres con el atajo Super+Espacio, osea la tecla Windows y el espacio.

Y ya se puede usar la nueva configuración personalizada en todas las aplicaciones.

Ubuntu recién instalado

Para eliminar los resultados de búsqueda en línea en el tablero, busca en Unity: Seguridad y privacidad → Búsqueda y da clic sobre el interruptor de Incluir resultados de búsqueda en línea.

Para activar los espacios de trabajo, busca en Unity: Apariencia → Comportamiento y da clic sobre Activar las áreas de trabajo.

Activa el firewall, teclea en la terminal:

sudo ufw enable

Si quieres conectarte desde otra computadora con SSH, debes abrir el puerto 22 en tu máquina:

sudo ufw allow 22

Busca e instala actualizaciones

Ya sea con la aplicación de Actualización de software o con:

sudo apt-get update
sudo apt-get upgrade

Ten en cuenta que la lista de los paquetes por actualizar en Actualización de software y apt-get upgrade puede variar un poco debido a: Phasing of Stable Release Updates (a veces en Actualización de software dice que está todo al día, pero al ejecutar apt-get upgrade te da una lista de paquetes que si necesitan actualización).

Navegador

Mi navegador preferido para desarrollo web: Google Chrome
Para activar el WebGL a veces es necesario entrar a: chrome://gpu/
Instalar chat de voz y video para gmail: Chat de vídeo y voz de Google
Activar el click to play para Flash: Configuración → Mostrar configuración avanzada… → Privacidad → Configuración de contenido → Complementos → Permitirme elegir cuándo ejecutar contenido de complementos

Plugins

ColorZilla: Advanced Eyedropper, Color Picker, Gradient Generator and other colorful goodies.
Postman – REST Client: Postman helps you be more efficient while working with APIs.
EditThisCookie: EditThisCookie is a cookie manager. You can add, delete, edit, search, protect and block cookies!

Misceláneos

Algunas cosas útiles que he encontrado a través de los años y que siempre termino instalando:

sudo apt-get install alpine testdisk mlock gddrescue transmission \
comix gimp gimp-ufraw gnote inkscape anki fail2ban logwatch chkrootkit \
unrar curl nmap htop mtr-tiny pdftk wkhtmltopdf imagemagick poppler-utils \
pandoc gdal-bin network-manager-openvpn-gnome libgeoip-dev libav-tools python-dev

Configuración básica

Abre una terminal y teclea:

echo "" >> ~/.bashrc
echo "export EDITOR=nano" >> ~/.bashrc

Esto pone a nano como el editor por defecto, en lugar de vi.

Activa TRIM para mejorar el rendimiento de tu disco duro de estado sólido

Si cuentas con un SSD, lo más recomendable es que pongas un trabajo cron a realizar las tareas de mantenimiento que necesita este tipo de disco duro:
Enable TRIM on SSD in Ubuntu for better performance (Using a daily cron job – recommended)

Verifica que el comando fstrim funciona adecuadamente en tu equipo:

sudo fstrim -v /

Si todo sale bien, verás algo como:
/: 2.5 GiB (2688892928 bytes) trimmed

Entonces, teclea en la terminal:

sudo nano /etc/cron.daily/trim

Agrégale este contenido:

#!/bin/sh
LOG=/var/log/trim.log
echo "*** $(date -R) ***" >> $LOG
fstrim -v / >> $LOG

Si tienes otras particiones en el SSD agrégalas al final del script anterior.

No olvides hacer ejecutable el script:

sudo chmod +x /etc/cron.daily/trim

Ubuntu para desarrollo de software

git es mi herramienta predilecta para control de versiones, y la necesito para instalar mi ambiente de trabajo: rbenv, nvm, etc.

Aquí la guía de: Cómo instalar git

Para facilitar los cambios de directorio en la terminal: z

git clone https://github.com/rupa/z ~/z
echo '. ~/z/z.sh' >> ~/.bashrc

Aquí la guía de: Cómo instalar Ruby

Si te interesa el gamedev en Ruby, checa los prerequisitos para Ubuntu aquí: Getting Started on Linux

Y estas las gemas necesarias para darle rienda suelta al hobby:

gem install gosu chipmunk texplay lotu

Este es un mini demo que hice inspirado en el venerable Missile Command:

gem install missile-command-ruby

Instala Node.js con esta guía.
Instala PostgreSQL con esta guía.
Instala RethinkDB con esta guía.
Instala Redis con esta guía.

Instala OpenJDK Java con esta guía u Oracle Java con esta otra.
Las IDEs de JetBrains como IntelliJ (y demás) necesitan que se configure de manera particular el Inotify Watches Limit.

Ubuntu desktop y entretenimiento

Instala calibre.

Drivers de Nvidia

sudo apt-get install nvidia-current

Para ajustar los tonos del monitor de acuerdo a la hora del día

Antes recomendaba f.lux, pero ya no hay repo actualizado y al parecer no funcionaba en algunos equipos. He probado Redshift y jala bastante bien.

sudo apt-get install redshift geoclue-hostip

Durante la noche, teclea en la terminal:

redshift &

Para escuchar música

Un muy buen reproductor de música: Clementine

sudo apt-get install clementine

Para descargar videos de youtube

Instala youtube-dl

Después de instalar git, clona en un directorio, entra a él y después ejecuta:

make clean
make all
sudo make install

Servidor de medios

Instala Plex Media Server.
Guía de instalación.

Para poder conectar algún dispositivo como una Smart TV a tu servidor Plex, debes abrir el puerto 32400 en el firewall. Teclea en la terminal:

sudo ufw allow from 192.168.x.x to any port 32400

Cambia 192.168.x.x por la dirección IP de tu Smart TV.

Si tus videos y películas están en otro disco duro, recuerda darle permisos 755 al directorio /media/$USER:

sudo chmod 755 /media/$USER

De otra forma Plex no podrá leer tus archivos.

Unos artículos atrás había comentado ya, un poco acerca de git y cuan grandioso es. :)

Instalación

Abre una terminal y teclea:

sudo apt-get install git

Listo, ya puedes usar git.

Para probar tu instalación teclea esto:

git --version

En mi caso presenta: git version 2.1.0.

Configuración

Es recomendable ejecutar los siguientes comandos para propósitos de identificación. Estos datos serán utilizados para marcar los commits que realices.

git config --global user.name "Pon aquí tu nombre"
git config --global user.email "pon@aqui.tu.correo"

Para tener texto en color:

git config --global color.ui "auto"

Para habilitar la detección automática del número de hilos a usar al empacar repositorios (bueno para computadoras multi-CPU o multi-núcleo):

git config --global pack.threads "0"

Since Git 2.0, Git defaults to the more conservative ‘simple’ behavior, which only pushes the current branch to the corresponding remote branch that ‘git pull’ uses to update the current branch.

git config --global push.default simple

Aquí algunos alias que tengo dados de alta en mi ~/.gitconfig, ayudan a teclear menos en la terminal:

[alias]
    l = log --oneline --decorate --graph
    co = checkout
    ci = commit
    man = help
    h = help
    a = add
    f = fetch
    d = diff
    dc = diff --cached
    dt = difftool
    dtc = difftool --cached
    ds = diff --stat
    dsc = diff --stat --cached
    s = status --short --branch
    b = branch
 
[credential]
    helper = cache

GitHub Social Code Hosting

Si tienes un proyecto open source y quieres un servicio de hospedaje de código y control de versiones premium sin pagar un centavo, prueba con GitHub.
También cuentan con soporte para proyectos privados en planes.

Tutoriales

Node.js es una plataforma construida sobre el JavaScript runtime de Chrome, útil para crear aplicaciones de red rápidas y escalables.

Se recomienda (por seguridad) no usar npm o node con sudo, nvm sirve bien para este propósito.

Primero, instala los prerequisitos para Ubuntu:

sudo apt-get install python g++ make
sudo apt-get update
sudo apt-get build-dep nodejs

Clona el repositorio y configura tu $SHELL:

git clone https://github.com/creationix/nvm.git ~/.nvm && cd ~/.nvm && git checkout `git describe --abbrev=0 --tags`
echo "source ~/.nvm/nvm.sh" >> ~/.bashrc
exec $SHELL

Revisa las versiones disponibles con:

nvm ls-remote

Instala la versión más reciente de v0.12.x con:

nvm install 0.12

Para tener Node.js disponible cada que abras una terminal, teclea:

echo "nvm use 0.12" >> ~/.bashrc

Prueba que esté todo bien revisando las versiones de node y npm:

node -v #v0.12.2
npm -v #2.7.4

Instala un par de cosas que te serán útiles (Yeoman, Grunt, gulp.js y Bower), no uses sudo, no lo necesitas con nvm:

npm install -g yo grunt-cli bower gulp generator-angular generator-karma strongloop nodemon jspm resume-cli browserify

Ya con Node.js instalado, podemos echarle un ojo al tutorial de AngularJS ¿no? ;)

Para iniciar una nueva aplicación AngularJS con Yeoman, abre una terminal, entra a tu directorio de desarrollo y teclea:

mkdir hola-angular
cd hola-angular
yo angular

El instalador de Yeoman te hará algunas preguntas sobre qué deseas integrar a tu nueva app.

Si usas Ruby, te recomiendo instales el soporte para Sass (con Compass). Y la versión Sass de Bootstrap.

Terminada la instalación, inicializa un repositorio git con:

git init
git add .
git commit -m "Commit inicial"

Para iniciar y ver tu aplicación en el navegador, teclea en la terminal:

grunt serve

Recomiendo el cambio de angular-route por ui-router.

Teclea en la terminal:

bower uninstall angular-route --save
# ui-router y unos extras más que pueden ser útiles ;)
bower install ui-router angular-scroll angular-foundation foundation --save

Deberás modificar el archivo en app/scripts/app.js, ya que ese archivo contiene código que utiliza angular-route. Para que la aplicación siga funcionando debes modificar su contenido para que se vea así:

angular
  .module( 'holaAngularApp', [
    'ngAnimate',
    'ngAria',
    'ngCookies',
    'ngMessages',
    'ngResource',
    'ngSanitize',
    'ngTouch',
    'ui.router',
    'duScroll',
    'mm.foundation'
  ] )
  .config( function($stateProvider, $urlRouterProvider, $logProvider ) {
 
    $logProvider.debugEnabled( true );
    $urlRouterProvider.otherwise( '/' );
 
    $stateProvider
      .state( 'home', {
        url: '/',
        templateUrl: 'views/main.html',
        controller: 'MainCtrl',
        controllerAs: 'main'
      } )
      .state( 'about', {
        url: '/about',
        templateUrl: 'views/about.html',
        controller: 'AboutCtrl',
        controllerAs: 'about'
      } );
  } );

Y en el app/index.html, cambia:

<div ng-view=""></div>

Por:

<div ui-view=""></div>

Con esto tu aplicación ahora estará usando un ruteador mucho más versátil para las vistas.

Si quieres agregar soporte para templates en Jade, recuerda instalar el paquete grunt-contrib-jade:

npm install grunt-contrib-jade --save-dev

TODO: Poner las modificaciones necesarias para el Gruntfile.js.

Referencia

nvm – Node Version Manager

Si tienes sonido en las bocinas de tu laptop pero al conectar el cable HDMI a una televisión no se oye nada, hay varias cosas que puedes probar: ajustar el volumen y verificar que no esté en mute la salida.

Si a pesar de todo sigues sin sonido, espero esto te ayude.

Abre una terminal y teclea:

gksudo gedit /etc/default/grub

Busca esta línea:

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash"

Y cámbiala por esta otra:

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash radeon.audio=1"

Por último:

sudo update-grub

¡Reinicia y listo!

Referencia

Fast video playback with no sound

¿Qué hacer con una Alienware M11x R2 que trae por defecto Windows 7?

Instalarle Ubuntu, por supuesto. Je.
Estos son mis apuntes.

Ubuntu recién instalado

Para comenzar, no me late que aparezcan resultados de Amazon en mi menú de aplicaciones. Esto lo soluciona:

sudo apt-get remove unity-lens-shopping

Activa el firewall:

sudo ufw enable

Buscar e instalar actualizaciones

Ya sea con la aplicación de Actualización de software o con:

sudo apt-get update
sudo apt-get upgrade

Navegador

El mejor navegador en este momento: Google Chrome
Instalar chat de voz y video para gmail: Chat de vídeo y voz de Google
Instalar un color browser útil : Chroma
Instalar un color picker útil : Eye Dropper
Y una app para leer feeds: Feedly

Misceláneos

Algunas cosas útiles que he encontrado a través de los años y que siempre termino instalando:

sudo apt-get install byobu alpine testdisk mlock conky-all gddrescue
sudo apt-get install comix gimp gimp-ufraw gnote calibre inkscape unetbootin
sudo apt-get install denyhosts logwatch chkrootkit unrar curl nmap htop mtr-tiny
sudo apt-get install pdftk wkhtmltopdf imagemagick poppler-utils pandoc

Instala youtube-dl

Clonar en un directorio, entrar a él y después ejecutar:

make cleanall
make all
sudo make install

Configuración básica

Abre una terminal y teclea:

echo "export EDITOR=nano" >> ~/.bashrc

Esto pone a nano como el editor por defecto, en lugar de vi.

Activa TRIM para mejorar el rendimiento de tu disco duro de estado sólido

Si cuentas con un SSD, lo más recomendable es que pongas un trabajo cron a realizar las tareas de mantenimiento que necesita este tipo de disco duro:
Enable TRIM on SSD in Ubuntu for better performance (Using a daily cron job – recommended)

Ubuntu desktop y entretenimiento

La Alienware M11x R2 cuenta con la tecnología Optimus de nVidia y Ubuntu no trae soporte para esta tecnología, por lo tanto es necesario instalar un software que nos ayude a tomar control sobre la tarjeta de video (y de paso que no consuma tanta energía cuando no está siendo usada): Instala Bumblebee

Si tienes algún problema con los drivers y/o la pantalla, es posible que encuentres la solución aquí.

Para ajustar los tonos del monitor de acuerdo a la hora del día

f.lux para una pantalla agradable al trabajar durante la noche.

Para escuchar música

Un reproductor de música decente: Clementine
Puedes descargar la versión más reciente de Clementine para Ubuntu desde el PPA oficial:

sudo add-apt-repository ppa:me-davidsansome/clementine
sudo apt-get update
sudo apt-get install clementine

Ubuntu para desarrollo de software

git es mi herramienta predilecta para control de versiones, y la necesito para poder instalar otras cosas como Ruby y rbenv: Cómo instalar git

Para facilitar los cambios de directorio en la terminal: z

git clone https://github.com/rupa/z ~/z
echo '. ~/z/z.sh' >> ~/.bashrc

Ruby, qué puedo decir, es mi lenguaje favorito en estos momentos, el que me abrió los ojos a la programación funcional, hasta que llegue otro que me permita ser más productivo: Cómo instalar Ruby.

Si te interesa el gamedev en Ruby, checa los prerequisitos para Ubuntu: Getting Started on Linux

Y estas las gemas necesarias para darle rienda suelta al hobby:

gem install gosu chipmunk texplay lotu

Otro ambiente con el que me estoy involucrando últimamente es Node.js, aquí la guía de cómo instalarlo en Ubuntu.

PostgreSQL es una base de datos sólida y robusta: Cómo instalar PostgreSQL

emacs era mi editor de código favorito, aquí la guía para instalarlo: Cómo instalar emacs

Selecciona de aquí la que gustes: Chrome Release Channels

Después de que descargues el .deb, da doble clic sobre él, te aparecerá el Centro de software de Ubuntu, da clic sobre Instalar y listo.

Ubuntu 12.10 y anteriores

Instala dependencias

Abre una terminal y teclea:

sudo apt-get install libxss1 libnss3-1d libgconf2-4

Descarga el navegador

Bájalo de aquí Navegador Chrome, o teclea en una terminal:

Para la versión de 64bit:

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb

Para la versión de 32bit:

wget https://dl.google.com/linux/direct/google-chrome-stable_current_i386.deb

Ahora, sigue con la instalación dándole doble clic al .deb que descargaste o teclea en la terminal:

sudo dpkg -i google-chrome-stable_current_amd64.deb

¡Listo, ya cuentas con Google Chrome en tu máquina! ;)

Error: El paquete es de mala calidad

Si al tratar de instalar Google Chrome en Ubuntu te aparece un diálogo que dice:

El paquete es de mala calidad
 
No se permite la instalación de cualquier paquete que viole los estándares de calidad.
Eso podría causar problemas serios a su equipo. Contacte con la persona u organización
que le proporcionó este archivo de paquete e incluya los detalles a continuación.
 
Detalles:
Lintian check results for /home/victor/Descargas/google-chrome-stable_current_amd64.deb:
E: google-chrome-stable: file-in-etc-not-marked-as-conffile etc/cron.daily/google-chrome

Instálalo con el procedimiento manual descrito arriba, usando sudo dpkg -i …

Referencia

Install Latest Google Chrome in Ubuntu 12.10/12.04/11.10/Linux Mint

Emacs se ha convertido en mi editor de código favorito, aquí presento los pasos necesarios para compilarlo e instalarlo en Ubuntu a partir del código fuente (ya sabes, la versión más reciente aún no se encuentra en los repositorios oficiales). ;)

El procedimiento para hacernos con la versión más reciente de Emacs es descargar el código fuente, descomprimir el archivo, instalar las dependencias necesarias para compilarlo, compilar el código fuente e instalar.

Al momento de editar este artículo, la última versión disponible era la 24.3
Revisa cuál es la más reciente aquí.

Instalación

Abre una terminal, ingresa al directorio en donde se va a descargar el código fuente de Emacs (por ejemplo ~/tmp), luego teclea lo siguiente:

  1. wget http://ftp.gnu.org/pub/gnu/emacs/emacs-24.3.tar.gz
  2. tar -xzvf emacs-24.3.tar.gz
  3. sudo apt-get install xorg-dev libjpeg-dev libpng-dev libgif-dev libtiff-dev autoconf automake libgconf2-dev libgpm-dev libtool libdbus-1-dev libgtk2.0-dev libm17n-dev libncurses-dev libotf-dev librsvg2-dev libXpm-dev texinfo
  4. cd emacs-24.3
  5. ./configure
  6. make

Prueba si se compiló bien:

src/emacs -q

Si no hubo problemas para ejecutarlo, instálalo con:

sudo make install

Listo, para probar tu instalación teclea esto:

emacs &

Cierra la aplicación, cerrando la ventana o con la combinación Control+x+c, que usualmente se denota así:

C-x-c

Un ambiente más amigable: emacs-starter-kit

Primero debemos agregar el repositorio donde se encuentra el starter-kit:

gedit ~/.emacs.d/init.el

Y agrega estas líneas:

  1. ;; Agrega el repositorio de paquetes Marmalade para poder instalar el starter-kit
  2. (require 'package)
  3. (add-to-list 'package-archives
  4.              '("marmalade" . "http://marmalade-repo.org/packages/") t)
  5. (package-initialize)
  6.  
  7. ;; Instala automáticamente paquetes que hagan falta
  8. (when (not package-archive-contents)
  9.   (package-refresh-contents))
  10.  
  11. ;; Agrega los paquetes que desees a esta lista, en mi caso los que ocupo son estos:
  12. (defvar my-packages '(starter-kit ruby-mode ruby-end haml-mode sass-mode scss-mode coffee-mode)
  13.   "A list of packages to ensure are installed at launch.")
  14.  
  15. (dolist (p my-packages)
  16.   (when (not (package-installed-p p))
  17.     (package-install p)))

Inicia Emacs y… ¡Listo, a programar!

Configuración

Para personalizar Emacs, abre una terminal y teclea:

gedit ~/.emacs.d/$USER.el

A continuación presento el contenido del mío:

  1. ; tab width to two spaces
  2. (setq-default indent-tabs-mode nil)
  3. (setq-default tab-width 2)
  4.  
  5. ; move across buffers
  6. ; http://stackoverflow.com/questions/91071/emacs-switch-active-window
  7. (global-set-key (kbd "S-<up>") 'windmove-up)
  8. (global-set-key (kbd "S-<down>") 'windmove-down)
  9. (global-set-key (kbd "S-<right>") 'windmove-right)
  10. (global-set-key (kbd "S-<left>") 'windmove-left)
  11.  
  12. ; resize buffers
  13. ; http://www.emacswiki.org/emacs/WindowResize
  14. (global-set-key (kbd "S-C-<left>") 'shrink-window-horizontally)
  15. (global-set-key (kbd "S-C-<right>") 'enlarge-window-horizontally)
  16. (global-set-key (kbd "S-C-<down>") 'shrink-window)
  17. (global-set-key (kbd "S-C-<up>") 'enlarge-window)
  18.  
  19. ; default theme
  20. (load-theme 'wombat)
  21.  
  22. ; default global mode
  23. ; http://stackoverflow.com/questions/6378831/emacs-globally-enable-whitespace-mode
  24. (global-whitespace-mode 1)
  25. (column-number-mode 1)
  26.  
  27. ; font settings
  28. ;(set-face-attribute 'default nil :height 110)
  29. (if (eq window-system 'x)
  30.   (set-default-font "DejaVu Sans Mono-13"))
  31.  
  32. ; incrementar/decrementar el tamaño de la fuente
  33. (defun sacha/increase-font-size ()
  34.   (interactive)
  35.   (set-face-attribute 'default
  36.                       nil
  37.                       :height
  38.                       (ceiling (* 1.10
  39.                                   (face-attribute 'default :height)))))
  40. (defun sacha/decrease-font-size ()
  41.   (interactive)
  42.   (set-face-attribute 'default
  43.                       nil
  44.                       :height
  45.                       (floor (* 0.9
  46.                                   (face-attribute 'default :height)))))
  47. (global-set-key (kbd "C-+") 'sacha/increase-font-size)
  48. (global-set-key (kbd "C--") 'sacha/decrease-font-size)
  49.  
  50.  
  51. ; Agregar modo CSS para abrir así los archivos .scss
  52. (add-to-list 'auto-mode-alist '("\\.scss$" . scss-mode))
  53.  
  54. ; Agregar modo coffeescript para abrir así los archivos .coffee.erb
  55. (add-to-list 'auto-mode-alist '("\\.coffee.erb$" . coffee-mode))
  56.  
  57. ;; https://github.com/bbatsov/emacs-dev-kit/blob/master/ruby-config.el
  58. ;; Rake files are ruby, too, as are gemspecs, rackup files, and gemfiles.
  59. (add-to-list 'auto-mode-alist '("\\.rake$" . ruby-mode))
  60. (add-to-list 'auto-mode-alist '("Rakefile$" . ruby-mode))
  61. (add-to-list 'auto-mode-alist '("\\.gemspec$" . ruby-mode))
  62. (add-to-list 'auto-mode-alist '("\\.ru$" . ruby-mode))
  63. (add-to-list 'auto-mode-alist '("Gemfile$" . ruby-mode))
  64. (add-to-list 'auto-mode-alist '("Guardfile$" . ruby-mode))
  65. (add-to-list 'auto-mode-alist '("\\.rabl$" . ruby-mode))
  66.  
  67. ;; We never want to edit Rubinius bytecode
  68. (add-to-list 'completion-ignored-extensions ".rbc")
  69.  
  70. ;; Load ruby-end minor mode when ruby-mode is loaded
  71. ;; http://stackoverflow.com/questions/4767557/how-do-i-get-hs-minor-mode-to-load-automatically-on-php-mode-in-emacs
  72. (add-hook 'ruby-mode-hook (lambda () (ruby-end-mode 1)))
  73. ;(add-to-list 'load-path "/home/victor/.emacs.d")
  74. ;(require 'ruby-end)
  75.  
  76. ;transparent emacs!
  77. (defun djcb-opacity-modify (&optional dec)
  78.   "modify the transparency of the emacs frame; if DEC is t,
  79.     decrease the transparency, otherwise increase it in 5%-steps"
  80.   (let* ((alpha-or-nil (frame-parameter nil 'alpha)) ; nil before setting
  81.          (oldalpha (if alpha-or-nil alpha-or-nil 100))
  82.          (newalpha (if dec (- oldalpha 5) (+ oldalpha 5))))
  83.     (when (and (>= newalpha frame-alpha-lower-limit) (<= newalpha 100))
  84.       (modify-frame-parameters nil (list (cons 'alpha newalpha))))))
  85.  
  86. ;; C-8 will increase opacity (== decrease transparency)
  87. ;; C-9 will decrease opacity (== increase transparency
  88. ;; C-0 will returns the state to normal
  89. (global-set-key (kbd "C-8") '(lambda()(interactive)(djcb-opacity-modify)))
  90. (global-set-key (kbd "C-9") '(lambda()(interactive)(djcb-opacity-modify t)))
  91. (global-set-key (kbd "C-0") '(lambda()(interactive)
  92.                                (modify-frame-parameters nil `((alpha . 100)))))

Referencias

Installing Emacs from Source on Ubuntu
Emacs Starter Kit