Propriétés pour la configuration de l’application

Le .magento.app.yaml Le fichier utilise des propriétés pour gérer la prise en charge de l’environnement pour le Commerce application.

name

Le name indique le nom de l’application utilisé dans routes.yaml pour définir le HTTP en amont (par défaut, mymagento:http). Par exemple, si la valeur de name est app, vous devez utiliser app:http dans le champ en amont.

type et build

Le type et build les propriétés fournissent des informations sur l’image du conteneur de base pour créer et exécuter le projet.

Les pris en charge type Le langage est PHP. Spécifiez la version PHP comme suit :

type: php:<version>

Le build détermine ce qui se passe par défaut lors de la création du projet. Le flavor spécifie un ensemble par défaut de tâches de génération à exécuter. L’exemple suivant illustre la configuration par défaut pour . type et build de 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'

Installation et utilisation du compositeur 2

Le build: flavor: La propriété n’est pas utilisée pour le compositeur 2.x. Vous devez donc installer manuellement le compositeur pendant la phase de création. Pour installer et utiliser le compositeur 2.x dans vos projets Starter et Pro, vous devez apporter trois modifications à votre .magento.app.yaml configuration :

Utilisez les fragments de configuration suivants dans les vôtres .magento.app.yaml configuration :

# 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

Voir Packages requis pour plus d’informations sur le compositeur.

dependencies

Spécifiez les dépendances dont votre application peut avoir besoin pendant le processus de création.

Adobe Commerce prend en charge les dépendances dans les langues suivantes :

Ces dépendances sont indépendantes des dépendances éventuelles de votre application et sont disponibles dans le PATH, pendant le processus de création et dans l’environnement d’exécution de votre application.

Vous pouvez spécifier ces dépendances comme suit :

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

runtime

Utilisez pour modifier la configuration PHP au moment de l'exécution, par exemple pour activer les extensions. Les extensions suivantes sont requises :

runtime:
    extensions:
        - xsl
        - newrelic
        - sodium

Voir Paramètres PHP pour plus d’informations sur l’activation des extensions.

disk

Définit la taille du disque persistant de l’application en Mo.

disk: 5120

La taille de disque minimale recommandée est de 256 Mo. Si l’erreur s’affiche UserError: Error building the project: Disk size may not be smaller than 128MB, augmentez la taille à 256 Mo.

relationships

Définit le mapping de service dans l'application.

La relation name est disponible pour l’application dans MAGENTO_CLOUD_RELATIONSHIPS variable d’environnement. Le <service-name>:<endpoint-name> La relation est mappée aux valeurs de nom et de type définies dans .magento/services.yaml fichier .

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

Voici un exemple de relations par défaut :

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

Voir Services tertiaires pour obtenir une liste complète des types de services et des points d’entrée actuellement pris en charge.

mounts

Objet dont les clés sont des chemins d’accès relatifs à la racine de l’application. Le montage est une zone accessible en écriture sur le disque pour les fichiers. Voici une liste par défaut des montages configurés dans le magento.app.yaml fichier utilisant volume_id[/subpath] syntaxe :

 # 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"

Le format d’ajout de votre montage à cette liste est le suivant :

"/public/sites/default/files": "shared:files/files"

Vous pouvez rendre le montage web accessible en l’ajoutant au web bloc d’emplacements.

access

Le access La propriété indique un niveau minimum de rôle d’utilisateur qui est autorisé à accéder aux environnements SSH. Les rôles utilisateur disponibles sont les suivants :

Le rôle utilisateur par défaut est . contributor, qui restreint l’accès SSH des utilisateurs avec uniquement visionneuse droits. Vous pouvez remplacer le rôle utilisateur par . viewer pour autoriser l’accès SSH aux utilisateurs avec uniquement visionneuse droits :

access:
    ssh: viewer