Configurar o armazenamento remoto

O módulo de Armazenamento remoto oferece a opção de armazenar arquivos de mídia e agendar importações e exportações em um contêiner de armazenamento remoto persistente usando um serviço de armazenamento, como o AWS S3. Por padrão, o aplicativo do Adobe Commerce armazena arquivos de mídia no mesmo sistema de arquivos que contém o aplicativo. Isso é ineficiente para configurações complexas de vários servidores e pode resultar em redução do desempenho ao compartilhar recursos. Com o módulo de Armazenamento remoto, você pode armazenar arquivos de mídia no pub/media diretório e arquivos de importação/exportação na var diretório do armazenamento remoto de objetos para aproveitar o redimensionamento de imagens do lado do servidor.

INFO
O armazenamento remoto está disponível somente para a versão 2.4.2 e posterior do Commerce. Consulte a Notas de versão do 2.4.2.
INFO
O módulo de armazenamento remoto possui limitado no Adobe Commerce na infraestrutura em nuvem. O Adobe não pode solucionar problemas completamente com o serviço de adaptador de armazenamento de terceiros. Consulte Configurar o armazenamento remoto para a infraestrutura do Commerce na nuvem para obter orientação sobre como implementar o armazenamento remoto para projetos na nuvem.

imagem do esquema

Opções de armazenamento remoto

É possível configurar o armazenamento remoto usando o remote-storage com a opção setup comando CLI. A variável remote-storage A opção usa a seguinte sintaxe:

--remote-storage-<parameter-name>="<parameter-value>"

A variável parameter-name refere-se ao nome do parâmetro de armazenamento remoto específico. A tabela a seguir lista os parâmetros disponíveis para configurar o armazenamento remoto:

Parâmetro de linha de comando
Nome do parâmetro
Descrição
Valor padrão
remote-storage-driver
driver
Nome do adaptador
Valores possíveis:
arquivo: desativa o armazenamento remoto e usa o sistema de arquivos local
aws-s3: Use o Serviço de armazenamento simples da Amazon (Amazon S3)
nenhum
remote-storage-bucket
balde
Armazenamento de objetos ou nome do container
nenhum
remote-storage-prefix
prefixo
Prefixo opcional (local dentro do armazenamento de objetos)
vazio
remote-storage-region
região
Nome da região
nenhum
remote-storage-key
chave de acesso
Chave de acesso opcional
vazio
remote-storage-secret
chave secreta
Chave secreta opcional
vazio

Adaptadores de armazenamento

O local de armazenamento padrão está no sistema de arquivos local. A adaptador de armazenamento O permite que você se conecte a um serviço de armazenamento e armazene seus arquivos em qualquer lugar. Commerce O é compatível com a configuração dos seguintes serviços de armazenamento:

Habilitar armazenamento remoto

Você pode instalar o armazenamento remoto durante uma instalação do Adobe Commerce ou adicionar armazenamento remoto a uma instância existente do Commerce. Os exemplos a seguir demonstram cada método usando um conjunto de remote-storage parâmetros com o Commerce setup Comandos da CLI. No mínimo, você deve fornecer o armazenamento driver, bucket, e region.

  • Exemplo: instalar o Commerce com armazenamento remoto

    code language-bash
    bin/magento setup:install --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
  • Exemplo: habilitar o armazenamento remoto no Commerce existente

    code language-bash
    bin/magento setup:config:set --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
TIP
Para o Adobe Commerce na infraestrutura em nuvem, consulte Configurar o armazenamento remoto para a infraestrutura do Commerce na nuvem.

Limitação

Não é possível habilitar o armazenamento remoto e o armazenamento de banco de dados ao mesmo tempo. Desabilite o armazenamento do banco de dados se estiver usando o armazenamento remoto.

bin/magento config:set system/media_storage_configuration/media_database 0

A habilitação do armazenamento remoto pode afetar sua experiência de desenvolvimento estabelecida. Por exemplo, certas funções de arquivo PHP podem não funcionar como esperado. O uso do Commerce Framework para operações de arquivo deve ser empregado.

A lista de funções nativas proibidas do PHP está disponível em repositório magento-coding-standard.

Migrar conteúdo

Depois de habilitar o armazenamento remoto para um adaptador específico, você pode usar a CLI para migrar o existente mídia para o armazenamento remoto.

./magento2ce/bin/magento remote-storage:sync
INFO
O comando sync migra somente arquivos no estado pub/media diretório, não os arquivos de importação/exportação no var diretório. Consulte Importação/exportação programada no Guia do usuário do Commerce 2.4.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c