Commit e9958561 authored by Luis Gil's avatar Luis Gil
Browse files

built and update file http2.html.es 

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1837200 13f79535-47bb-0310-9956-ffa450edef68
parent 884cbcec

docs/manual/howto/http2.html.es

+216 −86

File changed.

Preview size limit exceeded, changes collapsed.

docs/manual/howto/http2.xml.es

+170 −37
Original line number Diff line number Diff line 
<?xml version='1.0' encoding='UTF-8' ?>

<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.es.xsl"?>

<!-- English Revision: 1780813:1834265 (outdated) -->

<!-- English Revision: 1834265 -->

<!-- Spanish translation : Daniel Ferradal -->

<!-- Reviewed & updated by Luis Gil de Bernabé Pfeiffer lgilbernabe[AT]apache.org -->
@@ -28,24 +28,29 @@ 
  <title>Guía HTTP/2</title>



  <summary>

    <p>Esta es la guía para configurar HTTP/2 en Apache httpd. Ésta 

    característica es <em>experimental</em> así que es de esperar que algunas

    directivas e interfaces cambien con nuevas versiones.

    <p>

        Esta es la guía para configurar HTTP/2 en Apache httpd. Ésta característica

        está <em>lista en produción</em> así que es de esperar que las interfaces

        y las directivas se mantengan consistentes en cada verión.

    </p>

  </summary>

  <seealso><a href="../mod/mod_http2.html">mod_http2</a></seealso>

  <seealso><module>mod_http2</module></seealso>



  <section id="protocol">

    <title>El protocolo HTTP/2</title>



    <p>HTTP/2 es la evolución del protocolo de la capa de aplicación con más

    éxito, HTTP. Se centra en hacer un uso más eficiente de los recursos de red. No cambia la característica fundamental de HTTP, la semántica. Todavía hay solicitudes, respuestas, cabeceras y todo los elementos típicos de HTTP/1. Así que, si ya conoce HTTP/1, también conoce el 95% de HTTP/2.</p>

    éxito, HTTP. Se centra en hacer un uso más eficiente de los recursos de red. 

    No cambia la característica fundamental de HTTP, la semántica. Todavía hay 

    olicitudes, respuestas, cabeceras y todo los elementos típicos de HTTP/1. Así 

    que, si ya conoce HTTP/1, también conoce el 95% de HTTP/2.</p>

    

    <p>Se ha escrito mucho sobre HTTP/2 y de cómo funciona. La norma más

    estándar es, por supuesto, su 

    <a href="https://tools.ietf.org/html/rfc7540">RFC 7540</a> 

    (<a href="http://httpwg.org/specs/rfc7540.html"> también disponible en un

    formato más legible, YMMV</a>). Así que, ahí encontrará toda la especificación del protocolo.</p>

    formato más legible, YMMV</a>). Así que, ahí encontrará toda la especificación 

    del protocolo.</p>



    <p>Pero, como con todos los RFC, no es ideal como primera lectura. Es mejor

    entender primero <em>qué</em> se quiere hacer y después leer el RFC sobre
@@ -57,36 +62,82 @@ 
    <p>Si le parece demasiado largo, o no lo ha leido, hay algunos términos

    y elementos a tener en cuenta cuando lea este documento:</p>

    <ul>

        <li>HTTP/2 es un <strong>protocolo binario</strong>, al contrario que HTTP 1.1 que es texto plano. La intención para HTTP 1.1 es que sea legible (por ejemplo capturando el tráfico de red) mientras que para HTTP/2 no. Más información en el FAQ oficial <a href="https://http2.github.io/faq/#why-is-http2-binary">¿Por qué es binario HTTP/2?</a></li>

        <li>HTTP/2 es un <strong>protocolo binario</strong>, al contrario que 

        HTTP 1.1 que es texto plano. La intención para HTTP 1.1 es que sea 

        legible (por ejemplo capturando el tráfico de red) mientras que para 

        HTTP/2 no. Más información en el FAQ oficial 

        <a href="https://http2.github.io/faq/#why-is-http2-binary">¿Por qué es 

            binario HTTP/2?</a></li>



        <li><strong>h2</strong> es HTTP/2 sobre TLS (negociación de protocolo a través de ALPN).</li>

        <li><strong>h2</strong> es HTTP/2 sobre TLS (negociación de protocolo a 

        través de ALPN).</li>



        <li><strong>h2c</strong> es HTTP/2 sobre TCP.</li>



        <li>Un <strong>frame</strong> es la unidad más pequeña de comunicación dentro de una conexión HTTP/2, que consiste en una cabecera y una secuencia de octetos de longitud variable estructurada de acuerdo con el tipo de frame. Más información en la documentación oficial <a href="http://httpwg.org/specs/rfc7540.html#FramingLayer">Sección de Capa de Frame</a>.</li>



        <li>Un <strong>stream</strong> es un flujo bidireccional de frames dentro de una conexión HTTP/2. El concepto correspondiente en HTTP 1.1 es un intercambio de mensajes de solicitud/respuesta. Más información en la documentación oficial <a href="http://httpwg.org/specs/rfc7540.html#StreamsLayer">Sección Capa de Stream</a>.</li>



        <li>HTTP/2 es capaz de llevar <strong>múltiples streams</strong> de datos sobre la misma conexión TCP, evitando la clásica solicitud lenta "head-of-line blocking" de HTTP 1.1 y evitando generar múltiples conexiones TCP para cada solicitud/respuesta (KeepAlive parcheó el problema en HTTP 1.1 pero no lo resolvió completamente).</li>

        <li>Un <strong>frame</strong> es la unidad más pequeña de comunicación 

        dentro de una conexión HTTP/2, que consiste en una cabecera y una secuencia 

        de octetos de longitud variable estructurada de acuerdo con el tipo de 

        frame. Más información en la documentación oficial 

        <a href="http://httpwg.org/specs/rfc7540.html#FramingLayer">Sección de 

            Capa de Frame</a>.</li>



        <li>Un <strong>stream</strong> es un flujo bidireccional de frames dentro 

        de una conexión HTTP/2. El concepto correspondiente en HTTP 1.1 es un 

        intercambio de mensajes de solicitud/respuesta. Más información en la 

        documentación oficial 

        <a href="http://httpwg.org/specs/rfc7540.html#StreamsLayer">Sección Capa 

            de Stream</a>.</li>



        <li>

            HTTP/2 es capaz de llevar <strong>múltiples streams</strong> de datos

            sobre la misma conexión TCP, evitando la clásica solicitud lenta 

            "head-of-line blocking" de HTTP 1.1 y evitando generar múltiples conexiones

            TCP para cada solicitud/respuesta (KeepAlive parcheó el problema en 

            HTTP 1.1 pero no lo resolvió completamente).

      </li>

    </ul>

  </section>



  <section id="implementation">

    <title>HTTP/2 en Apache httpd</title>

    <p>El protocolo HTTP/2 se implementa con su propio módulo httpd, llamado acertadamente <a href="../mod/mod_http2.html">mod_http2</a>. Incluye el set completo de características descritas por el RFC 7540 y soporta HTTP/2 sobre texto plano (http:), así como conexiones seguras (https:). La variante de texto plano se llama '<code>h2c</code>', la segura '<code>h2</code>'. Para <code>h2c</code> permite el modo <em>direct</em>

    y el <code>Upgrade:</code> a través de una solicitud inicial HTTP/1.</p>



    <p>Una característica de HTTP/2 que ofrece capacidades nuevas para desarrolladores de web es <a href="#push">Server Push</a>. Vea esa sección para saber como su aplicación web puede hacer uso de ella.</p>

    <p>

        El protocolo HTTP/2 se implementa con su propio módulo httpd, llamado 

        acertadamente <module>mod_http2</module>. Incluye el set completo de 

        características descritas por el RFC 7540 y soporta HTTP/2 sobre texto 

        plano (http:), así como conexiones seguras (https:). La variante de texto

        plano se llama '<code>h2c</code>', la segura '<code>h2</code>'. Para 

        <code>h2c</code> permite el modo <em>direct</em>

        y el <code>Upgrade:</code> a través de una solicitud inicial HTTP/1.

    </p>

    

    <p>

        Una característica de HTTP/2 que ofrece capacidades nuevas para 

        desarrolladores de web es <a href="#push">Server Push</a>. Vea esa sección

         para saber como su aplicación web puede hacer uso de ella.

     </p>

  </section>

  

  <section id="building">

    <title>Compilar httpd con soporte HTTP/2</title>

    <p><a href="../mod/mod_http2.html">mod_http2</a> usa la librería <a href="https://nghttp2.org">nghttp2</a>

    como su implementación base. Para compilar <code>mod_http2</code> necesita al menos la versión 1.2.1 de <code>libnghttp2</code> instalada en su sistema.</p>



    <p>Cuando usted ejecuta <code>./configure</code> en el código fuente de Apache HTTPD, necesita indicarle '<code>--enable-http2</code>' como una opción adicional para activar la compilación de este módulo. Si su <code>libnghttp2</code> está ubicado en una ruta no habitual (cualquiera que sea en su sistema operativo), puede indicar su ubicación con '<code>--with-nghttp2=&lt;path&gt;</code>' para <code>./configure</code>.</p>

    <p>

        <module>mod_http2</module> usa la librería <a href="https://nghttp2.org">

        nghttp2</a>como su implementación base. Para compilar 

        <module>mod_http2</module> necesita al menos la versión 1.2.1 de 

        <code>libnghttp2</code> instalada en su sistema.

    </p>



    <p>

        Cuando usted ejecuta <code>./configure</code> en el código fuente de 

        Apache HTTPD, necesita indicarle '<code>--enable-http2</code>' como una 

        opción adicional para activar la compilación de este módulo. Si su 

        <code>libnghttp2</code> está ubicado en una ruta no habitual (cualquiera que 

        sea en su sistema operativo), puede indicar su ubicación con 

        '<code>--with-nghttp2=&lt;path&gt;</code>' para <code>./configure</code>.

    </p>



    <p>Aunque puede que eso sirva para la mayoría, habrá quien prefiera un <code>nghttp2</code> compilado estáticamente para este módulo. Para ellos existe la opción <code>--enable-nghttp2-staticlib-deps</code>. Funciona de manera muy similar a como uno debe enlazar openssl estáticamente para mod_ssl.</p>

    <p>Aunque puede que eso sirva para la mayoría, habrá quien prefiera un <code>nghttp2</code> compilado estáticamente para este módulo. Para ellos existe la opción <code>--enable-nghttp2-staticlib-deps</code>. Funciona de manera muy similar a como uno debe enlazar openssl estáticamente para <module>mod_ssl</module>.</p>



    <p>Hablando de SSL, necesita estar al tanto de que la mayoría de los navegadores hablan HTTP/2 solo con URLs <code>https:</code>. Así que necesita un servidor con soporte SSL. Pero no solo eso, necesitará una librería SSL que de soporte a la extensión <code>ALPN</code>. Si usa OpenSSL, necesita al menos la versión 1.0.2.</p>

  </section>
@@ -94,7 +145,7 @@ 
  <section id="basic-config">

    <title>Configuración básica</title>



    <p>Cuando tiene un <code>httpd</code> compilado con <code>mod_http2</code> necesita una configuración básica para activarlo. Lo primero, como con cualquier otro módulo de Apache, es que necesita cargarlo:</p>

    <p>Cuando tiene un <code>httpd</code> compilado con <module>mod_http2</module> necesita una configuración básica para activarlo. Lo primero, como con cualquier otro módulo de Apache, es que necesita cargarlo:</p>

    

    <highlight language="config">

LoadModule http2_module modules/mod_http2.so
@@ -147,7 +198,7 @@ ProtocolsHonorOrder Off 


    <p>Hace que el orden en que <em>usted</em> escribió los Protocols sea irrelevante y sólo el orden de preferencia del cliente será decisorio.</p>



    <p>Una última cosa: cuando usted configura los protocolos no se comprueba si son correctos o están bien escritos. Puede mencionar protocolos que no existen, así que no hay necesidad de proteger <code>Protocols</code> con ningún <code>IfModule</code> de comprobación.</p>

    <p>Una última cosa: cuando usted configura los protocolos no se comprueba si son correctos o están bien escritos. Puede mencionar protocolos que no existen, así que no hay necesidad de proteger <directive module="core">Protocols</directive> con ningún <directive type="section" module="core">IfModule</directive> de comprobación.</p>



    <p>Para más consejos avanzados de configuración, vea la <a href="../mod/mod_http2.html#dimensioning">

    sección de módulos sobre dimensionamiento</a> y <a href="../mod/mod_http2.html#misdirected">
@@ -157,15 +208,15 @@ ProtocolsHonorOrder Off 
  <section id="mpm-config">

    <title>Configuración MPM</title>

    

    <p>HTTP/2 está soportado en todos los módulos de multi-proceso que se ofrecen con httpd. Aun así, si usa el mpm <code>prefork</code>, habrá  restricciones severas.</p>

    <p>HTTP/2 está soportado en todos los módulos de multi-proceso que se ofrecen con httpd. Aun así, si usa el mpm <module>prefork</module>, habrá  restricciones severas.</p>



    <p>En <code>prefork</code>, <code>mod_http2</code> solo procesará una solicitud cada vez por conexión. Pero los clientes, como los navegadores, enviarán muchas solicitudes al mismo tiempo. Si una de ellas tarda mucho en procesarse (o hace un sondeo que dura más de la cuenta), las otras solicitudes se quedarán atascadas.</p>

    <p>En <module>prefork</module>, <module>mod_http2</module> solo procesará una solicitud cada vez por conexión. Pero los clientes, como los navegadores, enviarán muchas solicitudes al mismo tiempo. Si una de ellas tarda mucho en procesarse (o hace un sondeo que dura más de la cuenta), las otras solicitudes se quedarán atascadas.</p>



    <p><code>mod_http2</code> no evitará este límite por defecto. El motivo es que <code>prefork</code> hoy en día solo se escoge si ejecuta motores de proceso que no están preparados para multi-hilo, p.ej. fallará con más de una solicitud.</p>

    <p><module>mod_http2</module> no evitará este límite por defecto. El motivo es que <module>prefork</module> hoy en día solo se escoge si ejecuta motores de proceso que no están preparados para multi-hilo, p.ej. fallará con más de una solicitud.</p>



    <p>Si su configuración lo soporta, hoy en día <code>event</code> es el mejor mpm que puede usar.</p>

    <p>Si su configuración lo soporta, hoy en día <module>event</module> es el mejor mpm que puede usar.</p>

    

    <p>Si realmente está obligado a usar <code>prefork</code> y quiere multiples solicitudes, puede configurar la directiva <directive module="mod_http2">H2MinWorkers</directive> para hacerlo posible. Sin embargo, si esto falla, es bajo su cuenta y riesgo.</p>

    <p>Si realmente está obligado a usar <module>prefork</module> y quiere multiples solicitudes, puede configurar la directiva <directive module="mod_http2">H2MinWorkers</directive> para hacerlo posible. Sin embargo, si esto falla, es bajo su cuenta y riesgo.</p>

  </section>

  

  <section id="clients">
@@ -216,14 +267,18 @@ ProtocolsHonorOrder Off 


    <p>Resumiendo: no hay una estrategia mejor sobre cómo usar esta característica de HTTP/2 y todo el mundo está experimentando con ella. Así que, ¿cómo experimenta usted con ella en Apache httpd?</p>



    <p><code>mod_http2</code> busca e inspecciona las cabeceras de respuesta 

    <p><module>mod_http2</module> busca e inspecciona las cabeceras de respuesta 

    <code>Link</code> con cierto formato:</p>



    <highlight language="config">

Link &lt;/xxx.css&gt;;rel=preload, &lt;/xxx.js&gt;; rel=preload

    </highlight>



    <p>Si la conexión soporta PUSH, estos dos recursos se enviarán al cliente. Como desarrollador web, puede configurar estas cabeceras o bien directamente en la respuesta de su aplicación o configurar su servidor con:</p>

    <p>

        Si la conexión soporta PUSH, estos dos recursos se enviarán al cliente. 

        Como desarrollador web, puede configurar estas cabeceras o bien 

        directamente en la respuesta de su aplicación o configurar su servidor con:

    </p>



    <highlight language="config">

&lt;Location /xxx.html&gt;
@@ -232,7 +287,8 @@ Link &lt;/xxx.css&gt;;rel=preload, &lt;/xxx.js&gt;; rel=preload 
&lt;/Location&gt;

    </highlight>



    <p>Si quiere usar enlaces con <code>preload</code> sin activar un PUSH, puede usar el parámetro <code>nopush</code>, como en:</p>

    <p>Si quiere usar enlaces con <code>preload</code> sin activar un PUSH, puede

    usar el parámetro <code>nopush</code>, como en:</p>



    <highlight language="config">

        Link &lt;/xxx.css&gt;;rel=preload;nopush
@@ -246,13 +302,90 @@ H2Push Off 


    <p>Y hay más:</p>



    <p>El módulo mantiene un registro de lo que se ha enviado con PUSH para cada conexión (hashes de URLs, básicamente) y no hará PUSH del mismo recurso dos veces. Cuando la conexión se cierra, la información es descartada.</p>

    <p>

        El módulo mantiene un registro de lo que se ha enviado con PUSH para cada

        conexión (hashes de URLs, básicamente) y no hará PUSH del mismo recurso dos

        veces. Cuando la conexión se cierra, la información es descartada.

    </p>



    <p>Hay gente pensando cómo un cliente puede decirle al servidor lo que ya tiene, para evitar los PUSH de esos elementos, pero eso algo muy experimental ahora mismo.</p>

    <p>

        Hay gente pensando cómo un cliente puede decirle al servidor lo que ya

        tiene, para evitar los PUSH de esos elementos, pero eso algo muy

        experimental ahora mismo.

    </p>



    <p>Otro borrador experimental que ha sido implementado en 

    <code>mod_http2</code> es el <a href="https://tools.ietf.org/html/draft-ruellan-http-accept-push-policy-00"> Campo de Cabecera

    Accept-Push-Policy</a> en la que un cliente puede, para cada solicitud, definir qué tipo de PUSH acepta.</p>

    <module>mod_http2</module> es el <a href="https://tools.ietf.org/html/draft-ruellan-http-accept-push-policy-00"> Campo de Cabecera

    Accept-Push-Policy</a> en la que un cliente puede, para cada solicitud, definir 

    qué tipo de PUSH acepta.</p>



    <p>

        Puede que PUSH no siempre lance la peticion/respuesta/funcionamiento que

        uno espera. Hay varios estudios sobre este tema en internet, que explican

        el beneficio y las debilidades de como diferentes funcionalidades del

        cliente y de la red influyen en el resultado.

        Por Ejemplo, que un servidor haga "PUSH" de recursos, no significa que el 

        navegador vaya a usar dichos datos.

    </p>

    <p>

        Lo más importante que influye en la respuesta que se envía, es la solicitud

        que se simuló. La url de solicitud de un PUSH es dada por la aplicación,

        pero ¿de donde vienen las cabeceras de la petición? por ejemplo si el PUSH

        pide una cabecera <code>accept-language</code> y si es así, ¿con qué valor?

    </p>

    <p>Httpd mirará la petición original (la que originó el PUSH) y copiará las

        siguientes cabeceras a las peticiones PUSH:

        <code>user-agent</code>, <code>accept</code>, <code>accept-encoding</code>,

        <code>accept-language</code>, <code>cache-control</code>.

    </p>

    <p>

        Todas las otras cabeceras son ignorados. Las cookies tampoco serán copiadas.

        Impulsar los recursos que requieren una cookie para estar presente no

        funcionará. Esto puede ser una cuestión de debate. Pero a menos que esto se

        discuta más claramente con el navegador, evitemos el exceso de precaución y

        no expongamos las cookies donde podrían o no ser visibles.

    </p>



</section>

<section id="earlyhints">

    <title>"Early Hints"</title>



    <p>Una alternativa de "Pushear" recursos es mandar una cabecera 

        <code>Link</code> al cliente antes que la respuesta esté lista. Esto usa

        una caracteristica de HTTP que se llama  "Early Hints" y está descrita en

        la <a href="https://tools.ietf.org/html/rfc8297">RFC 8297</a>.</p>

    <p>Para poder usar esto, necesita habilitarlo explicitamente en el servidor 

    via</p>

    

    <highlight language="config">

H2EarlyHints on

    </highlight>

    

    <p>(No está habilitado por defecto ya q ue algunos navegadores más antiguos 

        se caen con dichas  respuestas.)

    </p>



    <p>si esta funcionalidad esta activada, puede usar la directiva 

        <directive module="mod_http2">H2PushResource</directive> para que lance 

        "Early hints" y recursos mediante push:

    </p>

    <highlight language="config">

&lt;Location /xxx.html&gt;

    H2PushResource /xxx.css

    H2PushResource /xxx.js

&lt;/Location&gt;

    </highlight>

    <p>

        Esto lanzará una respuesta <code>"103 Early Hints"</code> a un cliente 

        tan pronto como el servidor <em>comience</em> a procesar la solicitud. 

        Esto puede ser mucho antes que en el momento en que se determinaron los 

        primeros encabezados de respuesta, dependiendo de su aplicación web.

    </p>



    <p>

        Si la directiva <directive module="mod_http2">H2Push</directive> está 

        habilitada, esto comenzará el PUSH justo después de la respuesta 103.

        Sin embargo, si la directiva <directive module="mod_http2">H2Push</directive> está dehabilitada, la respuesta 103 se le enviará al cliente.

    </p>

  </section>

</manualpage>

docs/manual/howto/http2.xml.meta

+1 −1
Original line number Diff line number Diff line
@@ -8,7 +8,7 @@ 


  <variants>

    <variant>en</variant>

    <variant outdated="yes">es</variant>

    <variant>es</variant>

    <variant>fr</variant>

  </variants>

</metafile>