Página Inicial>Relacionado com a programação>Outro código-fonte
Baixar

Módulo NGINX para fantoche

Este módulo foi migrado de James Fryman [email protected] para Vox Pupuli.

INSTALANDO OU ATUALIZANDO

Este módulo gerencia a configuração do NGINX.

Requisitos

  • Fantoche 4.6.1 ou posterior. O Puppet 3 foi suportado até a versão 0.6.0.
  • apt agora é uma dependência suave. Se o seu sistema usa o apt, você precisará configurar uma versão apropriada do módulo apt. A versão 4.4.0 ou superior é recomendada devido ao manuseio adequado de apt-transport-https .

Documentação Adicional

  • Um guia de início rápido para o módulo NGINX Puppet

Instalar e inicializar uma instância NGINX 

 include nginx

Um proxy reverso simples 

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

Um host virtual com conteúdo estático 

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

Um exemplo de proxy mais complexo 

 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 ' ,
}

Adicione um 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 ' ,
}

Converter membros upstream de Array em Hash

O tipo de dados Array para membros de um nginx::resource::upstream é substituído por um Hash. A seguinte configuração não é mais válida: 

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

A partir de agora a configuração deverá ficar assim: 

 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,
    },
  },
}

Configuração SSL

Por padrão, a criação de um recurso de servidor criará apenas um servidor HTTP. Para criar também um servidor HTTPS (habilitado para SSL), defina ssl => true no servidor. Você terá um servidor HTTP escutando em listen_port (porta 80 por padrão) e um servidor HTTPS escutando em ssl_port (porta 443 por padrão). Ambos os servidores terão o mesmo server_name e uma configuração semelhante.

Para criar apenas um servidor HTTPS, defina ssl => true e também defina listen_port com o mesmo valor de ssl_port . Defini-los com o mesmo valor desativa o servidor HTTP. O servidor resultante estará escutando ssl_port .

Idempotência com nginx 1.15.0 e posterior

Por padrão, este módulo pode configurar a diretiva ssl on obsoleta. Na próxima vez que você executar o puppet, ele será removido, pois o fato nginx_version estará disponível agora. Para evitar esse problema de idempotência, você pode definir manualmente o parâmetro nginx_version da classe base.

Locais

Os locais exigem configurações específicas dependendo se devem ser incluídos nos servidores HTTP, HTTPS ou em ambos.

Servidor somente HTTP (padrão)

Se você tiver apenas um servidor HTTP (ou seja, ssl => false no servidor), certifique-se de não definir ssl => true em qualquer local associado ao servidor.

Servidor HTTP e HTTPS

Se você definir ssl => true e também definir listen_port e ssl_port para valores diferentes no servidor, você precisará ser específico com as configurações de localização, pois terá um servidor HTTP escutando em listen_port e um servidor HTTPS escutando em ssl_port :

  • Para adicionar um local apenas ao servidor HTTP, defina ssl => false no local (este é o padrão).
  • Para adicionar um local ao servidor HTTP e HTTPS, defina ssl => true no local e garanta ssl_only => false (que é o valor padrão para ssl_only ).
  • Para adicionar um local apenas ao servidor HTTPS, defina ssl => true e ssl_only => true no local.

Servidor somente HTTPS

Se você configurou ssl => true e também configurou listen_port e ssl_port com o mesmo valor no servidor, você terá um único servidor HTTPS escutando em ssl_port . Para adicionar um local a este servidor, defina ssl => true e ssl_only => true no local.

Suporte Hiera

Definindo recursos nginx no 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

Um proxy UDP de syslog de fluxo 

 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 com passageiro pré-compilado

Exemplo de configuração para Debian e RHEL/CentOS (>6), extraindo os pacotes Nginx e Passenger do repositório Phusion. Veja notas adicionais em 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 ' ,
  }
}

Aqui está o exemplo 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 fonte do pacote adicionará o repositório Phusion Passenger às fontes APT. Para cada host virtual você deve especificar qual Ruby deve ser usado. 

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

Mestre de marionetes servido por Nginx e Passenger

Configuração do host virtual para servir o 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 ' ,
  },
}

Exemplo de classe fantoche chamando nginx::server com HTTPS FastCGI e redirecionamento 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 '
      }
    }
  }
}

Adicionar fastcgi_params personalizados 

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

Chame a classe web::nginx_ssl_with_redirect 

 web::nginx_ssl_with_redirect { 'sub-domain-name' :
    backend_port => 9001,
  }
Expandir
Informações adicionais
Aplicativos Relacionados
Recomendado para você
Informações Relacionadas Todos