<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Grafana on Infraestructuras BigData Cloud .es</title><link>https://infraestructurasbigdatacloud.es/grafana/</link><description>Recent content in Grafana on Infraestructuras BigData Cloud .es</description><generator>Hugo -- gohugo.io</generator><language>es-es</language><lastBuildDate>Tue, 10 Feb 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://infraestructurasbigdatacloud.es/grafana/index.xml" rel="self" type="application/rss+xml"/><item><title>Keycloak con Grafana</title><link>https://infraestructurasbigdatacloud.es/keycloak-oauth-grafana/</link><pubDate>Tue, 10 Feb 2026 00:00:00 +0000</pubDate><guid>https://infraestructurasbigdatacloud.es/keycloak-oauth-grafana/</guid><description>&lt;p&gt;Grafana suele ser de las primeras herramientas que se montan en cualquier plataforma, y también de las primeras en llenarse de usuarios locales: el de cada persona del equipo, el de quien ya se fue y nadie dio de baja, el &lt;code&gt;admin&lt;/code&gt; compartido&amp;hellip; Si ya tienes &lt;strong&gt;Keycloak&lt;/strong&gt; como proveedor de identidad, conectarlos te quita todo eso de encima: &lt;strong&gt;inicio de sesión único&lt;/strong&gt;, altas y bajas en un solo sitio y los permisos de Grafana decididos con roles de Keycloak.&lt;/p&gt;
&lt;p&gt;En este artículo te cuento cómo lo configuro, probado con &lt;strong&gt;Keycloak 26.5&lt;/strong&gt; y &lt;strong&gt;Grafana 12.3&lt;/strong&gt;. Usaré estos nombres de ejemplo; cámbialos por los tuyos:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Keycloak: &lt;code&gt;https://sso.example.com&lt;/code&gt;, con un &lt;em&gt;realm&lt;/em&gt; llamado &lt;code&gt;ejemplo&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Grafana: &lt;code&gt;https://grafana.example.com&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="cómo-funciona"&gt;Cómo funciona&lt;/h2&gt;
&lt;p&gt;Grafana actúa como cliente de &lt;strong&gt;OpenID Connect&lt;/strong&gt; (OIDC) con el flujo de &lt;em&gt;authorization code&lt;/em&gt;, reforzado con &lt;strong&gt;PKCE&lt;/strong&gt;:&lt;/p&gt;
&lt;div class="mermaid"&gt;sequenceDiagram
actor U as Usuario
participant G as Grafana
participant K as Keycloak
U-&amp;gt;&amp;gt;G: Entra
G-&amp;gt;&amp;gt;U: Redirige a Keycloak
U-&amp;gt;&amp;gt;K: Inicia sesión
K-&amp;gt;&amp;gt;U: Vuelve con un código
U-&amp;gt;&amp;gt;G: Entrega el código
G-&amp;gt;&amp;gt;K: Código + secreto + PKCE
K-&amp;gt;&amp;gt;G: Tokens con los roles
G-&amp;gt;&amp;gt;U: Sesión con su rol
&lt;/div&gt;
&lt;p&gt;Grafana nunca ve la contraseña del usuario: solo recibe unos tokens firmados por Keycloak en los que van, entre otras cosas, los roles que le has asignado.&lt;/p&gt;
&lt;h2 id="1-el-cliente-en-keycloak"&gt;1. El cliente en Keycloak&lt;/h2&gt;
&lt;p&gt;En la consola de administración, dentro del &lt;em&gt;realm&lt;/em&gt;, ve a &lt;strong&gt;Clients → Create client&lt;/strong&gt; y recorre los tres pasos del asistente:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;General settings&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;&lt;em&gt;Client type&lt;/em&gt;: &lt;code&gt;OpenID Connect&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;em&gt;Client ID&lt;/em&gt;: &lt;code&gt;grafana&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Capability config&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;&lt;em&gt;Client authentication&lt;/em&gt;: &lt;strong&gt;On&lt;/strong&gt;. Grafana es una aplicación de servidor y puede guardar un secreto, así que el cliente es confidencial.&lt;/li&gt;
&lt;li&gt;&lt;em&gt;Authentication flow&lt;/em&gt;: solo &lt;strong&gt;Standard flow&lt;/strong&gt;. Deja desmarcado &lt;em&gt;Direct access grants&lt;/em&gt;: permite pedir tokens enviando la contraseña del usuario directamente, y no lo necesitas (luego lo activaremos un momento para una prueba).&lt;/li&gt;
&lt;li&gt;&lt;em&gt;PKCE Method&lt;/em&gt;: &lt;strong&gt;S256&lt;/strong&gt;. Así Keycloak exige PKCE y rechaza a cualquiera que no lo use.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Login settings&lt;/strong&gt;
&lt;ul&gt;
&lt;li&gt;&lt;em&gt;Root URL&lt;/em&gt;: &lt;code&gt;https://grafana.example.com&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;em&gt;Valid redirect URIs&lt;/em&gt;: &lt;code&gt;https://grafana.example.com/login/generic_oauth&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;em&gt;Valid post logout redirect URIs&lt;/em&gt;: &lt;code&gt;https://grafana.example.com/login&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;em&gt;Web origins&lt;/em&gt;: &lt;code&gt;https://grafana.example.com&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Guarda y, en la pestaña &lt;strong&gt;Credentials&lt;/strong&gt; del cliente, copia el &lt;strong&gt;Client secret&lt;/strong&gt;. Lo necesitarás en Grafana.&lt;/p&gt;
&lt;h2 id="2-los-roles"&gt;2. Los roles&lt;/h2&gt;
&lt;p&gt;Grafana tiene tres roles básicos por organización: &lt;strong&gt;Viewer&lt;/strong&gt;, &lt;strong&gt;Editor&lt;/strong&gt; y &lt;strong&gt;Admin&lt;/strong&gt;. Vamos a crear su equivalente en Keycloak como &lt;strong&gt;roles del cliente&lt;/strong&gt; &lt;code&gt;grafana&lt;/code&gt; (no del &lt;em&gt;realm&lt;/em&gt;: así quedan agrupados con la aplicación a la que pertenecen).&lt;/p&gt;
&lt;p&gt;En el cliente, pestaña &lt;strong&gt;Roles → Create role&lt;/strong&gt;, crea tres: &lt;code&gt;admin&lt;/code&gt;, &lt;code&gt;editor&lt;/code&gt; y &lt;code&gt;viewer&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;Para asignarlos a una persona: &lt;strong&gt;Users →&lt;/strong&gt; el usuario &lt;strong&gt;→ Role mapping → Assign role&lt;/strong&gt;, filtra por roles de cliente y elige el que toque. Mejor todavía, asígnalos a &lt;strong&gt;grupos&lt;/strong&gt; (por ejemplo, &lt;code&gt;grafana-admins&lt;/code&gt;, &lt;code&gt;grafana-editores&lt;/code&gt; y &lt;code&gt;grafana-lectores&lt;/code&gt;) y luego mete a las personas en el grupo: es mucho más fácil de mantener cuando el equipo crece.&lt;/p&gt;
&lt;p&gt;Crear también el rol &lt;code&gt;viewer&lt;/code&gt;, en lugar de dar acceso de lectura a todo el &lt;em&gt;realm&lt;/em&gt;, es una decisión deliberada: &lt;strong&gt;solo entra en Grafana quien tenga algún rol de Grafana&lt;/strong&gt;. En una organización con muchos usuarios en Keycloak, no todo el mundo tiene por qué ver tus paneles.&lt;/p&gt;
&lt;h3 id="no-hace-falta-ningún-mapper"&gt;No hace falta ningún &lt;em&gt;mapper&lt;/em&gt;&lt;/h3&gt;
&lt;p&gt;En los tutoriales antiguos verás que hay que crear un &lt;em&gt;mapper&lt;/em&gt; para que los roles lleguen en el token. Ya no es necesario: Keycloak incluye por defecto los roles de cada cliente en el &lt;em&gt;access token&lt;/em&gt;, en &lt;code&gt;resource_access.&amp;lt;cliente&amp;gt;.roles&lt;/code&gt;, y Grafana 12 lo lee de ahí.&lt;/p&gt;
&lt;p&gt;Ojo con un detalle: esos roles van en el &lt;em&gt;access token&lt;/em&gt;, pero &lt;strong&gt;no en el &lt;em&gt;ID token&lt;/em&gt; ni en la respuesta de &lt;em&gt;userinfo&lt;/em&gt;&lt;/strong&gt;. Si usas una versión antigua de Grafana que no los encuentra, ve a &lt;strong&gt;Client scopes → roles → Mappers → client roles&lt;/strong&gt; y activa &lt;em&gt;Add to ID token&lt;/em&gt;.&lt;/p&gt;
&lt;h2 id="3-comprobar-el-token-opcional"&gt;3. Comprobar el token (opcional)&lt;/h2&gt;
&lt;p&gt;Antes de tocar Grafana, me gusta ver con mis propios ojos qué lleva el token. Para esta prueba, activa un momento &lt;em&gt;Direct access grants&lt;/em&gt; en el cliente y pide un token con un usuario de prueba:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nb"&gt;read&lt;/span&gt; -s KEYCLOAK_PASSWORD &lt;span class="c1"&gt;# la contraseña del usuario, sin que quede en el historial&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl -s &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; -d &lt;span class="nv"&gt;client_id&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;grafana &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; -d &lt;span class="nv"&gt;client_secret&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;&lt;/span&gt;&lt;span class="nv"&gt;$KEYCLOAK_CLIENT_SECRET&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;&lt;/span&gt; &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; -d &lt;span class="nv"&gt;grant_type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;password &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; -d &lt;span class="nv"&gt;username&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;ana &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; -d &lt;span class="nv"&gt;password&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;&lt;/span&gt;&lt;span class="nv"&gt;$KEYCLOAK_PASSWORD&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;&lt;/span&gt; &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; https://sso.example.com/realms/ejemplo/protocol/openid-connect/token &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;|&lt;/span&gt; jq -r .access_token &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;|&lt;/span&gt; jq -R &lt;span class="s1"&gt;&amp;#39;split(&amp;#34;.&amp;#34;)[1] | gsub(&amp;#34;-&amp;#34;;&amp;#34;+&amp;#34;) | gsub(&amp;#34;_&amp;#34;;&amp;#34;/&amp;#34;) | @base64d | fromjson
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s1"&gt; | {preferred_username, resource_access}&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;El último &lt;code&gt;jq&lt;/code&gt; descodifica la parte central del token (un JWT) en tu propia máquina. Deberías ver algo así:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-json" data-lang="json"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;#34;preferred_username&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;ana&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;#34;resource_access&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;#34;grafana&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nt"&gt;&amp;#34;roles&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;admin&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Hay webs muy populares para descodificar tokens, pero un token válido es una credencial: &lt;strong&gt;no lo pegues en ninguna web&lt;/strong&gt;. Y cuando termines, &lt;strong&gt;vuelve a desactivar &lt;em&gt;Direct access grants&lt;/em&gt;&lt;/strong&gt;.&lt;/p&gt;
&lt;h2 id="4-la-configuración-de-grafana"&gt;4. La configuración de Grafana&lt;/h2&gt;
&lt;p&gt;Todo va en la sección &lt;code&gt;[auth.generic_oauth]&lt;/code&gt; del &lt;code&gt;grafana.ini&lt;/code&gt;:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-ini" data-lang="ini"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;[server]&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;root_url&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;https://grafana.example.com&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;[auth]&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;oauth_auto_login&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;true&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;signout_redirect_url&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;https://sso.example.com/realms/ejemplo/protocol/openid-connect/logout?client_id=grafana&amp;amp;post_logout_redirect_uri=https%3A%2F%2Fgrafana.example.com%2Flogin&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;[auth.generic_oauth]&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;enabled&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;true&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;name&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;Keycloak&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;allow_sign_up&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;true&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;client_id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;grafana&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;client_secret&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;$__file{/run/secrets/grafana-oauth-secret}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;scopes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;openid email profile&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;auth_url&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;https://sso.example.com/realms/ejemplo/protocol/openid-connect/auth&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;token_url&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;https://sso.example.com/realms/ejemplo/protocol/openid-connect/token&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;api_url&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;https://sso.example.com/realms/ejemplo/protocol/openid-connect/userinfo&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;use_pkce&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;true&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;login_attribute_path&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;preferred_username&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;email_attribute_path&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;email&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;name_attribute_path&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;name&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;role_attribute_path&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;contains(resource_access.grafana.roles[*], &amp;#39;admin&amp;#39;) &amp;amp;&amp;amp; &amp;#39;Admin&amp;#39; || contains(resource_access.grafana.roles[*], &amp;#39;editor&amp;#39;) &amp;amp;&amp;amp; &amp;#39;Editor&amp;#39; || contains(resource_access.grafana.roles[*], &amp;#39;viewer&amp;#39;) &amp;amp;&amp;amp; &amp;#39;Viewer&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;role_attribute_strict&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s"&gt;true&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Lo importante, línea a línea:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;client_secret = $__file{...}&lt;/code&gt;&lt;/strong&gt;: Grafana lee el secreto de un fichero, así no queda escrito en el &lt;code&gt;grafana.ini&lt;/code&gt; ni en el repositorio. Si lo despliegas en contenedores, cualquier opción se puede pasar también como variable de entorno: &lt;code&gt;GF_&lt;/code&gt; más la sección y la clave en mayúsculas, como &lt;code&gt;GF_AUTH_GENERIC_OAUTH_CLIENT_ID&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;use_pkce = true&lt;/code&gt;&lt;/strong&gt;: obligatorio, porque en Keycloak hemos exigido PKCE. Sin esto, Keycloak rechaza el inicio de sesión.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;role_attribute_path&lt;/code&gt;&lt;/strong&gt;: una expresión &lt;a href="https://jmespath.org/" target="_blank" rel="noopener"&gt;JMESPath&lt;/a&gt; que se evalúa sobre los datos del usuario y devuelve el rol de Grafana. Se lee de izquierda a derecha: si tiene &lt;code&gt;admin&lt;/code&gt;, &lt;code&gt;Admin&lt;/code&gt;; si no, si tiene &lt;code&gt;editor&lt;/code&gt;, &lt;code&gt;Editor&lt;/code&gt;; si no, si tiene &lt;code&gt;viewer&lt;/code&gt;, &lt;code&gt;Viewer&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;role_attribute_strict = true&lt;/code&gt;&lt;/strong&gt;: si la expresión no devuelve un rol válido, &lt;strong&gt;no se entra&lt;/strong&gt;. Junto con la expresión anterior, es lo que hace que solo accedan quienes tengan algún rol de Grafana. Quien no lo tenga verá el mensaje &lt;em&gt;«IdP did not return a role attribute, please contact your administrator»&lt;/em&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;oauth_auto_login = true&lt;/code&gt;&lt;/strong&gt;: quien entra en Grafana va directo a Keycloak, sin pasar por la pantalla de inicio de sesión de Grafana.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;signout_redirect_url&lt;/code&gt;&lt;/strong&gt;: al salir de Grafana también se cierra la sesión en Keycloak. Si no, al volver a entrar Keycloak te dejaría pasar sin pedir nada.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Los roles se sincronizan &lt;strong&gt;en cada inicio de sesión&lt;/strong&gt;: si cambias el rol de alguien en Keycloak, Grafana lo aplica la próxima vez que esa persona entre. Y no hace falta crear a nadie en Grafana: el usuario se da de alta solo la primera vez (&lt;code&gt;allow_sign_up&lt;/code&gt;).&lt;/p&gt;
&lt;h3 id="la-puerta-de-emergencia"&gt;La puerta de emergencia&lt;/h3&gt;
&lt;p&gt;Con &lt;code&gt;oauth_auto_login&lt;/code&gt;, la pantalla de inicio de sesión de Grafana desaparece. Pero si un día Keycloak se cae, necesitas poder entrar con el administrador local. Para eso está:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;https://grafana.example.com/login?disableAutoLogin=true
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Esa dirección muestra el formulario de usuario y contraseña de siempre. Guarda la contraseña del &lt;code&gt;admin&lt;/code&gt; local en tu gestor de secretos y no la uses para nada más.&lt;/p&gt;
&lt;h2 id="5-probarlo"&gt;5. Probarlo&lt;/h2&gt;
&lt;p&gt;Con tres usuarios de prueba, cada uno con un rol distinto, el resultado es este:&lt;/p&gt;
&lt;div class="tabla"&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Usuario&lt;/th&gt;
&lt;th&gt;Rol del cliente &lt;code&gt;grafana&lt;/code&gt; en Keycloak&lt;/th&gt;
&lt;th&gt;Rol en Grafana&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;ana&lt;/td&gt;
&lt;td&gt;&lt;code&gt;admin&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Admin&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;eva&lt;/td&gt;
&lt;td&gt;&lt;code&gt;editor&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Editor&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;luis&lt;/td&gt;
&lt;td&gt;&lt;code&gt;viewer&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;Viewer&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;luis, antes de asignarle &lt;code&gt;viewer&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;ninguno&lt;/td&gt;
&lt;td&gt;No puede entrar&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;&lt;p&gt;Si algo no cuadra, el registro de Grafana es bastante claro. Busca las líneas de &lt;code&gt;oauth.generic_oauth&lt;/code&gt;: ahí verás, por ejemplo, el aviso de que no se pudo extraer el rol.&lt;/p&gt;
&lt;h2 id="conclusión"&gt;Conclusión&lt;/h2&gt;
&lt;p&gt;Con un cliente en Keycloak, tres roles y una docena de líneas en el &lt;code&gt;grafana.ini&lt;/code&gt; tienes inicio de sesión único en Grafana, permisos gestionados desde un único sitio y ningún usuario local que mantener (salvo el de emergencia). Y lo mismo vale para el resto de herramientas que hablen OpenID Connect: una vez tienes Keycloak, cada aplicación nueva es un cliente más.&lt;/p&gt;</description></item><item><title>Quarkus backend sync y async</title><link>https://infraestructurasbigdatacloud.es/quarkus-backend-sync-async/</link><pubDate>Tue, 23 Sep 2025 00:00:00 +0000</pubDate><guid>https://infraestructurasbigdatacloud.es/quarkus-backend-sync-async/</guid><description>&lt;p&gt;&lt;em&gt;Supersonic Subatomic Java&lt;/em&gt;. Así se presenta Quarkus, y no es solo marketing: arranca en milisegundos, consume poca memoria y se compila a nativo sin despeinarse. Pero hay una pregunta que todo equipo se hace en cuanto empieza un servicio con Quarkus: &lt;strong&gt;¿lo escribo síncrono o asíncrono?&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;La respuesta corta es que Quarkus &lt;strong&gt;siempre es reactivo por dentro&lt;/strong&gt;, y lo que tú eliges es hasta dónde llega esa reactividad a tu código. En este artículo te cuento los modelos que tienes, del más sencillo al más exigente, con el mismo ejemplo en cada uno, y cuál elijo yo hoy.&lt;/p&gt;
&lt;p&gt;Los ejemplos son de Quarkus 3 con Java 21, usando &lt;strong&gt;Quarkus REST&lt;/strong&gt; (lo que antes se llamaba RESTEasy Reactive) y Panache sobre PostgreSQL.&lt;/p&gt;
&lt;h2 id="dos-tipos-de-hilos"&gt;Dos tipos de hilos&lt;/h2&gt;
&lt;p&gt;Para entender todo lo demás hay que entender esto. Por debajo, Quarkus se apoya en &lt;strong&gt;Vert.x&lt;/strong&gt;, que trabaja con dos tipos de hilos:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Hilos de E/S (&lt;em&gt;event loop&lt;/em&gt;)&lt;/strong&gt;: muy pocos, normalmente dos por núcleo. Cada uno atiende muchísimas peticiones a la vez, con una condición: &lt;strong&gt;no se pueden bloquear nunca&lt;/strong&gt;. Si uno se queda esperando a la base de datos, todas las peticiones que dependen de él se quedan esperando también.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Hilos de trabajo (&lt;em&gt;worker&lt;/em&gt;)&lt;/strong&gt;: un grupo mucho más grande, pensado para código que sí se bloquea (consultas JDBC, llamadas HTTP síncronas, ficheros&amp;hellip;). Cada petición ocupa un hilo mientras dura.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Con Quarkus REST, &lt;strong&gt;la firma del método decide en qué hilo se ejecuta&lt;/strong&gt;:&lt;/p&gt;
&lt;div class="mermaid"&gt;flowchart TD
peticion[&amp;#34;Petición HTTP&amp;#34;] --&amp;gt; eventloop[&amp;#34;Hilo de E/S (Vert.x)&amp;#34;]
eventloop --&amp;gt; decision{&amp;#34;¿Qué devuelve&amp;lt;br/&amp;gt;el método?&amp;#34;}
decision --&amp;gt;|&amp;#34;Uni / Multi&amp;#34;| reactivo[&amp;#34;Se queda en el hilo de E/S&amp;lt;br/&amp;gt;(no puede bloquear)&amp;#34;]
decision --&amp;gt;|&amp;#34;Un tipo normal&amp;#34;| worker[&amp;#34;Pasa a un hilo de trabajo&amp;lt;br/&amp;gt;(puede bloquear)&amp;#34;]
decision --&amp;gt;|&amp;#34;@RunOnVirtualThread&amp;#34;| virtual[&amp;#34;Pasa a un hilo virtual&amp;lt;br/&amp;gt;(puede bloquear, y es barato)&amp;#34;]
&lt;/div&gt;
&lt;p&gt;Puedes forzar el comportamiento con &lt;code&gt;@Blocking&lt;/code&gt; y &lt;code&gt;@NonBlocking&lt;/code&gt;, pero normalmente no hace falta: Quarkus acierta solo.&lt;/p&gt;
&lt;h2 id="1-síncrono-el-de-toda-la-vida"&gt;1. Síncrono: el de toda la vida&lt;/h2&gt;
&lt;p&gt;El ejemplo es actualizar una tarea: si existe, cambiamos sus campos y devolvemos un 204; si no, un 404. Con la extensión &lt;code&gt;quarkus-hibernate-orm-panache&lt;/code&gt; (bloqueante):&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-java" data-lang="java"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@Entity&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kd"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;Tarea&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kd"&gt;extends&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;PanacheEntity&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="c1"&gt;// io.quarkus.hibernate.orm.panache&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;String&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;nombre&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Integer&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;duracion&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-java" data-lang="java"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@Path&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;/tareas&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@Consumes&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;MediaType&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;APPLICATION_JSON&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kd"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;TareaResource&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nd"&gt;@PUT&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nd"&gt;@Path&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;{id}&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nd"&gt;@Transactional&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nf"&gt;actualizar&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nd"&gt;@PathParam&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;id&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Long&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Tarea&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;tarea&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Tarea&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;existente&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Tarea&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;findById&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;if&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;existente&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;==&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;status&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;Response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;Status&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;NOT_FOUND&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="na"&gt;build&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;existente&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;nombre&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;tarea&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;nombre&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;existente&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;duracion&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;tarea&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;duracion&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;noContent&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="na"&gt;build&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Se lee de arriba abajo, se depura con puntos de ruptura normales y las trazas de error dicen exactamente dónde ha fallado. Como devuelve un tipo normal (&lt;code&gt;Response&lt;/code&gt;), Quarkus lo ejecuta en un hilo de trabajo y puede bloquearse esperando a la base de datos sin molestar a nadie.&lt;/p&gt;
&lt;p&gt;Fíjate en un detalle: aunque tu código sea síncrono, &lt;strong&gt;la capa HTTP de Quarkus sigue siendo reactiva&lt;/strong&gt;. La petición entra por el &lt;em&gt;event loop&lt;/em&gt; y solo tu método pasa a un hilo de trabajo. En mis notas lo llamaba «&lt;em&gt;half async&lt;/em&gt;»: es lo que tienes por defecto, y es la razón de que Quarkus rinda bien incluso con código bloqueante.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;El límite&lt;/strong&gt; es el número de hilos de trabajo. Por defecto, el grupo crece hasta el mayor de 200 u 8 por núcleo. Si cada petición pasa medio segundo esperando a otro servicio, con 200 hilos no atiendes más de 400 peticiones por segundo, por mucha CPU libre que tengas.&lt;/p&gt;
&lt;h2 id="2-asíncrono-del-todo-mutiny-y-hibernate-reactive"&gt;2. Asíncrono del todo: Mutiny y Hibernate Reactive&lt;/h2&gt;
&lt;p&gt;El modelo «&lt;em&gt;full async&lt;/em&gt;» lleva la reactividad hasta la base de datos. Cambias a &lt;code&gt;quarkus-hibernate-reactive-panache&lt;/code&gt; y al cliente reactivo de PostgreSQL, y tu método deja de devolver un resultado para devolver &lt;strong&gt;la promesa de un resultado&lt;/strong&gt;, un &lt;code&gt;Uni&lt;/code&gt; de &lt;a href="https://smallrye.io/smallrye-mutiny/" target="_blank" rel="noopener"&gt;Mutiny&lt;/a&gt;:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-java" data-lang="java"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@Entity&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kd"&gt;class&lt;/span&gt; &lt;span class="nc"&gt;Tarea&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kd"&gt;extends&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;PanacheEntity&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="c1"&gt;// io.quarkus.hibernate.reactive.panache&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;String&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;nombre&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Integer&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;duracion&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-java" data-lang="java"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@PUT&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@Path&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;{id}&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@WithTransaction&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Uni&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;Response&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nf"&gt;actualizar&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nd"&gt;@PathParam&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;id&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Long&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Tarea&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;tarea&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Tarea&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;Tarea&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;findById&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;map&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;existente&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;if&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;existente&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;==&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;status&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;Response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;Status&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;NOT_FOUND&lt;/span&gt;&lt;span class="p"&gt;).&lt;/span&gt;&lt;span class="na"&gt;build&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;existente&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;nombre&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;tarea&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;nombre&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;existente&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;duracion&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;tarea&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;duracion&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Response&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;noContent&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="na"&gt;build&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;});&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Aquí &lt;strong&gt;ningún hilo espera nunca&lt;/strong&gt;: el &lt;em&gt;event loop&lt;/em&gt; lanza la consulta, se va a atender otras peticiones y, cuando PostgreSQL responde, retoma el &lt;code&gt;map&lt;/code&gt;. Con un puñado de hilos atiendes miles de peticiones concurrentes y con muy poca memoria.&lt;/p&gt;
&lt;p&gt;Si vienes de versiones anteriores, verás código con &lt;code&gt;@ReactiveTransactional&lt;/code&gt; o con &lt;code&gt;Panache.withTransaction(...)&lt;/code&gt; (como el de la imagen de este artículo). En Quarkus 3 lo habitual es la anotación &lt;code&gt;@WithTransaction&lt;/code&gt;, que deja el código mucho más limpio.&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;El precio&lt;/strong&gt;: el código se escribe como una cadena de transformaciones, las trazas de error son menos claras, depurar cuesta más y todo lo que toques tiene que ser reactivo. Y eso nos lleva al error más común.&lt;/p&gt;
&lt;h2 id="3-el-error-clásico-bloquear-el-event-loop"&gt;3. El error clásico: bloquear el &lt;em&gt;event loop&lt;/em&gt;&lt;/h2&gt;
&lt;p&gt;Mezclar los dos mundos sin cuidado es la forma más rápida de tener un servicio lento con un modelo «rápido». Esto, por ejemplo, está mal:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-java" data-lang="java"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@GET&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Uni&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;String&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nf"&gt;informe&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;String&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;datos&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;clienteLento&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;consultar&lt;/span&gt;&lt;span class="p"&gt;();&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="c1"&gt;// llamada bloqueante... en el hilo de E/S&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Uni&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;createFrom&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="na"&gt;item&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;datos&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Como devuelve un &lt;code&gt;Uni&lt;/code&gt;, se ejecuta en el &lt;em&gt;event loop&lt;/em&gt;, y la llamada bloqueante lo congela. Vert.x te avisará en el registro con un &lt;code&gt;Thread vert.x-eventloop-thread-0 has been blocked for ...&lt;/code&gt;, y en algunos casos (como usar Hibernate ORM bloqueante) Quarkus directamente se negará con una excepción. Tienes dos salidas:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-java" data-lang="java"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// a) Decirle a Quarkus que este método bloquea: se ejecutará en un hilo de trabajo&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@GET&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@Blocking&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Uni&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;String&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nf"&gt;informe&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;...&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// b) Sacar solo la parte bloqueante a un hilo de trabajo y seguir siendo reactivo&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@GET&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Uni&lt;/span&gt;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;String&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nf"&gt;informe&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="k"&gt;return&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Uni&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;createFrom&lt;/span&gt;&lt;span class="p"&gt;().&lt;/span&gt;&lt;span class="na"&gt;item&lt;/span&gt;&lt;span class="p"&gt;(()&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;clienteLento&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;consultar&lt;/span&gt;&lt;span class="p"&gt;())&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;runSubscriptionOn&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;Infrastructure&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="na"&gt;getDefaultWorkerPool&lt;/span&gt;&lt;span class="p"&gt;());&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;La regla es sencilla: &lt;strong&gt;si devuelves &lt;code&gt;Uni&lt;/code&gt; o &lt;code&gt;Multi&lt;/code&gt;, no bloquees nunca&lt;/strong&gt;.&lt;/p&gt;
&lt;h2 id="4-hilos-virtuales-lo-mejor-de-los-dos-mundos-casi"&gt;4. Hilos virtuales: lo mejor de los dos mundos (casi)&lt;/h2&gt;
&lt;p&gt;Desde Java 21 hay una tercera vía, y es la que más ha cambiado mi recomendación. Los &lt;strong&gt;hilos virtuales&lt;/strong&gt; son hilos que gestiona la JVM, no el sistema operativo: cuestan muy poco y cuando uno se bloquea esperando E/S, libera el hilo real para otro. Puedes tener cientos de miles.&lt;/p&gt;
&lt;p&gt;En Quarkus se activan con una anotación sobre &lt;strong&gt;el mismo código síncrono&lt;/strong&gt; del principio:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-java" data-lang="java"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@PUT&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@Path&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;{id}&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@Transactional&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nd"&gt;@RunOnVirtualThread&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;public&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Response&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nf"&gt;actualizar&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nd"&gt;@PathParam&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s"&gt;&amp;#34;id&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Long&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;Tarea&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="n"&gt;tarea&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="c1"&gt;// exactamente el mismo código que la versión síncrona&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Código sencillo de leer y depurar, y una capacidad de concurrencia cercana a la del modelo reactivo. Pero hay que conocer sus trampas:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;El cuello de botella se muda a la base de datos.&lt;/strong&gt; Los hilos virtuales no crean conexiones: si el &lt;em&gt;pool&lt;/em&gt; tiene 20, solo 20 peticiones consultan a la vez y el resto espera su turno. Dimensiona el &lt;em&gt;pool&lt;/em&gt; (y lo que aguante tu PostgreSQL) en consecuencia.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;El anclaje (&lt;em&gt;pinning&lt;/em&gt;).&lt;/strong&gt; En Java 21, un hilo virtual que se bloquea dentro de un bloque &lt;code&gt;synchronized&lt;/code&gt; se queda «anclado» al hilo real y pierde la ventaja. Java 24 lo resolvió, pero si estás en 21, vigila las bibliotecas que uses.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;No los metas en un &lt;em&gt;pool&lt;/em&gt;&lt;/strong&gt; ni guardes cosas caras en &lt;code&gt;ThreadLocal&lt;/code&gt;: están pensados para crearse y tirarse uno por tarea.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="comparativa"&gt;Comparativa&lt;/h2&gt;
&lt;div class="tabla"&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;&lt;/th&gt;
&lt;th&gt;Síncrono&lt;/th&gt;
&lt;th&gt;Asíncrono (Mutiny)&lt;/th&gt;
&lt;th&gt;Hilos virtuales&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Hilo donde corre tu código&lt;/td&gt;
&lt;td&gt;De trabajo&lt;/td&gt;
&lt;td&gt;De E/S&lt;/td&gt;
&lt;td&gt;Virtual&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Persistencia&lt;/td&gt;
&lt;td&gt;Hibernate ORM&lt;/td&gt;
&lt;td&gt;Hibernate Reactive&lt;/td&gt;
&lt;td&gt;Hibernate ORM&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Facilidad de escritura y depuración&lt;/td&gt;
&lt;td&gt;Alta&lt;/td&gt;
&lt;td&gt;Baja&lt;/td&gt;
&lt;td&gt;Alta&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Peticiones concurrentes&lt;/td&gt;
&lt;td&gt;Limitadas por los hilos de trabajo&lt;/td&gt;
&lt;td&gt;Muy altas&lt;/td&gt;
&lt;td&gt;Muy altas (limitadas por el &lt;em&gt;pool&lt;/em&gt; de conexiones)&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Memoria por petición&lt;/td&gt;
&lt;td&gt;Alta (un hilo del sistema)&lt;/td&gt;
&lt;td&gt;Mínima&lt;/td&gt;
&lt;td&gt;Baja&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Riesgo típico&lt;/td&gt;
&lt;td&gt;Agotar los hilos de trabajo&lt;/td&gt;
&lt;td&gt;Bloquear el &lt;em&gt;event loop&lt;/em&gt;&lt;/td&gt;
&lt;td&gt;Anclaje y &lt;em&gt;pool&lt;/em&gt; de conexiones&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;&lt;h2 id="cuál-elijo"&gt;¿Cuál elijo?&lt;/h2&gt;
&lt;p&gt;Mi criterio, a día de hoy:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Empieza síncrono.&lt;/strong&gt; Para la gran mayoría de servicios (un CRUD, una API interna, un &lt;em&gt;backend&lt;/em&gt; de gestión), el modelo bloqueante de Quarkus rinde de sobra y es el más fácil de mantener por cualquier persona del equipo.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Si te quedas corto de concurrencia&lt;/strong&gt; porque pasas mucho tiempo esperando a otros servicios o a la base de datos, añade &lt;code&gt;@RunOnVirtualThread&lt;/code&gt; donde haga falta antes de reescribir nada.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Ve a reactivo del todo&lt;/strong&gt; cuando de verdad lo aproveches: &lt;em&gt;streaming&lt;/em&gt; (&lt;code&gt;Multi&lt;/code&gt;, SSE, WebSockets), mensajería con Kafka, composición de muchas llamadas en paralelo, o servicios que tienen que exprimir al máximo muy poca memoria. Y solo si el equipo conoce Mutiny.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Lo que no recomiendo es elegir el modelo reactivo «porque es más rápido»: con un equipo que no lo domina, acabas con un &lt;em&gt;event loop&lt;/em&gt; bloqueado y un servicio más lento y más difícil de depurar que su versión síncrona.&lt;/p&gt;
&lt;h2 id="conclusión"&gt;Conclusión&lt;/h2&gt;
&lt;p&gt;Con Quarkus no hay que elegir entre sencillez y rendimiento de forma tan drástica como antes: la capa HTTP ya es reactiva aunque tú escribas código síncrono, y los hilos virtuales te dan concurrencia alta sin cambiar de paradigma. El modelo reactivo completo sigue siendo la mejor herramienta para &lt;em&gt;streaming&lt;/em&gt; y mensajería, pero ya no es la única forma de escalar.&lt;/p&gt;</description></item><item><title>curl para todo</title><link>https://infraestructurasbigdatacloud.es/curl-para-todo/</link><pubDate>Tue, 14 Jan 2025 00:00:00 +0000</pubDate><guid>https://infraestructurasbigdatacloud.es/curl-para-todo/</guid><description>&lt;p&gt;Si trabajas con sistemas, usas curl. Aunque no lo sepas: además de la herramienta de línea de comandos, está &lt;strong&gt;libcurl&lt;/strong&gt;, la biblioteca que llevan dentro coches, televisores, routers, impresoras, consolas y una cantidad absurda de programas. El propio proyecto habla de &lt;strong&gt;más de veinte mil millones de instalaciones&lt;/strong&gt;, y su autor, Daniel Stenberg, contaba a finales de 2022 que &lt;a href="https://daniel.haxx.se/blog/2022/11/25/89-operating-systems/" target="_blank" rel="noopener"&gt;curl funcionaba en 89 sistemas operativos&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;El nombre es un juego de palabras: &lt;em&gt;client for URLs&lt;/em&gt;, que en inglés también se lee &lt;em&gt;see URL&lt;/em&gt; («ver URL»). Y eso es lo que hace: hablar con cualquier cosa que tenga una URL. Nació en 1998 (venía de herramientas anteriores, &lt;code&gt;httpget&lt;/code&gt; y &lt;code&gt;urlget&lt;/code&gt;) y hoy entiende HTTP en todas sus versiones, FTP, SFTP, SMTP, IMAP, MQTT, LDAP y unos cuantos protocolos más.&lt;/p&gt;
&lt;p&gt;Casi todo el mundo lo usa para descargar un fichero y poco más. En este artículo te cuento cómo lo uso yo a diario, de lo básico a lo que menos gente conoce.&lt;/p&gt;
&lt;h2 id="lo-básico-bien-hecho"&gt;Lo básico, bien hecho&lt;/h2&gt;
&lt;p&gt;Para descargar algo en un script, esta es la combinación que uso siempre:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl -fsSL -o instalar.sh https://example.com/instalar.sh
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;
&lt;li&gt;&lt;code&gt;-f&lt;/code&gt; (&lt;code&gt;--fail&lt;/code&gt;): si el servidor responde con un error (404, 500&amp;hellip;), curl termina con error en lugar de guardarte la página de error como si fuera el fichero.&lt;/li&gt;
&lt;li&gt;&lt;code&gt;-sS&lt;/code&gt;: silencioso, sin barra de progreso, pero mostrando los errores si los hay.&lt;/li&gt;
&lt;li&gt;&lt;code&gt;-L&lt;/code&gt;: sigue las redirecciones.&lt;/li&gt;
&lt;li&gt;&lt;code&gt;-o fichero&lt;/code&gt;: guarda en ese fichero (con &lt;code&gt;-O&lt;/code&gt; usa el nombre del fichero remoto).&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Y ya que estamos: &lt;strong&gt;no hagas &lt;code&gt;curl ... | sh&lt;/code&gt;&lt;/strong&gt; con algo que no has leído. Descárgalo, léelo y ejecútalo después. Ahorra sustos.&lt;/p&gt;
&lt;h2 id="ver-qué-está-pasando-de-verdad"&gt;Ver qué está pasando de verdad&lt;/h2&gt;
&lt;p&gt;Cuando algo falla con HTTP, lo primero es mirar la conversación entera:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl -v https://example.com/
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Con &lt;code&gt;-v&lt;/code&gt; ves la resolución DNS, la conexión, la negociación TLS, las cabeceras que envías y las que recibes. Si necesitas todavía más detalle, &lt;code&gt;--trace-ascii traza.txt&lt;/code&gt; vuelca todo lo que entra y sale.&lt;/p&gt;
&lt;p&gt;Para ver &lt;strong&gt;solo las cabeceras de respuesta&lt;/strong&gt; de una petición GET normal (con &lt;code&gt;-I&lt;/code&gt; se hace una petición HEAD, que algunos servidores tratan distinto):&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl -sS -D - -o /dev/null https://example.com/
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Es mi forma rápida de comprobar cabeceras de seguridad, como la política de seguridad de contenidos o HSTS:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl -sS -D - -o /dev/null https://example.com/ &lt;span class="p"&gt;|&lt;/span&gt; grep -i -E &lt;span class="s1"&gt;&amp;#39;strict-transport|content-security&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="dónde-se-va-el-tiempo"&gt;¿Dónde se va el tiempo?&lt;/h3&gt;
&lt;p&gt;&lt;code&gt;-w&lt;/code&gt; (&lt;code&gt;--write-out&lt;/code&gt;) imprime variables al terminar la petición. Mi favorita es el desglose de tiempos:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl -sS -o /dev/null -w &lt;span class="s1"&gt;&amp;#39;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s1"&gt; DNS: %{time_namelookup}s
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s1"&gt; conexión: %{time_connect}s
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s1"&gt; TLS: %{time_appconnect}s
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s1"&gt; 1.er byte: %{time_starttransfer}s
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s1"&gt; total: %{time_total}s
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s1"&gt; código: %{http_code}
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="s1"&gt;&amp;#39;&lt;/span&gt; https://example.com/
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Los tiempos son acumulados desde el inicio. Si el DNS ya se lleva medio segundo, el problema no está en tu aplicación; si la diferencia grande está entre TLS y el primer byte, es el servidor el que tarda en responder.&lt;/p&gt;
&lt;h2 id="probar-un-servidor-antes-de-cambiar-el-dns"&gt;Probar un servidor antes de cambiar el DNS&lt;/h2&gt;
&lt;p&gt;Esta es la que más tiempo me ha ahorrado en migraciones. Has montado el servidor nuevo, pero el DNS sigue apuntando al viejo. ¿Cómo lo pruebas &lt;strong&gt;con su nombre real y su certificado real&lt;/strong&gt;, sin tocar el &lt;code&gt;/etc/hosts&lt;/code&gt;?&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl --resolve example.com:443:203.0.113.10 https://example.com/
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;--resolve&lt;/code&gt; le dice a curl que, para &lt;code&gt;example.com&lt;/code&gt; en el puerto 443, use esa IP. Todo lo demás (la cabecera &lt;code&gt;Host&lt;/code&gt;, el SNI de TLS, la validación del certificado) va como si el DNS ya estuviera cambiado. Si quieres apuntar a otro nombre en lugar de a una IP, tienes &lt;code&gt;--connect-to&lt;/code&gt;:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl --connect-to example.com:443:servidor-nuevo.example.net:443 https://example.com/
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="certificados"&gt;Certificados&lt;/h2&gt;
&lt;p&gt;Para ver rápidamente quién emitió un certificado y cuándo caduca:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl -sSv -o /dev/null https://example.com/ 2&amp;gt;&lt;span class="p"&gt;&amp;amp;&lt;/span&gt;&lt;span class="m"&gt;1&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; grep -E &lt;span class="s1"&gt;&amp;#39;subject:|issuer:|expire date:&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Si el certificado no es válido, curl se niega a seguir, y hace bien. La opción &lt;code&gt;-k&lt;/code&gt; (&lt;code&gt;--insecure&lt;/code&gt;) se salta esa comprobación: úsala solo para diagnosticar y nunca en un script. Si el problema es que el servidor usa una CA propia, dile a curl cuál es con &lt;code&gt;--cacert ca.crt&lt;/code&gt; (en &lt;a href="https://infraestructurasbigdatacloud.es/openssl-basics/"&gt;OpenSSL básico&lt;/a&gt; y &lt;a href="https://infraestructurasbigdatacloud.es/easyrsa/"&gt;EasyRSA&lt;/a&gt; tienes cómo crearlas).&lt;/p&gt;
&lt;h2 id="hablar-con-apis"&gt;Hablar con APIs&lt;/h2&gt;
&lt;p&gt;Desde la versión 7.82, &lt;code&gt;--json&lt;/code&gt; hace en una sola opción lo que antes eran tres: envía el cuerpo por POST y pone las cabeceras &lt;code&gt;Content-Type&lt;/code&gt; y &lt;code&gt;Accept&lt;/code&gt; a &lt;code&gt;application/json&lt;/code&gt;:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl --fail-with-body --json &lt;span class="s1"&gt;&amp;#39;{&amp;#34;nombre&amp;#34;: &amp;#34;Ana&amp;#34;, &amp;#34;rol&amp;#34;: &amp;#34;admin&amp;#34;}&amp;#39;&lt;/span&gt; https://api.example.com/usuarios
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;--fail-with-body&lt;/code&gt; es como &lt;code&gt;-f&lt;/code&gt;, pero te muestra el cuerpo de la respuesta de error, que en una API suele traer el motivo. Con &lt;code&gt;--json @fichero.json&lt;/code&gt; lee el cuerpo de un fichero, y con &lt;code&gt;--json @-&lt;/code&gt; de la entrada estándar.&lt;/p&gt;
&lt;p&gt;Para los parámetros de la URL, &lt;code&gt;--url-query&lt;/code&gt; se encarga de codificarlos por ti:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl --url-query &lt;span class="s2"&gt;&amp;#34;q=podman compose&amp;#34;&lt;/span&gt; --url-query &lt;span class="s2"&gt;&amp;#34;pagina=2&amp;#34;&lt;/span&gt; https://api.example.com/buscar
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Y, combinado con &lt;code&gt;jq&lt;/code&gt;, tienes un cliente de API en una línea:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl -fsS https://api.example.com/usuarios &lt;span class="p"&gt;|&lt;/span&gt; jq -r &lt;span class="s1"&gt;&amp;#39;.[] | select(.rol == &amp;#34;admin&amp;#34;) | .nombre&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="los-secretos-fuera-de-la-línea-de-comandos"&gt;Los secretos, fuera de la línea de comandos&lt;/h3&gt;
&lt;p&gt;Cuidado con esto: &lt;strong&gt;todo lo que pones en la línea de comandos lo puede ver cualquier usuario de la máquina&lt;/strong&gt; con &lt;code&gt;ps&lt;/code&gt;, y además acaba en el historial de la terminal. Así que nada de &lt;code&gt;-H &amp;quot;Authorization: Bearer eyJ...&amp;quot;&lt;/code&gt; a pelo. Dos alternativas:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 1. Cabeceras desde un fichero (con permisos 600)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl -H @cabeceras.txt https://api.example.com/
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 2. Variables (desde curl 8.3): %TOKEN importa la variable de entorno TOKEN&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl --variable %TOKEN --expand-header &lt;span class="s2"&gt;&amp;#34;Authorization: Bearer {{TOKEN}}&amp;#34;&lt;/span&gt; https://api.example.com/
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Para usuario y contraseña, lo mismo: mejor un fichero &lt;code&gt;.netrc&lt;/code&gt; con &lt;code&gt;--netrc-file&lt;/code&gt; que &lt;code&gt;-u usuario:contraseña&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id="vigilar-un-servicio"&gt;Vigilar un servicio&lt;/h2&gt;
&lt;p&gt;curl es, también, el sistema de monitorización más sencillo que existe. Esto comprueba que una web responde en menos de 10 segundos, reintenta dos veces ante cualquier fallo y termina con error si no lo consigue:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl -fsS --max-time &lt;span class="m"&gt;10&lt;/span&gt; --retry &lt;span class="m"&gt;2&lt;/span&gt; --retry-all-errors -o /dev/null https://miapp.example.com/salud &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;miapp no responde&amp;#34;&lt;/span&gt; &lt;span class="p"&gt;|&lt;/span&gt; systemd-cat -p err -t vigilancia
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Mételo en un temporizador de systemd y ya tienes una vigilancia básica (aunque, como cuento en &lt;a href="https://infraestructurasbigdatacloud.es/arquitectura-simple/"&gt;Arquitectura de contenedores simple&lt;/a&gt;, lo ideal es vigilar también desde fuera de la máquina).&lt;/p&gt;
&lt;h2 id="y-ahora-lo-que-casi-nadie-sabe-que-hace"&gt;Y ahora, lo que casi nadie sabe que hace&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;Descargas en paralelo y con patrones.&lt;/strong&gt; Los corchetes generan secuencias y &lt;code&gt;-Z&lt;/code&gt; descarga en paralelo:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl -Z -O &lt;span class="s2"&gt;&amp;#34;https://example.com/imagenes/foto[01-20].webp&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;strong&gt;Enviar correo.&lt;/strong&gt; curl habla SMTP, así que un script puede mandar un aviso sin instalar nada más:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl --ssl-reqd smtps://smtp.example.com:465 &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --netrc-file ~/.netrc-smtp &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --mail-from avisos@example.com &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; --mail-rcpt yo@example.com &lt;span class="se"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; -T mensaje.txt
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Donde &lt;code&gt;mensaje.txt&lt;/code&gt; es el correo tal cual, con sus cabeceras:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;From: Avisos &amp;lt;avisos@example.com&amp;gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;To: &amp;lt;yo@example.com&amp;gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;Subject: La copia de seguridad ha fallado
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;Revisa el servidor, que la copia de esta noche no ha terminado.
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;strong&gt;Subir ficheros&lt;/strong&gt; por FTP o SFTP con &lt;code&gt;-T&lt;/code&gt;, &lt;strong&gt;leer ficheros locales&lt;/strong&gt; con &lt;code&gt;file://&lt;/code&gt;, o &lt;strong&gt;consultar un diccionario&lt;/strong&gt; con el protocolo DICT:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;curl dict://dict.org/d:curl
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Para saber qué protocolos y funciones trae tu curl (depende de cómo se compiló), mira la salida de &lt;code&gt;curl -V&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id="conclusión"&gt;Conclusión&lt;/h2&gt;
&lt;p&gt;curl está instalado en prácticamente todas las máquinas que vas a tocar, y eso lo convierte en la herramienta de diagnóstico más universal que tienes. Merece la pena dedicarle una tarde a &lt;code&gt;curl --help all&lt;/code&gt; o al manual (&lt;code&gt;man curl&lt;/code&gt;): cada vez que lo hago descubro una opción que me ahorra un script entero.&lt;/p&gt;</description></item><item><title>Arquitectura de contenedores simple</title><link>https://infraestructurasbigdatacloud.es/arquitectura-simple/</link><pubDate>Tue, 15 Oct 2024 00:00:00 +0000</pubDate><guid>https://infraestructurasbigdatacloud.es/arquitectura-simple/</guid><description>&lt;p&gt;Cada vez que enseño una arquitectura de un solo servidor con contenedores, sea físico o virtual, alguien la mira por encima del hombro y suelta: «eso está bien para desarrollo, pero no es producción».&lt;/p&gt;
&lt;p&gt;Vamos a bajar la velocidad.&lt;/p&gt;
&lt;p&gt;Si llevas años trabajando con clústeres repartidos en varias zonas, replicación, autoescalado y CDN delante, es normal que una máquina con un puñado de contenedores te parezca un juguete. Pero &lt;strong&gt;producción no es una cantidad de nodos: es el entorno que da servicio real a quien lo usa&lt;/strong&gt;. Y una pyme de diez personas con su web, su ERP ligero o su aplicación interna no necesita, ni puede pagar, ni sabría mantener, la complejidad de un Kubernetes multizona.&lt;/p&gt;
&lt;p&gt;Lo que sí necesita es que el servicio esté bien hecho: que se actualice, que tenga copias de seguridad que se puedan restaurar, que avise cuando algo falla y que se pueda reconstruir desde cero en poco tiempo. Eso no depende del número de máquinas.&lt;/p&gt;
&lt;h2 id="qué-le-pedimos-a-producción"&gt;¿Qué le pedimos a producción?&lt;/h2&gt;
&lt;p&gt;Antes de dibujar nada, conviene poner números. Las preguntas que importan son las de siempre, el &lt;a href="https://infraestructurasbigdatacloud.es/rto-rpo/"&gt;RTO y el RPO&lt;/a&gt;:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;¿Cuánto tiempo puede estar caído el servicio?&lt;/strong&gt; Si la respuesta es «una o dos horas un par de veces al año, y mejor de noche», una sola máquina te vale.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;¿Cuántos datos puedes permitirte perder?&lt;/strong&gt; Si una copia cada hora o cada noche es suficiente, no necesitas réplicas síncronas.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;¿Cuánta carga hay?&lt;/strong&gt; Un servidor modesto de 4 núcleos y 16 GB sirve sin despeinarse a miles de usuarios de una aplicación de gestión.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Si tus respuestas van por ahí, sigue leyendo. Si te piden un 99,99 % o miles de peticiones por segundo con picos imprevisibles, este no es tu artículo (aunque al final te cuento cómo crecer).&lt;/p&gt;
&lt;h2 id="la-arquitectura"&gt;La arquitectura&lt;/h2&gt;
&lt;div class="mermaid"&gt;flowchart TB
usuarios[&amp;#34;Usuarios&amp;#34;] --&amp;gt;|HTTPS| proxy
vigilancia[&amp;#34;Vigilancia externa&amp;#34;] -.-&amp;gt;|comprueba| proxy
subgraph vm[&amp;#34;Servidor Linux (físico o virtual)&amp;#34;]
proxy[&amp;#34;Proxy inverso&amp;lt;br/&amp;gt;TLS automático&amp;#34;] --&amp;gt; app[&amp;#34;Aplicación&amp;lt;br/&amp;gt;(contenedores)&amp;#34;]
app --&amp;gt; bd[(&amp;#34;Base de datos&amp;#34;)]
copias[&amp;#34;Copias de seguridad&amp;#34;] -.-&amp;gt; bd
end
codigo[&amp;#34;Git: OpenTofu + Ansible&amp;#34;] --&amp;gt;|crea y configura| vm
copias --&amp;gt;|cifradas| externo[(&amp;#34;Almacenamiento externo&amp;#34;)]
&lt;/div&gt;
&lt;p&gt;Pocas piezas, y cada una con un único trabajo:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Un servidor físico o una máquina virtual&lt;/strong&gt; con una distribución Linux de soporte largo.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Podman y &lt;code&gt;podman-compose&lt;/code&gt;&lt;/strong&gt;, gobernados por systemd, que arrancan los servicios con la máquina y los levantan si se caen.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Un proxy inverso&lt;/strong&gt; que es lo único expuesto a internet y que se encarga de los certificados.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;La aplicación y su base de datos&lt;/strong&gt;, cada una en su contenedor, con los datos en volúmenes.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Copias de seguridad&lt;/strong&gt; que salen de la máquina.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Vigilancia desde fuera&lt;/strong&gt;, para enterarte tú antes que tus usuarios.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Todo descrito como código&lt;/strong&gt;, para poder reconstruirlo.&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Vamos por partes.&lt;/p&gt;
&lt;h2 id="1-la-máquina-un-servidor-físico-o-una-máquina-virtual"&gt;1. La máquina: un servidor físico o una máquina virtual&lt;/h2&gt;
&lt;p&gt;Todo lo que viene a continuación (Podman, el proxy, las copias&amp;hellip;) se instala exactamente igual en &lt;strong&gt;un servidor físico&lt;/strong&gt; que en &lt;strong&gt;una máquina virtual&lt;/strong&gt;. Elige la que encaje con tu empresa:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Un servidor físico&lt;/strong&gt; es el caso más habitual en una pyme: el servidor del armario de la oficina o uno alquilado en un centro de datos. No pagas cuota mensual por capacidad y todo el rendimiento es tuyo, pero el hardware es cosa tuya: &lt;strong&gt;discos en RAID 1&lt;/strong&gt; (o sin RAID si quieres lo más simple: con buenas copias, un disco roto es una restauración, no un desastre), un &lt;strong&gt;SAI&lt;/strong&gt; que aguante los cortes de luz y apague el servidor de forma ordenada, gestión remota fuera de banda (IPMI o similar), que es recomendable para reiniciarlo o reinstalarlo sin desplazarte aunque no imprescindible, y, si puedes, garantía con reposición en el siguiente día laborable. Si está en la oficina, necesitarás una IP fija o un túnel para publicarlo.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Una máquina virtual&lt;/strong&gt;, en un proveedor o en tu propio hipervisor (Proxmox, por ejemplo), te quita de encima el hardware y te da instantáneas y la posibilidad de crecer en minutos, a cambio de una cuota o de mantener el hipervisor.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;En los dos casos, nada exótico: Debian, Ubuntu LTS o una derivada de RHEL. Lo importante es lo que le haces encima:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Actualizaciones de seguridad automáticas&lt;/strong&gt; (&lt;code&gt;unattended-upgrades&lt;/code&gt; en Debian/Ubuntu, &lt;code&gt;dnf-automatic&lt;/code&gt; en la familia RHEL), con reinicio programado en la ventana que acuerdes.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;SSH solo con claves&lt;/strong&gt;, sin acceso de &lt;code&gt;root&lt;/code&gt; y, si puedes, abierto únicamente desde tu IP o tras una VPN.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Cortafuegos&lt;/strong&gt; que solo deja pasar 80 y 443 desde internet.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Disco de datos separado del disco del sistema&lt;/strong&gt; (un segundo disco, o un par en RAID 1, en el servidor físico; un disco adicional en la máquina virtual): si hay que reinstalar el sistema, los datos no van con él.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="2-los-contenedores"&gt;2. Los contenedores&lt;/h2&gt;
&lt;p&gt;Aquí está la gracia: la aplicación queda empaquetada y versionada, y la máquina no tiene que saber nada de ella. Uso &lt;strong&gt;Podman&lt;/strong&gt;, que no necesita ningún demonio corriendo, con &lt;strong&gt;&lt;code&gt;podman-compose&lt;/code&gt;&lt;/strong&gt;, que entiende el mismo formato &lt;code&gt;compose.yaml&lt;/code&gt; que conoce todo el mundo. Quien venga de Docker no tiene que aprender nada nuevo.&lt;/p&gt;
&lt;p&gt;Un &lt;code&gt;compose.yaml&lt;/code&gt; para una aplicación web con PostgreSQL quedaría así:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;services&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;proxy&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;image&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;docker.io/library/caddy:2.8-alpine&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;restart&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;unless-stopped&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;ports&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="s2"&gt;&amp;#34;80:80&amp;#34;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="s2"&gt;&amp;#34;443:443&amp;#34;&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;volumes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;./Caddyfile:/etc/caddy/Caddyfile:ro,Z&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;caddy-datos:/data&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;depends_on&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;app&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;app&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;image&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;registro.ejemplo.es/miapp:1.4.2&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;restart&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;unless-stopped&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;environment&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;DATABASE_URL&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;postgres://miapp@bd:5432/miapp&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;env_file&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;.env &lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="c"&gt;# secretos fuera del repositorio&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;depends_on&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;bd&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;condition&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;service_healthy&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;deploy&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;resources&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;limits&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;memory&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;2g&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;bd&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;image&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;docker.io/library/postgres:17.0-alpine&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;restart&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;unless-stopped&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;env_file&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;.env&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;volumes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;bd-datos:/var/lib/postgresql/data&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;healthcheck&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;test&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;CMD-SHELL&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;pg_isready -U miapp&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;interval&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;10s&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;retries&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="m"&gt;5&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;volumes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;caddy-datos&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;bd-datos&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Fíjate en varias cosas:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Solo el proxy publica puertos.&lt;/strong&gt; La aplicación y la base de datos solo se ven dentro de la red del proyecto.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Nombres de imagen completos&lt;/strong&gt; (&lt;code&gt;docker.io/library/...&lt;/code&gt;): Podman no adivina el registro, y así no hay sorpresas sobre de dónde viene cada imagen.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Imágenes con versión concreta&lt;/strong&gt;, nunca &lt;code&gt;latest&lt;/code&gt; (ya te conté por qué en &lt;a href="https://infraestructurasbigdatacloud.es/7-consejos-containerfiles/"&gt;7 consejos para escribir Containerfiles&lt;/a&gt;).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;restart: unless-stopped&lt;/code&gt;&lt;/strong&gt;: si un proceso muere, Podman lo vuelve a levantar. Del arranque de la máquina se encarga systemd, como verás ahora.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;:Z&lt;/code&gt; en el montaje del &lt;code&gt;Caddyfile&lt;/code&gt;&lt;/strong&gt;: en distribuciones con SELinux (la familia RHEL) etiqueta el fichero para que el contenedor pueda leerlo; donde no hay SELinux, se ignora.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;healthcheck&lt;/code&gt; y límites de memoria&lt;/strong&gt;: la aplicación no arranca hasta que la base de datos responde, y una fuga de memoria no se lleva por delante toda la máquina.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="systemd-al-mando-con-un-enlace-simbólico"&gt;Systemd al mando, con un enlace simbólico&lt;/h3&gt;
&lt;p&gt;Podman no tiene un demonio que levante los contenedores al arrancar la máquina, y eso es una virtud: ese trabajo ya lo hace systemd, y lo hace muy bien. Basta una unidad que ejecute &lt;code&gt;podman-compose&lt;/code&gt;, y la guardo &lt;strong&gt;junto al &lt;code&gt;compose.yaml&lt;/code&gt;, en el mismo repositorio&lt;/strong&gt;, para que todo lo de la aplicación viva en un único sitio:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-ini" data-lang="ini"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# /srv/miapp/miapp.service&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;[Unit]&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;Description&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;miapp (podman-compose)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;Wants&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;network-online.target&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;After&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;network-online.target&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;[Service]&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;Type&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;oneshot&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;RemainAfterExit&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;yes&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;WorkingDirectory&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;/srv/miapp&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;ExecStart&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;/usr/bin/podman-compose up -d&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;ExecStop&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;/usr/bin/podman-compose down&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;TimeoutStartSec&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;300&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;[Install]&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="na"&gt;WantedBy&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s"&gt;multi-user.target&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;En lugar de copiarla a &lt;code&gt;/etc/systemd/system/&lt;/code&gt;, la &lt;strong&gt;enlazo&lt;/strong&gt; con un symlink. &lt;code&gt;systemctl link&lt;/code&gt; lo crea por ti:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;systemctl link /srv/miapp/miapp.service
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;systemctl &lt;span class="nb"&gt;enable&lt;/span&gt; --now miapp.service
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;ls -l /etc/systemd/system/miapp.service
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# /etc/systemd/system/miapp.service -&amp;gt; /srv/miapp/miapp.service&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;La ventaja es que &lt;strong&gt;la unidad que ejecuta systemd es siempre la del repositorio&lt;/strong&gt;: un &lt;code&gt;git pull&lt;/code&gt; y un &lt;code&gt;systemctl daemon-reload&lt;/code&gt; bastan para aplicar cualquier cambio, sin copias que se desincronicen. Y te queda lo mejor de systemd gratis: &lt;code&gt;systemctl status miapp&lt;/code&gt;, dependencias de red, orden de arranque y apagado limpio de los contenedores cuando se reinicia la máquina.&lt;/p&gt;
&lt;h2 id="3-el-proxy-inverso"&gt;3. El proxy inverso&lt;/h2&gt;
&lt;p&gt;Caddy es mi opción para esto porque pide y renueva los certificados de Let&amp;rsquo;s Encrypt sin que hagas nada. El &lt;code&gt;Caddyfile&lt;/code&gt; completo cabe en cuatro líneas:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-caddyfile" data-lang="caddyfile"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="gh"&gt;miapp.ejemplo.es&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="k"&gt;encode&lt;/span&gt; &lt;span class="s"&gt;zstd&lt;/span&gt; &lt;span class="s"&gt;gzip&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="k"&gt;reverse_proxy&lt;/span&gt; &lt;span class="n"&gt;app&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="mi"&gt;8080&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Traefik o Nginx con Certbot valen igual; lo que importa es que &lt;strong&gt;haya una única puerta de entrada&lt;/strong&gt; y que los certificados se renueven solos.&lt;/p&gt;
&lt;h2 id="4-los-datos"&gt;4. Los datos&lt;/h2&gt;
&lt;p&gt;Sí, la base de datos va en un contenedor, y no pasa nada. El contenedor es solo el proceso: &lt;strong&gt;los datos viven en un volumen&lt;/strong&gt; sobre el disco de datos, y eso es lo que hay que cuidar. Para una pyme, un PostgreSQL bien configurado en la misma máquina rinde de sobra y ahorra latencia y factura.&lt;/p&gt;
&lt;h2 id="5-copias-de-seguridad"&gt;5. Copias de seguridad&lt;/h2&gt;
&lt;p&gt;Esta es la pieza que convierte un «juguete» en producción, y la que más se olvida. Mi receta:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Un &lt;strong&gt;volcado lógico&lt;/strong&gt; de la base de datos (&lt;code&gt;pg_dump&lt;/code&gt;) programado con un temporizador de systemd o un cron.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href="https://restic.net/" target="_blank" rel="noopener"&gt;restic&lt;/a&gt;&lt;/strong&gt; para copiar ese volcado, los volúmenes y la configuración a un almacenamiento &lt;strong&gt;fuera de la máquina&lt;/strong&gt; (otro proveedor, otra región o un NAS en otra ubicación: si el servidor está en la oficina, la copia tiene que salir de ella), cifrado y con retención (por ejemplo, 7 diarias, 4 semanales y 12 mensuales).&lt;/li&gt;
&lt;li&gt;Y lo más importante: &lt;strong&gt;restaurar de vez en cuando&lt;/strong&gt;. Una copia que nunca has restaurado no es una copia, es una esperanza.&lt;/li&gt;
&lt;/ul&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;podman-compose &lt;span class="nb"&gt;exec&lt;/span&gt; -T bd pg_dump -U miapp -Fc miapp &amp;gt; /srv/copias/miapp.dump
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;restic backup /srv/copias /srv/miapp --tag diaria
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;restic forget --keep-daily &lt;span class="m"&gt;7&lt;/span&gt; --keep-weekly &lt;span class="m"&gt;4&lt;/span&gt; --keep-monthly &lt;span class="m"&gt;12&lt;/span&gt; --prune
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="6-vigilancia"&gt;6. Vigilancia&lt;/h2&gt;
&lt;p&gt;No hace falta montar un Prometheus con Grafana para empezar (aunque si lo tienes, mejor). Lo mínimo:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Una comprobación externa&lt;/strong&gt; que pida la web cada minuto y te avise si no responde o si el certificado está a punto de caducar.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Alertas de disco&lt;/strong&gt;: lo que más tumba estas máquinas es un disco lleno de registros o de imágenes viejas. Configura la rotación de registros del motor de contenedores y limpia imágenes con &lt;code&gt;podman image prune&lt;/code&gt; de forma periódica.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Registros en &lt;code&gt;journald&lt;/code&gt;&lt;/strong&gt;: en una máquina con systemd es el destino por defecto de Podman, así que los consultas con &lt;code&gt;journalctl&lt;/code&gt; aunque el contenedor ya no exista.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="7-todo-como-código"&gt;7. Todo como código&lt;/h2&gt;
&lt;p&gt;Esto es lo que de verdad le da la categoría de producción: &lt;strong&gt;si la máquina desaparece, la reconstruyes en minutos&lt;/strong&gt;, no en días.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href="https://opentofu.org/" target="_blank" rel="noopener"&gt;OpenTofu&lt;/a&gt;&lt;/strong&gt;, la bifurcación libre de Terraform bajo la Linux Foundation, crea la máquina virtual, el disco de datos, las reglas de red y el registro DNS. Usa el mismo lenguaje y los mismos proveedores, así que si vienes de Terraform no cambia nada. Con un servidor físico, OpenTofu se queda con el DNS y lo que haya en la nube (el almacenamiento de las copias, por ejemplo), y el resto empieza en Ansible.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Ansible&lt;/strong&gt; la configura: usuarios, SSH, cortafuegos, actualizaciones automáticas, Podman, el repositorio con el &lt;code&gt;compose.yaml&lt;/code&gt;, el &lt;code&gt;Caddyfile&lt;/code&gt; y la unidad, el symlink a systemd, los temporizadores de copias&amp;hellip;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Podman en tu portátil&lt;/strong&gt; para probar: como la aplicación entera es un &lt;code&gt;compose.yaml&lt;/code&gt;, no necesitas levantar una máquina virtual para ensayar. Clonas el repositorio y ejecutas &lt;code&gt;podman-compose up&lt;/code&gt;, y tienes en local exactamente lo mismo que en producción.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Con eso, recuperarte de un desastre es: crear la máquina (&lt;code&gt;tofu apply&lt;/code&gt; si es virtual; instalar el sistema base en el servidor reparado o en uno de repuesto si es física), &lt;code&gt;ansible-playbook&lt;/code&gt;, restaurar la última copia y cambiar el DNS si hace falta. Y ese tiempo, medido de verdad en un simulacro, es tu RTO real.&lt;/p&gt;
&lt;p&gt;Desplegar una versión nueva de la aplicación se queda en cambiar la etiqueta de la imagen y ejecutar:&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-sh" data-lang="sh"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;podman-compose pull &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; podman-compose up -d
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Habrá unos segundos de corte mientras se reinicia el contenedor. Si eso no es aceptable para tu caso, ya estás empezando a necesitar otra cosa.&lt;/p&gt;
&lt;h2 id="los-límites-sin-trampas"&gt;Los límites, sin trampas&lt;/h2&gt;
&lt;p&gt;Esta arquitectura tiene un &lt;strong&gt;punto único de fallo&lt;/strong&gt; evidente: la máquina. Si falla el servidor físico, o el anfitrión de la máquina virtual, cae el servicio hasta que se repare, el proveedor lo levante o tú lo reconstruyas en otra máquina. Es una decisión consciente, no un descuido, y hay que dejarla por escrito.&lt;/p&gt;
&lt;p&gt;Es momento de crecer cuando:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;El negocio no tolera &lt;strong&gt;paradas de horas&lt;/strong&gt; ni cortes de segundos en cada despliegue.&lt;/li&gt;
&lt;li&gt;La carga &lt;strong&gt;no cabe en una máquina&lt;/strong&gt; o tiene picos que exigen escalar en horizontal.&lt;/li&gt;
&lt;li&gt;Hay &lt;strong&gt;varios equipos&lt;/strong&gt; desplegando servicios distintos y necesitan aislamiento y autonomía.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Y lo bueno es que el camino es natural, porque ya lo tienes todo en contenedores y como código: primero, una segunda máquina con la base de datos replicada y un balanceador delante; después, si de verdad hace falta, un Kubernetes gestionado. Las imágenes que construyes hoy son las mismas que desplegarás entonces.&lt;/p&gt;
&lt;h2 id="conclusión"&gt;Conclusión&lt;/h2&gt;
&lt;p&gt;Una arquitectura simple &lt;strong&gt;no es una arquitectura de desarrollo&lt;/strong&gt;: es una arquitectura dimensionada para su problema. Un servidor, físico o virtual, con contenedores, un proxy con TLS, copias de seguridad probadas, vigilancia externa y todo descrito como código es una producción perfectamente digna para la mayoría de las pymes. Lo que no es digno es cualquier arquitectura, simple o compleja, sin copias, sin actualizaciones y sin forma de reconstruirla.&lt;/p&gt;</description></item><item><title>Arquitecturas distribuidas: idempotencia</title><link>https://infraestructurasbigdatacloud.es/arquitecturas-distribuidas-idempotencia/</link><pubDate>Mon, 01 May 2023 00:00:00 +0000</pubDate><guid>https://infraestructurasbigdatacloud.es/arquitecturas-distribuidas-idempotencia/</guid><description>&lt;p&gt;En el diseño de sistemas distribuidos, la idempotencia es una propiedad fundamental que garantiza que una operación puede ejecutarse múltiples veces sin alterar el resultado más allá de su primera ejecución. Esta característica es esencial para mantener la consistencia y fiabilidad en entornos donde las fallas de red, los reintentos automáticos y las operaciones concurrentes son comunes.&lt;/p&gt;
&lt;h2 id="qué-es-la-idempotencia"&gt;¿Qué es la idempotencia?&lt;/h2&gt;
&lt;p&gt;En informática, una operación es idempotente si su ejecución repetida produce el mismo efecto que una sola ejecución. Por ejemplo, en el contexto de las API RESTful, los métodos HTTP como &lt;code&gt;GET&lt;/code&gt;, &lt;code&gt;PUT&lt;/code&gt; y &lt;code&gt;DELETE&lt;/code&gt; son inherentemente idempotentes, ya que pueden repetirse sin cambiar el estado del servidor.&lt;/p&gt;
&lt;p&gt;Esta propiedad es crucial en sistemas distribuidos, donde las operaciones pueden fallar o duplicarse debido a problemas de red o errores del sistema. La idempotencia permite que estas operaciones se repitan de manera segura, asegurando la integridad y consistencia de los datos.&lt;/p&gt;
&lt;h2 id="aplicación-de-la-idempotencia-en-sistemas-distribuidos"&gt;Aplicación de la idempotencia en sistemas distribuidos&lt;/h2&gt;
&lt;p&gt;En arquitecturas distribuidas, la idempotencia se aplica en diversas áreas para garantizar la fiabilidad y consistencia del sistema:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Diseño de API&lt;/strong&gt;: Al diseñar endpoints RESTful, es importante que operaciones como &lt;code&gt;PUT&lt;/code&gt; y &lt;code&gt;DELETE&lt;/code&gt; sean idempotentes. Esto asegura que múltiples solicitudes idénticas no causen efectos secundarios no deseados.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Manejo de Reintentos&lt;/strong&gt;: En caso de fallas temporales, los sistemas pueden reintentar operaciones. La idempotencia permite que estos reintentos no afecten negativamente al sistema, ya que las operaciones repetidas no alteran el estado más allá de la primera ejecución.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Procesamiento de Mensajes&lt;/strong&gt;: En sistemas de mensajería como Apache Kafka o AWS SQS, los mensajes pueden entregarse más de una vez. Implementar idempotencia en los consumidores de mensajes garantiza que los mensajes duplicados no causen efectos secundarios no deseados.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="implementación-de-la-idempotencia"&gt;Implementación de la idempotencia&lt;/h2&gt;
&lt;p&gt;Para lograr la idempotencia en sistemas distribuidos, se pueden seguir varias estrategias:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Uso de identificadores únicos&lt;/strong&gt;: Asignar un identificador único (como un UUID) a cada operación permite al sistema reconocer y manejar solicitudes duplicadas.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Almacenamiento del estado de la operación&lt;/strong&gt;: Mantener un registro del estado de cada operación (pendiente, completada, fallida) ayuda a identificar y gestionar solicitudes repetidas.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Control de concurrencia&lt;/strong&gt;: Implementar mecanismos como bloqueos o control de versiones evita condiciones de carrera y asegura que las operaciones idempotentes se ejecuten correctamente.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Transacciones atómicas&lt;/strong&gt;: Utilizar transacciones atómicas en bases de datos garantiza que las operaciones se completen completamente o no se realicen en absoluto, manteniendo la integridad de los datos.&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id="referencias"&gt;Referencias&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="https://betterprogramming.pub/architecting-distributed-systems-the-importance-of-idempotence-138722a6b88e" target="_blank" rel="noopener"&gt;https://betterprogramming.pub/architecting-distributed-systems-the-importance-of-idempotence-138722a6b88e&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://apolonio.es/idempotente" target="_blank" rel="noopener"&gt;https://apolonio.es/idempotente&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://apolonio.es/idempotencia" target="_blank" rel="noopener"&gt;https://apolonio.es/idempotencia&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://loadfocus.com/es-es/glossary/what-is-idempotency" target="_blank" rel="noopener"&gt;https://loadfocus.com/es-es/glossary/what-is-idempotency&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://appmaster.io/es/glossary/idempotencia-de-microservicios" target="_blank" rel="noopener"&gt;https://appmaster.io/es/glossary/idempotencia-de-microservicios&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.cyberghostvpn.com/es/glossary/idempotence" target="_blank" rel="noopener"&gt;https://www.cyberghostvpn.com/es/glossary/idempotence&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://docs.aws.amazon.com/es_es/wellarchitected/latest/framework/rel_prevent_interaction_failure_idempotent.html" target="_blank" rel="noopener"&gt;https://docs.aws.amazon.com/es_es/wellarchitected/latest/framework/rel_prevent_interaction_failure_idempotent.html&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://www.educaopen.com/digital-lab/metaterminos/i/idempotencia" target="_blank" rel="noopener"&gt;https://www.educaopen.com/digital-lab/metaterminos/i/idempotencia&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</description></item></channel></rss>