Configurar o armazenamento remoto para a infraestrutura do Commerce na nuvem

A partir do pacote ece-tools 2002.1.5, você pode usar uma variável de ambiente para habilitar o módulo de Armazenamento Remoto; no entanto, o módulo de Armazenamento Remoto tem suporte 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.

Variável de ambiente

A variável REMOTE_STORAGE é usada durante a fase de implantação de um projeto de infraestrutura de nuvem.

REMOTE_STORAGE

Configure um adaptador de armazenamento para armazenar arquivos de mídia em um contêiner de armazenamento remoto persistente usando um serviço de armazenamento, como o AWS S3. Habilite o módulo de Armazenamento remoto para melhorar o desempenho em projetos na nuvem com configurações complexas de vários servidores que devem compartilhar recursos. Este é um exemplo de configuração de armazenamento remoto usando o arquivo .magento.env.yaml:

stage:
  deploy:
    REMOTE_STORAGE:
      driver: aws-s3 # Required
      prefix: cloud # Optional
      config:
        bucket: my-bucket # Required
        region: my-region # Required
        key: my-key # Optional
        secret: my-secret-key # Optional

Definir a variável com a CLI da nuvem

Defina a variável REMOTE_STORAGE como uma variável de nível de ambiente para que os arquivos não sejam compartilhados entre os ambientes de Produção, de Preparo e de Integração. Definir as variáveis no nível do ambiente proporciona a flexibilidade de usar somente o armazenamento remoto em ambientes selecionados, como excluir o uso do armazenamento remoto no ambiente de integração.

Para adicionar a variável de armazenamento remoto usando a CLI da Nuvem:

magento-cloud variable:create --level environment --name REMOTE_STORAGE --json true --inheritable false --value '{"driver":"aws-s3","prefix":"uat","config":{"bucket":"aws-bucket-id","region":"eu-west-1","key":"optional-key","secret":"optional-secret"}}'

Isso cria uma variável REMOTE_STORAGE com a configuração JSON especificada. A variável REMOTE_STORAGE usa uma cadeia de caracteres JSON para configurar o armazenamento remoto. Veja a seguir um exemplo de configuração JSON:

{
  "driver": "aws-s3",
  "prefix": "uat",
  "config": {
    "bucket": "aws-bucket-id",
    "region": "aws-region-id",
    "key": "optional-key",
    "secret": "optional-secret"
  }
}

Depois de criar a configuração e implantar, os logs de implantação devem incluir informações sobre a configuração de armazenamento remoto, por exemplo INFO: Remote storage driver set to: "aws-s3"

Definir variável com a interface da Web do projeto

Como alternativa, você pode usar a Interface da Web do projeto para adicionar a variável ao ambiente apropriado.

Para adicionar a variável de armazenamento remoto usando a Interface da Web do Project:

Usar autenticação opcional

O key e o secret são opcionais. Ao criar a variável, você pode ocultar o key e o secret selecionando a opção sensitive. Com essa configuração, os valores não ficam visíveis na interface da Web. Consulte Visibilidade da variável no guia do Commerce on Cloud Infrastructure.

Se quiser usar um método de autenticação diferente, omita o key e o secret da configuração JSON,. Configure o método de autenticação alternativo e verifique se o servidor está autorizado para o bucket do S3.

Sincronizar o armazenamento remoto

Depois de habilitar o módulo de Armazenamento remoto, sincronize os arquivos de mídia atuais para o local de armazenamento remoto.

Para iniciar a sincronização:

bin/magento remote-storage:sync

Configuração do Fastly

Se você optar por usar a solução de armazenamento remoto com um projeto Adobe Commerce na infraestrutura em nuvem, use a orientação do Amazon S3 na documentação do Fastly para garantir que o Fastly Image Otimization funcione com o AWS S3.

Esteja preparado com suas credenciais do Fastly. Em projetos Pro, use SSH para se conectar ao servidor e obter as credenciais do Fastly no arquivo /mnt/shared/fastly_tokens.txt. Os ambientes de preparo e produção têm credenciais exclusivas. Você deve obter as credenciais para cada ambiente.

Continue configurando o armazenamento remoto para projetos na nuvem com as seguintes tarefas: