DocumentaçãoKCS da Experience Cloud

Falha na implantação devido à configuração incorreta da porta Valkey no Adobe Commerce

Última atualização: 31 de julho de 2026

Ocorre uma falha de implantação na infraestrutura do Adobe Commerce na nuvem quando a configuração do Valkey Stale Cache usa uma porta incorreta no arquivo .magento.env.yaml. Para resolver o problema, atualize as portas Valkey e reimplante com sucesso.

Descrição description

Ambiente

  • Produto: Adobe Commerce na infraestrutura em nuvem
  • Versão: 2.4.8
  • Ambiente de implantação: Integração

Problema/Sintomas

  • Falha na implantação ao aplicar a configuração de Cache Obsoleto em .magento.env.yaml.
  • Os logs de implantação exibem o seguinte erro: Texto sem Formatação1A conexão com o tcp://localhost:6370 autônomo Redis falhou após 1 falha. Último Erro: (111) Conexão recusada.
  • O Adobe Commerce falha ao se conectar ao back-end do cache Valkey configurado.
  • As configurações de conexão Valkey fazem referência a uma porta incorreta na configuração.
  • Falha na validação de implantação durante a configuração de back-end do cache.

Resolução resolution

Siga as etapas abaixo para resolver o problema:

  1. Antes de enviar a configuração de Cache Obsoleto no .magento.env.yaml, execute o seguinte comando para obter os detalhes da relação Valkey:

    code language-none 
    magento-cloud relationships
...
       port: <port_number>

  2. Observe o valor da porta retornado para o serviço Valkey existente.

  3. Localize todas as referências à porta Valkey no arquivo .magento.env.yaml e atualize cada ocorrência da porta 6370 para o valor de porta correto identificado na etapa anterior.

  4. Revise a seção backend_options e atualize qualquer referência à porta 26370 para a porta Valkey correta, se presente.

  5. Salve o arquivo .magento.env.yaml atualizado e confirme as alterações.

  6. Reimplante o aplicativo do Adobe Commerce usando a configuração corrigida.

  7. Verifique se a implantação foi concluída com êxito e confirme se nenhum erro de conexão Valkey aparece nos logs de implantação.

Observação: verifique se todos os arquivos de configuração que fazem referência a Valkey, incluindo .magento.app.yaml e services.yaml, usam a mesma configuração de porta.

Leitura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles