[Alleen PaaS]{class="badge informative" title="Is alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur) en op projecten in het veld."}

Variabelen implementeren

Het volgende stelt variabelen controleacties in in de opstellen fase op en kan waarden van de ​ Globale variabelen ​ erven en met voeten treden. Voeg deze variabelen in het deploy werkgebied van het .magento.env.yaml -bestand in:

stage:
  deploy:
    DEPLOY_VARIABLE_NAME: value

Voor meer informatie over het aanpassen van het bouwstijl en opstellen proces:

CACHE_CONFIGURATION

Configureer Redis-pagina en standaardcaching. Wanneer u de parameter cm_cache_backend_redis instelt, moet u de opties server , port en database opgeven.

stage:
  deploy:
    CACHE_CONFIGURATION:
      frontend:
        default:
          backend: file
        page_cache:
          backend: file

Standaard overschrijft het implementatieproces alle instellingen in het env.php -bestand. U kunt er echter voor kiezen een of meer waarden voor een serviceconfiguratie samen te voegen zonder alle waarden te overschrijven.

Stel de optie _merge in op een van de volgende opties:

In het volgende voorbeeld worden nieuwe waarden samengevoegd met een bestaande configuratie:

stage:
  deploy:
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          backend_options:
            database: 10
        page_cache:
          backend_options:
            database: 11

Het volgende voorbeeld gebruikt ​ preload eigenschap ​ zoals die in de gids van de Configuratie wordt bepaald:

stage:
  deploy:
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          id_prefix: '061_'
          backend_options:
            preload_keys:
              - '061_EAV_ENTITY_TYPES:hash'
              - '061_GLOBAL_PLUGIN_LIST:hash'
              - '061_DB_IS_UP_TO_DATE:hash'
              - '061_SYSTEM_DEFAULT:hash'

Om een douane ​ REDIS_BACKEND ​ model (niet alleen van de lijst van gewenste personen) te gebruiken, plaats de _custom_redis_backend optie aan true om de correcte bevestiging zoals in het volgende voorbeeld toe te laten:

stage:
  deploy:
    CACHE_CONFIGURATION:
      frontend:
        default:
          _custom_redis_backend: true
          backend: '\CustomRedisModel'

CLEAN_STATIC_FILES

Laat of maakt het schoonmaken ​ statische inhoudsdossiers ​ toe onbruikbaar tijdens de bouwstijl wordt geproduceerd of fase opstelt. Gebruik de standaardwaarde waar in ontwikkeling als beste praktijken.

Als u statische inhoud door een afzonderlijk proces wijzigt, plaats de waarde aan vals.

stage:
  deploy:
    CLEAN_STATIC_FILES: false

Het niet opschonen van statische weergavebestanden vóór de implementatie kan problemen veroorzaken als u updates voor bestaande bestanden implementeert zonder de vorige versies te verwijderen. Wegens ​ statische dossierreserve ​ regels, kunnen de reserveverrichtingen het verkeerde dossier tonen als de folder veelvoudige versies van het zelfde dossier bevat.

CRON_CONSUMERS_RUNNER

Gebruik deze omgevingsvariabele om te bevestigen dat de berichtenrijen na een implementatie worden uitgevoerd.

Voorbeeld van een array die specifiek consumers en multiple_processes voor elke consument wordt uitgevoerd:

stage:
  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      max_messages: 1000
      consumers:
        - example_consumer_1
        - example_consumer_2
-     multiple_processes:
        example_consumer_1: 4
        example_consumer_2: 3

Voorbeeld van een lege array die alles consumers uitvoert:

stage:
  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      max_messages: 1000
      consumers: []

Standaard overschrijft het implementatieproces alle instellingen in het env.php -bestand. Zie ​ berichtrijen ​ in de Gids van de Configuratie van Commerce voor op-gebouw Adobe Commerce beheren.

CONSUMERS_WAIT_FOR_MAX_MESSAGES

Configureer hoe consumers berichten uit de wachtrij met berichten verwerkt door een van de volgende opties te kiezen:

stage:
  deploy:
    CONSUMERS_WAIT_FOR_MAX_MESSAGES: false

CRYPT_KEY

Wanneer u het gegevensbestand van één milieu aan een andere zonder installatieproces verplaatst, hebt u de overeenkomstige cryptografische informatie nodig. Adobe Commerce gebruikt de waarde van de coderingssleutel die in de Cloud Console is ingesteld als de crypt/key -waarde in het env.php -bestand.

DATABASE_CONFIGURATION

Als u een gegevensbestand in het ​ verhoudingen bezit ​ van het .magento.app.yaml dossier bepaalde, kunt u uw gegevensbestandverbindingen voor plaatsing aanpassen.

stage:
  deploy:
    DATABASE_CONFIGURATION:
      some_config: 'some_value'

Standaard overschrijft het implementatieproces alle instellingen in het env.php -bestand. U kunt er echter voor kiezen een of meer waarden voor een serviceconfiguratie samen te voegen zonder alle waarden te overschrijven.

Stel de optie _merge in op een van de volgende opties:

In het volgende voorbeeld worden nieuwe waarden samengevoegd met een bestaande configuratie:

stage:
  deploy:
    DATABASE_CONFIGURATION:
      some_config: 'some_new_value'
      _merge: true

U kunt ook een tabelvoorvoegsel configureren.

In het volgende voorbeeld wordt het voorvoegsel van de tabel ece_ gebruikt met standaardverbindingsinstellingen in plaats van de optie _merge :

stage:
  deploy:
    DATABASE_CONFIGURATION:
      connection:
        default:
          username: user
          host: host
          dbname: magento
          password: password
      table_prefix: 'ece_'

Voorbeelduitvoer:

MariaDB [main]> SHOW TABLES;
+-------------------------------------+
| Tables_in_main                      |
+-------------------------------------+
| ece_admin_passwords                 |
| ece_admin_system_messages           |
| ece_admin_user                      |
| ece_admin_user_session              |
| ece_adminnotification_inbox         |
| ece_amazon_customer                 |
| ece_authorization_rule              |
| ece_cache                           |
| ece_cache_tag                       |
| ece_captcha_log                     |
...

ELASTICSUITE_CONFIGURATION

Behoudt aangepaste Elastic Suite service-instellingen tussen implementaties en gebruikt deze in de sectie 'system/default/glimlach_elasticsuite_core_base_settings' van de hoofdconfiguratie van Elastic Suite . Als het Elastic Suite composer-pakket is geïnstalleerd, wordt het automatisch geconfigureerd.

stage:
  deploy:
    ELASTICSUITE_CONFIGURATION:
      es_client:
        servers: 'remote-host:9200'
      indices_settings:
        number_of_shards: 1
        number_of_replicas: 0

           indices_settings:
               number_of_shards: 3
               number_of_replicas: 2

Standaard overschrijft het implementatieproces alle instellingen in het env.php -bestand. U kunt er echter voor kiezen een of meer waarden voor een serviceconfiguratie samen te voegen zonder alle waarden te overschrijven.

Stel de optie _merge in op een van de volgende opties:

In het volgende voorbeeld wordt een nieuwe waarde samengevoegd met de bestaande configuratie:

stage:
  deploy:
    ELASTICSUITE_CONFIGURATION:
      indices_settings:
        number_of_shards: 3
        number_of_replicas: 2
      _merge: true

Bekende beperkingen:

ENABLE_GOOGLE_ANALYTICS

Hiermee schakelt u Google Analytics in en uit bij de implementatie naar omgevingen voor Staging en Integratie. Google Analytics geldt standaard alleen voor de productieomgeving. Stel deze waarde in op true om Google Analytics in te schakelen in de omgevingen voor Staging en Integratie.

Voeg de omgevingsvariabele ENABLE_GOOGLE_ANALYTICS toe aan het deploy werkgebied in het .magento.env.yaml -bestand:

stage:
  deploy:
    ENABLE_GOOGLE_ANALYTICS: true

FORCE_UPDATE_URLS

Bij implementatie in een Pro- of Starter-testomgeving vervangt deze variabele Adobe Commerce-basis-URL's in de database door de project-URL's die zijn opgegeven door de variabele MAGENTO_CLOUD_ROUTES . Gebruik dit plaatsen om het standaardgedrag van ​ met voeten te treden UPDATE_URLS ​ veranderlijk opstelt, die wanneer het opstellen aan het Opvoeren of de milieu's van de Productie wordt genegeerd.

stage:
  deploy:
    FORCE_UPDATE_URLS: true

LOCK_PROVIDER

De vergrendelingsprovider voorkomt het starten van dubbele snijtaken en afdekgroepen. Gebruik de vergrendelingsprovider van file in de productieomgeving. De milieu's van de aanzet en het Pro integratiemilieu gebruiken niet ​ MAGENTO_CLOUD_LOCKS_DIR ​ variabele, zodat ece-tools automatisch de db slotleverancier toepast.

stage:
  deploy:
    LOCK_PROVIDER: "db"

Zie ​ vormen het slot ​ in gids installeren.

MYSQL_USE_SLAVE_CONNECTION

Adobe Commerce kan meerdere databases asynchroon lezen. Reeks aan true om a read-only verbinding aan het gegevensbestand automatisch te gebruiken om read-only verkeer op een niet hoofdknoop te ontvangen. Deze verbinding verbetert prestaties door lading het in evenwicht brengen, omdat slechts één knoop lees-schrijf verkeer behandelt. Stel in op false om een bestaande alleen-lezen-verbindingsarray uit het env.php -bestand te verwijderen.

stage:
  deploy:
    MYSQL_USE_SLAVE_CONNECTION: true

Wanneer de variabele MYSQL_USE_SLAVE_CONNECTION is ingesteld op true , wordt de parameter synchronous_replication standaard ingesteld op true in het env.php -bestand in Pro Staging and Production-omgevingen. Wanneer MYSQL_USE_SLAVE_CONNECTION op false wordt geplaatst, wordt de synchronous_replication parameter niet gevormd.

QUEUE_CONFIGURATION

Gebruik deze omgevingsvariabele om aangepaste servicemontages voor de wachtrij tussen implementaties te behouden. Deze variabele ondersteunt zowel AMQP (voor RabbitMQ)- als STOMP-protocollen (voor ActiveMQ Artemis). Als u bijvoorbeeld liever een bestaande berichtwachtrij gebruikt in plaats van dat u de cloudinfrastructuur gebruikt om deze voor u te maken, gebruikt u de omgevingsvariabele QUEUE_CONFIGURATION om deze aan te sluiten op uw site:

stage:
  deploy:
    QUEUE_CONFIGURATION:
      amqp:
        host: test.host
        port: 1234
      amqp2:
        host: test.host2
        port: 12345
      mq:
        host: mq.host
        port: 1234

Voor ActiveMQ-artemis met STOMP-protocol:

stage:
  deploy:
    QUEUE_CONFIGURATION:
      stomp:
        host: activemq.host
        port: 61616
        user: username
        password: password

Standaard overschrijft het implementatieproces alle instellingen in het env.php -bestand. U kunt er echter voor kiezen een of meer waarden voor een serviceconfiguratie samen te voegen zonder alle waarden te overschrijven.

Stel de optie _merge in op een van de volgende opties:

In het volgende voorbeeld worden nieuwe waarden samengevoegd met een bestaande configuratie:

stage:
  deploy:
    QUEUE_CONFIGURATION:
      _merge: true
      amqp:
        host: changed1.host
        port: 5672
      amqp2:
        host: changed2.host2
        port: 12345
      mq:
        host: changedmq.host
        port: 1234

REDIS_BACKEND

Specificeert de achtergrondmodelconfiguratie voor het geheime voorgeheugen van Redis.

Adobe Commerce versie 2.3.0 en hoger bevat de volgende back-endmodellen:

Het voorbeeld voor het instellen van REDIS_BACKEND

stage:
  deploy:
    REDIS_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'

REDIS_USE_SLAVE_CONNECTION

Adobe Commerce kan meerdere Redis-instanties asynchroon lezen. Reeks aan true om a read-only verbinding aan een Redis instantie automatisch te gebruiken om read-only verkeer op een niet hoofdknoop te ontvangen. Deze verbinding verbetert prestaties door lading het in evenwicht brengen, omdat slechts één knoop lees-schrijf verkeer behandelt. Stel in op false om een bestaande alleen-lezen-verbindingsarray uit het env.php -bestand te verwijderen.

stage:
  deploy:
    REDIS_USE_SLAVE_CONNECTION: true

U moet een Redis-service hebben geconfigureerd in het .magento.app.yaml -bestand en in het services.yaml -bestand.

​ ECE-Hulpmiddelen versie 2002.0.18 ​ en later gebruik meer fout-verdraagzame montages. Als Adobe Commerce geen gegevens van Redis slave instantie kan lezen, dan leest het gegevens van Redis meester instantie.

De read-only verbinding is niet beschikbaar voor gebruik in het integratiemilieu of als u CACHE_CONFIGURATION variabele ​ gebruikt.

VALKEY_BACKEND

VALKEY_BACKEND geeft de achtergrondmodelconfiguratie voor de Valkey-cache op.

Adobe Commerce versie 2.8.0 en hoger bevat de volgende back-endmodellen:

In het volgende voorbeeld wordt beschreven hoe u VALKEY_BACKEND instelt:

stage:
  deploy:
  VALKEY_USE_SLAVE_CONNECTION: true
  VALKEY_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'

VALKEY_USE_SLAVE_CONNECTION

Adobe Commerce kan meerdere Redis-instanties asynchroon lezen. VALKEY_USE_SLAVE_CONNECTION Reeks aan true om a read-only verbinding aan een instantie van Redis automatisch te gebruiken om read-only verkeer op een niet hoofdknoop te ontvangen. Deze verbinding verbetert prestaties door lading het in evenwicht brengen, omdat slechts één knoop lees-schrijf verkeer behandelt. Stel VALKEY_USE_SLAVE_CONNECTION in op false om een bestaande alleen-lezen-verbindingsarray uit het env.php -bestand te verwijderen.

stage:
  deploy:
    VALKEY_USE_SLAVE_CONNECTION: true

U moet een Redis-service hebben geconfigureerd in het .magento.app.yaml -bestand en in het services.yaml -bestand.

​ ECE-Hulpmiddelen versie 2002.0.18 ​ en later gebruik meer fout-verdraagzame montages. Als Adobe Commerce geen gegevens van de Valkey slave instantie kan lezen, dan leest het gegevens van Redis meester instantie.

De read-only verbinding is niet beschikbaar voor gebruik in het integratiemilieu of als u CACHE_CONFIGURATION variabele ​ gebruikt.

RESOURCE_CONFIGURATION

Wijst een middelnaam aan een gegevensbestandverbinding toe. Deze configuratie komt overeen met de sectie resource van het env.php -bestand.

Standaard overschrijft het implementatieproces alle instellingen in het env.php -bestand. U kunt er echter voor kiezen een of meer waarden voor een serviceconfiguratie samen te voegen zonder alle waarden te overschrijven.

Stel de optie _merge in op een van de volgende opties:

In het volgende voorbeeld worden nieuwe waarden samengevoegd met een bestaande configuratie:

stage:
  deploy:
    RESOURCE_CONFIGURATION:
      _merge: true
      default_setup:
        connection: default

SCD_COMPRESSION_LEVEL

Specificeert welk ​ gzip ​ compressieniveau (0 aan 9) te gebruiken wanneer het comprimeren van statische inhoud; 0 maakt compressie onbruikbaar.

stage:
  deploy:
    SCD_COMPRESSION_LEVEL: 5

SCD_COMPRESSION_TIMEOUT

Wanneer de tijd die nodig is om de statische elementen te comprimeren, de time-outlimiet voor compressie overschrijdt, wordt het implementatieproces onderbroken. Stel de maximale uitvoeringstijd, in seconden, in voor de opdracht voor het comprimeren van statische inhoud.

stage:
  deploy:
    SCD_COMPRESSION_TIMEOUT: 800

SCD_MATRIX

U kunt meerdere landinstellingen per thema configureren. Deze aanpassing versnelt het implementatieproces door het aantal onnodige themabestanden te verminderen. Bijvoorbeeld, kunt u het magento/backend thema in het Engels en een douanethema in andere talen opstellen.

In het volgende voorbeeld wordt het thema Magento/backend geïmplementeerd met drie landinstellingen:

stage:
  deploy:
    SCD_MATRIX:
      "magento/backend":
        language:
          - en_US
          - fr_FR
          - af_ZA

Ook, kunt u verkiezen om __ geen thema op te stellen:

stage:
  deploy:
    SCD_MATRIX:
      "magento/backend": [ ]

SCD_MAX_EXECUTION_TIME

Staat u toe om de maximale verwachte uitvoeringstijd voor statische inhoudsplaatsing te verhogen.

Door gebrek, plaatst Adobe Commerce de maximum verwachte uitvoering aan 900 seconden, maar in sommige scenario's zou u meer tijd kunnen nodig hebben om de statische inhoudsplaatsing voor een project van de Wolk te voltooien.

stage:
  deploy:
    SCD_MAX_EXECUTION_TIME: 3600

SCD_NO_PARENT

Stel in de implementatiefase SCD_NO_PARENT: true zo in dat het genereren van statische inhoud voor bovenliggende thema's niet plaatsvindt tijdens de implementatiefase. Dit het plaatsen minimaliseert plaatsingstijd en verhindert plaatsonderbreking die kan voorkomen als de statische inhoud tijdens de plaatsing bouwt ontbreekt. Zie ​ Statische inhoudsplaatsing ​.

stage:
  deploy:
    SCD_NO_PARENT: true

SCD_STRATEGY

Staat u toe om de ​ plaatsingsstrategie ​ voor statische inhoud aan te passen. Zie ​ statische meningsdossiers ​ opstellen.

Gebruik deze opties slechts als u meer dan één scène hebt:

stage:
  deploy:
    SCD_STRATEGY: "compact"

SCD_THREADS

Plaatst het aantal draden voor statische inhoudsplaatsing. De standaardwaarde wordt ingesteld op basis van het aantal gedetecteerde CPU-thread en de standaardwaarde 4 wordt niet overschreden. Verhoog het aantal draden versnelt de statische plaatsing van inhoud; het verminderen van het aantal draden vertraagt het. U kunt bijvoorbeeld de waarde van de thread instellen:

stage:
  deploy:
    SCD_THREADS: 2

Om plaatsingstijd verder te verminderen, gebruik ​ het Beheer van de Configuratie ​ met het scd-dump bevel om statische plaatsing in de bouwstijlfase te bewegen.

SEARCH_CONFIGURATION

Gebruik deze omgevingsvariabele om aangepaste instellingen voor zoekservices tussen implementaties te behouden. Bijvoorbeeld:

Elasticsearch-configuratie:

stage:
  deploy:
    SEARCH_CONFIGURATION:
      engine: elasticsearch
      elasticsearch_server_hostname: http://elasticsearch.internal
      elasticsearch_server_port: '9200'
      elasticsearch_index_prefix: magento2
      elasticsearch_server_timeout: '15'

OpenSearch-configuratie (voor Commerce 2.4.6 en hoger):

stage:
  deploy:
    SEARCH_CONFIGURATION:
      engine: opensearch
      opensearch_server_hostname: 'http://opensearch.internal'
      opensearch_server_port: '9200'
      opensearch_index_prefix: 'magento2'
      opensearch_server_timeout: '15'

Standaard overschrijft het implementatieproces alle instellingen in het env.php -bestand. U kunt er echter voor kiezen een of meer waarden voor een serviceconfiguratie samen te voegen zonder alle waarden te overschrijven.

Stel de optie _merge in op een van de volgende opties:

In het volgende voorbeeld wordt een nieuwe waarde samengevoegd met de bestaande configuratie:

stage:
  deploy:
    SEARCH_CONFIGURATION:
      engine: elasticsearch
      elasticsearch_server_port: '9200'
      _merge: true

SESSION_CONFIGURATION

Configureer de Redis-sessieopslag. Vereist de opties save, redis, host, port en database voor de opslagvariabele van de sessie. Bijvoorbeeld:

stage:
  deploy:
    SESSION_CONFIGURATION:
      redis:
        bot_first_lifetime: 100
        bot_lifetime: 10001
        database: 0
        disable_locking: 1
        host: redis.internal
        max_concurrency: 10
        max_lifetime: 10001
        min_lifetime: 100
        port: 6379
      save: redis

Standaard overschrijft het implementatieproces alle instellingen in het env.php -bestand. U kunt er echter voor kiezen een of meer waarden voor een serviceconfiguratie samen te voegen zonder alle waarden te overschrijven.

Stel de optie _merge in op een van de volgende opties:

In het volgende voorbeeld wordt een nieuwe waarde samengevoegd met de bestaande configuratie:

stage:
  deploy:
    SESSION_CONFIGURATION:
      _merge: true
      redis:
        max_concurrency: 10

SKIP_SCD

Stel in op true om de implementatie van statische inhoud tijdens de implementatiefase over te slaan.

Voor de opstellen fase, plaats SKIP_SCD: true zodat de statische inhoudsbouwstijl niet tijdens de opstellen fase gebeurt. Dit het plaatsen minimaliseert plaatsingstijd en verhindert plaatsonderbreking die kan voorkomen als de statische inhoud tijdens de plaatsing bouwt ontbreekt. Zie ​ Statische inhoudsplaatsing ​.

stage:
  deploy:
    SKIP_SCD: true

UPDATE_URLS

Vervang bij implementatie Adobe Commerce basis-URL's in de database door het project-URL's die zijn opgegeven door de variabele MAGENTO_CLOUD_ROUTES . Deze configuratie is handig voor lokale ontwikkeling, waarbij basis-URL's zijn ingesteld voor uw lokale omgeving. Wanneer u implementeert in een Cloud-omgeving, worden de URL's bijgewerkt zodat u toegang hebt tot uw winkel en beheerder met de project-URL's.

Gebruik de variabele FORCE_UPDATE_URLS als u URL's moet bijwerken bij de implementatie naar een Pro- of Starter-staging- en productieomgeving.

stage:
  deploy:
    UPDATE_URLS: false

VERBOSE_COMMANDS

Laat toe of maak ​ Symfony ​ onbruikbaar zuivert breedband niveau voor bin/magento bevelen CLI die tijdens de plaatsingsfase worden uitgevoerd.

Kies het detailniveau in de logboeken:

stage:
  deploy:
    VERBOSE_COMMANDS: "-vv"