NGINX Unit 1.2 Available Now<\/p>\n
On June 7 we released NGINX Unit 1.2<\/span>, the latest version of our dynamic multilingual application and web server, with support for many exciting features that enable its use in more sophisticated environments. This follows the general availability (GA) release of version 1.0<\/a> on April 12 and the release of version 1.1, with bug fixes and minor updates, just a couple weeks later.<\/p>\n NGINX Unit 1.2<\/span> includes these new features:<\/p>\n These new features make your applications even more configurable. All parameters can be defined dynamically, without any disruption to running services or loss of connectivity. <\/p>\n Let’s review the features in more detail.<\/p>\n When any application starts, it can get information about its environment from the operating system. As described in Wikipedia<\/a> (as of June 8, 2018<\/span>), environment variables “are part of the environment in which a process runs. For example, a running process can query the value of the In web applications, environment variables are often used to specify app parameters and credentials for access to services such as databases. (In this post we are not discussing the security of using environment variables for this purpose, and recommend doing your own research on the best ways to pass security credentials to applications.)<\/p>\n Starting in NGINX Unit 1.2<\/a>, you can use the API to dynamically set environment variables for applications.<\/p>\n When you change the list of variables for an application, only the processes for that particular application are restarted, gracefully and without loss of any connections. Other applications running on the same instance of NGINX Unit are not affected.<\/p>\n Following are examples of how to add, change, and delete environment variables. <\/p>\n This configuration defines the variable We tested this configuration with the following minimal Python code, which returns the value of the With a running instance of NGINX Unit, you can use the API to add a variable either adding it to the existing configuration (as in this example) or by uploading an entire new configuration that includes it. This example defines the new environment variable To display all environment variables assigned to an application, access its “ Or you can display just one variable by appending its name to the previous URL:<\/p>\n You can use the When PHP starts up, it reads the system‑level php.ini<\/strong> file, which for an Ubuntu system running PHP 7 is located in the \/etc\/php\/7.0\/embed\/<\/strong> directory by default. By default, all PHP applications read the same configuration file. <\/p>\n There are many configuration options for PHP, which most of our users customize for their particular applications. Examples of these options include memory management, include paths, and temporary file locations. For more information, see the PHP documentation about the php.ini<\/strong> file<\/a> and the core configuration options<\/a>.<\/p>\n Starting in NGINX Unit 1.2<\/span>, you can define the location of php.ini<\/strong> on a per‑application basis, and add specific configuration options directly with the API.<\/p>\n PHP reads php.ini<\/strong> only at startup, so when you change the file, you must restart the application workers for the relevant instances of the PHP application. When you use the NGINX Unit API<\/span> to change configuration options, however, NGINX Unit reloads the PHP application workers automatically, with no dropped connections or effect on the running processes of other applications.<\/p>\n This sample configuration defines \/etc\/my-configs\/php.ini<\/strong> as the configuration file for the application called myphp<\/strong>:<\/p>\n You can use the NGINX Unit API<\/span> to add new configuration options for use by a single application:<\/p>\n Note:<\/strong> The value You can always display the currently defined configuration options:<\/p>\n You can change the value of one option at a time (as in the following example):<\/p>\n You can also change multiple options at the same time by uploading the full “ Go executables are often designed to be configured with a set of command‑line arguments. You can define things like connectivity options, file locations, and database hosts.<\/p>\n Note:<\/strong> We recommend that you do not specify passwords or other sensitive information as command‑line options.<\/p>\n Starting in NGINX Unit 1.2<\/span>, you can define Go command‑line arguments as a JSON array in the configuration.<\/p>\n For example, the command line might look like this for a Go app that is supposed to be executed with arguments to define a temporary file path:<\/p>\n When you start a Go app with NGINX Unit instead of a command, you need to specify such command‑line arguments in an The new features in NGINX Unit 1.2<\/span> make it even easier to configure your applications. You can define all parameters dynamically, without any disruption to running services or loss of connectivity.<\/p>\n The full changelog for Unit development is available in the source code repositories (https:\/\/hg.nginx.org\/unit\/file\/tip\/CHANGES<\/a> and https:\/\/github.com\/nginx\/unit\/blob\/master\/CHANGES<\/a>) and on the Unit documentation website (https:\/\/unit.nginx.org\/CHANGES.txt<\/a>).<\/p>\n Watch our code repository on GitHub and join the discussions and development at https:\/\/github.com\/nginx\/unit<\/a>.<\/p>\n If you wish to become a full\u2011time engineer for NGINX, check our job board<\/a>.<\/p>\n NGINX Plus subscribers get support for NGINX Unit at no additional charge. Download a free 30‑day trial of NGINX Plus<\/a> today! <\/p>\n The post NGINX Unit 1.2 Available Now<\/a> appeared first on NGINX<\/a>.<\/p>\n Source: NGINX Unit 1.2 Available Now<\/a><\/p>\n","protected":false},"excerpt":{"rendered":" NGINX Unit 1.2 Available Now On June 7 we released NGINX Unit 1.2, the latest version of our dynamic multilingual application and web server, with support for many exciting features that enable its use in more sophisticated environments. This follows the general availability (GA) release of version 1.0 on April 12 and the release of version 1.1, with bug fixes and minor updates, just a couple weeks later. NGINX Unit 1.2 includes these new features: All types of applications can now be dynamically configured with their own environment variables. Configuration options for PHP applications can be defined in the php.ini file or directly with the NGINX Unit API. Go executables can now be configured with command‑line arguments. These new features make your applications even more configurable. All parameters can be defined dynamically, without any disruption to running services or loss of connectivity. Let’s review [ more… ]<\/a><\/p>\n<\/div>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[169],"tags":[652],"class_list":["post-24869","post","type-post","status-publish","format-standard","hentry","category-news","tag-nginx"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/posts\/24869","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/comments?post=24869"}],"version-history":[{"count":1,"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/posts\/24869\/revisions"}],"predecessor-version":[{"id":24870,"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/posts\/24869\/revisions\/24870"}],"wp:attachment":[{"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/media?parent=24869"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/categories?post=24869"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jirak.net\/wp\/wp-json\/wp\/v2\/tags?post=24869"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
Managing Environment Variables<\/h2>\n
TEMP<\/code> environment variable to discover a suitable location to store temporary files, or the HOME<\/code> or USERPROFILE<\/code> variable to find the directory structure owned by the user running the process.”<\/p>\nMinimal Configuration<\/h3>\n
VAR1<\/code> for a Python app called myapp<\/strong>. We show only the minimal configuration:<\/p>\n{\r\n \"listeners\": {\r\n \"*:8081\": {\r\n \"application\": \"myapp\"\r\n }\r\n },\r\n\r\n \"applications\": {\r\n \"myapp\": {\r\n \"type\": \"python\",\r\n \"path\": \"\/srv\/demo\/var\",\r\n \"module\": \"wsgi\",\r\n \"environment\": {\r\n \"VAR1\": \"Hello world\"\r\n }\r\n }\r\n }\r\n}<\/code><\/pre>\nVAR1<\/code> environment variable:<\/p>\nimport os\r\n\r\ndef application(environ, start_response):\r\n output = os.environ['VAR1']\r\n start_response('200 OK', [('Content-type', 'text\/html')])\r\n return [output.encode('utf-8')]<\/code><\/pre>\nDefining an Environment Variable at Runtime<\/h3>\n
Darkside<\/code>:<\/p>\n# curl -X PUT -d '\"We have cookies\"' --unix-socket \/run\/control.unit.sock http:\/\/localhost\/config\/applications\/myapp\/environment\/Darkside<\/span>\r\n{\r\n \"success\": \"Reconfiguration done.\"\r\n}<\/code><\/pre>\nDisplaying Environment Variables<\/h3>\n
environment<\/code>” object directly:<\/p>\n# curl --unix-socket \/run\/control.unit.sock http:\/\/localhost\/config\/applications\/myapp\/environment<\/span>\r\n{\r\n \"VAR1\": \"Hello world\",\r\n \"Darkside\": \"We have cookies\"\r\n}<\/code><\/pre>\n# curl --unix-socket .\/control.unit.sock http:\/\/localhost\/config\/applications\/myapp\/environment\/VAR1<\/span>\r\n\"Hello world\"<\/code><\/pre>\nDeleting an Environment Variable<\/h3>\n
DELETE<\/code> method to delete one variable at a time (as in this example) or the entire environment<\/code> object:<\/p>\n# curl -X DELETE --unix-socket \/run\/control.unit.sock http:\/\/localhost\/config\/applications\/myapp\/environment\/Darkside<\/span>\r\n{\r\n \"success\": \"Reconfiguration done.\"\r\n}<\/code><\/pre>\nPHP Configuration and the php.ini File<\/h2>\n
Full Configuration<\/h3>\n
{\r\n \"listeners\": {\r\n \"*:8081\": {\r\n \"application\": \"myphp\"\r\n }\r\n },\r\n\r\n \"applications\": {\r\n \"myphp\": {\r\n \"type\": \"php\",\r\n \"root\": \"\/srv\/demo\/phpini\",\r\n \"index\": \"index.php\",\r\n \"options\": {\r\n \"file\": \"\/etc\/my-configs\/php.ini\"\r\n }\r\n }\r\n }\r\n}<\/code><\/pre>\nDefining PHP Configuration Options at Runtime<\/h3>\n
# curl -X PUT -d '{\"expose_php\": \"0\", \"memory_limit\": \"256M\"}' --unix-socket \/run\/control.unit.sock http:\/\/localhost\/config\/applications\/myphp\/options\/admin<\/span>\r\n{\r\n \"success\": \"Reconfiguration done.\"\r\n}<\/code><\/pre>\n0<\/code> (zero) for the expose_php<\/code> option is enclosed in quotes because PHP configuration options are processed as strings, even when they represent numbers; in JSON, strings must be within quotes.<\/p>\nDisplaying PHP Configuration Options<\/h3>\n
# curl --unix-socket \/run\/control.unit.sock http:\/\/localhost\/config\/applications\/myphp\/options<\/span>\r\n{\r\n \"file\": \"\/etc\/my-configs\/php.ini\",\r\n \"admin\": {\r\n \"expose_php\": \"0\",\r\n \"memory_limit\": \"256M\"\r\n }\r\n}<\/code><\/pre>\nChanging the Value of a PHP Configuration Option<\/h3>\n
# curl -X PUT -d '\"1\"' --unix-socket \/run\/control.unit.sock http:\/\/localhost\/config\/applications\/myphp\/options\/admin\/expose_php<\/span>\r\n{\r\n \"success\": \"Reconfiguration done.\"\r\n}<\/code><\/pre>\noptions<\/code>” object.<\/p>\nGo Command-Line Arguments<\/h2>\n
# \/srv\/demo\/go-apps\/app --tmp-files \/tmp\/go-cache<\/span><\/code><\/pre>\narguments<\/code> array in the configuration, as in this example:<\/p>\n{\r\n \"listeners\": {\r\n \"*:8081\": {\r\n \"application\": \"mygo\"\r\n }\r\n },\r\n\r\n \"applications\": {\r\n \"mygo\": {\r\n \"type\": \"go\",\r\n \"executable\": \"\/srv\/demo\/go-apps\/app\",\r\n \"arguments\": [\"--tmp-files\", \"\/tmp\/go-cache\"]\r\n }\r\n }\r\n}<\/code><\/pre>\nConclusion<\/h2>\n