{"id":22862745,"url":"https://github.com/nedap/puppet-nginx","last_synced_at":"2026-02-26T01:34:08.081Z","repository":{"id":9824385,"uuid":"11810125","full_name":"nedap/puppet-nginx","owner":"nedap","description":"Puppet nginx module","archived":false,"fork":false,"pushed_at":"2022-11-28T10:54:29.000Z","size":27,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-25T04:07:57.801Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nedap.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-08-01T06:53:02.000Z","updated_at":"2023-04-02T06:20:40.000Z","dependencies_parsed_at":"2023-01-11T20:13:21.904Z","dependency_job_id":null,"html_url":"https://github.com/nedap/puppet-nginx","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nedap%2Fpuppet-nginx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nedap%2Fpuppet-nginx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nedap%2Fpuppet-nginx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nedap%2Fpuppet-nginx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nedap","download_url":"https://codeload.github.com/nedap/puppet-nginx/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246443525,"owners_count":20778247,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-13T10:14:41.072Z","updated_at":"2026-02-26T01:34:03.049Z","avatar_url":"https://github.com/nedap.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# nginx\n\nThis is the nginx module.\n\n## Basic usage\n\nThis module manages nginx.\n\nIt should be included on any host that needs nginx.\n\n```puppet\nclass { 'nginx': }\n```\n\n## Configuring a vhost\n\nTo build the basic skeleton of a vhost the ``nginx::vhost`` type can be used.\nIt will generate a nginx configuration file and symlink it after which nginx\nis reloaded.\n\nTo expand on that configuration and include arbitrary configuration this module\ndoes not provide for the ``nginx::vhost::config`` type is provided. The target\nparameter of that module must be the name of the ``nginx::vhost`` resource you\ncreated before.\n\n```puppet\nnginx::vhost { 'site1':\n  server_name =\u003e 'site.example.com',\n}\n\nnginx::vhost::config { 'site1-http-extra-option':\n  target  =\u003e 'site1',\n  order   =\u003e '120',\n  content =\u003e 'Arbitrary configuration you want to add to the generated file',\n}\n```\n\n## Order\nThis module and it's types make heavy use of the native concat type from\nthe Onyxpoint concat module.\n\nIn order to be able to inject configuration in either the generated ``nginx.conf``\nor one of the vhosts order ranges have been set up.\n\n### Order nginx.conf\n\n  * 001: the first line this module generates. If you need something before\n         that, an order of 000.\n  * 010: opens the 'events' configuration block\n  * 011: writes the default events configuration block provided by this module\n  * 012-018: free for your use\n  * 019: closes the 'events' configuration block\n  * 020: opens the 'http' configuration block\n  * 021: writes the default http configuration provided by this module\n  * 022-028: free for your use\n  * 029: closes the 'http' configuration block\n  * 030-099: free for your use\n\n### Order vhost\n\n  * 000: opens the 'upstream' block\n  * 001-098: free for your use\n  * 099: closes the 'upstream' block\n  * 100: opens the 'http' block\n  * 101-198: free for your use\n  * 199: closes the' http' block\n  * 200: opens the 'https' block\n  * 201-298: free for your use\n  * 299: closes the 'https' block\n\n## Dependencies\n\nThis module depends on the following Puppet modules:\n\n  * Puppetlabs stdlib: https://github.com/puppetlabs/puppetlabs-stdlib\n  * Onyxpoint concat: https://github.com/onyxpoint/pupmod-concat\n  * templatelv: https://github.com/duritong/puppet-templatewlv\n\n## Contributing\n\nFeel free to fork, epand upon this module and send pull requests back\nour way.\n\nFor contributions to be accepted we do require the following:\n\n  * Code must pass without warnings through puppet-lint or have a real\n    good reason as why it can't pass that check.\n  * Certain manifests are extensively documented because of how important\n    they are. Should your change touch these manifests you must update the\n    documentation accordingly.\n  * Tests must be added or changed to reflect the new behaviour and must of\n    course pass. Tests can be found in the ``spec/`` directory and are written\n    with the help of rspec-puppet.\n\n## License\n\nCopyright 2012 - 2013, Nedap Steppingstone.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n\n## Support\n\nFile an issue at: https://github.com/nedap/puppet-nginx/issues.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnedap%2Fpuppet-nginx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnedap%2Fpuppet-nginx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnedap%2Fpuppet-nginx/lists"}