DocumentatieCommerceHandleiding voor Commerce in de cloud

[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."}

Projectstructuur

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Beheerder
  • Ontwikkelaar

Een Adobe Commerce on cloud-infrastructuurproject bevat essentiële bestanden voor referenties en toepassingsconfiguratie. Deze bestanden zijn beschikbaar in de vorm van een sjabloon volgens de Adobe Commerce-versie. Zie de wolkenmalplaatjes die op versie van Adobe Commerce in de magento/magento-cloud bewaarplaats GitHub ​ worden gebaseerd.

In de volgende tabel worden de bestanden beschreven die zijn opgenomen in een wolkenproject:

Bestand
Beschrijving
/.magento/routes.yaml
Het dossier van de configuratie dat www aan het apex domein en php toepassing opnieuw richt om HTTP te dienen. Zie ​ routes ​ vormen.
/.magento/services.yaml
Een configuratiedossier dat een instantie MySQL (MariaDB), Redis, en OpenSearch of Elasticsearch bepaalt. Zie ​ de diensten ​ vormen.
/app
De map code wordt gebruikt voor aangepaste modules. De design omslag wordt gebruikt voor ​ douanethema's ​. De map etc bevat configuratiebestanden voor de toepassing.
/m2-hotfixes
Wordt gebruikt voor aangepaste patches.
/update
Een de dienstomslag die door de steunmodule wordt gebruikt.
.gitignore
Geef op welke bestanden en mappen u wilt negeren. Zie .gitignore reference ​ .
.magento.app.yaml
Een configuratiebestand dat de eigenschappen definieert om de toepassing samen te stellen. Zie ​ toepassing ​ vormen.
.magento.env.yaml
Het dossier van de configuratie voor de bouw, opstellen, en post-opstellen fasen. Het pakket ece-tools bevat een voorbeeld van dit bestand. Zie ​ milieu's ​ vormen.
composer.json
Zoekt Adobe Commerce en de configuratiescripts om uw toepassing voor te bereiden. Zie ​ Vereiste pakketten ​.
composer.lock
Slaat versiegebiedsdelen voor elk pakket op. Zie ​ Vereiste pakketten ​.
magento-vars.php
Gebruikt om ​ veelvoudige opslag ​ en plaatsen te bepalen die variabelen gebruiken.
NOTE
Wanneer u uw lokale wijzigingen in de externe server doorvoert, gebruikt het implementatiescript de waarden die zijn gedefinieerd door configuratiebestanden in de map .magento . Vervolgens verwijdert het script de map en de inhoud ervan. Dit heeft geen invloed op uw lokale ontwikkelomgeving.

Hoofdmap van toepassing

De locatie van de hoofdmap van de toepassing is afhankelijk van de omgeving.

  • Begin en ProIntegratie: /app
  • Productie van de Aanzet: /<project-ID>
  • Pro het Staging: /<project-ID>_stg
  • Proproductie: /<project-ID>

Schrijfbare mappen

De externe integratie-, staging- en productieomgevingen zijn alleen-lezen. De volgende folders zijn slechts beschrijfbare folders voor veiligheidsredenen:

  • var
  • pub/static
  • pub/media
  • app/etc
  • /tmp
NOTE
In Productie- en staging-omgevingen heeft elk knooppunt in de cluster met drie knooppunten een /tmp -map die niet met de andere knooppunten wordt gedeeld.

Bestanden negeren

Er is een base .gitignore -bestand met de Adobe Commerce op de projectopslagplaats van de cloud-infrastructuur. Zie het recentste dossier .gitignore in magento-wolkenbewaarplaats ​. Als u een bestand wilt toevoegen dat in de lijst van .gitignore staat, kunt u de optie -f (geforceerd) gebruiken bij het stapelen van een commit:

git add <path/filename> -f

Basissjabloon wijzigen

U kunt de volgende stappen gebruiken om de structuur van een bestaand project te veranderen om het recentste basissjabloon voor Adobe Commerce op wolkeninfrastructuur te weerspiegelen.

  1. Kloont het project aan een lokaal werkstation.

  2. Werk het composer.json -bestand bij met de volgende waarden voor de extra -sectie.

    code language-json 
    "extra": {
    "magento-force": true
    "magento-deploystrategy": "copy"
}

  3. Voeg het .gitignore -bestand toe dat is ontworpen voor de basissjabloon. Bijvoorbeeld, als u het .gitignore dossier voor versie 2.2.6 malplaatje nodig hebt, gebruik ​ .gitignore voor 2.2.6 ​ dossier als verwijzing.

  4. Wis de git-cache.

    code language-bash 
    git rm -r --cached .

  5. Wijzigingen toevoegen en doorvoeren.

    code language-bash 
    git add -A && git commit -m "Update base template"
WARNING
Het implementatieproces begint wanneer u een samenvoeging, push of synchronisatie van uw omgeving uitvoert of wanneer u een handmatige herimplementatie activeert, waarbij de toepassing van Commerce zich in de onderhoudsmodus bevindt. Voor een productieomgeving raadt Adobe aan om deze werkzaamheden tijdens niet-piekuren af te ronden om onderbreking van de service te voorkomen.
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938