Mercurial > hg > nginx-site
changeset 2755:6eff5d63925b
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 +++ b/xml/en/linux_packages.xml @@ -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 @@ module_hotfixes=true </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 @@ and if so, accept it. <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 @@ pub rsa2048 2011-08-19 [SC] [expires: 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62 uid nginx signing key <signing-key@nginx.com> </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 @@ sudo apt install nginx <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 @@ pub rsa2048 2011-08-19 [SC] [expires: 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62 uid nginx signing key <signing-key@nginx.com> </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 @@ sudo apk add nginx-module-image-filter@n </section> + <section name="Amazon Linux" id="Amazon-Linux"> <para> @@ -523,7 +539,8 @@ module_hotfixes=true </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 @@ To build binary packages, run <command>m <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 +++ b/xml/ru/linux_packages.xml @@ -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 @@ sudo yum install nginx <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 @@ uid [ unknown] nginx signing key <s 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62 uid nginx signing key <signing-key@nginx.com> </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 @@ sudo apt install nginx <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 @@ uid [ unknown] nginx signing key <s 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62 uid nginx signing key <signing-key@nginx.com> </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 @@ sudo apk add nginx-module-image-filter@n </section> + <section name="Amazon Linux" id="Amazon-Linux"> <para>