Mercurial > hg > nginx-site

changeset 2755:6eff5d63925b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Linux packages: updated Debian and Ubuntu to best practices. While at it, added paragraphs to properly split logical sections.
author Konstantin Pavlov <thresh@nginx.com>
date Wed, 11 Aug 2021 13:35:03 +0300
parents 3975b5ffd38e
children 7898e090ad72
files xml/en/linux_packages.xml xml/ru/linux_packages.xml
diffstat 2 files changed, 147 insertions(+), 112 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/linux_packages.xml	Tue Aug 03 12:54:38 2021 +0300
+++ b/xml/en/linux_packages.xml	Wed Aug 11 13:35:03 2021 +0300
@@ -7,7 +7,7 @@
 <article name="nginx: Linux packages"
          link="/en/linux_packages.html"
          lang="en"
-         rev="64">
+         rev="65">
 
 <section name="Supported distributions and versions" id="distributions">
 
@@ -201,7 +201,8 @@
 </programlisting>
 
 By default, the repository for stable nginx packages is used.
-If you would like to use mainline nginx packages, run the following command:
+If you would like to use mainline nginx packages,
+run the following command:
 <programlisting>
 sudo yum-config-manager --enable nginx-mainline
 </programlisting>
@@ -224,40 +225,22 @@
 <para>
 Install the prerequisites:
 <programlisting>
-sudo apt install curl gnupg2 ca-certificates lsb-release
+sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring
 </programlisting>
-
-To set up the apt repository for stable nginx packages,
-run the following command:
-<programlisting>
-echo "deb http://nginx.org/packages/debian `lsb_release -cs` nginx" \
-    | sudo tee /etc/apt/sources.list.d/nginx.list
-</programlisting>
+</para>
 
-If you would like to use mainline nginx packages,
-run the following command instead:
-<programlisting>
-echo "deb http://nginx.org/packages/mainline/debian `lsb_release -cs` nginx" \
-    | sudo tee /etc/apt/sources.list.d/nginx.list
-</programlisting>
-
-Set up repository pinning to prefer our packages over
-distribution-provided ones:
-<programlisting>
-echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
-    | sudo tee /etc/apt/preferences.d/99nginx
-</programlisting>
-
-Next, import an official nginx signing key so apt could verify the packages
+<para>
+Import an official nginx signing key so apt could verify the packages
 authenticity.
 Fetch the key:
 <programlisting>
-curl -o /tmp/nginx_signing.key https://nginx.org/keys/nginx_signing.key
+curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
+    | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
 </programlisting>
 
 Verify that the downloaded file contains the proper key:
 <programlisting>
-gpg --dry-run --quiet --import --import-options import-show /tmp/nginx_signing.key
+gpg --dry-run --quiet --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg
 </programlisting>
 
 The output should contain the full fingerprint
@@ -268,12 +251,37 @@
       573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62
 uid                      nginx signing key &lt;signing-key@nginx.com&gt;
 </programlisting>
+If the fingerprint is different, remove the file.
+</para>
 
-Finally, move the key to apt trusted key storage (note the "asc" file extension change):
+<para>
+To set up the apt repository for stable nginx packages,
+run the following command:
 <programlisting>
-sudo mv /tmp/nginx_signing.key /etc/apt/trusted.gpg.d/nginx_signing.asc
+echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
+http://nginx.org/packages/debian `lsb_release -cs` nginx" \
+    | sudo tee /etc/apt/sources.list.d/nginx.list
 </programlisting>
 
+If you would like to use mainline nginx packages,
+run the following command instead:
+<programlisting>
+echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
+http://nginx.org/packages/mainline/debian `lsb_release -cs` nginx" \
+    | sudo tee /etc/apt/sources.list.d/nginx.list
+</programlisting>
+</para>
+
+<para>
+Set up repository pinning to prefer our packages over
+distribution-provided ones:
+<programlisting>
+echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
+    | sudo tee /etc/apt/preferences.d/99nginx
+</programlisting>
+</para>
+
+<para>
 To install nginx, run the following commands:
 <programlisting>
 sudo apt update
@@ -289,40 +297,22 @@
 <para>
 Install the prerequisites:
 <programlisting>
-sudo apt install curl gnupg2 ca-certificates lsb-release
+sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring
 </programlisting>
-
-To set up the apt repository for stable nginx packages,
-run the following command:
-<programlisting>
-echo "deb http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
-    | sudo tee /etc/apt/sources.list.d/nginx.list
-</programlisting>
+</para>
 
-If you would like to use mainline nginx packages,
-run the following command instead:
-<programlisting>
-echo "deb http://nginx.org/packages/mainline/ubuntu `lsb_release -cs` nginx" \
-    | sudo tee /etc/apt/sources.list.d/nginx.list
-</programlisting>
-
-Set up repository pinning to prefer our packages over
-distribution-provided ones:
-<programlisting>
-echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
-    | sudo tee /etc/apt/preferences.d/99nginx
-</programlisting>
-
-Next, import an official nginx signing key so apt could verify the packages
+<para>
+Import an official nginx signing key so apt could verify the packages
 authenticity.
 Fetch the key:
 <programlisting>
-curl -o /tmp/nginx_signing.key https://nginx.org/keys/nginx_signing.key
+curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
+    | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
 </programlisting>
 
 Verify that the downloaded file contains the proper key:
 <programlisting>
-gpg --dry-run --quiet --import --import-options show-only /tmp/nginx_signing.key
+gpg --dry-run --quiet --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg
 </programlisting>
 
 The output should contain the full fingerprint
@@ -333,12 +323,37 @@
       573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62
 uid                      nginx signing key &lt;signing-key@nginx.com&gt;
 </programlisting>
+If the fingerprint is different, remove the file.
+</para>
 
-Finally, move the key to apt trusted key storage (note the "asc" file extension change):
+<para>
+To set up the apt repository for stable nginx packages,
+run the following command:
 <programlisting>
-sudo mv /tmp/nginx_signing.key /etc/apt/trusted.gpg.d/nginx_signing.asc
+echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
+http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
+    | sudo tee /etc/apt/sources.list.d/nginx.list
 </programlisting>
 
+If you would like to use mainline nginx packages,
+run the following command instead:
+<programlisting>
+echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
+http://nginx.org/packages/mainline/ubuntu `lsb_release -cs` nginx" \
+    | sudo tee /etc/apt/sources.list.d/nginx.list
+</programlisting>
+</para>
+
+<para>
+Set up repository pinning to prefer our packages over
+distribution-provided ones:
+<programlisting>
+echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
+    | sudo tee /etc/apt/preferences.d/99nginx
+</programlisting>
+</para>
+
+<para>
 To install nginx, run the following commands:
 <programlisting>
 sudo apt update
@@ -492,6 +507,7 @@
 
 </section>
 
+
 <section name="Amazon Linux" id="Amazon-Linux">
 
 <para>
@@ -523,7 +539,8 @@
 </programlisting>
 
 By default, the repository for stable nginx packages is used.
-If you would like to use mainline nginx packages, run the following command:
+If you would like to use mainline nginx packages,
+run the following command:
 <programlisting>
 sudo yum-config-manager --enable nginx-mainline
 </programlisting>
@@ -562,7 +579,8 @@
 
 <para>
 Packaging sources are distributed under the same
-<link url="../LICENSE">2-clause BSD-like license</link> used by nginx.
+<link url="../LICENSE">2-clause BSD-like license</link>
+used by nginx.
 </para>
 
 </section>
--- a/xml/ru/linux_packages.xml	Tue Aug 03 12:54:38 2021 +0300
+++ b/xml/ru/linux_packages.xml	Wed Aug 11 13:35:03 2021 +0300
@@ -7,12 +7,13 @@
 <article name="nginx: пакеты для Linux"
          link="/ru/linux_packages.html"
          lang="ru"
-         rev="64">
+         rev="65">
 
 <section name="Поддерживаемые дистрибутивы и версии" id="distributions">
 
 <para>
-Пакеты nginx доступны для следующих дистрибутивов Linux и их версий:
+Пакеты nginx доступны для следующих дистрибутивов Linux и их
+версий:
 </para>
 
 <para>
@@ -88,6 +89,7 @@
 <link id="SLES">SLES</link>
 
 <table note="yes">
+
 <tr>
 <td width="30%">Версия</td>
 <td>Поддерживаемые платформы</td>
@@ -223,40 +225,22 @@
 <para>
 Установите пакеты, необходимые для подключения apt-репозитория:
 <programlisting>
-sudo apt install curl gnupg2 ca-certificates lsb-release
+sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring
 </programlisting>
-
-Для подключения apt-репозитория для стабильной версии nginx,
-выполните следующую команду:
-<programlisting>
-echo "deb http://nginx.org/packages/debian `lsb_release -cs` nginx" \
-    | sudo tee /etc/apt/sources.list.d/nginx.list
-</programlisting>
+</para>
 
-Если предпочтительно использовать пакеты для основной версии nginx,
-выполните следующую команду вместо предыдущей:
-<programlisting>
-echo "deb http://nginx.org/packages/mainline/debian `lsb_release -cs` nginx" \
-    | sudo tee /etc/apt/sources.list.d/nginx.list
-</programlisting>
-
-Для использования пакетов из нашего репозитория вместо распространяемых в дистрибутиве,
-настройте закрепление:
-<programlisting>
-echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
-    | sudo tee /etc/apt/preferences.d/99nginx
-</programlisting>
-
+<para>
 Теперь нужно импортировать официальный ключ,
 используемый apt для проверки подлинности пакетов.
 Скачайте ключ:
 <programlisting>
-curl -o /tmp/nginx_signing.key https://nginx.org/keys/nginx_signing.key
+curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
+    | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
 </programlisting>
 
 Проверьте, верный ли ключ был загружен:
 <programlisting>
-gpg --dry-run --quiet --import --import-options import-show /tmp/nginx_signing.key
+gpg --dry-run --quiet --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg
 </programlisting>
 
 Вывод команды должен содержать полный отпечаток ключа
@@ -267,12 +251,37 @@
       573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62
 uid                      nginx signing key &lt;signing-key@nginx.com&gt;
 </programlisting>
+Если отпечаток отличается от вышеуказанного, удалите файл ключа.
+</para>
 
-Переместите ключ в каталог доверенных ключей apt (обратите внимание на изменение расширения "asc"):
+<para>
+Для подключения apt-репозитория для стабильной версии nginx,
+выполните следующую команду:
 <programlisting>
-sudo mv /tmp/nginx_signing.key /etc/apt/trusted.gpg.d/nginx_signing.asc
+echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
+http://nginx.org/packages/debian `lsb_release -cs` nginx" \
+    | sudo tee /etc/apt/sources.list.d/nginx.list
 </programlisting>
 
+Если предпочтительно использовать пакеты для основной версии nginx,
+выполните следующую команду вместо предыдущей:
+<programlisting>
+echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
+http://nginx.org/packages/mainline/debian `lsb_release -cs` nginx" \
+    | sudo tee /etc/apt/sources.list.d/nginx.list
+</programlisting>
+</para>
+
+<para>
+Для использования пакетов из нашего репозитория вместо
+распространяемых в дистрибутиве, настройте закрепление:
+<programlisting>
+echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
+    | sudo tee /etc/apt/preferences.d/99nginx
+</programlisting>
+</para>
+
+<para>
 Чтобы установить nginx, выполните следующие команды:
 <programlisting>
 sudo apt update
@@ -288,40 +297,22 @@
 <para>
 Установите пакеты, необходимые для подключения apt-репозитория:
 <programlisting>
-sudo apt install curl gnupg2 ca-certificates lsb-release
+sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-archive-keyring
 </programlisting>
-
-Для подключения apt-репозитория для стабильной версии nginx,
-выполните следующую команду:
-<programlisting>
-echo "deb http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
-    | sudo tee /etc/apt/sources.list.d/nginx.list
-</programlisting>
+</para>
 
-Если предпочтительно использовать пакеты для основной версии nginx,
-выполните следующую команду вместо предыдущей:
-<programlisting>
-echo "deb http://nginx.org/packages/mainline/ubuntu `lsb_release -cs` nginx" \
-    | sudo tee /etc/apt/sources.list.d/nginx.list
-</programlisting>
-
-Для использования пакетов из нашего репозитория вместо распространяемых в дистрибутиве,
-настройте закрепление:
-<programlisting>
-echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
-    | sudo tee /etc/apt/preferences.d/99nginx
-</programlisting>
-
+<para>
 Теперь нужно импортировать официальный ключ,
 используемый apt для проверки подлинности пакетов.
 Скачайте ключ:
 <programlisting>
-curl -o /tmp/nginx_signing.key https://nginx.org/keys/nginx_signing.key
+curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
+    | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
 </programlisting>
 
 Проверьте, верный ли ключ был загружен:
 <programlisting>
-gpg --dry-run --quiet --import --import-options import-show /tmp/nginx_signing.key
+gpg --dry-run --quiet --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg
 </programlisting>
 
 Вывод команды должен содержать полный отпечаток ключа
@@ -332,12 +323,37 @@
       573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62
 uid                      nginx signing key &lt;signing-key@nginx.com&gt;
 </programlisting>
+Если отпечаток отличается от вышеуказанного, удалите файл ключа.
+</para>
 
-Переместите ключ в каталог доверенных ключей apt (обратите внимание на изменение расширения "asc"):
+<para>
+Для подключения apt-репозитория для стабильной версии nginx,
+выполните следующую команду:
 <programlisting>
-sudo mv /tmp/nginx_signing.key /etc/apt/trusted.gpg.d/nginx_signing.asc
+echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
+http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
+    | sudo tee /etc/apt/sources.list.d/nginx.list
 </programlisting>
 
+Если предпочтительно использовать пакеты для основной версии nginx,
+выполните следующую команду вместо предыдущей:
+<programlisting>
+echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
+http://nginx.org/packages/mainline/ubuntu `lsb_release -cs` nginx" \
+    | sudo tee /etc/apt/sources.list.d/nginx.list
+</programlisting>
+</para>
+
+<para>
+Для использования пакетов из нашего репозитория вместо
+распространяемых в дистрибутиве, настройте закрепление:
+<programlisting>
+echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
+    | sudo tee /etc/apt/preferences.d/99nginx
+</programlisting>
+</para>
+
+<para>
 Чтобы установить nginx, выполните следующие команды:
 <programlisting>
 sudo apt update
@@ -490,6 +506,7 @@
 
 </section>
 
+
 <section name="Amazon Linux" id="Amazon-Linux">
 
 <para>