Bakåtkompatibla ändringar

Senast uppdaterad: 31 januari 2025

Ämnen:
Moln

Skapat för:

Administratör
Utvecklare

Bakåtkompatibla ändringar kan kräva att du justerar molnkonfigurationen och processerna för befintliga Cloud-projekt när du uppgraderar till den senaste versionen av ece-tools-paketet eller andra Creative Suite-paket för Commerce.

Ändringar i paketet `ece-tools`

Vissa funktioner som tidigare fanns i paketet ece-tools finns nu i separata paket. De här paketen är dispositionsberoenden för ece-tools, som installeras och uppdateras automatiskt när du installerar eller uppdaterar extraverktyg.

Den nya arkitekturen bör inte påverka installations- eller uppdateringsprocesserna. Du kan dock behöva ändra vissa kommandosyntaxer och processer när du arbetar med ditt Adobe Commerce i ett molninfrastrukturprojekt. Mer information finns i följande inkompatibla ändringar bakåt och i versionsinformationen för Cloud Tools Suite.

Ändringar av tjänstens versionskrav

Vi ändrade minimikravet för PHP-version från 7.0.x till 7.1.x för molnprojekt som använder ece-tools v2002.1.0 och senare. Om din miljökonfiguration anger PHP 7.0 ska du uppdatera php-konfigurationen i filen .magento.app.yaml.

WARNING

På grund av ändringen av PHP-versionskraven stöder ece-tools 2002.1.0 bara Adobe Commerce i molninfrastrukturprojekt som kör Adobe Commerce 2.1.15 eller senare. Om projektet använder en tidigare version måste du uppgradera innan du uppdaterar till ece-tools 2002.1.0.

Ändringar av miljökonfiguration

Följande tabell innehåller information om miljövariabler och andra miljökonfigurationsfiler som har tagits bort eller tagits bort i ece-tools v2002.1.0.

Objekt	Ersättning
Variabeln `SCD_EXCLUDE_THEMES`	`SCD_MATRIX`
Variabeln `STATIC_CONTENT_THREADS`	`SCD_THREADS`
Variabeln `DO_DEPLOY_STATIC_CONTENT`	`SKIP_SCD`
Variabeln `STATIC_CONTENT_SYMLINK`	Ingen. Nu skapar bygget alltid en länk till den statiska innehållskatalogen `pub/static`.
`build_options.ini` fil	Använd filen `.magento.env.yaml` för att konfigurera miljövariabler för att hantera bygg- och distributionsåtgärder i alla dina miljöer. Om du skapar en molnmiljö som innehåller filen `build_options.ini` misslyckas bygget.

Ändringar av CLI-kommandon

Följande tabell sammanfattar ändringar av CLI-kommandon i ECE-Tools v2002.1.0 som kan kräva att du uppdaterar kommandon eller skript.

Kommando	Ersättning
`m2-ece-build`	`vendor/bin/ece-tools build`
`m2-ece-deploy`	`vendor/bin/ece-tools deploy`
`m2-ece-scd-dump`	`vendor/bin/ece-tools config:dump`
`vendor/bin/ece-tools patch`	`vendor/bin/ece-patches apply`
`vendor/bin/ece-tools docker:build`	`vendor/bin/ece-docker build:compose`
`vendor/bin/ece-tools docker:config:convert`	`vendor/bin/ece-docker image:generate:php`

I tidigare versioner av ECE-Tools kunde du använda kommandona m2-ece-build och m2-ece-deploy för att konfigurera distributionsnätverk i filen .magento.app.yaml. När du uppdaterar till v2002.1.0 bör du kontrollera konfigurationen hooks i filen .magento.app.yaml för att se om det finns föråldrade kommandon och ersätta dem om det behövs.

Ändringar av molnkorrigeringar

Ta bort hämtade korrigeringsfiler-Paketet magento/magento-cloud-patches paketerar alla korrigeringsfiler som är tillgängliga från sidan programhämtningar och tillämpar dem automatiskt när du distribuerar till molnet. För att förhindra korrigeringskonflikter efter uppgradering till ECE-Tools 2002.1.0 eller senare, tar du bort eventuella patchar som du laddat ned och lagt till manuellt i ditt projekt.
Uppdaterar kommandot Tillämpa korrigeringar-Vi har flyttat kommandot för att tillämpa korrigeringar från katalogen vendor/bin/ece-tools till katalogen vendor/bin/ece-patches. Om du använder det här kommandot för att tillämpa korrigeringar manuellt använder du den nya sökvägen.

Tillämpa korrigeringar manuellt
php ./vendor/bin/ece-patches apply

Ändringar av Cloud Docker

PHP-versionen måste vara som lägst PHP-version nu PHP 7.1-Om Commerce-värden kör en tidigare version uppgraderar du till PHP v7.1 eller senare.
Kommandot Cloud Docker för Commerce ändras-
- Uppdaterar Cloud Docker för Commerce-kommandon för Docker-byggåtgärder-Vi har flyttat Cloud Docker för Commerce-kommandon från katalogen vendor/bin/ece-tools till katalogen vendor/bin/ece-docker. Uppdatera skript och kommandon så att de använder den nya sökvägen.
  
  När du har uppgraderat till ece-tools 2002.1.0 kan du använda följande kommando för att visa tillgängliga ece-docker -kommandon.
  php ./vendor/bin/ece-docker list
- Uppdaterar Cloud-dispositionskommandona-Vi har ändrat namn på sökvägen till kommandofilen från ./bin/docker till ./bin/magento-docker. Uppdatera skript och kommandon så att de använder den nya sökvägen.
- Kronbehållaren ingår inte längre i standardkonfigurationen för Docker-Now, du måste lägga till alternativet --with-cron i kommandot ece-docker build:compose för att kunna inkludera kronbehållaren i konfigurationen för Docker-miljön. Se Hantera cron-jobb i guiden Cloud Docker för Commerce.
  
  Skript som tidigare genererade behållare med cron-jobb är nu utan cron-behållare.
- Med temporära behållare-I tidigare versioner togs inte de behållare som skapades av bin/magento-docker-kommandoåtgärder bort, så du kunde använda dem för andra åtgärder. magento-docker-kommandona tar nu bort alla behållare som de skapar när kommandot har slutförts.
  
  Om du vill behålla en behållare som skapats med en Docker-compose-åtgärd använder du kommandot docker-compose run i stället för kommandot bin/magento-docker.
- När du kör kopplingar efter distribution-Kommandot cloud-deploy körs inte längre kopplingar efter distribution. Använd det nya cloud-post-deploy-kommandot för att köra kopplingar efter distributionen. Uppdatera skripten och lägg till kommandot för att köra kopplingar efter distributionen.
  bin/magento-docker ece-deploy bin/magento-docker ece-post-deploy
  Om du använder docker-compose-kommandon direkt kan du köra kommandot docker-compose run deploy cloud-post-deploy efter kommandot för distribution.
Uppdatering av databasen-Databasbehållaren lagras nu i den magento-db beständiga Docker-volymen. När du uppdaterar Docker-miljön tas databasen inte längre bort automatiskt. Om det behövs kan du ta bort det manuellt med något av följande kommandon.
- Ta bort behållaren magento-db:
  docker volume rm magento-db
- Ta bort alla associerade volymer när du stänger av Docker-behållarna:
  docker-compose down -v
Åsidosätt filsynkroniseringsinställningar för arkiv- och säkerhetskopieringsfiler-Arkiv- och säkerhetskopieringsfiler med följande tillägg synkroniseras inte längre när du använder dockningssynkronisering eller mutagen: SQL, GZ, ZIP och BZ2. Du kan åsidosätta standardfilsynkroniseringen för dessa filtyper genom att byta namn på filen så att den slutar med ett annat filtillägg. Till exempel: synchronize-me.zip-backup

recommendation-more-help