Egenskaper för programkonfiguration

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

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.

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:

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:

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.

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"

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

access

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

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