Ansible ロール: Nginx

注意: NGINX, Inc. の公式 NGINX Ansible ロール を使用することを検討してください。

RedHat/CentOS、Debian/Ubuntu、Archlinux、FreeBSD または OpenBSD サーバーに Nginx をインストールします。

このロールは、RedHat 系のシステムでは Nginx yum リポジトリから、Debian 系のシステムでは apt から、Archlinux では pacman から、FreeBSD では pkgng から、OpenBSD では pkg_add から最新の Nginx をインストールし、設定します。Nginx をインストールした後、独自の [virtualhost].conf ファイルを /etc/nginx/conf.d/ に追加し、特定のウェブサイトのために使用する場所やオプションを説明する必要があります。

要件

特にありません。

ロール変数

使用可能な変数は以下にリストされており、デフォルト値が示されています（defaults/main.yml を参照）:

nginx_listen_ipv6: true

IPv6 でのリッスンを有効にするかどうか（このロールで管理されるすべての vhost に適用されます）。

nginx_vhosts: []

Nginx の仮想ホスト用の vhost 定義（サーバーブロック）のリスト。各エントリは server_name で名付けられた別の設定ファイルを作成します。空のままにすると、独自の仮想ホスト設定を提供する必要があります。利用可能なサーバーオプションについては、defaults/main.yml のコメント付きの例を参照してください。

nginx_remove_default_vhost: false

Nginx が提供する「デフォルト」仮想ホスト設定を削除するかどうか。これを有効にすると、基本の / URL が独自の仮想ホストに向けられます。

nginx_upstreams: []

Nginx をロードバランサーとして構成する場合、この変数を使用して 1 つ以上のアップストリームセットを定義できます。

nginx_user: "nginx"

Nginx を実行するユーザー。RedHat では nginx、Debian では www-data、FreeBSD および OpenBSD では www がデフォルトです。

nginx_worker_processes: "{{ ansible_processor_vcpus|default(ansible_processor_count) }}"
nginx_worker_connections: "1024"
nginx_multi_accept: "off"

nginx_worker_processes は、マシン上のコア数に設定します。nginx_worker_connections は、プロセスごとの接続数です。

nginx_error_log: "/var/log/nginx/error.log warn"
nginx_access_log: "/var/log/nginx/access.log main buffer=16k flush=2m"

デフォルトのエラーログとアクセスログの設定です。

nginx_keepalive_timeout: "65"
nginx_keepalive_requests: "100"

Nginx の keepalive 設定です。

設定テンプレートの上書き

オプションが公開されていないため、変数でカスタマイズできない場合は、仮想ホスト設定ファイルや nginx.conf ファイルを生成するために使用するテンプレートを上書きできます。

nginx_conf_template: "nginx.conf.j2"
nginx_vhost_template: "vhost.j2"

必要に応じて、vhost ごとにテンプレートを設定することもできます。

依存関係

特にありません。

例 Playbook

- hosts: server
  roles:
    - { role: geerlingguy.nginx }

ライセンス

MIT / BSD

著者情報

このロールは2014年に Jeff Geerling によって作成されました。彼は Ansible for DevOps の著者です。