DocumentatieCommerceConfiguratiegids

Voorbeeld met CLI-opdrachten

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ervaren
  • Beheerder
  • Ontwikkelaar

Dit voorbeeld toont hoe te om gedeelde, systeem-specifieke, en gevoelige waarden in uw ontwikkelingssysteem te plaatsen, dan die waarden in uw productiesysteem op te stellen.
Dit wordt gedaan door een combinatie gedeelde configuraties, het config.php dossier, en het bevel van Commerce CLI te gebruiken.

In dit voorbeeld worden de volgende configuratie-instellingen gebruikt:

  • Vat Aantal en Naam van de Opslag voor de gedeelde configuratiemontages.

    Deze worden gevonden onder Slaat > Montages > Configuratie > Algemeen > Algemeen.

  • verzendt E-mail naar voor de gevoelige configuratiewaarde.

    Dit wordt gevonden onder Slaat > Montages > Configuratie > Algemeen > Contacten.

  • Standaard E-mailDomein voor de systeem-specifieke configuratiewaarde.

    Dit wordt gevonden onder Opslag > Montages > Configuratie > Klanten > de Configuratie van de Klant > creeer Nieuwe Opties van de Rekening.

U kunt de zelfde procedure gebruiken in dit voorbeeld wordt getoond om het even welke montages in de volgende verwijzingen te vormen die:

Voordat u begint

Alvorens u begint, de toestemmingen en de eigendom van het opstellingssysteem zoals besproken in Vereiste voor ontwikkeling, bouwt, en productiesystemen.

Veronderstellingen

Dit onderwerp verstrekt een voorbeeld om de configuratie van het productiesysteem te wijzigen. U kunt desgewenst verschillende configuratieopties kiezen.

In dit voorbeeld gaan we uit van het volgende:

  • U gebruikt Git-bronbesturingselement
  • Het ontwikkelingssysteem is beschikbaar in een Git-opslagplaats op afstand met de naam mconfig
  • Uw Git-werkvertakking krijgt de naam m2.2_deploy

Stap 1: Plaats de configuratie in het ontwikkelingssysteem

U kunt als volgt de standaardwaarden voor landinstelling en gewicht in uw ontwikkelingssysteem instellen:

  1. Meld u aan bij de beheerder.

  2. Klik Slaat op > Montages > Configuratie > Algemeen > Algemeen.

  3. Als u meer dan één beschikbare website hebt, gebruik de lijst van de Mening van de Opslag in de hogere linkerhoek om naar een verschillende website te schakelen aangezien het volgende cijfer toont.

    de websites van de Schakelaar

  4. In de juiste ruit, breid Informatie van de Opslag uit.

  5. Indien nodig, ontruim het Standaardvakje van het Gebruik naast het BTW Aantal en de gebieden van de Naam van de Opslag.

  6. Voer een getal in het veld in (bijvoorbeeld 12345 ).

  7. Op het gebied van de Naam van de Opslag, ga een waarde (als My Store) in.

  8. Klik sparen Config.

  9. In de linkernavigatie, onder Algemeen, klik Contacten.

  10. In de juiste ruit, breid E-mailOpties uit.

  11. Indien nodig, ontruim het Gebruik Standaard checkbox naast verzendt E-mail naar gebied.

  12. Voer een e-mailadres in het veld in.

  13. Klik sparen Config.

  14. Gebruik de lijst van de Mening van de Opslag om StandaardConfig te selecteren aangezien het volgende cijfer toont.

    Schakelaar aan het gebrek config

  15. In de linkerruit, klik Klanten > Configuratie van de Klant.

  16. In de juiste ruit, breid uit tot Nieuwe Opties van de Rekening.

  17. Indien noodzakelijk, ontruim het checkbox van de systeemwaarde van het 0} Gebruik naast het Standaard e-mailgebied gebied.

  18. Voer een domeinnaam in het veld in.

  19. Klik sparen Config.

  20. Maak de cache leeg als daarom wordt gevraagd.

Stap 2: Werk de configuratie bij

Nu u de configuratie in Admin hebt veranderd, schrijf de gedeelde configuratie aan een dossier zoals gebruikend de volgende stappen:

om de configuratie bij te werken:

  1. Meld u aan bij uw ontwikkelsysteem als of schakel over naar de eigenaar van het bestandssysteem.

  2. Verandering in de toepassingswortel en stel het dumpbevel in werking.

    code language-bash 
    cd <Magento root dir>
php bin/magento app:config:dump

    Als Commerce bijvoorbeeld is geïnstalleerd in /var/www/html/magento2 , voert u het volgende in:

    code language-bash 
    cd /var/www/html/magento2
php bin/magento app:config:dump

  3. Controleer of app/etc/config.php is bijgewerkt.

    code language-bash 
    git status

    Monsterrespons:

    code language-none 
    On branch m2.2_deploy
Changed but not updated:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)
       modified:   app/etc/config.php
    note warning
    WARNING
    Verzend __ geen veranderingen in generated, pub/media, of pub/static folders aan broncontrole. U genereert deze bestanden op uw buildsysteem. Het ontwikkelingssysteem heeft waarschijnlijk code, thema's, enzovoort, die niet klaar zijn voor gebruik op het productiesysteem.

  4. Controleer uw wijzigingen in app/etc/config.php alleen om broncontrole te verkrijgen.

    code language-bash 
    git add app/etc/config.php && git commit -m "Updated shared configuration" && git push mconfig m2.2_deploy

Hoewel app/etc/env.php (de systeem-specifieke configuratie) werd bijgewerkt, controleer het niet aan broncontrole.
U zult de zelfde configuratiemontages op uw productiesysteem later in deze procedure tot stand brengen.

Stap 3: Werk uw bouwstijlsysteem bij en produceer dossiers

Nu u uw veranderingen in de gedeelde configuratie aan broncontrole hebt geëngageerd, kunt u die veranderingen in uw bouwstijlsysteem trekken, de code compileren, en statische dossiers produceren.

om het bouwstijlsysteem bij te werken:

  1. Meld u aan bij het constructiesysteem als de eigenaar van het bestandssysteem.

  2. Wijzig de hoofdmap van de toepassing.

    code language-bash 
    cd <Magento root dir>

  3. Trek de wijzigingen in app/etc/config.php van het bronbesturingselement.

    code language-bash 
    git pull mconfig m2.2_deploy

  4. Compileer code.

    code language-bash 
    bin/magento setup:di:compile

  5. Nadat de code is gecompileerd, produceer statische meningsdossiers.

    code language-bash 
    bin/magento setup:static-content:deploy -f

  6. Controleer de veranderingen in broncontrole.

    code language-bash 
    git add -A && git commit -m "Updated files on build system" && git push mconfig m2.2_deploy

Stap 4: Productiesysteem bijwerken

De laatste stap in het proces is het bijwerken van uw productiesysteem. U moet het in twee delen doen:

  • De gevoelige en systeemspecifieke instellingen bijwerken
  • De gedeelde instellingen bijwerken

De gevoelige en systeemspecifieke instellingen bijwerken

Als u de gevoelige en systeemspecifieke instellingen wilt instellen met omgevingsvariabelen, moet u het volgende weten:

  • Bereik voor elke instelling

    Als u de instructies in Stap 1 volgde, verzendt het werkingsgebied voor E-mail naar website en het werkingsgebied voor Standaard E-maildomein is globaal (namelijk het werkingsgebied Standaard Config).

    U hebt de websitecode nodig om te plaatsen verzendt E-mail naar configuratiewaarde.

    Voor meer informatie bij het vinden van deze waarde, zie: de milieuvariabelen van het Gebruik om configuratiemontagesmet voeten te treden.

  • Configuratiepaden voor de instellingen die in dit voorbeeld worden gebruikt:

    table 0-row-2 1-row-2 2-row-2
    Naam instellen Configuratiepad
    E-mails verzenden naar contact/email/recipient_email
    Standaard-e-maildomein customer/create_account/email_domain

    Voor alle gevoelige en systeem-specifieke configuratiewegen, zie: Gevoelige en systeem-specifieke verwijzing van configuratiepaden.

De variabelen instellen met CLI-opdrachten

Gebruik de volgende CLI bevelen om systeem-specifieke en gevoelige configuratiemontages te plaatsen:

  • magento config:set voor systeemspecifieke instellingen
  • magento config:sensitive:set voor gevoelige instellingen

Om het systeem-specifieke plaatsen Standaard E-mailDomein te plaatsen, dat in het standaardwerkingsgebied is, gebruik het volgende bevel:

bin/magento config:set customer/create_account/email_domain <email domain>

U hoeft het bereik niet in de opdracht te gebruiken omdat dit het standaardbereik is.

Om waarden voor te plaatsen verzendt E-mail naar, echter, moet u het werkingsgebiedtype (website) en de werkingsgebiedcode kennen, die waarschijnlijk verschillend op elke plaats is.

Voorbeeld:

bin/magento config:sensitive:set contact/email/recipient_email --scope=website --scope-code=<website code> <email address>

De gedeelde instellingen bijwerken

Deze sectie bespreekt hoe te om alle veranderingen te trekken u op uw ontwikkeling aanbracht en systemen aan een productiemilieu bouwt, dat de gedeelde configuratiemontages (de Naam van de Opslag en het Aantal van de BTW) bijwerkt.

om het productiesysteem bij te werken:

  1. Meld u als eigenaar van het bestandssysteem aan bij het productiesysteem.

  2. Schakel over naar de hoofdmap van de toepassing en schakel de onderhoudsmodus in.

    code language-bash 
    cd <Magento root dir>
    code language-bash 
    bin/magento maintenance:enable

    Zie magento maintenance:enable voor extra opties, zoals de mogelijkheid om een IP-adreslijst in te stellen.

  3. Stop alle actieve workers in de wachtrij door cron_run als volgt in te stellen op false in app/etc/env.php :

    code language-php?start_inline=1 
    'cron_consumers_runner' => [
        'cron_run' => false
    ]

  4. Werk de configuratie bij.

    code language-bash 
    bin/magento app:config:import

  5. Tot slot kill alle actieve consumentenprocessen.

    code language-bash 
    kill <PID>

    Waar PID de proces-id is die moet worden gedood, bijvoorbeeld:

    code language-bash 
    kill 1234

  6. Trek code van broncontrole.

    code language-bash 
    git pull mconfig m2.2_deploy

  7. Werk de configuratie bij.

    code language-bash 
    bin/magento app:config:import

  8. Maak de cache leeg.

    code language-bash 
    bin/magento cache:clean

  9. Eindonderhoudsmodus.

    code language-bash 
    bin/magento maintenance:disable

Configuratie-instellingen controleren in de beheerder

Om de configuratiemontages te verifiëren:

  1. Meld u aan bij de beheerder van het productiesysteem.

  2. Klik Slaat op > Montages > Configuratie > Algemeen > Algemeen.

  3. Gebruik de lijst van de Mening van de Opslag in de hogere linkerhoek om aan een verschillende website over te schakelen.

    De gedeelde configuratieopties die u in het ontwikkelingssysteem instelt, worden als volgt weergegeven.

    de montages van de Controle in het productiesysteem

    note info
    INFO
    Het gebied van de Naam van de Opslag is editable in het websitewerkingsgebied maar als u op het Gebrek Config schakelt, is het niet editable. Dit is het resultaat van hoe u de opties in het ontwikkelingssysteem plaatst. De waarde van het Aantal van BTW is niet editable in websitewerkingsgebied.

  4. Als u dit nog niet hebt gedaan, schakelaar aan het werkingsgebied Standaard Config.

  5. In de linkernavigatie, onder Algemeen, klik Contacten.

    verzendt E-mail naar gebied is niet editable, aangezien het volgende cijfer toont. Dit is een gevoelige instelling.

    de montages van de Controle in het productiesysteem

  6. In de linkerruit, klik Klanten > Configuratie van de Klant.

  7. In de juiste ruit, breid uit tot Nieuwe Opties van de Rekening.

    De waarde van het StandaardE-mailDomein gebied wordt getoond als volgt. Dit is een systeemspecifieke instelling.

    de montages van de Controle in het productiesysteem

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c