Beranda>Terkait pemrograman>Kode sumber lainnya
Unduh

Modul NGINX untuk Boneka

Modul ini dimigrasikan dari James Fryman [email protected] ke Vox Pupuli.

MENGINSTAL ATAU MENINGKATKAN

Modul ini mengelola konfigurasi NGINX.

Persyaratan

  • Boneka 4.6.1 atau lebih baru. Boneka 3 didukung hingga rilis 0.6.0.
  • apt sekarang menjadi ketergantungan lunak. Jika sistem Anda menggunakan apt, Anda harus mengonfigurasi versi modul apt yang sesuai. Versi 4.4.0 atau lebih tinggi direkomendasikan karena penanganan apt-transport-https yang tepat.

Dokumentasi Tambahan

  • Panduan Memulai Modul Boneka NGINX

Instal dan bootstrap instance NGINX 

 include nginx

Proksi terbalik sederhana 

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

Host virtual dengan konten statis 

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

Contoh proksi yang lebih kompleks 

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

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

Konversikan anggota upstream dari Array ke Hash

Tipe data Array untuk anggota nginx::resource::upstream digantikan oleh Hash. Konfigurasi berikut tidak berlaku lagi: 

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

Mulai sekarang, konfigurasinya akan terlihat seperti ini: 

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

Konfigurasi SSL

Secara default, membuat sumber daya server hanya akan membuat server HTTP. Untuk juga membuat server HTTPS (berkemampuan SSL), setel ssl => true di server. Anda akan memiliki server HTTP yang mendengarkan di listen_port (port 80 secara default) dan server HTTPS yang mendengarkan di ssl_port (port 443 secara default). Kedua server akan memiliki server_name yang sama dan konfigurasi yang serupa.

Untuk membuat server HTTPS saja, setel ssl => true dan setel juga listen_port ke nilai yang sama dengan ssl_port . Menyetelnya ke nilai yang sama akan menonaktifkan server HTTP. Server yang dihasilkan akan mendengarkan di ssl_port .

Idempotensi dengan nginx 1.15.0 dan yang lebih baru

Secara default, modul ini mungkin mengonfigurasi direktif ssl on yang tidak digunakan lagi. Saat Anda menjalankan boneka berikutnya, ini akan dihapus karena fakta nginx_version sekarang akan tersedia. Untuk menghindari masalah idempotensi ini, Anda dapat mengatur parameter nginx_version kelas dasar secara manual.

Lokasi

Lokasi memerlukan pengaturan khusus bergantung pada apakah lokasi tersebut harus disertakan dalam HTTP, HTTPS, atau kedua server.

Server khusus HTTP (default)

Jika Anda hanya memiliki server HTTP (yaitu ssl => false di server) pastikan Anda tidak menyetel ssl => true di lokasi mana pun yang Anda kaitkan dengan server.

Server HTTP dan HTTPS

Jika Anda menyetel ssl => true dan juga menyetel listen_port dan ssl_port ke nilai yang berbeda di server, Anda harus spesifik dengan pengaturan lokasi karena Anda akan memiliki server HTTP yang mendengarkan di listen_port dan server HTTPS yang mendengarkan di ssl_port :

  • Untuk menambahkan lokasi hanya ke server HTTP, setel ssl => false pada lokasi (ini adalah default).
  • Untuk menambahkan lokasi ke server HTTP dan HTTPS, setel ssl => true pada lokasi, dan pastikan ssl_only => false (yang merupakan nilai default untuk ssl_only ).
  • Untuk menambahkan lokasi hanya ke server HTTPS, atur ssl => true dan ssl_only => true pada lokasi.

Server khusus HTTPS

Jika Anda telah menyetel ssl => true dan juga menyetel listen_port dan ssl_port ke nilai yang sama di server, Anda akan memiliki satu server HTTPS yang mendengarkan di ssl_port . Untuk menambahkan lokasi ke server ini, setel ssl => true dan ssl_only => true pada lokasi tersebut.

Dukungan Hiera

Mendefinisikan sumber daya nginx di 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

Proksi UDP syslog aliran 

 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 dengan Penumpang yang telah dikompilasi sebelumnya

Contoh konfigurasi untuk Debian dan RHEL/CentOS (>6), menarik paket Nginx dan Passenger dari repo Phusion. Lihat catatan tambahan di 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 ' ,
  }
}

Berikut contoh untuk 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 sumber paket akan menambahkan repositori Penumpang Phusion ke sumber APT. Untuk setiap virtual host Anda harus menentukan Ruby mana yang harus digunakan. 

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

Dalang dilayani oleh Nginx dan Passenger

Konfigurasi host virtual untuk melayani dalang: 

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

Contoh pemanggilan kelas boneka nginx::server dengan HTTPS FastCGI dan pengalihan 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 '
      }
    }
  }
}

Tambahkan fastcgi_params khusus 

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

Panggil kelas web::nginx_ssl_with_redirect 

 web::nginx_ssl_with_redirect { 'sub-domain-name' :
    backend_port => 9001,
  }
Memperluas
Informasi Tambahan
Aplikasi Terkait
Direkomendasikan untuk Anda
Informasi Terkait Semua