Dev

Photo by Mabel Amber

• Exprimiendo jq: cómo manipular ficheros JSON

  • 12 Oct 2022
  • post
  • Xavi Aznar

  En esta entrada describo un caso práctico sobre cómo manipular un documento JSON (una IAM Policy de Google Cloud) para añadir un nuevo miembro a un rol determinado.

  Las políticas pueden gestionarse directamente mediante la herramienta de línea de comandos gcloud, por ejemplo, sobre un folder. Sin embargo puede ser interesante disponer de un registro con el estado deseado de los permisos de los recursos y así evitar drift (por ejemplo, si alguien modifica los permisos mediante gcloud o desde la consola).

  Aunque el ejemplo se centra en un fichero de políticas de GCP, la entrada describe técnicas aplicables a la manipulación de cualquier fichero JSON.

• go-queue: Un ejercicio en Go

  • 29 Aug 2022
  • post
  • Xavi Aznar

  Hace unos días leía en el foro de Kubernetes el caso de un usuario que no tenía claro cómo hacer que su aplicación fuera escalable, ya que al llegar a un determinado nivel de carga, la aplicación se saturaba.

  El problema, por lo que entendí, es que la aplicación hacía “todo el trabajo”: recibía las peticiones de los usuarios, gestionaba las acciones para procesar cada petición y devolvía el resultado a los usuarios una vez finalizado.

  Una solución rápida podría ser desplegar un horizontal pod autoscaler, pero probablemente lo ideal sería cambiar la arquitectura de la aplicación…

  Así que me puse a ello en mi lenguaje de programación favorito: Go ;)

• Mejora al tutorial 'Building a Web App with Go and SQLite': devolver el Id del nuevo registro

  • 12 Aug 2022
  • post
  • Xavi Aznar

  Habitualmente, al insertar un valor en el backend a través de la API, si la operación tiene éxito, se devuelve el identificador del registro creado.

  En el tutorial de Jeremy Morgan Building a Web App with Go and SQLite, se devuelve un mensaje genérico {"message": "success"}, que no permite realizar acciones adicionales sobre el nuevo registro.

  En esta entrada modificamos el código de la función AddPerson para devolver el identificador del nuevo registro.

• Mejora al tutorial 'Building a Web App with Go and SQLite': Devolver los registros posteriores al especificado

  • 12 Aug 2022
  • post
  • Xavi Aznar

  En la entrada Mejora al tutorial ‘Building a Web App with Go and SQLite’: limitar el número de registros devueltos por defecto modificamos el código original del tutorial de Jeremy Morgan Building a Web App with Go and SQLite para que el usuario pudiera especificar el número de resultados devueltos al consultar la API a través del parámetro count: http://<URL>/api/v1/person?count=15.

  El problema es que siempre se devuelven las entradas empezando por la de Id más bajo (habitualmente, 1).

  En esta entrada, modificamos la función getPersonById para introducir también el parámetro count y que se devuelvan count resultados a partir del Id especificado.

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