Cómo instalar Pagekit CMS en Debian 9

Pagekit es un CMS moderno, intuitivo, modular y flexible de código abierto (licencia MIT) construido con componentes Symfony y Vue.js. Le brinda las herramientas para crear hermosos sitios web. Tiene un rico ecosistema de temas y complementos.

En este tutorial, lo guiaremos a través del proceso de instalación de Pagekit CMS 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

Para instalar Pagekit, asegúrese de que su servidor cumpla con los siguientes requisitos:

• Apache versión 2.2 o superior o servidor web NGINX.
• MySQL versión 5.1 o superior o SQLite 3.
• PHP versión 5.5.9 o superior.
• Extensiones PHP requeridas: JSON, Session, ctype, Tokenizer, SimpleXML, DOM, mbstring, PCRE 8.0+, ZIP y PDO con controladores MySQL o SQLite.
• Extensiones de PHP opcionales: cURL, iconv y XML Parser, así como APC o XCache para el almacenamiento en caché.

• 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 Pagekit 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 que está bien para el CMS de octubre.

Descargue e instale PHP 7.0 y las extensiones de PHP requeridas:

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

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 Pagekit

Pagekit CMS admite bases de datos MySQL, MariaDB y SQLite. 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 versión 10.2 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

NOTA: Se le solicitará la contraseña de usuario raíz. Ingrese una contraseña segura y continúe.

Compruebe la versión de MariaDB:

mysql --version
# mysql  Ver 15.1 Distrib 10.2.22-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 Pagekit, 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.1

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

# 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.

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"

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

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

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 Pagekit

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 Pagekit ejecutando:

sudo vim /etc/nginx/sites-available/pagekit.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/pagekit;
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;
} }

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

sudo ln -s /etc/nginx/sites-available/pagekit.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 Pagekit CMS

Cree un directorio raíz de documentos en el que debe residir Pagekit:

sudo mkdir -p /var/www/pagekit

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

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

Navegue a la raíz del documento:

cd /var/www/pagekit

Descargue la última versión estable de Pagekit CMS a través de wget:

wget https://github.com/pagekit/pagekit/releases/download/1.0.16/pagekit-1.0.16.zip

Descomprima el contenido de Pagekit CMS y elimine el archivo .zip descargado.

unzip pagekit-1.0.16.zip
rm pagekit-1.0.16.zip

Cambie la propiedad del directorio /var/www/pagekit a www-data.

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

Paso 6: complete la configuración de Pagekit

Abra su sitio en un navegador web y debería ver la siguiente página:

Haga clic en el icono de la flecha hacia la derecha para continuar con la instalación. Elija su idioma y haga clic en el botón «Siguiente»:

A continuación, elija su base de datos, ya sea SQLite o MySQL, complete los campos obligatorios y haga clic en el botón «Siguiente»:

Después de eso, configure su sitio ingresando al Título del sitio y creando una cuenta de usuario administrador:

Y eso debería ser todo. Será redirigido a la página de inicio de sesión de Pagekit. Proporcione su nombre de usuario y contraseña para iniciar sesión en el panel de control de Pagekit.

Eso es todo. Si te atascaste, consulta los documentos oficiales de Pagekit.