Guía para la configuración de servidor Amazon EC2

Transcripción

1 Guía para la configuración de servidor Amazon EC2 La siguiente es una guía paso a paso para instalar y configurar un servidor Amazon Linux que puede servir aplicaciones Rails 3.1. De partida, asumiendo que se tiene una cuenta en Amazon AWS y ya se ha escogido y cargado una instancia AMI, se deben generar una llave, un certificado y una key-pair para el acceso por ssh, las cuales llamaremos: cert-<código_del_certificado>.pem pk-<código_de_la_llave>.pem (mismo código del certificado) <nombre_keypair>.pem Estos archivos (se generan y descargan desde la consola de AWS) son todo los que necesitamos para poder manejar nuestra cuenta y sus instancias en nuestra máquina local a través de la api ofrecida por Amazon, la cual se puede descargar en un archivo comprimido desde Se debe extraer la carpeta ec2-api-tools (puede cambiar la versión), navegar hasta el directorio bin, y pegar la llave y el certificado, los cuales deben tener permisos del tipo 600. Para ello, ejecutar los siguientes comandos: user$ chmod 600 cert-<código_del_certificado>.pem user$ chmod 600 pk-<código_de_la_llave>.pem Ahora debemos indicarle a bash las rutas de la aplicación para poder utilizarla. Para ello debemos abrir el archivo.bash_profile que se encuentra en home (dependiendo de la distribución de Linux, el archivo podría ser.bach_rc) con permisos de root con el siguiente comando: user$ sudo nano ~/.bash_profile (puede cambiar nano por su editor favorito) Una vez abierto el archivo, agregar las siguientes líneas y guardar: export EC2_HOME=$HOME/path_to/ec2-api-tools #(cambiar path_to y la versión) export PATH=$PATH:$EC2_HOME/bin export EC2_PRIVATE_KEY=pk-<código_de_la_llave>.pem export EC2_CERT=cert-<código_del_certificado>.pem export JAVA_HOME=export JAVA_HOME=/usr/lib/jvm/java-6-openjdk/jre #(poner el path real a la jre) export PATH=~/path_to/ec2-api-tools /bin:$PATH Vale decir que se deben reemplazar las rutas y nombres por los utilizados realmente. Ahora debemos recargar bash para que podamos usar la aplicación: user$ source ~/.bash_profile Listo, ya podemos utilizar el programa ec2-api-tools. Lo primero que debemos hacer es abrir los puertos 80 y 443 para requerimientos http y https. Para ello, revisamos primero los grupos de seguridad y luego les damos los permisos correspondientes. Desde la terminal ejecutamos:

2 user$ ec2-describe-group El comando arrojará una lista de grupos con nombres de la forma sg Para cada uno de estos grupos ejecutamos los siguientes comandos para darles permisos: user$ ec2-authorize sg p 80 user$ ec2-authorize sg p 443 Listo, ya tenemos nuestra instancia preparada y ahora podemos acceder a ella para configurarla. Para entrar por ssh debemos primero dar permisos 600 al archivo <nombre_keypai>.pem y guardarlo en el directorio ~/.ssh, y luego ejecutar el siguiente comando: ssh -i ~/.ssh/<nombre_keypair>.pem ec2-user@ec compute- 1.amazonaws.com Se debe cambiar ec compute-1.amazonaws.com por la dirección de nuestra instancia. Ahora podemos pasar a instalar Apache, SVN, Rails, Ruby, MySQL, Passenger y los demás paquetes necesarios en nuestra instancia. 1) Instalar herramientas de desarrollo (g++, gcc, etc.) user$ yum groupinstall 'Development Tools' user$ sudo yum install -y patch readline readline-devel zlib zlib-devel libyaml-devel libffi-devel openssl-devel 2) Instalar git, curl y rvm. Ejecutar los siguientes comandos para las instalaciones: user$ sudo yum install git user$ sudo yum install curl user$ bash < <(curl -s user$ echo '[[ -s "$HOME/.rvm/scripts/rvm" ]] &&. "$HOME/.rvm/scripts/rvm" # Load RVM function' >> ~/.bash_profile user$ source ~/.bash_profile user$ rvm -v 3) Instalar Ruby user$ rvm pkg install zlib user$ rvm install user$ rvm use default ( chequear con "ruby -v") 4) Actualizar gems e instalar Rails 3.1 user$ gem update system user$ gem install rails --pre #(Instala la versión más reciente, 3.1 en este caso)

3 user$ gem install capistrano bundler 5) Instalar Apache, Passenger y SVN user$ sudo yum install httpd mod_ssl subversion user$ sudo yum install httpd-devel apr-devel apr-util-devel curl-devel user$ gem install passenger user$ passenger-install-apache2-module El último comando iniciará la instalación de Passenger, la cual nos pedirá un par de intervenciones. Cuando finalice, nos indicará que agreguemos ciertas líneas a la configuración de apache. Debemos copiar esas líneas y pegarlas al final del archivo de configuración, el cual abrimos con: user$ sudo nano /etc/httpd/conf/httpd.conf Ahora debemos indicarle a Apache que se ejecute cada vez que se inicie la instancia: user$ sudo chkconfig httpd on Ejecutamos apache para ver que todo está bien: user$ sudo service httpd restart 8) Instalar MySQL user$ sudo yum install mysql mysql-server mysql-libs mysql-devel user$ gem install mysql -- --with-mysql-conf=/usr/bin/mysql with-mysqllib=/usr/lib/mysql user$ sudo chkconfig mysqld on user$ sudo service mysqld restart 9) Instalación local, creación de aplicación Rails y usuarios MySQL concordantes. Instalar MySQL varía bastante dependiendo de la distribución. Los comando del apartado anterior debiesen bastar para cualquier distribución con paquetes RPM (LinuxAmazon/CentOS/Fedora/RedHat), y para otras hay suficientes tutoriales. De cualquier modo, lo que deseamos es tener la configuración local igual a la del servidor. De partida, asumimos que ya se tiene configurada la versión local de Rails y la aplicación ha sido creada. Así, suponemos que se creó la aplicación nombreapp con mysql como motor de bd: user$ rails new nombreapp -d mysql Ahora crearemos el usuario y las bases de datos necesarias. Estos pasos se deben repetir en la versión local y en el servidor. Primero, debemos asignar un contraseña al usuario root: user$ mysqladmin -u root password 'new-password' Luego entramos como root para crear el nuevo usuario, las bases de datos y asignar permisos: -Entrar a mysql como root

4 user$ mysql -u root -p -Crear usuario ec2-user con clave _password_: mysql$ create user identified by '_password_'; -Crear bases de datos test, development y production para la aplicación mysql$ create database nombreapp_test; -Asignar todos los privilegios sobre las bases de datos creadas al usuario ec2-user mysql$ grant all privileges on nombreapp_test.* to 'ec2-user'@'localhost' identified by '_password_'; Recordar seguir estos pasos tanto a nivel local como de servidor para no tener discordancias. Importante: Dado que los Sistemas Operativos de la máquina local y el servidor puede ser distintos, pueden existir ciertas incompatibilidades en la configuración de MySQL. Así, en la máquina local se debe ubicar el archivo my.cnf (su ubicación depende del SO usado) y en cada definición del socket a usar se debe cambiar la ruta que aparece por la siguiente y luego reiniciar el servicio: /var/lib/mysql/mysql.sock (esta es la ruta a usar) user$ sudo service mysql restart Esa es la ruta que existe en el servidor y que se utiliza en archivos de la aplicación Rails que habrá que editar, como se verá en el próxima apartado. 10) Configurar la aplicación Rails local Ya estamos muy cerca de poder hacer deploy de nuestra aplicación en el servidor, pero para ello primero debemos editar todos los archivos de configuración de nuestra app. Nos movemos al directorio de la app y ejecutamos lo siguiente: user$ capify. Este comando generará el archivo deploy.rb ubicado en /config. Abrimos el archivo, borramos todo su contenido y pegamos lo siguiente (se puede ver mejor en set :domain, 'ec compute-1.amazonaws.com' #Cambiar por el nombre del servidor set :application, 'nombre_app' #Cambiar por el nombre real de la app set :user, 'ec2-user' #Este usuario no se debe cambiar set :scm, :subversion set :svn_user, 'usuario_svn' #Cambiar por el real set :svn_password, 'clave_svn' set :applicationdir, "/home/#{user}/www" #Directorio donde se alojará la app en el servidor set :use_sudo, false # Configuración de svn set :repository, " #Cambiar por el real # Servidores

5 server domain, :web, :app, :db, :primary => true #Opciones SSH ssh_options[:keys] = [File.join(ENV["HOME"], ".ssh", "<nombre_keypair>.pem")] #Esto asume que en la máquina local la keypair está en el directorio ~/.ssh ssh_options[:forward_agent] = true # Otras configuraciones default_run_options[:pty] = true # Ignorar errores en consola de Windows set :chmod755, "app config db lib public vendor script script/* public/disp*" set :deploy_to, applicationdir set :deploy_via, :export # Reiniciar servidor Passenger luego de hacer deploy namespace :deploy do task :start do ; end task :stop do ; end task :restart, :roles => :app, :except => { :no_release => true } do run "#{try_sudo} touch #{File.join(current_path,'tmp','restart.txt')}" end end Se deben cambiar todas las opciones por las reales. Ahora, debemos abrir el archivo Gemfile ubicado en el directorio de la app y pegar las siguientes líneas: gem 'mysql2' gem 'execjs' gem 'therubyracer' Ahora ejecutar lo siguiente: user$ bundle install Como mencionamos antes, existen ciertas discordancias en la configuración de MySQL. Para evitar problemas debemos editar el archivo config/database.yml, y bajo los apartados test, development y production, cambiar las líneas user, password y socket por las siguientes: username: ec2-user password: _password_ socket: /var/lib/mysql/mysql.sock 11) Últimos pasos Ahora debemos importar nuestra aplicación al servidor SVN que servirá de repositorio. Debemos ubicarnos en el directorio de la app y ejecutar lo siguiente: user$ svn import. user$ cd.. user$ rm -rf nombre_app user$ svn co

6 Hecho lo anterior, ingresamos al servidor por ssh, creamos un directorio de prueba (mkdir nombre_directorio) en nuestro home, y hacemos un checkout de la aplicación. Al hacerlo se nos preguntará si queremos guardar el certificado del servidor SVN, a lo que contestaremos que sí, para que al hacer deploy nuestro servidor Amazon tenga el permiso para actualizar la aplicación. Ahora, en nuestra máquina local, nos situamos en el directorio de la app y ejecutamos: user$ cap deploy:setup user$ cap deploy Luego, ingresamos por ssh al servidor, vamos al directorio de la app (dado que estamos bajo control de versiones, el directorio será /path_to_app/current) y ejecutamos: user$ bundle install Esto se debe hacer ya que Rails3.1 no es aún estable, lo que genera algunos conflictos con Ruby Luego de ejecutado el comando, debemos ubicar el directorio ruby p290@global y removerlo para que no haya problemas con Rake (nuevamente, problemas de Rails 3.1). En un servidor con Amazon linux, esto se debiera hacer con el comando user$ rm -rf ~/.rvm/gems/ruby p290@global Ahora, en la máquina local, vamos al directorio de la app y ejecutamos user$ cap deploy:migrations Si todo está bien, la ejecución debiera correr sin problema. Nos falta indicarle a Apache dónde está ubicada nuestra app en el servidor (podemos usar un host virtual también si lo deseamos). Para ello abrimos el archivo de configuración user$ sudo nano /etc/httpd/conf/httpd.conf y buscamos la línea que dice: DocumentRoot /var/www/html Debemos cambiar esa ruta por la de nuestra app, por ejemplo: DocumentRoot /home/ec2-user/www/current/public Guardamos el archivo y reiniciamos Apache: user$ sudo service httpd restart Hay que asegurarse que la ruta dada tenga permisos de lectura para cualquier usuario, así que cada directorio en la ruta debe tener como mínimo permisos 711. Además, en la app misma los archivos html debieran tener al menos permisos 644. Hecho todo lo anterior, podemos ver nuestra aplicación desde cualquier browser ingresando la dirección del servidor.