Omgevingsvariabelen voor implementatie configureren

Het bestand van .magento.env.yaml gebruikt omgevingsvariabelen om het beheer van het maken en implementeren van acties in al uw omgevingen te centraliseren, inclusief Pro Staging en Production. Om unieke acties in elke milieu te vormen, moet u dit dossier in elke milieu wijzigen.

Bestandsstructuur

Het bestand .magento.env.yaml bevat twee secties: stage en log . De stage sectie controleert acties die tijdens de fasen van het de plaatsingsproces van de Wolkvoorkomen.

Omgevingsvariabelen

Het ece-tools pakket plaatst waarden in het env.php dossier dat op waarden van variabelen van de Wolkwordt gebaseerd, variabelen die in Cloud Console worden geplaatst, en het .magento.env.yaml configuratiedossier. De omgevingsvariabelen in het .magento.env.yaml -bestand passen de Cloud-omgeving aan door de bestaande Commerce-configuratie te overschrijven. Als een standaardwaarde Not Set is, dan neemt het ece-tools pakket NO actie en gebruikt het Commerce gebrek of de waarde van de configuratie MAGENTO_CLOUD_RELATIONSHIPS. Als de standaardwaarde is ingesteld, wordt die standaardwaarde ingesteld door het ece-tools -pakket.

De volgende onderwerpen bevatten gedetailleerde definities, zoals of een standaardwaarde is ingesteld of niet, van alle variabelen die u in het .magento.env.yaml -bestand kunt gebruiken:

Configuratiebestand maken van CLI

U kunt een .magento.env.yaml -configuratiebestand voor een Cloud-omgeving genereren met behulp van de volgende ece-tools -opdrachten.

Maakt een configuratiebestand

php ./vendor/bin/ece-tools cloud:config:create `<configuration-json>`

Waarden bijwerken in het configuratiebestand

php ./vendor/bin/ece-tools cloud:config:update `<configuration-json>`

Voor beide opdrachten is één argument vereist: een array in JSON-indeling die een waarde opgeeft voor ten minste één variabele voor build, implementatie of implementatie na implementatie. Met de volgende opdracht stelt u bijvoorbeeld waarden in voor de variabelen SCD_THREADS en CLEAN_STATIC_FILES :

php vendor/bin/ece-tools cloud:config:create '{"stage":{"build":{"SCD_THREADS":5}, "deploy":{"CLEAN_STATIC_FILES":false}}}'

En maakt een .magento.env.yaml -bestand met de volgende instellingen:

stage:
  build:
    SCD_THREADS: 5
  deploy:
    CLEAN_STATIC_FILES: false

U kunt de opdracht cloud:config:update gebruiken om het nieuwe bestand bij te werken. Met de volgende opdracht wijzigt u bijvoorbeeld de waarde SCD_THREADS en voegt u de configuratie SCD_COMPRESSION_TIMEOUT toe:

php vendor/bin/ece-tools cloud:config:update '{"stage":{"build":{"SCD_THREADS":3, "SCD_COMPRESSION_TIMEOUT":1000}}}'

Het bijgewerkte bestand bevat de volgende configuratie:

stage:
  build:
    SCD_THREADS: 3
    SCD_COMPRESSION_TIMEOUT: 1000
  deploy:
    CLEAN_STATIC_FILES: false

Configuratiebestand valideren

Gebruik de volgende opdracht ece-tools om het configuratiebestand van .magento.env.yaml te valideren voordat u wijzigingen aanbrengt in de externe cloud-omgeving.

php ./vendor/bin/ece-tools cloud:config:validate

De volgende voorbeeldreactie bevat een lijst met te corrigeren items:

Environment configuration is not valid. Correct the following items in your .magento.env.yaml file:
The SCD_THREADS variable contains an invalid value of type string. Use the following type: integer.
The SCD_STRATEGY variable contains an invalid value fast. Use one of the available value options: compact, quick, standard.
The NOT_EXIST_OPTION variable is not allowed in configuration.

PHP-constanten

U kunt PHP-constanten gebruiken in .magento.env.yaml -bestandsdefinities in plaats van hard-coderingswaarden. In het volgende voorbeeld wordt de driver_options gedefinieerd met behulp van een PHP-constante:

stage:
  deploy:
    DATABASE_CONFIGURATION:
      connection:
        default:
          driver_options:
            !php/const:\PDO::MYSQL_ATTR_LOCAL_INFILE : 1
        indexer:
          driver_options:
            !php/const:\PDO::MYSQL_ATTR_LOCAL_INFILE : 1
      _merge: true

Foutafhandeling

Wanneer een fout optreedt als gevolg van een onverwachte waarde in het configuratiebestand van .magento.env.yaml , ontvangt u een foutbericht. In het volgende foutbericht wordt bijvoorbeeld een lijst met voorgestelde wijzigingen in elk item met een onverwachte waarde weergegeven, waarbij soms geldige opties worden geboden:

- Environment configuration is not valid. Please correct .magento.env.yaml file with next suggestions:
  Item CRON_CONSUMERS_RUNNER is not supposed to be in stage build. Please move it to one of possible stages: global, deploy
  Item SKIP_SCD has unexpected type string. Please use one of next types: boolean
  Item VERBOSE_COMMANDS has unexpected type boolean. Please use one of next types: string
  Item SKIP_HTML_MINIFICATION has unexpected type string. Please use one of next types: boolean
  Item CRON_CONSUMERS_RUNNER has unexpected type boolean. Please use one of next types: array
  Item VAR_WARM_UP_PAGES is not allowed in configuration.
  Item WARM_UP_PAGES has unexpected type string. Please use one of next types: array

Breng de gewenste correcties aan, wijs deze toe en duw op de wijzigingen. Als u geen foutbericht ontvangt, slagen de wijzigingen in het configuratiebestand voor de validatie.

Optimalisatie van configuratiebeheer

Als u het Beheer van de Configuratie na het dumpen van de configuraties hebt toegelaten, zou u de variabelen SCD_* van opstellen aan het bouwstijlstadium moeten bewegen. Zie Statische strategieën van de inhoudsplaatsing.

Voor configuratiebeheer:

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...
    REDIS_USE_SLAVE_CONNECTION: 1

Na het toelaten van het Beheer van de Configuratie, verplaats de variabelen SCD_* naar het bouwstijlstadium:

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    REDIS_USE_SLAVE_CONNECTION: 1
  build:
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...