Documentación

El contenido estático no se puede generar en Adobe Commerce en una infraestructura en la nube

Last update: Mon Jul 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

El contenido estático no se genera durante la implementación en Adobe Commerce en la infraestructura en la nube, a menudo debido a variables de entorno mal configuradas. Problemas como el error No se puede crear un enlace simbólico para "/app/…/.htaccess" durante el proceso de compilación, o bien falta un archivo deployed_version.txt. Para resolver el problema, asegúrese de que CLEAN_STATIC_FILES esté habilitado y vuelva a implementar el entorno.

Descripción description

Entorno

Infraestructura de Adobe Commerce en la nube

Problema/Síntomas

  • El contenido estático no se genera durante la implementación.
  • Error mostrado: No se puede crear un enlace simbólico para "/app/…/.htaccess".
  • El archivo deployed_version.txt falta o está obsoleto.
  • Variable CLEAN_STATIC_FILES incoherente entre entornos.

Resolución resolution

Para resolver el problema, siga estos pasos:

  1. Compruebe la variable CLEAN_STATIC_FILES para asegurarse de que está habilitada (o que no está configurada, que está habilitada de forma predeterminada). Puede verificarlo de cualquiera de las siguientes maneras:

    • Acceda al servidor mediante SSH (por ejemplo, nodo 01) y ejecute el siguiente comando:

      code language-none 
      php -r 'echo json_decode(base64_decode($_ENV[ "MAGENTO_CLOUD_VARIABLES"] ))->CLEAN_STATIC_FILES . "\n";'

    • Busque la variable en el archivo .magento.env.yaml del repositorio.

    • Ejecute el siguiente comando CLI localmente:

      code language-none 
      magento-cloud variables:list -p <clusterID>

    • Visite la consola de Cloud en https://console.adobecommerce.com/username/<cluster ID>/<environment>/settings/variables para inspeccionar la variable.

  2. Compare la variable CLEAN_STATIC_FILES entre entornos para identificar discrepancias (por ejemplo, habilitada en el ensayo pero deshabilitada en la producción) y ajústela para garantizar la coherencia.

  3. Insertar cambios en el entorno para almacenar en déclencheur un contenido estático de regeneración y regeneración.

Lectura relacionada

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f