Egenskaper för programkonfiguration

Filen .magento.app.yaml använder egenskaper för att hantera miljöstöd för programmet Commerce.

Namn
Beskrivning
Standard
Obligatoriskt
access
Anpassa användarroller
Nej
crons
Uppdatera specifikationer och schemalägg cron-jobb
Nej
dependencies
Aktivera ytterligare beroenden
php:composer/composer: '2.2.4'
Nej
disk
Definiera den beständiga diskstorleken
5120
Ja
firewall
(Endast Starter) Kontrollera utgående trafik
Nej
hooks
Skräddarsy kommandon för faserna för bygge, driftsättning och efterdriftsättning
Nej
mounts
Ange banor

Banor:

  • "var": "shared:files/var"
  • "app/etc": "shared:files/etc"
  • "pub/media": "shared:files/media"
  • "pub/static": "shared:files/static"
Nej
name
Definiera programnamnet
mymagento
Ja
relationships
Karttjänster

Tjänster:

  • database: "mysql:mysql"
  • redis: "redis:redis"
  • opensearch: "opensearch:opensearch"
Nej
runtime
Körningsegenskapen innehåller tillägg som krävs av programmet Commerce.

Tillägg:

  • xsl
  • newrelic
  • sodium
Ja
type
Ange basbehållarbilden
php:8.3
Ja
variables
Använda en miljövariabel för en viss Commerce-version
Nej
web
Hantera externa begäranden
Ja
workers
Hantera externa begäranden
Ja, om inte egenskapen web används

name

Egenskapen name innehåller det programnamn som används i filen routes.yaml för att definiera HTTP-uppströmmen (som standard mymagento:http). Om värdet för name till exempel är app måste du använda app:http i det överordnade fältet.

WARNING
Ändra inte namnet på programmet efter att det har distribuerats. Detta leder till dataförlust.

type och build

Egenskaperna type och build innehåller information om basbehållaravbildningen för att skapa och köra projektet.

Det type-språk som stöds är PHP. Ange PHP-versionen enligt följande:

type: php:<version>

Egenskapen build avgör vad som händer som standard när projektet skapas. flavor anger en standarduppsättning med byggåtgärder som ska köras. I följande exempel visas standardkonfigurationen för type och build från magento-cloud/.magento.app.yaml:

# The toolstack used to build the application.
type: php:8.3
build:
    flavor: none

dependencies:
    php:
        composer/composer: '2.7.2'

Installera och använda Composer 2

Egenskapen build: flavor: används inte för Composer 2.x och du måste därför installera Composer manuellt under byggfasen. Om du vill installera och använda Composer 2.x i dina Starter- och Pro-projekt måste du göra tre ändringar i din .magento.app.yaml-konfiguration:

  1. Ta bort composer som build: flavor: och lägg till none. Den här ändringen förhindrar att Creative Cloud använder standardversionen av Composer 1.x för att köra byggåtgärder.
  2. Lägg till composer/composer: '^2.0' som ett php-beroende för installation av Composer 2.x.
  3. Lägg till byggaktiviteterna composer i en build-krok för att köra byggaktiviteterna med Composer 2.x.

Använd följande konfigurationsfragment i din egen .magento.app.yaml-konfiguration:

# 1. Change flavor to none.
build:
    flavor: none

# 2. Add Composer ^2.0 as a php dependency.
dependencies:
    php:
        composer/composer: '^2.0'

# 3. Add a build hook to run the build tasks using Composer 2.x.
hooks:
    build: |
        set -e
        composer --no-ansi --no-interaction install --no-progress --prefer-dist --optimize-autoloader

Mer information om Composer finns i Obligatoriska paket.

dependencies

Ange beroenden som programmet kan behöva under byggprocessen.

Adobe Commerce stöder beroenden av följande språk:

  • PHP
  • Ruby
  • Node.js

Dessa beroenden är oberoende av de eventuella beroendena för ditt program och är tillgängliga i PATH, under byggprocessen och i körningsmiljön för ditt program.

Du kan ange dessa beroenden enligt följande:

ruby:
   sass: "~3.4"
nodejs:
   grunt-cli: "~0.3"

runtime

Används för att ändra PHP-konfigurationen vid körning, till exempel för att aktivera tillägg. Följande tillägg krävs:

runtime:
    extensions:
        - xsl
        - newrelic
        - sodium

Mer information om hur du aktiverar tillägg finns i PHP-inställningar.

disk

Definierar programmets beständiga diskstorlek i MB.

disk: 5120

Den minsta rekommenderade diskstorleken är 256 MB. Om felet UserError: Error building the project: Disk size may not be smaller than 128MB visas ökar du storleken till 256 MB.

NOTE
För Pro Staging- och Production-miljöer måste du skicka in en Adobe Commerce Support-biljett för att uppdatera konfigurationen mounts och disk för ditt program. När du skickar biljetten anger du de konfigurationsändringar som krävs och inkluderar en uppdaterad version av din .magento.app.yaml-fil.

relationships

Definierar tjänstmappningen i programmet.

Relationen name är tillgänglig för programmet i miljövariabeln MAGENTO_CLOUD_RELATIONSHIPS. Relationen <service-name>:<endpoint-name> mappas till de namn- och typvärden som definierats i filen .magento/services.yaml.

relationships:
    <name>: "<service-name>:<endpoint-name>"

Följande är ett exempel på standardrelationerna:

relationships:
    database: "mysql:mysql"
    redis: "redis:redis"
    opensearch: "opensearch:opensearch"
    rabbitmq: "rabbitmq:rabbitmq"

En fullständig lista över de tjänstetyper och slutpunkter som stöds finns i Tjänster.

mounts

Ett objekt vars nycklar är sökvägar i förhållande till programmets rot. Monteringen är ett skrivbart område på disken för filer. Följande är en standardlista över mängder som har konfigurerats i filen magento.app.yaml med syntaxen volume_id[/subpath]:

 # The mounts that will be performed when the package is deployed.
mounts:
    "var": "shared:files/var"
    "app/etc": "shared:files/etc"
    "pub/media": "shared:files/media"
    "pub/static": "shared:files/static"

Formatet för att lägga till din montering i den här listan är följande:

"/public/sites/default/files": "shared:files/files"
  • shared - Delar en volym mellan program i en miljö.
  • disk - Definierar storleken som är tillgänglig för den delade volymen.
NOTE
För Pro Staging- och Production-miljöer måste du skicka in en Adobe Commerce Support-biljett för att uppdatera konfigurationen mounts och disk för ditt program. När du skickar biljetten anger du de konfigurationsändringar som krävs och inkluderar en uppdaterad version av din .magento.app.yaml-fil.

Du kan göra monteringen webbtillgänglig genom att lägga till den i web-blocket med platser.

WARNING
När platsen har data ska du inte ändra subpath-delen av monteringsnamnet. Det här värdet är den unika identifieraren för området files. Om du ändrar det här namnet förlorar du alla webbplatsdata som lagras på den gamla platsen.

access

Egenskapen access anger en lägsta användarrollnivå som tillåter SSH-åtkomst till miljöerna. De tillgängliga användarrollerna är:

  • admin - Kan ändra inställningar och köra åtgärder i miljön. Har behörighet för medverkande och visningsprogram.
  • contributor - Kan överföra kod till den här miljön och grenar från miljön. Har visningsprogrambehörighet.
  • viewer - Kan endast visa miljön.

Standardanvändarrollen är contributor, vilket begränsar SSH-åtkomsten från användare med endast visningsprogrambehörighet. Du kan ändra användarrollen till viewer för att tillåta SSH-åtkomst för användare med endast visningsprogrambehörighet:

access:
    ssh: viewer
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26