Ampliando la base de datos

Para cumplir el requerimiento cree varias tablas, al igual que la primera vez, lo hice desde la web de Xata. El editor es sencillo pero suficiente para lo que necesito.

Para manejar las ordenes tal cual se especifica en el README del reto, me pareció conveniente utilizar el concepto de objeto dentro de una tabla. Lo intente desde el editor web pero no me funcionó (luego encontré el por qué en la documentación*) así que opte por cargar el schema desde un .json 😵

*While the API supports the object type, the Web UI and CLI do not expose it as an option yet. There is still work in progress.

Lo primero fue instalar el cliente de xata, seguir los pasos para autenticarlo con la cuenta y ejecutar los comandos deseados. Para no perder la definición de las tablas creadas, primero un dump, agregar la definición de la tabla ordenes y luego un upload.

xata schema dump
xata shema upload C:\coding\xata\CocinaZombie.json

Acá el schema completo

{

  "tables": [
    {
      "name": "comanda",
      "columns": [
        {
          "name": "FechaHora",
          "type": "datetime",
          "defaultValue": "2023-03-09T12:00:00Z"
        }
      ]
    },
    {
      "name": "cocina",
      "columns": [
        {
          "name": "Limite",
          "type": "int",
          "defaultValue": "0"
        }
      ]
    },
    {
      "name": "menu",
      "columns": [
        {
          "name": "nombre",
          "type": "string"
        },
        {
          "name": "detalle",
          "type": "text"
        },
        {
          "name": "especial",
          "type": "bool"
        }
      ]
    },

    {
      "name": "order",
      "columns": [
        {
          "name": "table",
          "type": "int"
        },
        {
          "name": "createdAt",
          "type": "datetime"
        },
        {
          "name": "dishes",
          "type": "object",
          "columns": [
            {
              "name": "name",
              "type": "string"
            },
            {
              "name": "quantity",
              "type": "int"
            }
          ]
        }
      ]
    }
  ]
}

Primera vez que trabajo con una base de datos en esta modalidad, me parece casi magia y sobre todo al leer un poco más la documentación, se me ocurren varias cosas que podría hacer con la posibilidad de crear nuevas columnas en una tabla utilizando el API REST 🤯

Querys con APIs

Primero, unas pruebas con Insomnia para tener claro los endpoints y métodos. Ahí me di cuenta que definir dishes como objeto no me sirve, ya que solo permite un elemento. Entonces veo dos opciones:

• Utilizar un campo texto y almacenar la colección de platos en formato json

• Crear una tabla subordinada

En un desarrollo de los que estoy acostumbrado me iría por la segunda opción sin pensarlo, pero como la idea del reto es probar cosas nuevas me decidí por la primera.

Así que eliminé las dos columnas dishes.name y dishes.quantity, y las reemplacé por un campo texto dishes.

Un poco de LowCode

Ya con las tablas listas, hay que utilizarlas en la aplicación. Primero pensé en modificar el mismo web panel del reto 1 (ver acá), pero al final terminé creando uno nuevo con:

• un botón para crear nueva orden

• una grilla con el listado de las órdenes creadas

• un popup para ver el menú y crear la orden

El resultado se lo puede ver aquí.

Un detalle que descubrí al hacer el deploy, es que si se hace el push desde línea de comandos a un repositorio que no existe da error, pero si se lo hace desde Docker Desktop se crea el repositorio. Acá el repositorio con las imágenes.

Nota de color, el menú 'zombie' es una muestra de la gastronomía ecuatoriana 😁

Como parte del Backend de la suerte 2023 (actividad que se está volviendo tradicional en la comunidad Malandriner) me tocó resolver el reto con Xata, una herramienta que se presenta como "la base de datos serverless que te dará super-poderes". No la conocía de nada pero veo que tiene características interesantes (consulta vía API, manejo de ramas para migración), una capa gratuita generosa y unos precios muy atractivos, muy probablemente la vuelva a utilizar en un futuro en algún proyecto real.

Primeros pasos

Se puede acceder a Xata con los clientes oficiales (la documentación muestra ejemplos con TS) y vía su API REST. Como siempre hago al utilizar un API nueva (o incluso en alguna conocida) es probar los endpoints con Insomnia.

La documentación se ve completa, pero con pocos ejemplos, sin embargo resulta sencilla de seguir hasta dar con los endpoints que creo voy a necesitar. Lo primero es obtener el token (desde la configuración de la cuenta) que irá en todas las llamadas.

Para las pruebas utilicè los siguientes métodos:

• Get user details https://xata.io/docs/api-reference/user#get-user-details

• Get list of workspaces https://xata.io/docs/api-reference/workspaces#get-list-of-workspaces

• List databases https://xata.io/docs/api-reference/workspaces/workspace_id/dbs#list-databases

• Insert record https://xata.io/docs/api-reference/db/db_branch_name/tables/table_name/data#insert-record

• Query table https://xata.io/docs/api-reference/db/db_branch_name/tables/table_name/query#query-table

Primera parte lista, con esto tengo la seguridad de poder consumir desde GX.

El MVP

Ahora si a usar Xata desde GeneXus, lo que me pareció interesante es que tienen disponible la especificación OpenApi para importarla (con ejemplos en insomnia y postman). Así que voy por esa opción a ver cómo me va, primero con el Core API que da acceso al usuario y el espacio de trabajo, y luego con la Workspace API que da acceso a las bases de datos, tablas, registros, entre otras.

Al cargar se despliegan todos los métodos, selecciono solo los que creo voy a necesitar para el primer reto (luego veré cómo agregar más). Si bien esto genera todos los objetos necesarios, el consumo de los endpoints es un poco enredado, así que mejor opté por utilizar el código generado desde insomnia.

curl --request POST \
  --url https://carlos-encalada-s-workspace-gq7o0i.us-west-2.xata.sh/db/cocina-zombie:main/tables/comanda/data \
  --header 'Authorization: Bearer xau_Z5b2SjkZRrLHOlYqWxjvZ8LNIR3j9jxM1' \
  --header 'Content-Type: application/json' \
  --data '{"FechaHora":"2023-03-13T20:00:00Z"}'

Para cumplir con los requisitos del primer reto (ver detalles), simplemente hice un web panel que en el evento Star recupera la última fecha-hora y al dar clic en el botón inserta un nuevo registro. Para el deploy utilice docker, la imagen se la puede encontrar aquí y una versión de prueba acá.

Para los próximos retos espero hacer algo más sofisticado y actualizar esta entrada, pero en conclusión Xata me parece una herramienta muy interesante para profundizar.

cd\
net use \\[ip]\[folder] /u:[user] [password]

Colocarlo en el directorio de inicio, ejecutando

shell:Startup

Lo primero es instalar Microsoft SQL Server dependiendo de la versión de GeneXus. Se puede utilizar la versión Express o Developer .

Para ejecutar las aplicaciones se requiere URL Rewrite, para compilar en Java o Android el JDK 1.8 o superior

Complementos adicionales (error en la instalación): Microsoft ODBC Driver for SQL Server , Microsoft Command Line Utilities for SQL Server y Microsoft LocalDB .

Instalación

En este caso se utilizarán las versiones v16 upgrade 10 y v17 upgrade 6

Durante la instalación se presentó un error indicando que faltaban algunas dependencias, pero al parecer la instalación terminó por que se encontraba disponible para iniciar🤔.

Validar Instalación

Luego de cargar las licencias se crea una KB de prueba para verificar que se puede generar una aplicación web y luego se instala el SDK de Android (aprox. 4GB) para comprobar la generación de una app nativa.

Luego de esto el equipo está listo para trabajar con GeneXus.

Referencias

SQL Server Downloads
GeneXus 16 hardware and software requirements
GeneXus 17 hardware and software requirements
Verificación de la instalación de GeneXus versión 16
Características de GeneXus que vale la pena conocer: LocalDB

La forma más cómoda es mediante Escritorio Remoto (RDP), en Windows utilizo mRemoteNG ya que permite tener organizadas las conexiones. Para Linux una alternativa es Remmina .
Una vez conectado el primer paso es actualizar (no importa si dice que está actualizado, hay que darle a Check) y luego reiniciar, actualizar, reiniciar.

Cambiar clave de administrador

Una medida básica de seguridad, los pasos son Settings, Accounts, Sign-in options, Password, Change.
Colocar la clave actual, digitar la nueva dos veces y colocar una pista (requerido). Cerrar sesión y volverse a conectar para validar.

Software esencial

Empezando por el navegador (Edge esta bien, pero) la opción recomendada es Firefox ESR (la versión de soporte extendido).

Habilitar la característica de servidor web, abrir Server Manager, Manage, Add Roles and Features, y seguir la guía del asistente.

Para manejar de forma sencilla los certificados SSL y poder configurar varios sitios en IIS utilizo Certify the Web

Crear usuarios

Siempre es preferible realizar cualquier tarea con un usuario diferente al Administrador y dependiendo de los requerimientos, se puede tener hasta dos usuarios conectados de forma concurrente sin necesidad de instalar una licencia adicional.
Los pasos son Settings, Accounts, Other Users, Add someone else to this PC, Users, New User....

Luego asegurarse de habilitar el acceso remoto: Settings, Remote Desktop, User accounts, Select users that can remotely access this PC.

VNC

Dependiendo del proveedor en el que se encuentre alojado el VPS, existe la posibilidad de conectarse por VNC. Como medida de seguridad se cambia la clave y si es posible desde el panel desactivar el acceso.

Luego de esto el servidor se encuentra listo para instalar el software adicional en función del uso que se le vaya a dar.

Referencias

Comparación de las ediciones Standard, Datacenter y Datacenter Azure Edition de Windows Server 2022
Obtén Firefox para tu empresa

La idea es levantar dos instancias de computo, una para bases de datos y otra para aplicaciones. Para esto se utilizarán procesadores ARM, ya que en la capa gratuita se tiene el equivalente a 4 cores y 24 GB en RAM 😮.

Personalización de la instancia

El primer cambio es la ubicación (Placement) para colocar dos instancias en el mismo dominio de falla (Fault Domains) con la idea de reducir la latencia.

Luego elegir la imagen y el aspecto (Image and shape), las bases de datos irán en instancias de Oracle Linux 8 y las aplicaciones en instancias Ubuntu 20.04 😎.
En la parte de red le puse nombres 'amigables' a la red y subred. Para la conexión subí la llave ssh pública y con eso la instancia estaba lista para crear.

Una vez aprovisionada la instancia es cuestión de conectarse por ssh para iniciar la configuración inicial (ver check lists 1 y 2)

Para más detalles de las características de la nube de Oracle y las opciones de la capa gratuita, se pueden consultar las referencias.

Referencias

Dos VPS ¡y más!… Siempre gratis
Oracle Cloud Giving Away Ampere Arm A1 Instances Always Free
Always Free Resources
Fault Domains
Connecting to an Instance

Actualizar

dnf check-update && dnf update

Cambiar la contraseña de root

passwd

Agregar un nuevo usuario y definir la clave

adduser karlos

passwd karlos

Dar privilegios de root

gpasswd -a karlos wheel

SSH

La parte de configuración y conexión SSH no varia con respecto a la parte 1

Finalmente reiniciar el servicio

systemctl reload sshd

Firewall

Docker

Eliminar versiones antiguas

sudo yum remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-engine

Actualizar índice de paquetes e instalar complementos

sudo yum check-update  

sudo yum install -y yum-utils

Agregar repositorio

sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

Instalar

sudo yum install docker-ce docker-ce-cli containerd.io

Iniciar servicio y verificar

sudo systemctl start docker

sudo systemctl status docker

Habilitar arranque al inicio

sudo systemctl enable docker

Verificar instalación

sudo docker run hello-world

Permisos de ejecución

sudo usermod -aG docker $(whoami)

Volver a iniciar sesión

Docker Compose

Descargar ejecutable

sudo curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Asignar permisos

sudo chmod +x /usr/local/bin/docker-compose

Verificar instalación

docker-compose --version

Con estos pasos se tiene listo el server con Alma Linux (uno de los candidatos a sustituir a CentOS).

Para más detalles de las opciones utilizadas se pueden consultar los artículos de referencia.

Referencias

Initial Server Setup with CentOS 7
How to update AlmaLinux
Text Install Docker Engine on CentOS
How To Install and Use Docker on CentOS 7
How To Install and Use Docker Compose on CentOS 7

Actualizar

apt update && apt upgrade

Cambiar la contraseña de root

passwd

Agregar un nuevo usuario

adduser karlos

Dar privilegios de root

usermod -aG sudo karlos

Crear llaves ssh

ssh-keygen

Copiar al servidor

ssh-copy-id karlos@remote_host

Configuraciones adicionales de SSH

Editar el archivo /etc/ssh/sshd_config para:

• Cambiar puerto (Port)
• Deshabilitar el acceso con contraseña (PasswordAuthentication)
• Deshabilitar el acceso root (PermitRootLogin)
• Limitar usuarios con acceso (AllowUsers karlos)

Finalmente reiniciar el servicio

systemctl restart ssh

Docker

Eliminar versiones antiguas

sudo apt-get remove docker docker-engine docker.io containerd runc

Actualizar índice de paquetes e instalar complementos

sudo apt-get update
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

Agregar llave GPG

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Agregar repositorio

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Instalar

sudo apt-get update

sudo apt-get install docker-ce docker-ce-cli containerd.io

Verificar instalación

sudo docker run hello-world

Permisos de ejecución

sudo usermod -aG docker $USER

Volver a iniciar sesión

Docker Compose

Descargar ejecutable

sudo curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Asignar permisos

sudo chmod +x /usr/local/bin/docker-compose

Verificar instalación

docker-compose --version

Con estos pasos tengo un servidor con todo listo para empezar a levantar diferentes servicios.

Para más detalles de las opciones utilizadas se pueden consultar los artículos de referencia.

Referencias

Primeros pasos con tu VPS
How to Change User Password in Ubuntu [Beginner’s Tutorial]
Initial Server Setup with Ubuntu 20.04
How to Set Up SSH Keys on Ubuntu 20.04
Configuración de ssh. Simplifica tus conexiones en Ubuntu, Linux Mint, etc
Install Docker Engine on Ubuntu
Tutorial de Docker
How To Install and Use Docker Compose on Ubuntu 20.04