Dev

Photo by Mabel Amber

• Mejora al tutorial 'Building a Web App with Go and SQLite': limitar el número de registros devueltos por defecto

  • 12 Aug 2022
  • post
  • Xavi Aznar

  En la mayoría de tutoriales sobre cómo construir una API en Go (incluído el tutorial de la documentación oficial de Go), el primer endpoint que se describe es el que usa el método GET y que recupera todos los registros de la base de datos.

  Sin embargo, en el mundo real, las APIs devuelven un número limitado de registros y un índice; en una nueva consulta, se puede obtener un nuevo conjunto de resultados (y un nuevo índice), etc. Esto es así porque el resultado de la consulta con GET puede, potencialmente, devolver un número elevado de registros.

  En el tutorial Building a Web App with Go and SQLite, se incluye una limitación hardcodeada en el código para evitar, precisamente, que se devuelvan todos los valores en la base de datos de ejemplo (1000 registros).

  En este artículo, voy a mostrar cómo obtener el valor desde la queryString para que sea configurable desde la llamada a la API.

• Uso del paquete 'flag' en Go

  • 23 Jul 2022
  • post
  • Xavi Aznar

  Una de puntos que siempre se destacan al trabajar con Go es lo completa que es la biblioteca estándar de funciones que proporciona el propio lenguaje.

  flag proporciona funcionalidad para gestionar las opciones de las aplicaciones sin interfaz gráfica que se ejecutan desde la línea de comandos (CLI).

  En esta entrada reviso cómo usar el paquete para los casos de uso más habituales.

• De vuelta al Blog

  • 23 Jul 2022
  • post
  • Xavi Aznar

  Ha pasado algo más de un mes desde la última entrada en el blog… Así que en vez de escribir una entrada como si no hubiera pasado nada, he decidido crear ésta entrada para comentar qué he estado haciendo…

• Cliente API en Bash (con curl)

  • 17 Jun 2022
  • post
  • Xavi Aznar

  En una entrada anterior, Obtener respuesta y código de la petición HTTP con curl, explicaba cómo mejorar, en mi opinión, la relación con la API desde los scripts (en Bash) que se ejecutan desde una pipeline.

  La idea que explicaba en el artículo era cómo usar el código HTTP devuelto por la función que expone la API para controlar posibles errores.

  Como prueba de concepto fue satisfactoria, pero no resulta práctica aplicarla; en un caso real se usan múltiples documentos y la repetición del mismo código una y otra vez hace que se alcance el límite de cuatro mil caracteres en un paso de la pipeline…

  Así que la solución es encapsular esta idea en una función en vez de repetir el mismo código una y otra vez: Don’t repeat yourself

• Sacando partido de la funcionalidad de jq

  • 19 May 2022
  • post
  • Xavi Aznar

  Siguendo con el tema de ayer, hoy quiero revisar otro bloque de código.

  En este caso, se construye un array en JSON usando Bash puro, cuando es el proceso se simplifica enormemente gracias a la función --slurp de jq.

• Obtener respuesta y código de la petición HTTP con curl

  • 18 May 2022
  • post
  • Xavi Aznar

  Llevo una temporada revisando código -MUCHO, MUCHO código- en Bash.

  Como parte de uno de los steps de ejecución de una pipeline, se consulta una API para obtener o actualizar información de una base de datos y hacer cosas con esa información, como desplegar recursos en un proveedor cloud (usando la cli) o lanzando Terraform.

  Uno de los patrones que me encontrado a la hora de interaccionar con la API es el siguiente:

  • Generar el payload en JSON y guardarlo en una variable.
  • Ejecutar la petición usando curl y guardar la respuesta en un fichero.
  • Filtrar la respuesta usando jq leyendo el fichero.

• Todo lo que esconden las opciones por defecto en Docker

  • 25 Mar 2022
  • post
  • Xavi Aznar

  El título tiene una sonoridad un poco a click bait, así que explicaré rápidamente a qué me refiero.

  Hace poco que hemos empezado a colaborar en un proyecto nuevo. Mientras nos vamos poniendo al día estoy ayudando a uno de mis compañeros -un crack en networking- con temas relacionados con contenedores, con los que está menos familiarizado.

  Revisando los ficheros de configuración de Google Cloud Build, encontramos, en el mismo fichero, referencias a la imagen de un contenedor como hashicorp/terraform:latest, otras en las que el nombre es de la forma gcr.io/cloud-builders/gcloud y otras en las que es, simplemente, alpine.

  Y claro, mi compañero no entiende nada…

• Bitwarden Cli

  • 20 Mar 2022
  • post
  • Xavi Aznar

  Hoy en día es obligatorio usar un gestor de contraseñas. En mi caso, uso Bitwarden (la edición Personal).

  Como cada vez paso más tiempo en la línea de comandos, he decido probar la versión CLI de Bitwarden.

• Guardar el estado de Terraform en MinIO

  • 11 Mar 2022
  • post
  • Xavi Aznar

  Terraform almacena el estado de la configuración en un fichero. Este fichero es crítico para que Terraform pueda mantener la coherencia entre el estado definido en los ficheros de configuración y el estado real de la infraestructura desplegada.

  Por defecto, Terraform almacena el estado de forma local; para facilitar la colaboración entre diferentes miembros de un equipo -entre otros casos de uso-, Terraform ofrece la posibilidad de usar otras ubicaciones para guardar el estado. Estas ubicaciones reciben el nombre de backends en Terraform (y hay unos cuantos disponibles, como puedes observar desplegando la entrada Available Backends en la web de Terraform).

  Una opción habitual es la de usar un bucket en un servicio como S3 de AWS como remote backend. Pero si no tienes acceso a una cuenta de AWS, puedes usar MinIO para trabajar con un backend de tipo S3 de forma completamente offline (por ejemplo, para aprender cómo funciona Terraform ;-D )

• Sobre el uso de mayúsculas o minúsculas en los nombres de variables en Bash

  • 5 Mar 2022
  • post
  • Xavi Aznar

  He estado buscando información sobre cuál es la manera correcta a la hora de definir los nombres de las variables en Bash… Y como en el caso de la eterna batalla entre espacios vs tabs o Vim vs Emacs, parece que no hay una solución definitiva (o seguida por todo el mundo de forma generalizada).