Cómo instalar la plataforma CMS de octubre en Debian 9

October CMS es una plataforma CMS gratuita, de código abierto y autohospedada basada en Laravel PHP Framework. El código fuente de octubre CMS está alojado en Github. En este tutorial, lo guiaremos a través del proceso de instalación de CMS de octubre en un sistema operativo Debian 9 (extendido) usando NGINX como servidor web, MariaDB como servidor de base de datos y, opcionalmente, puede proteger la capa de transporte usando el cliente acme.sh y la autoridad de certificación Let’s Encrypt para agregar compatibilidad con SSL.

Requisitos

Antes de continuar, debe verificar que su servidor cumpla con los requisitos mínimos del sistema. October CMS tiene los siguientes requisitos de servidor para alojamiento web:

• PHP versión 7.0 o superior
• Extensión PHP PDO
• Extensión PHP cURL
• Extensión PHP OpenSSL
• Biblioteca PHP Mbstring
• Biblioteca Zip PHP
• Biblioteca PHP GD
• Extensión PHP XML
• Extensión PHP JSON
• Apache con mod_rewrite o NGINX
• Servidor de base de datos (MariaDB, MySQL, PostgreSQL)

• Un sistema que ejecuta Debian 9 (stretch).
• Un usuario no root con privilegios sudo.

Pasos iniciales

Compruebe la versión de su sistema Debian:

lsb_release -ds
# Debian GNU/Linux 9.7 (stretch)

Configurar la zona horaria:

dpkg-reconfigure tzdata

Actualice los paquetes de su sistema operativo (software). Este es un primer paso importante porque garantiza que tenga las últimas actualizaciones y correcciones de seguridad para los paquetes de software predeterminados de su sistema operativo:

apt update && apt upgrade -y

Instale algunos paquetes esenciales que son necesarios para la administración básica del sistema operativo Debian:

apt install -y curl wget vim git sudo unzip socat bash-completion dirmngr apt-transport-https

Paso 1: instale PHP y las extensiones de PHP necesarias

La plataforma de octubre CMS requiere PHP versión 7.0 o superior. De forma predeterminada, Debian 9 tiene la versión 7.0 de PHP en sus repositorios de software predeterminados, lo cual está bien para el CMS de octubre.

Instale PHP, así como las extensiones de PHP necesarias:

sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-common php7.0-mysql php7.0-curl php7.0-json php7.0-zip php7.0-gd php7.0-xml php7.0-mbstring

Para mostrar PHP compilado en módulos, puede ejecutar:

php -m

ctype
curl
exif
fileinfo
. . .
. . .

Compruebe la versión de PHP:

php --version

# PHP 7.0.33-0+deb9u1 (cli) (built: Dec  7 2018 11:36:49) ( NTS )
# Copyright (c) 1997-2017 The PHP Group
# Zend Engine v3.0.0, Copyright (c) 1998-2017 Zend Technologies
# with Zend OPcache v7.0.33-0+deb9u1, Copyright (c) 1999-2017, by Zend Technologies

El servicio PHP-FPM se inicia y habilita automáticamente al reiniciar en el sistema Debian 9, por lo que no es necesario iniciarlo y habilitarlo manualmente. Podemos pasar al siguiente paso, que es la instalación y configuración de la base de datos.

Paso 2: instale MariaDB y cree una base de datos para octubre

October admite bases de datos MySQL/MariaDB, PostgreSQL, SQLite y SQL. El equipo de Debian reemplazó MySQL con MariaDB como la base de datos predeterminada de Debian 9 (stretch), por lo que en este tutorial usaremos MariaDB como el servidor de la base de datos. Si desea instalar MySQL original, puede agregar y usar el repositorio MySQL oficial mantenido por Oracle.

Instale el servidor de base de datos MariaDB desde el repositorio oficial de MariaDB:

sudo apt install -y software-properties-common dirmngr apt-transport-https
sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xF1656F24C74CD1D8
sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] https://mirrors.nxthost.com/mariadb/repo/10.2/debian stretch main'
sudo apt update
sudo apt install -y mariadb-server

Compruebe la versión de MariaDB:

mysql --version
# mysql  Ver 15.1 Distrib 10.2.21-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2

Ejecute el script de instalación mysql_secure para mejorar la seguridad de MariaDB y establezca la contraseña para el usuario root de MariaDB:

sudo mysql_secure_installation

Contesta cada una de las preguntas:

Enter current password for root (enter for none): Press Enter
Set root password? [Y/n] Y
New password: your_secure_password
Re-enter new password: your_secure_password
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

Inicie sesión en MariaDB como usuario root:

sudo mysql -u root -p
# Enter password

Cree una base de datos MariaDB y un usuario que usará para su instalación de octubre y recuerde las credenciales:

CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

Salga del shell de MariaDB:

quit

Paso 3: instale el cliente Acme.sh y obtenga el certificado Let’s Encrypt (opcional)

No es necesario proteger su sitio web con HTTPS, pero es una buena práctica para asegurar el tráfico de su sitio. Para obtener un certificado SSL de Let’s Encrypt utilizaremos el cliente Acme.sh. Acme.sh es un software de shell UNIX puro para obtener certificados SSL de Let’s Encrypt sin dependencias.

Descargue e instale Acme.sh:

sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh 
./acme.sh --install --accountemail [email protected]
source ~/.bashrc
cd ~

Compruebe la versión de acme.sh:

acme.sh --version
# v2.8.0

Obtener RSA y ECC/ECDSA certificados para su dominio/nombre de host:

# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256

Si desea certificados falsos para realizar pruebas, puede agregar el indicador –staging a los comandos anteriores.

Después de ejecutar los comandos anteriores, sus certificados y claves estarán en:

• Para RSA: directorio ~/example.com.
• Para ECC/ECDSA: directorio ~/example.com_ecc.

Para enumerar sus certificados emitidos, puede ejecutar:

acme.sh --list

Cree un directorio para almacenar sus certificados. Usaremos el directorio /etc/letsencrypt.

mkdir -p /etc/letsencrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc

Instalar/copiar certificados en el directorio /etc/letsencrypt.

# RSA
acme.sh --install-cert -d example.com \ 
--cert-file /etc/letsencrypt/example.com/cert.pem \
--key-file /etc/letsencrypt/example.com/private.key \
--fullchain-file /etc/letsencrypt/example.com/fullchain.pem \
--reloadcmd "sudo systemctl reload nginx.service"

# ECC/ECDSA
acme.sh –install-cert -d example.com –ecc \
–cert-file /etc/letsencrypt/example.com_ecc/cert.pem \
–key-file /etc/letsencrypt/example.com_ecc/private.key \
–fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem \
–reloadcmd «sudo systemctl reload nginx.service»

Todos los certificados se renovarán automáticamente cada 60 días.

Después de obtener los certificados, salga del usuario raíz y regrese al usuario sudo normal:

exit

Paso 4: instale NGINX y configure NGINX para octubre

Instale el servidor web NGINX:

sudo apt install -y nginx

Compruebe la versión de NGINX:

sudo nginx -v
# nginx version: nginx/1.10.3

Configure NGINX para octubre ejecutando:

sudo vim /etc/nginx/sites-available/october.conf

Y complete el archivo con la siguiente configuración:

server {
listen [::]:443 ssl http2;
listen 443 ssl http2;
    listen [::]:80;
    listen 80;
    
    server_name example.com;
    
    index index.php index.html;
    root /var/www/october;
ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com/private.key;
ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;
location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
fastcgi_read_timeout 120s;
}

location ~ ^/favicon\.ico { try_files $uri /index.php; }
location ~ ^/sitemap\.xml { try_files $uri /index.php; }
location ~ ^/robots\.txt { try_files $uri /index.php; }
location ~ ^/humans\.txt { try_files $uri /index.php; }
location ~ ^/storage/app/uploads/public { try_files $uri 404; }
location ~ ^/storage/app/media { try_files $uri 404; }
location ~ ^/storage/temp/public { try_files $uri 404; }
location ~ ^/modules/.*/assets { try_files $uri 404; }
location ~ ^/modules/.*/resources { try_files $uri 404; }
location ~ ^/modules/.*/behaviors/.*/assets { try_files $uri 404; }
location ~ ^/modules/.*/behaviors/.*/resources { try_files $uri 404; }
location ~ ^/modules/.*/widgets/.*/assets { try_files $uri 404; }
location ~ ^/modules/.*/widgets/.*/resources { try_files $uri 404; }
location ~ ^/modules/.*/formwidgets/.*/assets { try_files $uri 404; }
location ~ ^/modules/.*/formwidgets/.*/resources { try_files $uri 404; }
location ~ ^/modules/.*/reportwidgets/.*/assets { try_files $uri 404; }
location ~ ^/modules/.*/reportwidgets/.*/resources { try_files $uri 404; }
location ~ ^/plugins/.*/.*/assets { try_files $uri 404; }
location ~ ^/plugins/.*/.*/resources { try_files $uri 404; }
location ~ ^/plugins/.*/.*/behaviors/.*/assets { try_files $uri 404; }
location ~ ^/plugins/.*/.*/behaviors/.*/resources { try_files $uri 404; }
location ~ ^/plugins/.*/.*/reportwidgets/.*/assets { try_files $uri 404; }
location ~ ^/plugins/.*/.*/reportwidgets/.*/resources { try_files $uri 404; }
location ~ ^/plugins/.*/.*/formwidgets/.*/assets { try_files $uri 404; }
location ~ ^/plugins/.*/.*/formwidgets/.*/resources { try_files $uri 404; }
location ~ ^/plugins/.*/.*/widgets/.*/assets { try_files $uri 404; }
location ~ ^/plugins/.*/.*/widgets/.*/resources { try_files $uri 404; }
location ~ ^/themes/.*/assets { try_files $uri 404; }
location ~ ^/themes/.*/resources { try_files $uri 404; } }

Active la nueva configuración october.conf vinculando el archivo al directorio habilitado para sitios.

sudo ln -s /etc/nginx/sites-available/october.conf /etc/nginx/sites-enabled

Verifique la configuración de NGINX para errores de sintaxis:

sudo nginx -t

Recargar servicio NGINX:

sudo systemctl reload nginx.service

Paso 5: descargue e instale la plataforma CMS de octubre

Cree un directorio raíz de documentos:

sudo mkdir -p /var/www/october

Cambie la propiedad del directorio /var/www/october a [your_user]:

sudo chown -R [your_user]:[your_user] /var/www/october

Navegue a la raíz del documento:

cd /var/www/october

Descargue el instalador del CMS de octubre:

wget https://octobercms.com/download -O october.zip

Descomprimir el instalador de CMS de octubre:

unzip october.zip
rm october.zip
mv install-master/* .

Cambie la propiedad del directorio /var/www/october a www-data:

sudo chown -R www-data:www-data /var/www/october

Navegue hasta el script install.php en su navegador web, como example.com/install.php y siga las instrucciones de instalación.

Paso 6: complete la configuración de octubre

Asegúrese de que su Comprobación del sistema esté bien y continúe presionando «Aceptar y continuar» botón.

Configure su base de datos y la configuración del usuario administrador.

También puede configurar algunos ajustes avanzados o puede dejar los valores predeterminados.

Y por ultimo cuando todo este configurado presiona azul”Continuar» botón.

A continuación, se le preguntará «¿Cómo desea configurar su sitio?Tendrás 3 opciones: Comenzar desde cero, Comenzar desde un tema, Usar un ID de proyecto. Selecciona tu opción preferida.

Para acceder al área de administración de la plataforma CMS de octubre, simplemente agregue /backend a su URL/IP.

Después de la instalación, por razones de seguridad, debe eliminar los archivos de instalación, el script install.php y el directorio install_files:

sudo rm /var/www/october/install.php && sudo rm -rf /var/www/october/install_files