changeset 2323:eaef8f4ca921

Added Alpine Linux.
author Konstantin Pavlov <thresh@videolan.org>
date Wed, 30 Jan 2019 13:04:50 +0300
parents bb03e6ac2f16
children 3cf6a0cbec12
files xml/en/linux_packages.xml xml/ru/linux_packages.xml
diffstat 2 files changed, 201 insertions(+), 5 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="31"
+         rev="32"
          toc="no">
 
 <section id="distributions">
@@ -120,6 +120,24 @@ SLES:
 </para>
 
 <para>
+Alpine:
+
+<table note="yes">
+
+<tr>
+<td width="30%">Version</td>
+<td>Supported platforms</td>
+</tr>
+
+<tr>
+<td width="30%">3.8</td>
+<td>x86_64</td>
+</tr>
+
+</table>
+</para>
+
+<para>
 Before you install nginx for the first time on a new machine, you need to
 set up the nginx packages repository.
 Afterward, you can install and update nginx from the repository.
@@ -337,6 +355,85 @@ sudo zypper install nginx
 
 </section>
 
+
+<section name="Alpine" id="Alpine">
+
+<para>
+Install the prerequisites:
+<programlisting>
+sudo apk add openssl curl ca-certificates
+</programlisting>
+
+To set up the apk repository for stable nginx packages,
+run the following command:
+<programlisting>
+printf "%s%s%s\n" \
+    "http://nginx.org/packages/alpine/v" \
+    `egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release` \
+    "/main" \
+    | sudo tee -a /etc/apk/repositories
+</programlisting>
+
+If you would like to use mainline nginx packages,
+run the following command instead:
+<programlisting>
+printf "%s%s%s\n" \
+    "http://nginx.org/packages/mainline/alpine/v" \
+    `egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release` \
+    "/main" \
+    | sudo tee -a /etc/apk/repositories
+</programlisting>
+
+Next, import an official nginx signing key so apk could verify
+the packages authenticity.
+Fetch the key:
+<programlisting>
+curl -o /tmp/nginx_signing.rsa.pub https://nginx.org/keys/nginx_signing.rsa.pub
+</programlisting>
+
+Verify that downloaded file contains the proper key:
+<programlisting>
+openssl rsa -pubin -in /tmp/nginx_signing.rsa.pub -text -noout
+</programlisting>
+
+The output should contain the following modulus:
+<programlisting>
+Public-Key: (2048 bit)
+Modulus:
+    00:fe:14:f6:0a:1a:b8:86:19:fe:cd:ab:02:9f:58:
+    2f:37:70:15:74:d6:06:9b:81:55:90:99:96:cc:70:
+    5c:de:5b:e8:4c:b2:0c:47:5b:a8:a2:98:3d:11:b1:
+    f6:7d:a0:46:df:24:23:c6:d0:24:52:67:ba:69:ab:
+    9a:4a:6a:66:2c:db:e1:09:f1:0d:b2:b0:e1:47:1f:
+    0a:46:ac:0d:82:f3:3c:8d:02:ce:08:43:19:d9:64:
+    86:c4:4e:07:12:c0:5b:43:ba:7d:17:8a:a3:f0:3d:
+    98:32:b9:75:66:f4:f0:1b:2d:94:5b:7c:1c:e6:f3:
+    04:7f:dd:25:b2:82:a6:41:04:b7:50:93:94:c4:7c:
+    34:7e:12:7c:bf:33:54:55:47:8c:42:94:40:8e:34:
+    5f:54:04:1d:9e:8c:57:48:d4:b0:f8:e4:03:db:3f:
+    68:6c:37:fa:62:14:1c:94:d6:de:f2:2b:68:29:17:
+    24:6d:f7:b5:b3:18:79:fd:31:5e:7f:4c:be:c0:99:
+    13:cc:e2:97:2b:dc:96:9c:9a:d0:a7:c5:77:82:67:
+    c9:cb:a9:e7:68:4a:e1:c5:ba:1c:32:0e:79:40:6e:
+    ef:08:d7:a3:b9:5d:1a:df:ce:1a:c7:44:91:4c:d4:
+    99:c8:88:69:b3:66:2e:b3:06:f1:f4:22:d7:f2:5f:
+    ab:6d
+Exponent: 65537 (0x10001)
+</programlisting>
+
+Finally, move the key to apk trusted keys storage:
+<programlisting>
+sudo mv /tmp/nginx_signing.rsa.pub /etc/apk/keys/
+</programlisting>
+
+To install nginx, run the following command:
+<programlisting>
+sudo apk add nginx
+</programlisting>
+</para>
+
+</section>
+
 </section>
 
 
@@ -353,7 +450,8 @@ mainline version, while <literal>stable-
 sources for stable releases.
 To build binary packages, run <command>make</command> in
 <path>debian/</path> directory on Debian/Ubuntu, or in
-<path>rpm/SPECS/</path> on RHEL/CentOS/SLES.
+<path>rpm/SPECS/</path> on RHEL/CentOS/SLES, or in
+<path>apk/</path> on Alpine.
 </para>
 
 <para>
--- a/xml/ru/linux_packages.xml
+++ b/xml/ru/linux_packages.xml
@@ -7,7 +7,7 @@
 <article name="nginx: пакеты для Linux"
          link="/ru/linux_packages.html"
          lang="ru"
-         rev="31"
+         rev="32"
          toc="no">
 
 <section id="distributions">
@@ -119,6 +119,24 @@ SLES:
 </para>
 
 <para>
+Alpine:
+
+<table note="yes">
+
+<tr>
+<td width="30%">Версия</td>
+<td>Поддерживаемые платформы</td>
+</tr>
+
+<tr>
+<td width="30%">3.8</td>
+<td>x86_64</td>
+</tr>
+
+</table>
+</para>
+
+<para>
 Для того, чтобы поставить nginx на новой машине, необходимо подключить
 и настроить репозиторий пакетов nginx.
 После этого можно будет установить и обновлять nginx из этого репозитория.
@@ -334,6 +352,85 @@ sudo zypper install nginx
 
 </section>
 
+
+<section name="Alpine" id="Alpine">
+
+<para>
+Установите пакеты, необходимые для подключения apk-репозитория:
+<programlisting>
+sudo apk add openssl curl ca-certificates
+</programlisting>
+
+Для подключения apk-репозитория для стабильной версии nginx,
+выполните следующую команду:
+<programlisting>
+printf "%s%s%s\n" \
+    "http://nginx.org/packages/alpine/v" \
+    `egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release` \
+    "/main" \
+    | sudo tee -a /etc/apk/repositories
+</programlisting>
+
+Если предпочтительно использовать пакеты для основной версии nginx,
+выполните следующую команду вместо предыдущей:
+<programlisting>
+printf "%s%s%s\n" \
+    "http://nginx.org/packages/mainline/alpine/v" \
+    `egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release` \
+    "/main" \
+    | sudo tee -a /etc/apk/repositories
+</programlisting>
+
+Теперь нужно импортировать официальный ключ, используемый apk
+для проверки подлинности пакетов.
+Скачайте ключ:
+<programlisting>
+curl -o /tmp/nginx_signing.rsa.pub https://nginx.org/keys/nginx_signing.rsa.pub
+</programlisting>
+
+Проверьте, верный ли ключ был загружен:
+<programlisting>
+openssl rsa -pubin -in /tmp/nginx_signing.rsa.pub -text -noout
+</programlisting>
+
+Вывод команды должен содержать следующий модуль:
+<programlisting>
+Public-Key: (2048 bit)
+Modulus:
+    00:fe:14:f6:0a:1a:b8:86:19:fe:cd:ab:02:9f:58:
+    2f:37:70:15:74:d6:06:9b:81:55:90:99:96:cc:70:
+    5c:de:5b:e8:4c:b2:0c:47:5b:a8:a2:98:3d:11:b1:
+    f6:7d:a0:46:df:24:23:c6:d0:24:52:67:ba:69:ab:
+    9a:4a:6a:66:2c:db:e1:09:f1:0d:b2:b0:e1:47:1f:
+    0a:46:ac:0d:82:f3:3c:8d:02:ce:08:43:19:d9:64:
+    86:c4:4e:07:12:c0:5b:43:ba:7d:17:8a:a3:f0:3d:
+    98:32:b9:75:66:f4:f0:1b:2d:94:5b:7c:1c:e6:f3:
+    04:7f:dd:25:b2:82:a6:41:04:b7:50:93:94:c4:7c:
+    34:7e:12:7c:bf:33:54:55:47:8c:42:94:40:8e:34:
+    5f:54:04:1d:9e:8c:57:48:d4:b0:f8:e4:03:db:3f:
+    68:6c:37:fa:62:14:1c:94:d6:de:f2:2b:68:29:17:
+    24:6d:f7:b5:b3:18:79:fd:31:5e:7f:4c:be:c0:99:
+    13:cc:e2:97:2b:dc:96:9c:9a:d0:a7:c5:77:82:67:
+    c9:cb:a9:e7:68:4a:e1:c5:ba:1c:32:0e:79:40:6e:
+    ef:08:d7:a3:b9:5d:1a:df:ce:1a:c7:44:91:4c:d4:
+    99:c8:88:69:b3:66:2e:b3:06:f1:f4:22:d7:f2:5f:
+    ab:6d
+Exponent: 65537 (0x10001)
+</programlisting>
+
+Переместите ключ в каталог доверенных ключей apk:
+<programlisting>
+sudo mv /tmp/nginx_signing.rsa.pub /etc/apk/keys/
+</programlisting>
+
+Чтобы установить nginx, выполните следующую команду:
+<programlisting>
+sudo apk add nginx
+</programlisting>
+</para>
+
+</section>
+
 </section>
 
 
@@ -349,8 +446,9 @@ sudo zypper install nginx
 mainline-версии, в то время как ветки <literal>stable-*</literal> содержат
 исходные коды пакетов для стабильных релизов.
 Для сборки бинарных пакетов запустите <command>make</command> в каталоге
-<path>debian/</path> для Debian/Ubuntu или в каталоге
-<path>rpm/SPECS/</path> для RHEL/CentOS/SLES.
+<path>debian/</path> для Debian/Ubuntu, или в каталоге
+<path>rpm/SPECS/</path> для RHEL/CentOS/SLES, или в каталоге
+<path>apk/</path> для Alpine.
 </para>
 
 <para>