From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id E2E591582EF for ; Fri, 21 Feb 2025 15:38:00 +0000 (UTC) Received: from lists.gentoo.org (bobolink.gentoo.org [140.211.166.189]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) (Authenticated sender: relay-lists.gentoo.org@gentoo.org) by smtp.gentoo.org (Postfix) with ESMTPSA id CFED7343286 for ; Fri, 21 Feb 2025 15:38:00 +0000 (UTC) Received: from bobolink.gentoo.org (localhost [127.0.0.1]) by bobolink.gentoo.org (Postfix) with ESMTP id 1D059110484; Fri, 21 Feb 2025 15:36:28 +0000 (UTC) Received: from mail-ed1-x529.google.com (mail-ed1-x529.google.com [IPv6:2a00:1450:4864:20::529]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by bobolink.gentoo.org (Postfix) with ESMTPS id 5CAD811047B for ; Fri, 21 Feb 2025 15:36:27 +0000 (UTC) Received: by mail-ed1-x529.google.com with SMTP id 4fb4d7f45d1cf-5ded51d31f1so3867700a12.3 for ; Fri, 21 Feb 2025 07:36:27 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1740152186; x=1740756986; darn=lists.gentoo.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=wr3z6PAvbgo8iXO5/CszyCRahVlZdewFBneahx6D9kM=; b=BthbnsFsKhYXn5H2qPwAhbbfd1Lnz12JABB2CzuO5I8z+2ZiLzzOAIXwduvZ6nCtCx yZg4VfICxjZAILdwQtLgGuFYB5wBj632/93s3nwiie9GFsQx0oV/wwqEkeNXU3GlMhqb izx193vd5jGKKS9x941mkpq+OOV4efouWY13V/dAWo1UDXGx/3Qdg7OS6Hi+AmnVKAj2 pA/MD2YgJQ4X4atR1ebJTn5uxn67Q5j6WEjwFRvC1yll4zgid32AvjKzuRV9nbzbGBdY sOUaYp4Gg6cmxZ0DqXQ/wI+w4mZwIw6j4eYEiPywuLJaW/PjIPJSpSNlGVn9+TNZ0Zr8 twig== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1740152186; x=1740756986; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=wr3z6PAvbgo8iXO5/CszyCRahVlZdewFBneahx6D9kM=; b=oqPSZtvR+J0q8Q348i8jzWnpQeVowFaR4nMJ05Wr3M4l6/btR14nrAa7ghBJv2bv6v CckMg8XAFGcCbsJtpPCdP4f6vME9RnUYZwoBWQ56+98GlytMgOp1aAVbw/tiu3v7SFjE dEmbkSC3OVyW2x3BnE/aHapnXQO3b8FZQk7oQg/64Q0WQ3pMGg1NDC5H1MovAe6iPxbp w+pfeBQA9XoZv5aIsuWoU3P/R4IceIX3O4tiyjEDDHnzr5nIaLE4UOBEY8aKzD3UdZD+ fRY0573tDaQOLoZltcfdxnZLmFrpRqJkzDe3ndNjqpIE4BEQTClwoLgDH6MvZAfF8t3H TlqQ== X-Gm-Message-State: AOJu0Yw6xcRR9GPugjsfFBBB/rInUsVGU0oK6TR43JXSqM9SrUOQAxtN SrT6nGHUD3vL7sOHBTeq6/nL11C/z+Gc+zylm7tEuBkbUHUZxmTAIec0oCzo X-Gm-Gg: ASbGncv8QS8ECAW3u0pPJvdoflUoYKPCgXvAmZbCa1NMh1XJ7yl5MNyEozkeam0POfQ GhtfYouJcARHBCxbchp5BmLXtBFoBjigz6GcYY5/wwUQvW7d9CBFJSbSfwr8gpY4hZZto6tI9Wo XzGYV6cNAUVxjNT9XewG6Pq7OtlK14QxW/a7UPwp3V4wZWyg7DakiPWkgim+azx0u/PDPlaYUBu oSf/s44upIokLaTBFV1s0DtBrSnShUiRBov00wXU5jJkZbgqI+lv+CgwuLutK1+YbOD8QSCu9Us dDPJDETPDEqhsKoOrJfofzfzPzEy2EmJ4xaE+pn33mqi1D9xsqGzmQ1RniHWE04YNwSOVjblzQA = X-Google-Smtp-Source: AGHT+IHCKLyR2nNEI06Erf3lL1JbyhBuXYro2IAtWZ+pqCBVTrSpFea9NVjpwZ/90B8VA0rAHASZvA== X-Received: by 2002:a05:6402:4304:b0:5d0:cfdd:2ac1 with SMTP id 4fb4d7f45d1cf-5e0b70b5ed5mr4035687a12.6.1740152185439; Fri, 21 Feb 2025 07:36:25 -0800 (PST) Received: from localhost.localdomain (92-70-146-242.biz.kpn.net. [92.70.146.242]) by smtp.gmail.com with ESMTPSA id 4fb4d7f45d1cf-5dece28808fsm13709086a12.75.2025.02.21.07.36.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 21 Feb 2025 07:36:24 -0800 (PST) From: Zurab Kvachadze To: gentoo-dev@lists.gentoo.org Cc: pr@gentoo.org, Zurab Kvachadze Subject: [gentoo-dev] [PATCH 1/1] 2025-02-21-NGINX-packaging-changes: Add news item Date: Fri, 21 Feb 2025 16:36:21 +0100 Message-ID: <20250221153621.26266-2-zurabid2016@gmail.com> X-Mailer: git-send-email 2.45.3 In-Reply-To: <20250221153621.26266-1-zurabid2016@gmail.com> References: <20250221153621.26266-1-zurabid2016@gmail.com> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Archives-Salt: 54d58d7f-5984-4406-8bdc-a38052727361 X-Archives-Hash: 55314551d57ffb104417579049277ed0 Signed-off-by: Zurab Kvachadze --- .../2025-02-21-NGINX-packaging-changes.txt | 118 ++++++++++++++++++ 1 file changed, 118 insertions(+) create mode 100644 2025-02-21-NGINX-packaging-changes/2025-02-21-NGINX-packaging-changes.txt diff --git a/2025-02-21-NGINX-packaging-changes/2025-02-21-NGINX-packaging-changes.txt b/2025-02-21-NGINX-packaging-changes/2025-02-21-NGINX-packaging-changes.txt new file mode 100644 index 0000000..8050bda --- /dev/null +++ b/2025-02-21-NGINX-packaging-changes/2025-02-21-NGINX-packaging-changes.txt @@ -0,0 +1,118 @@ +Title: Breaking changes in NGINX packaging in Gentoo +Author: Zurab Kvachadze +Posted: 2025-02-21 +Revision: 1 +News-Item-Format: 2.0 +Display-If-Installed: www-servers/nginx + +NGINX is a web server and a reverse proxy. Following a year-long effort, +its packaging in Gentoo has undergone a major revamp[1]. Starting from +the mainline version %PUT_MAINLINE_NGINX_VERSION_HERE% and the stable +version %PUT_STABLE_NGINX_VERSION_HERE%, the changes will come into +force. If you are reading this NEWS item, the information below is +relevant for you. + +What changed? +==================== + +There are a few user-facing changes with the updated packaging. + +1. Third-party modules. + +Third-party modules, which were previously part of the NGINX package, +www-servers/nginx, are now separate packages in the www-nginx/ category. +The Lua, Brotli, headers-more and upload-progress are examples of the +modules that have been separated. Some of the modules have been removed +completely due to their apparent low usage and needlessness. + +The following is a list of modules that have been removed. If you rely +on any of the modules outlined below, please file a bug on Gentoo +Bugzilla[2][3] asking the module to be added. The recommended summary +for a bug is "www-servers/nginx: please add module MODULE_NAME", where +MODULE_NAME is the name of the module you would like to see added. + +Removed modules: + - ngx_cache_purge/http_cache_purge_module + - nginx_ngx_slowfs_cache/http_slowfs_cache_module + - ngx-fancyindex/http_fancyindex_module + - ngx_http_auth_pam_module/http_authpam_module + - nginx_upstream_check_module/http_upstream_check_module + - ngx_metrics/http_metrics_module + - naxsi/http_naxsi_module + - nginx-rtmp-module/rtmp_module + - nginx-dav-ext-module/http_dav_ext_module + - ModSecurity-nginx/http_security_module + - nginx-push-stream-module/http_push_stream_module + - nginx-sticky-module-ng/http_sticky_module + - nginx-mogilefs-module/http_mogilefs_module + - nginx-auth-ldap/http_auth_ldap_module + - nginx-vod-module/http_vod_module + - ngx_http_geoip2_module/http_geoip2_module + +2. USE flags. + +Some USE flags, like "http-cache", "ktls", "pcre", "pcre-jit" and so on, +have been removed. They did not have any effect or served no purpose, +thus you need not worry about them. + +The "http2", "http3" use flags have been renamed to +nginx_modules_http_v2 and nginx_modules_http_v3 respectively. They +correspond to NGINX_MODULES_HTTP "v2" and "v3" USE_EXPAND flags +accordingly. "ssl" use flag has been changed into individual "ssl" +USE_EXPAND flags for the mail, stream and HTTP servers. + +Thread pool support[4], previously toggled by the "threads" USE flag, is +now enabled unconditionally. Vim syntax files are now provided by the +main www-servers/nginx package. + +3. Default log files. + +Default log filenames are now error.log and access.log, instead of +error_log and access_log. + +User Action Required +==================== + +If you use any third-party modules, install the new separate package. +For instance, if you previously enabled the nginx_modules_http_lua USE +flag on www-servers/nginx, here is how you install the new Lua module +package. + + emerge www-nginx/ngx-lua-module + +To list all the available module packages, use + + emerge --search @www-nginx | less + +If you use the "http2" or "http3" USE flags, enable the corresponding +USE_EXPAND flags. To enable http2 only: + + echo 'www-servers/nginx NGINX_MODULES_HTTP: v2' >> \ + /etc/portage/package.use/nginx.use + +To enable http3: + + echo 'www-servers/nginx NGINX_MODULES_HTTP: v3' >> \ + /etc/portage/package.use/nginx.use + +To enable both http2 and http3: + + echo 'www-servers/nginx NGINX_MODULES_HTTP: v2 v3' >> \ + /etc/portage/package.use/nginx.use + +SSL/TLS modules are enabled by default. If you wish to disable them, use +the following command. + + echo www-servers/nginx NGINX_MODULES_HTTP: -ssl \ + NGINX_MODULES_STREAM: -ssl \ + NGINX_MODULES_MAIL: -ssl >> \ + /etc/portage/package.use/nginx.use + +The updated NGINX comes with a new logrotate file that points to the new +log filenames. If any of your scripts rely on the old log files, change +them accordingly as needed. + +[1]: https://github.com/gentoo/gentoo/pull/37590 +[2]: https://bugs.gentoo.org/ +[3]: https://wiki.gentoo.org/wiki/Bugzilla/Bug_report_guide +[4]: https://nginx.org/en/docs/ngx_core_module.html#thread_pool -- 2.45.3