index.html

<!doctype html>
<html>
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
    
    <title>Tutorial de Chef: infraestructura como código.</title>
    
    <link rel="stylesheet" href="css/reveal.css">
    <link rel="stylesheet" href="css/extra.css">
    <link rel="stylesheet" href="css/theme/sky.css">

    <!-- Theme used for syntax highlighting of code -->
    <link rel="stylesheet" href="lib/css/zenburn.css">
    
    <!-- Printing and PDF exports -->
    <script>
      var link = document.createElement( 'link' );
      link.rel = 'stylesheet';
      link.type = 'text/css';
      link.href = window.location.search.match( /print-pdf/gi ) ? 'css/print/pdf.css' : 'css/print/paper.css';
      document.getElementsByTagName( 'head' )[0].appendChild( link );
    </script>
  </head>
  <body>
    <div class="reveal">
      <div class="slides">

	<div class='footer'><a rel="license"
		 href="http://creativecommons.org/licenses/by-sa/4.0/"><img
		alt="Licencia de Creative Commons" style="border-width:0"
src="https://i.creativecommons.org/l/by-sa/4.0/88x31.png"
/></a><br />This work is under a <a rel="license"
				    href="http://creativecommons.org/licenses/by-sa/4.0/">CC-BY-SA 4.0 license</a>.</div>

	<section><h1>Provisionando con Chef</h1>
	  <h2><code>@jjmerelo</code> para <a href='https://www.meetup.com/es-ES/Granada-Geek/'>Granada Geek</a> + @iv_gii</h2>
	</section>
	
	<section
          data-background='https://farm2.staticflickr.com/1958/44950672935_cf0236ff00_k_d.jpg'><h1>Provisionar
          == amueblar</h1>

        </section>

        <section><h1>1. Provisionar</h1>
          <h1 class='fragment'>2. Comprobar</h1>
        </section>

        <section><h1>Usando <code>chef-run</code></h1>
          <pre><code>chef-run
    -i .vagrant/machines/default/virtualbox/private_key
      vagrant@127.0.0.1:2222 package ruby action=install</code></pre>
          <img src='img/chef-run.png' alt='ejecutando'>

	  <aside class='notes'>chef-run se ha introducido este año, y
	  simplifica el uso de chef porque se puede usar con un solo
	  fichero, y además se pueden ejecutar órdenes directamente
	  desde ahí. Incluye una serie de utilidades, que quedan
	  ocultas al usuario pero que se pueden usar si es necesario
	    desde el <em>nodo</em> o host.</aside>
	</section>

        <section><h1><code>chef-run</code> es</h1>
          <pre><code>chef-run objetivo recurso nombre [otras cosas]</code></pre>
          <pre class='fragment'><code>chef-run localhost package ruby [..]</code></pre>

          <aside class='notes'>Se puede empezar fácilmente a usar chef
          por aquí. Las instrucciones, en <a
            href='https://www.chef.sh/docs/reference/chef-run/'>esta
          página</a>. Lo que va a hacer chef-run es instalar un
          cliente de chef en la máquina objetivo (en este caso,
          definida con Vagrant) y a continuación instalar el paquete
          correspondiente. Pero lo importante es entender el concepto
            de recurso.</aside>
        </section>
        
          <section data-background='https://farm2.staticflickr.com/1906/45698887222_b2d2b11dfe_k_d.jpg'>
          <h1><strong>Recursos</strong> → <em>tareas</em></h1>
          <h2 class='fragment'>Recurso + recurso +... → Receta</h2>

          <aside class='notes'>Los recursos vienen descritos aquí: <a
            href='https://docs.chef.io/resource.html'>About
            resources</a>. Hay como tres o cuatro webs de Chef. Es un lío.</aside>
          </section>

          <section><h2>Recursos →</h2>
            <h3 class='fragment'>Describen el estado deseado</h3>
            <h3 class='fragment'>Y los <strong>pasos</strong> para alcanzarlo</h3>
            <h3 class='fragment'>Y el <strong>tipo</strong></h3>
            <h3 class='fragment'>Y propiedades adicionales</h3>
          </section>

          <section><h1><code>chef-run</code> es</h1>
            <pre><code>chef-run localhost package ruby action=install</code></pre>
            <pre class='fragment'><code>chef-run localhost tipo-recurso recurso pasos</code></pre>
            <aside class='notes'>Así se usan los recursos directamente
              desde la línea de órdenes, y se ilustra como funciona.</aside>
          </section>

          <section
          data-background='https://farm5.staticflickr.com/4855/46148347441_fd7763c791_k_d.jpg'><h1><code>chef-run</code>
            se auto-instala</h1>
            <h2 class='fragment'>Necesita acceso
              <code>sudo</code></h2>
          </section>

          <section><h1>Usando recetas</h1>
            <pre><code>package 'git' do
  action :install
end
            </code></pre>

            <pre class='fragment'><code>chef-run -i path-to/private_key user@host git.rb</code></pre>
            <aside class='notes'>Guardada en
            <code>git.rb</code>. Usando, como anteriormente, un
            recurso y una acción a hacer con el mismo. Instalar esto,
            como en todos los casos, es imprescindible porque si no
            no funcionan los recursos que usen git.</aside>
          </section>

          <section><h1>Una receta</h1>

            <pre><code>git 'microservice' do
  repository 'https://github.com/JJ/microservices-broker'
  user 'vagrant'
  destination '/home/vagrant/microservice'
  action :checkout
end
            </code></pre>
            <aside class='notes'>En este caso se trata de usar un
              recurso llamado <code>git</code>. Hay <a
  href='https://docs.chef.io/resource_reference.html'>una buena
              cantidad de recursos que se pueden usar</a>, así como
              una serie de propiedades comunes y específicas para
              recursos determinados. En este caso, <code>action</code>
  es específica de este recurso en particular; en el resto algunas son
              genéricas como <code>user</code>
            </aside>
          </section>

          <section><h1>Sh*t happens</h1>
            <pre><code>apt_package 'ruby' do
  default_release '2.3'
end
            </code></pre>

            <pre class='fragment'><code>The converge of the remote host failed for the
following reason:

  Expected process to exit with [0], but received '100'
            </code></pre>
            <aside class='notes'>Podemos querer instalar alguna
            versión de Ruby que no sea la estándar. Sin embargo, esto
              se obtiene de los repositorios y puede que no lo
              encuentren. El error obtenido no es óptimo</aside>
          </section>

          <section><h1>Usa los logs, Luke</h1>
            <pre><code> tail   ~/.chef-workstation/logs/default.log</code></pre>
            <pre class='fragment'><code>STDOUT: ruby:
  Installed: 1:2.1.5+deb8u2
  Candidate: 1:2.1.5+deb8u2
  Version table:
 *** 1:2.1.5+deb8u2 0
        500 http://httpredir.debian.org/debian/ jessie/main amd64 Packages
        100 /var/lib/dpkg/status
STDERR: E: The value '2.3' is invalid for APT::Default-Release as such a release is not available in the sources
---- End output of ["apt-cache", "-o", "APT::Default-Release=2.3", "policy", "ruby"] ----
Ran ["apt-cache", "-o", "APT::Default-Release=2.3", "policy", "ruby"] returned 100
            </code></pre>

            <aside class='notes'>La verdad es que podía dar ese error
      desde el principio, pero menos da una piedra. Por lo menos
              averiguamos de dónde se baja las cosas</aside>
          </section>

	  <section><h1>Usuario y directorio</h1>
	    <pre><code>user 'app' do
  comment 'User for app'
  home '/app'
  shell '/bin/bash'
  password '$1$JJsvHslasdfjVEroftprNn4JHtDi'
end

directory '/app' do
  owner 'app'
  group 'app'
  mode '0755'
end
	    </code></pre>

	    <aside class='notes'>Tanto <code>user</code>
	      como <code>directory</code> son dos recursos de Chef. El primero
	    sólo configura el usuario, hace falta el segundo para
	      crear el directorio realmente. La clave está encriptada
	      y se escribe directamente en el fichero /etc/shadow.</aside>
	  </section>

	  <section data-background='https://farm5.staticflickr.com/4906/45245369345_7ca334779c_o_d.jpg'>
	    <h1><strong>Nunca</strong> claves en ficheros.</h1>
	    <aside class='notes'>Pero si es encriptada no pasa
	    nada. Lo mejor es usar <em>data bags</em> para que no haya
	    problemas. </aside>
	  </section>

	  <section><h1>Creando una clave secreta</h1>
	    <pre><code>openssl passwd -1 $MS_PASSWORD</code></pre>
	    <aside class='notes'>Sacado
	      de <a href='https://docs.chef.io/resource_user.html#password-shadow-hash'>aquí</a></aside>
	  </section>

	  <section><h1>Instalando de verdad</h1>
	    <pre><code>package 'git' 
package 'gcc'
package 'make'
package 'sqlite3' do 
  case node[:platform]
  when 'redhat', 'centos', 'fedora'
    package_name 'sqlite-devel'
  when 'ubuntu', 'debian'
    package_name 'libsqlite3-dev'
  end
end
	    </code></pre>
	    <aside class='notes'>Aquí es donde se puede notar que se
	    está usando Ruby como lenguaje base. En este caso lo
	      hacemos para una sentencia <code>case</code>, pero
	      además usamos la variable <code>node</code> que contiene
	      información sobre el host sobre el que se está instalando.</aside>
	  </section>

	  <section><h1>Finalmente, las gemas</h1>
	    <pre><code>chef_gem 'bunny'
chef_gem 'sinatra'
chef_gem 'json'
chef_gem 'httparty'
chef_gem 'sqlite3'
chef_gem 'etcdv3'	    </code></pre>
	    <aside class='notes'><code>chef_gem</code> es la forma que
	    tiene Chef para instalar gemas, y es una alternativa al
	    Gemfile, que en realidad no es fácil de usar desde
	    aquí. Es mejor instalar todo, porque además chef va a
	      comprobar que efectivamente se hayan instalado</aside>
	  </section>

	  <section><h1>Y más cosas</h1>
	    <h1 class='fragment'>Servicios</h1>
	    <h1 class='fragment'>Plantillas</h1>
	    <aside class='notes'>Pero haría este seminario demasiado
	    extenso y/o no he tenido tiempo de preparármelo (pick
	      one).
	    </aside>
	  </section>
	  
	  <section><h1>Usa siempre sistemas de aprovisionamiento.</h1>
	  </section>

	  <section><h1>Infraestructura como código es
	      reproducible</h1>
	    <h2 class='fragment'>Y testeable</h2>
	  </section>

	  <section><h1>Vagrant + Chef == combinación
	      ganadora</h1></section>
	  
      </div>
    </div>

    <script src="lib/js/head.min.js"></script>
    <script src="js/reveal.js"></script>

		<script>
			// More info about config & dependencies:
			// - https://github.com/hakimel/reveal.js#configuration
			// - https://github.com/hakimel/reveal.js#dependencies
			Reveal.initialize({
			width: '95%',
			controls: true,
			progress: true,
			history: true,
				dependencies: [
					{ src: 'plugin/notes/notes.js', async: true },
					{ src: 'plugin/highlight/highlight.js', async: true, callback: function() { hljs.initHighlightingOnLoad(); } }
				]
			});
		</script>
	</body>
</html>