Inicio>Relacionado con la programación>Otro código fuente
Descargar

Módulo NGINX para marionetas

Este módulo se migró de James Fryman [email protected] a Vox Pupuli.

INSTALACIÓN O ACTUALIZACIÓN

Este módulo gestiona la configuración de NGINX.

Requisitos

  • Marioneta 4.6.1 o posterior. Puppet 3 fue compatible hasta la versión 0.6.0.
  • apt ahora es una dependencia suave. Si su sistema usa apt, necesitará configurar una versión apropiada del módulo apt. Se recomienda la versión 4.4.0 o superior debido al manejo adecuado de apt-transport-https .

Documentación adicional

  • Una guía de inicio rápido para el módulo Puppet de NGINX

Instalar y arrancar una instancia NGINX 

 include nginx

Un proxy inverso simple 

 nginx::resource::server { 'kibana.myhost.com' :
  listen_port => 80,
  proxy       => ' http://localhost:5601 ' ,
}

Un host virtual con contenido estático 

 nginx::resource::server { 'www.puppetlabs.com' :
  www_root => ' /var/www/www.puppetlabs.com ' ,
}

Un ejemplo de proxy más complejo 

 nginx::resource::upstream { 'puppet_rack_app' :
  members => {
    ' localhost:3000 ' => {
      server => ' localhost ' ,
      port   => 3000,
      weight => 1,
    },
    ' localhost:3001 ' => {
      server => ' localhost ' ,
      port   => 3001,
      weight => 1,
    },
    ' localhost:3002 ' => {
      server => ' localhost ' ,
      port   => 3002,
      weight => 2,
      },
  },
}

nginx::resource::server { 'rack.puppetlabs.com' :
  proxy => ' http://puppet_rack_app ' ,
}

Agregar un proxy smtp 

 class { 'nginx' :
  mail => true ,
}

nginx::resource::mailhost { 'domain1.example' :
  auth_http       => ' server2.example/cgi-bin/auth ' ,
  protocol        => ' smtp ' ,
  listen_port     => 587,
  ssl_port        => 465,
  starttls        => ' only ' ,
  xclient         => ' off ' ,
  proxy_protocol  => ' off ' ,
  proxy_smtp_auth => ' off ' ,
  ssl             => true ,
  ssl_cert        => ' /tmp/server.crt ' ,
  ssl_key         => ' /tmp/server.pem ' ,
}

Convierta miembros ascendentes de Array a Hash

El tipo de datos Array para los miembros de nginx::resource::upstream se reemplaza por un Hash. La siguiente configuración ya no es válida: 

 nginx::resource::upstream { 'puppet_rack_app' :
  members => {
    ' localhost:3000 ' ,
    ' localhost:3001 ' ,
    ' localhost:3002 ' ,
  },
}

A partir de ahora la configuración debe quedar así: 

 nginx::resource::upstream { 'puppet_rack_app' :
  members => {
    ' localhost:3000 ' => {
      server => ' localhost ' ,
      port   => 3000,
    },
    ' localhost:3001 ' => {
      server => ' localhost ' ,
      port   => 3001,
    },
    ' localhost:3002 ' => {
      server => ' localhost ' ,
      port   => 3002,
    },
  },
}

configuración SSL

De forma predeterminada, la creación de un recurso de servidor solo creará un servidor HTTP. Para crear también un servidor HTTPS (habilitado para SSL), configure ssl => true en el servidor. Tendrá un servidor HTTP escuchando en listen_port (puerto 80 de forma predeterminada) y un servidor HTTPS escuchando en ssl_port (puerto 443 de forma predeterminada). Ambos servidores tendrán el mismo server_name y una configuración similar.

Para crear solo un servidor HTTPS, configure ssl => true y también configure listen_port con el mismo valor que ssl_port . Establecerlos en el mismo valor deshabilita el servidor HTTP. El servidor resultante escuchará en ssl_port .

Idempotencia con nginx 1.15.0 y posterior

De forma predeterminada, este módulo puede configurar la directiva ssl on obsoleta. La próxima vez que ejecute Puppet, esto se eliminará ya que el hecho nginx_version ahora estará disponible. Para evitar este problema de idempotencia, puede configurar manualmente el parámetro nginx_version de la clase base.

Ubicaciones

Las ubicaciones requieren configuraciones específicas dependiendo de si deben incluirse en los servidores HTTP, HTTPS o ambos.

Servidor solo HTTP (predeterminado)

Si solo tiene un servidor HTTP (es decir, ssl => false en el servidor), asegúrese de no configurar ssl => true en ninguna ubicación que asocie con el servidor.

Servidor HTTP y HTTPS

Si configura ssl => true y también configura listen_port y ssl_port con valores diferentes en el servidor, deberá ser específico con la configuración de ubicación, ya que tendrá un servidor HTTP escuchando en listen_port y un servidor HTTPS escuchando en ssl_port :

  • Para agregar una ubicación solo al servidor HTTP, configure ssl => false en la ubicación (este es el valor predeterminado).
  • Para agregar una ubicación tanto al servidor HTTP como a HTTPS, establezca ssl => true en la ubicación y asegúrese de que ssl_only => false (que es el valor predeterminado para ssl_only ).
  • Para agregar una ubicación solo al servidor HTTPS, configure ssl => true y ssl_only => true en la ubicación.

Servidor solo HTTPS

Si configuró ssl => true y también configuró listen_port y ssl_port en el mismo valor en el servidor, tendrá un único servidor HTTPS escuchando en ssl_port . Para agregar una ubicación a este servidor, configure ssl => true y ssl_only => true en la ubicación.

Soporte Hiera

Definición de recursos nginx en Hiera. 

 nginx::nginx_upstreams :
  ' puppet_rack_app ' :
    ensure : present
    members :
      ' localhost:3000 ' :
        server : ' localhost '
        port : 3000
      ' localhost:3001 ' :
        server : ' localhost '
        port : 3001
      ' localhost:3002 ' :
        server : ' localhost '
        port : 3002
nginx::nginx_servers :
  ' www.puppetlabs.com ' :
    www_root : ' /var/www/www.puppetlabs.com '
  ' rack.puppetlabs.com ' :
    proxy : ' http://puppet_rack_app '
nginx::nginx_locations :
  ' static ' :
    location : ' ~ "^/static/[0-9a-fA-F]{8}/(.*)$" '
    server : www.puppetlabs.com
    www_root : /var/www/html
  ' userContent ' :
    location : /userContent
    server : www.puppetlabs.com
    www_root : /var/www/html
nginx::nginx_mailhosts :
  ' smtp ' :
    auth_http : server2.example/cgi-bin/auth
    protocol : smtp
    listen_port : 587
    ssl_port : 465
    starttls : only

Un proxy UDP de syslog de flujo 

 nginx::stream : true

nginx::nginx_cfg_prepend :
  include :
    - ' /etc/nginx/modules-enabled/*.conf '

nginx::nginx_streamhosts :
  ' syslog ' :
    ensure :                 ' present '
    listen_port :            514
    listen_options :         ' udp '
    proxy :                  ' syslog '
    proxy_read_timeout :     ' 1 '
    proxy_connect_timeout :  ' 1 '
    raw_append :
      - ' error_log off; '

nginx::nginx_upstreams :
  ' syslog ' :
    context : ' stream '
    members :
      ' 10.0.0.1:514 ' :
        server : ' 10.0.0.1 '
        port : 514
      ' 10.0.0.2:514 ' :
        server : ' 10.0.0.2 '
        port : 514
      ' 10.0.0.3:514 ' :
        server : ' 10.0.0.3 '
        port : 514

Nginx con pasajero precompilado

Ejemplo de configuración para Debian y RHEL/CentOS (>6), extrayendo los paquetes Nginx y Passenger del repositorio de Phusion. Consulte notas adicionales en https://github.com/voxpupuli/puppet-nginx/blob/master/docs/quickstart.md 

 class { 'nginx' :
  package_source  => ' passenger ' ,
  http_cfg_append => {
    ' passenger_root ' => ' /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini ' ,
  }
}

Aquí el ejemplo para OpenBSD: 

 class { 'nginx' :
  package_flavor => ' passenger ' ,
  service_flags  => ' -u '
  http_cfg_append => {
    passenger_root          => ' /usr/local/lib/ruby/gems/2.1/gems/passenger-4.0.44 ' ,
    passenger_ruby          =>  ' /usr/local/bin/ruby21 ' ,
    passenger_max_pool_size => ' 15 ' ,
  }
}

passenger de origen del paquete agregará el repositorio de Phusion Passenger a los orígenes de APT. Para cada host virtual debe especificar qué ruby ​​se debe utilizar. 

 nginx::resource::server { 'www.puppetlabs.com' :
  www_root          => ' /var/www/www.puppetlabs.com ' ,
  server_cfg_append => {
    ' passenger_enabled ' => ' on ' ,
    ' passenger_ruby '    => ' /usr/bin/ruby ' ,
  }
}

Titiritero atendido por Nginx y Passenger

Configuración de host virtual para servir a Puppet Master: 

 nginx::resource::server { 'puppet' :
  ensure               => present ,
  server_name          => [ ' puppet ' ],
  listen_port          => 8140,
  ssl                  => true ,
  ssl_cert             => ' /var/lib/puppet/ssl/certs/example.com.pem ' ,
  ssl_key              => ' /var/lib/puppet/ssl/private_keys/example.com.pem ' ,
  ssl_port             => 8140,
  server_cfg_append    => {
    ' passenger_enabled '      => ' on ' ,
    ' passenger_ruby '         => ' /usr/bin/ruby ' ,
    ' ssl_crl '                => ' /var/lib/puppet/ssl/ca/ca_crl.pem ' ,
    ' ssl_client_certificate ' => ' /var/lib/puppet/ssl/certs/ca.pem ' ,
    ' ssl_verify_client '      => ' optional ' ,
    ' ssl_verify_depth '       => 1,
  },
  www_root             => ' /etc/puppet/rack/public ' ,
  use_default_location => false ,
  access_log           => ' /var/log/nginx/puppet_access.log ' ,
  error_log            => ' /var/log/nginx/puppet_error.log ' ,
  passenger_cgi_param  => {
    ' HTTP_X_CLIENT_DN '     => ' $ssl_client_s_dn ' ,
    ' HTTP_X_CLIENT_VERIFY ' => ' $ssl_client_verify ' ,
  },
}

Ejemplo de clase de marionetas que llama a nginx::server con HTTPS FastCGI y redirección de HTTP 

 $full_web_path = ' /var/www '

define web::nginx_ssl_with_redirect (
  $backend_port         = 9000,
  $php                  = true ,
  $proxy                = undef ,
  $www_root             = " ${full_web_path} / ${name} / " ,
  $location_cfg_append  = undef ,
) {
  nginx::resource::server { "${name}.${facts['networking']['domain']}" :
    ensure              => present ,
    www_root            => " ${full_web_path} / ${name} / " ,
    location_cfg_append => {
      ' rewrite ' => ' ^ https://$server_name$request_uri? permanent '
    }‚,
  }

  if ! $www_root {
    $tmp_www_root = undef
  } else {
    $tmp_www_root = $www_root
  }

  nginx::resource::server { "${name}.${facts['networking']['domain']} ${name}" :
    ensure                => present ,
    listen_port           => 443,
    www_root              => $tmp_www_root ,
    proxy                 => $proxy ,
    location_cfg_append   => $location_cfg_append ,
    index_files           => [ ' index.php ' ],
    ssl                   => true ,
    ssl_cert              => ' /path/to/wildcard_mydomain.crt ' ,
    ssl_key               => ' /path/to/wildcard_mydomain.key ' ,
  }


  if $php {
    nginx::resource::location { "${name}_root" :
      ensure          => present ,
      ssl             => true ,
      ssl_only        => true ,
      server           => " ${name} .${facts['networking']['domain']} ${name} " ,
      www_root        => " ${full_web_path} / ${name} / " ,
      location        => ' ~ . php$ ' ,
      index_files     => [ ' index.php ' , ' index.html ' , ' index.htm ' ],
      proxy           => undef ,
      fastcgi         => " 127.0.0.1: ${backend_port} " ,
      fastcgi_script  => undef ,
      location_cfg_append => {
        fastcgi_connect_timeout => ' 3m ' ,
        fastcgi_read_timeout    => ' 3m ' ,
        fastcgi_send_timeout    => ' 3m '
      }
    }
  }
}

Agregar fastcgi_params personalizados 

 nginx::resource::location { "some_root" :
  ensure         => present ,
  location       => ' /some/url ' ,
  fastcgi        => " 127.0.0.1:9000 " ,
  fastcgi_param  => {
    ' APP_ENV ' => ' local ' ,
  },
}

Llamar a la clase web::nginx_ssl_with_redirect 

 web::nginx_ssl_with_redirect { 'sub-domain-name' :
    backend_port => 9001,
  }
Expandir
Información adicional
Aplicaciones relacionadas
Recomendado para ti
Información relacionada Todo