Pre requisitos

• Un servidor Ubuntu 20.04 con acceso por SSH con un usuario con privilegios de sudo.
• Un nombre de dominio para el blog, apuntando a la IP pública del servidor.

Paso 1 - Instalar Nginx

Ghost utiliza Nginx como reverse proxy:

ubuntu@ghost:~$ sudo apt update
ubuntu@ghost:~$ sudo apt install -y nginx

Podemos verificar que esté instalado y corriendo en el puerto 80 ingresando a través del browser: http://yourblogdomain/. Si todo está bien, deberíamos ver la página web default de Nginx.

Paso 2 - Instalar Mysql y crear base de datos

Ghost utiliza Mysql 8 o superior como base de datos:

ubuntu@ghost:~$ sudo apt install -y mysql-server

Chequeamos la versión:

ubuntu@ghost:~$ mysql --version
mysql  Ver 8.0.31-0ubuntu0.20.04.1 for Linux on x86_64 ((Ubuntu))

Ingresar a Mysql y establecer una contraseña para el usuario root:

ubuntu@ghost:~$ sudo mysql

mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'MyP4ssword!';

Salir de Mysql:

mysql> exit

Correr instalación segura de Mysql:

ubuntu@ghost:~$ mysql_secure_installation

Securing the MySQL server deployment.

Enter password for user root:

VALIDATE PASSWORD COMPONENT can be used to test passwords
and improve security. It checks the strength of password
and allows the users to set only those passwords which are
secure enough. Would you like to setup VALIDATE PASSWORD component?

Press y|Y for Yes, any other key for No: y

There are three levels of password validation policy:

LOW    Length >= 8
MEDIUM Length >= 8, numeric, mixed case, and special characters
STRONG Length >= 8, numeric, mixed case, special characters and dictionary                  file

Please enter 0 = LOW, 1 = MEDIUM and 2 = STRONG: 1
Using existing password for root.

Estimated strength of the password: 100
Change the password for root ? ((Press y|Y for Yes, any other key for No) : n

 ... skipping.
By default, a MySQL installation has an anonymous user,
allowing anyone to log into MySQL without having to have
a user account created for them. This is intended only for
testing, and to make the installation go a bit smoother.
You should remove them before moving into a production
environment.

Remove anonymous users? (Press y|Y for Yes, any other key for No) : y
Success.


Normally, root should only be allowed to connect from
'localhost'. This ensures that someone cannot guess at
the root password from the network.

Disallow root login remotely? (Press y|Y for Yes, any other key for No) : y
Success.

By default, MySQL comes with a database named 'test' that
anyone can access. This is also intended only for testing,
and should be removed before moving into a production
environment.


Remove test database and access to it? (Press y|Y for Yes, any other key for No) : y
 - Dropping test database...
Success.

 - Removing privileges on test database...
Success.

Reloading the privilege tables will ensure that all changes
made so far will take effect immediately.

Reload privilege tables now? (Press y|Y for Yes, any other key for No) : y
Success.

All done!

Creamos una base de datos y usuario para Ghost:

ubuntu@ghost:~$ sudo mysql -u root -p
mysql> CREATE DATABASE ghostdb;
mysql> CREATE USER ghostdbuser@localhost IDENTIFIED BY 'MyBl0gDB!';
mysql> GRANT ALL ON ghostdb.* TO ghostdbuser@localhost;
mysql> FLUSH PRIVILEGES;
mysql> EXIT;

Paso 3 - Instalar NodeJS

Instalar node 16.x LTS desde PPA:

ubuntu@ghost:~$ curl -L https://deb.nodesource.com/setup_16.x -o nodesource_setup.sh
ubuntu@ghost:~$ sudo bash nodesource_setup.sh
ubuntu@ghost:~$ sudo apt install nodejs

Chequeamos la versión:

ubuntu@ghost:~$ node -v
v16.18.1

Paso 4 - Instalar Ghost

Instalar Ghost-CLI, una herramienta para instalar y administrar Ghost desde la linea de comandos:

ubuntu@ghost:~$ sudo npm install ghost-cli@latest -g

Crear un usuario para Ghost. El usuario NO debe llamarse ghost, ya que trae problemas con la Ghost-CLI:

ubuntu@ghost:~$ sudo adduser ghostuser
ubuntu@ghost:~$ sudo usermod -aG sudo ghostuser

Crear un directorio para el sitio de Ghost, en este caso en /var/www:

ubuntu@ghost:~$ sudo mkdir /var/www/ghost
ubuntu@ghost:~$ sudo chown ghostuser:ghostuser /var/www/ghost
ubuntu@ghost:~$ sudo chmod 775 /var/www/ghost

Cambiar al nuevo usuario, ir al directorio del sitio  y correr el proceso de instalación:

ubuntu@ghost:~$ su - ghostuser
ghostuser@ghost:~$ cd /var/www/ghost
ghostuser@ghost:/var/www/ghost$ ghost install

Nos lleva a un proceso de instalación y nos pide los siguientes datos:

Blog URL: https://yourblogdomain

Mysql hostname: localhost

Mysql username: usuario configurado anteriormente (ghostdbuser)

Mysql password: la contraseña establecida para ese usuario

Ghost database name: la base de datos creada (ghostdb)

y nos pregunta si queremos configurar Nginx, un certificado SSL y Systemd: en los tres casos respondemos con "y" para que haga la configuración automática.

✔ Checking system Node.js version - found v16.18.1
✔ Checking logged in user
✔ Checking current folder permissions
✔ Checking system compatibility
✔ Checking for a MySQL installation
✔ Checking memory availability
✔ Checking free space
✔ Checking for latest Ghost version
✔ Setting up install directory
✔ Downloading and installing Ghost v5.22.10
✔ Finishing install process
? Enter your blog URL: https://community.nubi2go.com
? Enter your MySQL hostname: localhost
? Enter your MySQL username: ghostdbuser
? Enter your MySQL password: [hidden]
? Enter your Ghost database name: ghostdb
✔ Configuring Ghost
✔ Setting up instance
+ sudo useradd --system --user-group ghost
? Sudo Password [hidden]
+ sudo chown -R ghost:ghost /home/ghostuser/content
✔ Setting up "ghost" system user
ℹ Setting up "ghost" mysql user [skipped]
? Do you wish to set up Nginx? Yes
+ sudo mv /tmp/community-nubi2go-com/community.nubi2go.com.conf /etc/nginx/sites                                                                                        -available/community.nubi2go.com.conf
+ sudo ln -sf /etc/nginx/sites-available/community.nubi2go.com.conf /etc/nginx/s                                                                                        ites-enabled/community.nubi2go.com.conf
+ sudo nginx -s reload
✔ Setting up Nginx
? Do you wish to set up SSL? Yes
? Enter your email (For SSL Certificate) marketing@nubi2go.com
+ sudo mkdir -p /etc/letsencrypt
+ sudo ./acme.sh --install --home /etc/letsencrypt
+ sudo /etc/letsencrypt/acme.sh --issue --home /etc/letsencrypt --server letsenc                                                                                        rypt --domain community.nubi2go.com --webroot /home/ghostuser/system/nginx-root                                                                                         --reloadcmd "nginx -s reload" --accountemail marketing@nubi2go.com
+ sudo openssl dhparam -dsaparam -out /etc/nginx/snippets/dhparam.pem 2048
+ sudo mv /tmp/ssl-params.conf /etc/nginx/snippets/ssl-params.conf
+ sudo mv /tmp/community-nubi2go-com/community.nubi2go.com-ssl.conf /etc/nginx/s                                                                                        ites-available/community.nubi2go.com-ssl.conf
+ sudo ln -sf /etc/nginx/sites-available/community.nubi2go.com-ssl.conf /etc/ngi                                                                                        nx/sites-enabled/community.nubi2go.com-ssl.conf
+ sudo nginx -s reload
✔ Setting up SSL
? Do you wish to set up Systemd? Yes
+ sudo mv /tmp/community-nubi2go-com/ghost_community-nubi2go-com.service /lib/sy                                                                                        stemd/system/ghost_community-nubi2go-com.service
+ sudo systemctl daemon-reload
✔ Setting up Systemd
+ sudo systemctl is-active ghost_community-nubi2go-com
? Do you want to start Ghost? Yes
+ sudo systemctl start ghost_community-nubi2go-com
+ sudo systemctl is-enabled ghost_community-nubi2go-com
+ sudo systemctl enable ghost_community-nubi2go-com --quiet
✔ Starting Ghost

Ghost uses direct mail by default. To set up an alternative email method read ou                                                                                        r docs at https://ghost.org/docs/config/#mail

------------------------------------------------------------------------------

Ghost was installed successfully! To complete setup of your publication, visit:

    https://community.nubi2go.com/ghost/

¡Y listo! ya está instalado y configurado nuestro blog de Ghost. Vamos al sitio con la url que nos indica al final de la instalación https://yourblogdomain/ghost/ para crear la cuenta administrativa:

Una vez registrados, accedemos al panel de administración, donde se crean los posts, tags, usuarios, se configuran los temas y más:

y la vista de un usuario es:

Introducción

MkDocs es un generador de sitios estáticos orientado a construir la documentación técnica de un proyecto. Los archivos de documentación se escriben en Markdown y MkDocs se encarga de convertirlos a HTML, CSS y JS. Toda la configuración del sitio se realiza fácilmente mediante un único archivo YAML.

En esta guía te mostramos como instalar MkDocs en Ubuntu 20.04 y dejarlo corriendo con Apache.

Pre requisitos

Un servidor Ubuntu 20.04 con acceso por SSH con un usuario con privilegios de sudo.

Paso 1 - Instalar Apache

Necesitamos un web server que sirva el contenido estático, para eso instalamos Apache:

ubuntu@mkdocs:~$ sudo apt update
ubuntu@mkdocs:~$ sudo apt install apache2

Podemos verificar que esté instalado y corriendo en el puerto 80 ingresando a través del browser: http://ipdetuservidor/. Si todo está bien, deberíamos ver la página web default de Apache para Ubuntu.

Paso 2 - Instalar Python 3 y Pip

MkDocs está escrito en Python, por lo que vamos a necesitar que esté instalado en el servidor. Ubuntu y otras distribuciones basadas en Debian ya vienen con Python instalado. Verificamos que Python 3 está instalado:

ubuntu@mkdocs:~$ python3 --version
Python 3.8.12

MkDocs se instala como un paquete de pip, un package management system de Python, por lo que debemos instalarlo:

ubuntu@mkdocs:~$ sudo apt install -y python3-pip

Una vez que termine, verificamos que se haya instalado correctamente:

ubuntu@mkdocs:~$ pip3 --version
pip 21.3.1 from /usr/local/lib/python3.8/dist-packages/pip (python 3.8)

Paso 3 - Instalar MkDocs

ubuntu@mkdocs:~$ sudo pip3 install mkdocs

Verificamos que se haya instalado correctamente:

ubuntu@mkdocs~$ mkdocs --version
mkdocs, version 1.2.3 from /usr/local/lib/python3.8/dist-packages/mkdocs (Python 3.8)

También podemos instalar el tema Material para darle un buen look a nuestro sitio de documentación:

ubuntu@mkdocs~$ sudo pip3 install mkdocs-material

Paso 4 - Crear el proyecto de MkDocs

Ahora podemos crear el proyecto de MkDocs en el directorio que definamos, en este caso lo vamos a instalar en /var/www/:

ubuntu@mkdocs~$ cd /var/www
ubuntu@mkdocs:/var/www$ sudo mkdocs new my-docs

Esto nos va a crear la estructura del sitio de MkDocs:

ubuntu@mkdocs:/var/www$ ls my-docs/
docs  mkdocs.yml

• mkdocs.yml: archivo de configuración del sitio de MkDocs.
• docs: directorio donde debemos guardar los archivos Markdown de documentación. Viene con un index.md como home del sitio.

Agregar las siguientes lineas a mkdocs.yml para habilitar el tema Material:

theme:
  name: material

Para aplicar los cambios y generar el sitio estático corremos:

ubuntu@mkdocs:/var/www$ cd my-docs
ubuntu@mkdocs:/var/www/my-docs$ sudo mkdocs build

Esto nos va a crear el directorio site donde MkDocs va a guardar los archivos HTML, CSS Y JS.

ubuntu@mkdocs:/var/www/my-docs$ ls site
404.html  assets  index.html  search  sitemap.xml  sitemap.xml.gz

Paso 5 - Configurar Apache

Creamos el virtual host de Apache:

ubuntu@mkdocs~$ sudo nano /etc/apache2/sites-available/my-docs.conf

<VirtualHost *:80>

   ServerName my-docs.com
   DocumentRoot /var/www/my-docs/site
   
   <Directory "/var/www/my-docs/site">
      Options -Indexes
      AllowOverride None
      Order allow,deny
      Allow from all
   </Directory>
   
   ErrorLog ${APACHE_LOG_DIR}/error.log
   CustomLog ${APACHE_LOG_DIR}/access.log combined
   
</VirtualHost>

Habilitamos el nuevo archivo de virtual host con a2ensite:

ubuntu@mkdocs~$ sudo a2ensite my-docs.conf

Deshabilitamos el sitio default con a2dissite:

ubuntu@mkdocs~$ sudo a2dissite 000-default.conf

Y reiniciamos el servicio de Apache para que tome los cambios:

ubuntu@mkdocs~$ sudo systemctl restart apache2

¡Y listo! cuando volvemos a ingresar a través del browser, vamos a ver nuestro sitio de MkDocs con el tema Material:

Paso 6 - Escribiendo la documentación

Para escribir la documentación, creamos un archivo con extensión ".md" en el directorio docs:

ubuntu@mkdocs:~$ cd /var/www/my-docs/docs
ubuntu@mkdocs:/var/www/my-docs/docs$ sudo nano nubi_compute_service.md

A modo ejemplo escribimos un título, agregamos el logo del producto y una descripción con link:

# Nubi Compute Service
![](https://www.nubi2go.com/static/e1cc3940146d9b2fdf055b976e775ea0/7640e/computer_service_282.webp)

Nubi Compute Service ([NCS](https://nubi2go.com/services/nubi_compute_service)) es un servicio de máquinas virtuales en la nube.

Para aprender sobre el lenguaje de markup y su sintaxis, les recomendamos markdownguide.org.
En el sitio de mkdocs-material podemos ver todas las utilidades que tiene para escribir nuestra documentación.

Lo agregamos al nav del Home, colocando estas lineas al final del archivo mkdocs.yml:

nav:
  - Home: index.md
  - Services:
    - Nubi Compute Service: nubi_compute_service.md

y corremos el build:

ubuntu@mkdocs:/var/www/my-docs$ sudo mkdocs build

Cuando termina, veremos los cambios reflejados en el nav y la nueva página de documentación:

Como opcional, nuestra recomendación es tener la documentación en un repositorio de versionado de código como Github, para poder editar localmente los archivos markdown con nuestro IDE de preferencia. Se puede instalar MkDocs localmente, y a medida que se van haciendo cambios, se pueden visualizar con un dev-server que viene con MkDocs y levanta el sitio en localhost. Además, se puede poner como repositorio público, cosa que los usuarios que leen nuestra documentación puedan abrir issues.